[gtk-doc] fixxref, mkhtml2: more planning

[Stefan Sauer <stefkost src gnome org>]

commit 0663ebe05bafa73075d906204e7e0cc3baccd097
Author: Stefan Sauer <ensonic users sf net>
Date:   Tue Feb 27 22:42:04 2018 +0100

    fixxref, mkhtml2: more planning

 gtkdoc/fixxref.py |    4 ++++
 gtkdoc/mkhtml2.py |    3 ++-
 2 files changed, 6 insertions(+), 1 deletions(-)
---
diff --git a/gtkdoc/fixxref.py b/gtkdoc/fixxref.py
index b2956c2..4f76fa6 100755
--- a/gtkdoc/fixxref.py
+++ b/gtkdoc/fixxref.py
@@ -62,6 +62,10 @@ def Run(options):
     FixCrossReferences(options.module_dir, options.module, options.src_lang)
 
 
+# TODO(ensonic): try to refactor so that we get a list of path's and then just
+# loop over them.
+# - module_dir is by default 'html'
+# - html_dir can be set by configure, but is usually empty
 def LoadIndicies(module_dir, html_dir, extra_dirs):
     # Cache of dirs we already scanned for index files
     dir_cache = {}
diff --git a/gtkdoc/mkhtml2.py b/gtkdoc/mkhtml2.py
index bd96694..fdab883 100644
--- a/gtkdoc/mkhtml2.py
+++ b/gtkdoc/mkhtml2.py
@@ -37,7 +37,8 @@ TODO: convert the docbook-xml to html
   - maybe handle the combination <informalexample><programlisting> directly
   - switch to http://pygments.org/docs/quickstart/?
 - integrate MakeXRef from fixxref
-  - first create devhelp2 output
+  - as a step, we could run FixHTMLFile() on each output file
+- create devhelp2 output
 
 OPTIONAL:
 - minify html: https://pypi.python.org/pypi/htmlmin/