After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 707928 - Set DOC_MODULE_VERSION for gtk-doc
Set DOC_MODULE_VERSION for gtk-doc
Status: RESOLVED FIXED
Product: geocode-glib
Classification: Other
Component: general
0.99.x
Other Linux
: Normal normal
: ---
Assigned To: geocode-glib maintainer(s)
geocode-glib maintainer(s)
Depends on:
Blocks:
 
 
Reported: 2013-09-11 16:29 UTC by Marvin Schmidt
Modified: 2013-09-15 07:52 UTC
See Also:
GNOME target: ---
GNOME version: ---



Description Marvin Schmidt 2013-09-11 16:29:18 UTC
This will make gtk-doc install the docs into a versioned directory, so that future API versions can be installed in parallel
Comment 1 Zeeshan Ali 2013-09-13 01:06:08 UTC
Ok but how/where to define this? `git grep DOC_MODULE_VERSION` in gtk+, glib and clutter doesn't yield any results and I couldn't find any mention of such on gtk-doc manual: https://developer.gnome.org/gtk-doc-manual/unstable/ . Most likely this is just me admitting to my 0 skills in gtkdoc. :)
Comment 2 Marvin Schmidt 2013-09-14 08:42:52 UTC
As far as i can see the only place where it's 'documented' is in the example Makefile.am (https://git.gnome.org/browse/gtk-doc/tree/examples/Makefile.am#n14) - the gtk-doc manual doesn't really cover all the Makefile.am variables from what i see.
The modules you grep'ed through don't use this feature unfortunately. For clutter I opened a bug as well (bug 706106) but didn't get any response so far.
libchamplain would we an example of a module which makes use of DOC_MODULE_VERSION as of https://git.gnome.org/browse/libchamplain/commit/?id=1d400445400ee2e47629fdbfbb4db1a4611e1dcf
Comment 3 Zeeshan Ali 2013-09-15 00:21:36 UTC
Pushed a patch based on your patch to libchamplain. Thanks!
Comment 4 Marvin Schmidt 2013-09-15 07:52:15 UTC
I just now realize that I didn't attach the patch for it and see how this bug report was kind of confusing, sorry for that :-$

Thanks for writing the patch and pushing it!