GNOME Bugzilla – Bug 303571
Expansion of extra content files
Last modified: 2005-05-16 15:47:25 UTC
For a long time, an annoying aspect of gtk-doc is that you can't use the handy abbreviations (#GtkWidget) in extra material included with the manual that doesn't live in the templates. The attached patch: - Adds a --extra-db-files option to gtkdoc-mkdb which specifies extra files to expand and copy into the output directory - Adds a $expand_content_files variable to gtk-doc.make Thinking it over, it's probably better to rename the gtkdoc option to --expand-content-files as well. It's --extra-db-files on rough analogy to --main-sgml-file.
Created attachment 46241 [details] [review] Patch implementing --extra-db-files
Turns out that this patch causes a problem ... you can't reference undefined variables in EXTRA_DIST, so makefiles with the new gtk-doc.make break until expand_content_files is added to them. The only easy thing I can think of is to require people to list such content files in *both* content_files and in expand_content_files rather than make them parallel. I don't like it so much, but it should be workable.
Looks fine. I agree that '--expand-content-files' is better.
OK if I bump the gtk-doc version to 1.4 when committing this? I need a new version number to actually use this stuff in the Cairo docs.
Sure.
2005-05-10 Owen Taylor <otaylor@redhat.com> * gtkdoc-mkdb.in: Add an --expand-content-files option to specify extra files to expand abbreviations in and copy into the output directory. * gtk-doc.make examples/Makefile.am: Add expand_content_files variable. * configure.in: Up version to 1.4.