gtkmm 3.0 docs don't work in devhelp
Bug #886705 reported by
Mathias Hasselmann
This bug affects 4 people
Affects | Status | Importance | Assigned to | Milestone | |
---|---|---|---|---|---|
gtkmm3.0 (Ubuntu) |
Triaged
|
Undecided
|
Unassigned |
Bug Description
/usr/share/
so either debian/
-usr/share/
+usr/share/
or the base attribute of gtkmm-3.0.devhelp2 must be adjusted.
which solution do you prefer, so that i can do the patch?
affects: | ubuntu → gtkmm3.0 (Ubuntu) |
Changed in gtkmm3.0 (Ubuntu): | |
status: | New → Confirmed |
To post a comment you must log in.
That base attribute valueof the <book> tag in the .devhelp2 file is apparently set during make install (but only in the copy that is installed, not the original) by this line of the (generated) Makefile:
devhelp_install = $(doc_install_cmd) --book- base='$ (htmlrefdir: /=)'
For instance, you will see these lines during make install
/bin/mkdir -p '/opt/gnome/ share/devhelp/ books/gtkmm- 3.0' doc-install. pl" --verbose --mode=0644 --book- base='/ opt/gnome/ share/doc/ gtkmm-3. 0/reference /html' -t '/opt/gnome/ share/devhelp/ books/gtkmm- 3.0' -- reference/ gtkmm-3. 0.devhelp2 share/doc/ gtkmm-3. 0/reference/ html for Devhelp book
/usr/bin/perl -- "../docs/
doc-install: Using base path /opt/gnome/
doc-install: Translating gtkmm-3.0.devhelp2 (rewrote base path)
(That doc-install perl script is from mm-common.)
That htmlrefdir is based on the standard datarootdir variable. Presumably the debian package passes --datarootdir to configure to change the default, though I don't see where that is done here: bazaar. launchpad. net/~ubuntu- branches/ ubuntu/ oneiric/ gtkmm3. 0/oneiric/ files/head: /debian/
http://
That htmlrefdir is apparently also used when installing the .html files, so I wonder how the two locations could get out of sync.
Maybe they use a patch, because I don't see how else you could change gtkmm-3.0 to libgtkmm-3.0 in the $(book_name) here: /doc/$( book_name) /reference /html
libdocdir = $(datarootdir)
referencedir = $(libdocdir)
htmlrefdir = $(referencedir)
It feels like a debian/Ubuntu packageing bug but I'd welcome a patch for upstream gtkmm if it turns out that we are not really doing what the debian/Ubuntu package asks us to do.