Index: TODO
===================================================================
diff -u -rc4495e631e7b9ecd9defb279d903233dd44abdd0 -r984a062f8f5693e249ef6fd36c863db2af6693a9
--- TODO	(.../TODO)	(revision c4495e631e7b9ecd9defb279d903233dd44abdd0)
+++ TODO	(.../TODO)	(revision 984a062f8f5693e249ef6fd36c863db2af6693a9)
@@ -2390,8 +2390,17 @@
 sudo make install
 ====================
 
+- doc:
+   * This package contains 12 classes.... 3 objects .... 
+     Why are all these marked with "mismatch"?
+   * (optional) protected method elimination in leftbar
+   * heading "Glossary" missing. 
+     It ist not clear, what the list of items is, when one sees index.html
+   * make quality checks (missing documentation, ...) optional?
+     how to deal with non-resolvable quality checks?
+   * provide a renderer for XOTcl @-notation to produce object structure
+     for the new doctool (makes the old documentation usabel, eg. for XOTcl2)
 
-
 TODO:
 
 - serializer: check, why catch is needed for object-level alias 
@@ -2416,26 +2425,27 @@
    TODO: don't check hard coded method name 
 
 - doc:
+    * integrate ::nx::doc::make with Makefile.in
+      (provide shell calls and, targets and dependencies)
+
    NextScriptingLanguage/index.html: 
 
-    * heading "Glossary" missing. 
-      It ist not clear, what the list of items is, when one sees index.html
-
     * A short introductory text, what the "package"
       is whould be more well suited for the index page,
       moving glossary (index) to the left column.
       ..... Better to use "package_nx.html" as index.html
+      SS: I find that the glossary entries fit there because they
+      spawn the necessary vocabulary throughout the doc project.
 
     * glossary entries in nsf.nxd should be sorted (in the source)
      ...... Maybe, a single glossary.nxd file?
+     SS: Right now, the name of the nxd file derives from the the
+     script name. I mark this as TODO for the future.
 
     * provide a different flag for the generation of the documentation
       (-develop, .... or -final) to show/hide it.
+      SS: By "it", you refer to the glossary?
 
-   * This package contains 12 classes.... 3 objects .... 
-     Why are all these marked with "mismatch"?
-
-   * (optional) protected method elimination in leftbar
    * separate entries for methods and hooks (can't be called if not defined)?
     hooks: 
       * recreate should only be called internally, similarly "init" etc.
@@ -2500,21 +2510,6 @@
         }
       }
 
-- documentation
-   - documentationssytem
-   - langref (xotcl 2.0 + next-scripting)
-   - tutorial (split)
-   - migration guide
-
-   doctools
-   - integrate ::nx::doc::make with Makefile.in
-     (provide shell calls and, targets and dependencies)
-   - make quality checks (missing documentation, ...) optional?
-     how to deal with non-resolvable quality checks?
-   - provide a renderer for XOTcl @-notation to produce object structure
-     for the new doctool (makes the old documentation usabel, eg. for XOTcl2)
-
-
 - library + apps
     - new directory structure DONE
     - work on binary packages of xotcl (store + xml)
@@ -2566,9 +2561,6 @@
 #endif
 
 
-
-
-
 For future releases:
 
    * consider alternate method name/place for subcmds (and/or slots) on classes