[gtk-doc] maintenance: more todos and fix doc comment

[Stefan Kost <stefkost src gnome org>]

commit de446ea1a430f79e0ba9ed374860d12f638ebc06
Author: Stefan Kost <ensonic users sf net>
Date:   Mon Sep 28 17:58:49 2009 +0300

    maintenance: more todos and fix doc comment

 TODO           |    7 +++++++
 gtkdoc-mkdb.in |    7 ++++---
 2 files changed, 11 insertions(+), 3 deletions(-)
---
diff --git a/TODO b/TODO
index 7dc9979..c160688 100644
--- a/TODO
+++ b/TODO
@@ -135,6 +135,13 @@ diff -u --exclude="Makefile*" docs docs-tmpl | diffstat
   - 'dummy-docs' check if symbol docs are very short and repeat mainly words
     from the symbol.
 
+= Markup =
+* protected scope
+  * we can have /* < protected > */ in classes
+  * we can have <SUBSECTION Protected> in -section.txt
+  * ideally we have Scope: {Public, Protected, Private} supported in doc comments
+  * there is a bg for gir, https://bugzilla.gnome.org/show_bug.cgi?id=594125
+
 = GIR =
 == scanning ==
 * ideas
diff --git a/gtkdoc-mkdb.in b/gtkdoc-mkdb.in
index 41c4082..f300a6c 100755
--- a/gtkdoc-mkdb.in
+++ b/gtkdoc-mkdb.in
@@ -958,9 +958,10 @@ sub OutputSinceIndexes {
 }
 
 #############################################################################
-# Function    : OutputSinceIndexes
-# Description : This writes the 'since' api indexlists that can be included into
-#               the main document into an <index> tag.
+# Function    : OutputAnnotationGlossary
+# Description : This writes a glossary of the used annotation terms into a
+#               separate glossary file that can be included into the main
+#               document.
 #############################################################################
 
 sub OutputAnnotationGlossary {