[gtk-doc] gtkdoc: log commandline options



commit dca4402db521bfc10f6f0d1a2c002be3ae4cecf4
Author: Stefan Sauer <ensonic users sf net>
Date:   Fri Mar 2 08:06:41 2018 +0100

    gtkdoc: log commandline options
    
    This will help to understand what flags are actually used.

 gtkdoc/fixxref.py  |    2 ++
 gtkdoc/mkdb.py     |    2 ++
 gtkdoc/mkhtml.py   |    2 ++
 gtkdoc/mkhtml2.py  |   12 +++++++-----
 gtkdoc/mkman.py    |    2 ++
 gtkdoc/mkpdf.py    |    2 ++
 gtkdoc/scan.py     |    2 +-
 gtkdoc/scangobj.py |    2 ++
 8 files changed, 20 insertions(+), 6 deletions(-)
---
diff --git a/gtkdoc/fixxref.py b/gtkdoc/fixxref.py
index 4f76fa6..e8f8687 100755
--- a/gtkdoc/fixxref.py
+++ b/gtkdoc/fixxref.py
@@ -57,6 +57,8 @@ NoLinks = {
 
 
 def Run(options):
+    logging.info('options: %s', str(options.__dict__))
+
     LoadIndicies(options.module_dir, options.html_dir, options.extra_dir)
     ReadSections(options.module)
     FixCrossReferences(options.module_dir, options.module, options.src_lang)
diff --git a/gtkdoc/mkdb.py b/gtkdoc/mkdb.py
index 0abdb31..62e790c 100644
--- a/gtkdoc/mkdb.py
+++ b/gtkdoc/mkdb.py
@@ -235,6 +235,8 @@ def Run(options):
     global MODULE, INLINE_MARKUP_MODE, DEFAULT_STABILITY, NAME_SPACE, \
         DB_OUTPUT_DIR, doctype_header
 
+    logging.info('options: %s', str(options.__dict__))
+
     # We should pass the options variable around instead of this global variable horror
     # but too much of the code expects these to be around. Fix this once the transition is done.
     MODULE = options.module
diff --git a/gtkdoc/mkhtml.py b/gtkdoc/mkhtml.py
index ca84f79..ef02382 100644
--- a/gtkdoc/mkhtml.py
+++ b/gtkdoc/mkhtml.py
@@ -49,6 +49,8 @@ def run_xsltproc(options, args):
 
 
 def run(options):
+    logging.info('options: %s', str(options.__dict__))
+
     module = options.args[0]
     document = options.args[1]
     if options.verbose:
diff --git a/gtkdoc/mkhtml2.py b/gtkdoc/mkhtml2.py
index c189479..7699812 100644
--- a/gtkdoc/mkhtml2.py
+++ b/gtkdoc/mkhtml2.py
@@ -29,15 +29,16 @@ In contrast to our previous approach of running gtkdoc-mkhtml + gtkdoc-fixxref,
 this tools will replace both without relying on external tools such as xsltproc
 and source-highlight.
 
-TODO: convert the docbook-xml to html
+TODO:
 - more chunk converters
 - check each docbook tag if it can contain #PCDATA, if not don't check for
   xml.text
-- integrate syntax-highlighing from fixxref
-  - maybe handle the combination <informalexample><programlisting> directly
-  - switch to http://pygments.org/docs/quickstart/?
-- integrate MakeXRef from fixxref
+- integrate fixxref:
   - as a step, we could run FixHTMLFile() on each output file
+  - integrate syntax-highlighing from fixxref
+    - maybe handle the combination <informalexample><programlisting> directly
+    - switch to http://pygments.org/docs/quickstart/?
+  - integrate MakeXRef from fixxref
 - create devhelp2 output
 
 OPTIONAL:
@@ -885,5 +886,6 @@ def main(index_file):
 
 
 def run(options):
+    logging.info('options: %s', str(options.__dict__))
     document = options.args[0]
     sys.exit(main(document))
diff --git a/gtkdoc/mkman.py b/gtkdoc/mkman.py
index 515b37f..cc4deb3 100644
--- a/gtkdoc/mkman.py
+++ b/gtkdoc/mkman.py
@@ -27,6 +27,8 @@ from . import config
 
 
 def run(options):
+    logging.info('options: %s', str(options.__dict__))
+
     module = options.args[0]
     document = options.args[1]
     if options.verbose:
diff --git a/gtkdoc/mkpdf.py b/gtkdoc/mkpdf.py
index 75cf926..3e2099b 100755
--- a/gtkdoc/mkpdf.py
+++ b/gtkdoc/mkpdf.py
@@ -45,6 +45,8 @@ def run_xsltproc(options, args):
 
 
 def run(options):
+    logging.info('options: %s', str(options.__dict__))
+
     module = options.args[0]
     document = options.args[1]
 
diff --git a/gtkdoc/scan.py b/gtkdoc/scan.py
index 3e9c691..c1fe4d8 100644
--- a/gtkdoc/scan.py
+++ b/gtkdoc/scan.py
@@ -49,7 +49,7 @@ seen_headers = {}
 
 
 def Run(options):
-    # logging.basicConfig(level=logging.INFO)
+    logging.info('options: %s', str(options.__dict__))
 
     if not os.path.isdir(options.output_dir):
         os.mkdir(options.output_dir)
diff --git a/gtkdoc/scangobj.py b/gtkdoc/scangobj.py
index 1560764..4ad2717 100644
--- a/gtkdoc/scangobj.py
+++ b/gtkdoc/scangobj.py
@@ -1203,6 +1203,8 @@ def execute_command(options, description, command):
 
 
 def run(options):
+    logging.info('options: %s', str(options.__dict__))
+
     c_file = options.module + '-scan.c'
     output = common.open_text(c_file, 'w')
 


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]