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 533262 - no-template mode scans different source files
no-template mode scans different source files
Status: RESOLVED FIXED
Product: gtk-doc
Classification: Platform
Component: general
1.10
Other Linux
: Normal normal
: 1.11
Assigned To: gtk-doc maintainers
gtk-doc maintainers
Depends on:
Blocks:
 
 
Reported: 2008-05-15 10:51 UTC by Ross Burton
Modified: 2008-06-06 10:27 UTC
See Also:
GNOME target: ---
GNOME version: ---


Description Ross Burton 2008-05-15 10:51:30 UTC 
I switched my gtkdocize to no-template mode and suddenly the documentation being scanned changes.  Functions which were previously ignored (as they are not public) are being scanned, section headers are being ignored, and more.

By comparing the two makefiles I see this difference:

-- gtk-doc.make	2008-03-19 21:32:18.000000000 +0000
+++ gtk-doc.notmpl.make	2008-03-19 21:32:18.000000000 +0000

-sgml-build.stamp: tmpl.stamp $(HFILE_GLOB) $(CFILE_GLOB) $(DOC_MODULE)-sections.txt $(srcdir)/tmpl/*.sgml $(expand_content_files)

+sgml-build.stamp: $(DOC_MODULE)-decl.txt $(SCANOBJ_FILES) $(DOC_MODULE)-sections.txt $(DOC_MODULE)-overrides.txt $(expand_content_files)

That difference looks wrong to me.
Comment 1 Stefan Sauer (gstreamer, gtkdoc dev) 2008-05-20 17:20:32 UTC 
right, $(HFILE_GLOB) $(CFILE_GLOB) is missing. 

in the notmpl it should be:

sgml-build.stamp: $(DOC_MODULE)-decl.txt $(SCANOBJ_FILES) $(DOC_MODULE)-sections.txt $(DOC_MODULE)-overrides.txt $(HFILE_GLOB) $(CFILE_GLOB) $(expand_content_files)

I will try this as soon as possible. would be great if you coudl too and confirm if it fixes the problem.
Comment 2 Ross Burton 2008-05-20 18:02:59 UTC 
Sure, shout when its in svn and I'll give it a go.
Comment 3 Stefan Sauer (gstreamer, gtkdoc dev) 2008-06-04 10:59:23 UTC 
Ross, could you recheck?
Comment 4 Ross Burton 2008-06-06 10:27:01 UTC 
Much better, the only difference between tmpl-docs and no-tmpl-docs is now empty paragraphs in the tmpl-docs (which is a good difference).