gtk-doc r609 - trunk

[stefkost svn gnome org]

Author: stefkost
Date: Thu Oct 16 19:52:19 2008
New Revision: 609
URL: http://svn.gnome.org/viewvc/gtk-doc?rev=609&view=rev

Log:
	* TODO:
	* gtkdoc-mktmpl.in:
	  Small comment cleanup and loud thinking in TODO :)



Modified:
   trunk/ChangeLog
   trunk/TODO
   trunk/gtkdoc-mktmpl.in

Modified: trunk/TODO
==============================================================================
--- trunk/TODO	(original)
+++ trunk/TODO	Thu Oct 16 19:52:19 2008
@@ -42,8 +42,11 @@
     where TARGET_DIR = $(HTML_DIR)/$(DOC_MODULE)
     http://www.gnu.org/software/libtool/manual/automake/DESTDIR.html
     
-* $MODULE-unused.txt is produced in gtkdoc-mktmpl.txt only
+* $MODULE-unused.txt is produced in gtkdoc-mktmpl only
   * we won't find unused doc blobs in notmpl build
+  * we should add mktmpl::CheckAllDeclarationsOutput() to mkdb (call it after
+    OutputSGML), but only call it if there is no tmpl dir or
+    remove writing the unused.txt in mktmpl.txt
 
 = Output =
 * http://sagehill.net/docbookxsl/index.html
@@ -127,10 +130,23 @@
   * http://www.xml.com/pub/a/2001/04/18/perlxmlqstart1.html
 == handling the annotations ==
 * figure out how to install default glossary
-== output ==
-* add gtkdoc-mk??? to generate docbook xml templates for binding docs
-* have c-comments there as comments
-* when updating, mark sections that have changed
+== binding docs ==
+* simmillar workflow to gettext
+* add gtkdoc-mk??? to generate binding doc templates
+  * have c-comments there as comments
+  * when updating templates, mark sections that have changed as fuzzy
+* add options to gtkdoc-mkdb to build docbook from those templates
+* questions
+  * could we use the tmpl file mechanism?
+  * directory structure?
+    * we need to list the languages like ALL_LINGUAS for translations
+    * we need to create subdirs for binding docs, ideally we use one for 'C' as well
+* devhelp
+  * devhelp files need a language attribute in the book-tag
+    language={C,C++,JavaScript,Perl,Python,...}
+  * devhelp could show a selector for the language
+  * need to get existing python/~mm docs to use it, gtk-doc could output
+    language=C for own docs 
 == installation ==
 * need to install each book with a prefix
 * would be good to have a language attribute in book tag to allow filter by language

Modified: trunk/gtkdoc-mktmpl.in
==============================================================================
--- trunk/gtkdoc-mktmpl.in	(original)
+++ trunk/gtkdoc-mktmpl.in	Thu Oct 16 19:52:19 2008
@@ -38,10 +38,10 @@
 #
 #		Any templates which are no longer used (i.e. they are remove
 #		from $MODULE-sections.txt) are placed in the file
-#		tmpl/$MODULE-unused.txt. If they are included again later
+#		tmpl/$MODULE-unused.sgml. If they are included again later
 #		they are automatically copied back into position.
 #		If you are certain that these templates will never be used
-#		again you can delete them from $MODULE-unused.txt.
+#		again you can delete them from tmpl/$MODULE-unused.sgml.
 #
 #		Any parameters to functions which are no longer used are
 #		separated from the rest of the parameters with the line