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 86860 - docextract.py doesn't parse tmpl/*.sgml
docextract.py doesn't parse tmpl/*.sgml
Status: RESOLVED FIXED
Product: pygobject
Classification: Bindings
Component: codegen
unspecified
Other Linux
: Normal normal
: ---
Assigned To: James Henstridge
James Henstridge
Depends on:
Blocks: 86861
 
 
Reported: 2002-06-29 19:03 UTC by Murray Cumming
Modified: 2008-07-16 10:12 UTC
See Also:
GNOME target: ---
GNOME version: ---

Attachments
extract_tmpl.patch (2.97 KB, patch)
2002-07-08 18:18 UTC, Murray Cumming 		none Details | Review

Description Murray Cumming 2002-06-29 19:03:54 UTC 
docextract.py doesn't get the documentation in GTK+'s tmpl/*.sgml files. See
http://lists.gnome.org/archives/language-bindings/2002-March/msg00001.html

I'm not a gnome-python user, but we reuse this script for the gtkmm2
documentation.
Comment 1 James Henstridge 2002-07-08 14:49:29 UTC 
I added a docextract.parse_tmpl() function which can extract
additional documentation from a tmpl file.  It just adds to the
FunctionDoc objects in the dictionary.
Comment 2 Murray Cumming 2002-07-08 18:17:09 UTC 
Thankyou. So this patch seems to make sense.

+2002-07-08  Murray Cumming  <murrayc@usa.net>
+
+
* codegen/docextract.py (extract): Look for .sgml files and parse
+
them as tmpl/*.sgml files. The user would have specified a
+
directory for tmpl/*.sgml files as well as directories for *.cc files.
+
Comment 3 Murray Cumming 2002-07-08 18:18:00 UTC 
Created attachment 9717 [details] [review]
extract_tmpl.patch
Comment 4 James Henstridge 2002-07-09 15:47:29 UTC 
Instead of overloading the extract() function, I added an additional
extract_tmpl() function.  You pass in a list of tmpl/ directories
(this one does not recurse like extract() does).

2002-07-09  James Henstridge  <james@daa.com.au>

	* codegen/docextract.py (extract_tmpl): function to extract docs
	from gtk-doc 'tmpl' files.  Takes a list of tmpl/ directories as
	an argument.  Doesn't recurse.  Fixes bug 86860.