GNOME Bugzilla – Bug 752795
documentation is not rebuilt when only content of doc comments change
Last modified: 2015-07-23 19:13:05 UTC
The $(HFILE_GLOB) $(CFILE_GLOB) are used as prerequisites for the scan step: https://git.gnome.org/browse/gtk-doc/tree/gtk-doc.notmpl.make#n113 If a change in a doc comment in any *.c or *.h file (or anything covered by --suffixes) results in no change of the files generated by the scan step (e.g. only a typo was fixed), we don't proceed. In order to fix this, we need to add $(HFILE_GLOB) $(CFILE_GLOB) also as prerequisites for the mkdb step: https://git.gnome.org/browse/gtk-doc/tree/gtk-doc.notmpl.make#n145 In fact we can probably merge them. The mkdb takes care that the sgml.stamp is only written if any of the docbook files changed. Hence this change should be safe.
commit 08899bc14254bcd3bc0f5c41fa6bf2a36d1e0333 Author: Stefan Sauer <ensonic@users.sf.net> Date: Thu Jul 23 21:10:10 2015 +0200 make: run mkdb on any source change We did not rebuild the docs when sources where edited in a way that did not result in a structural doc change (e.g. a typo fix). Fixes #752795