updating the stock and sample, commented config file

etc/ldptool.ini

@@ -54,65 +54,74 @@ loglevel = ERROR
 #    descriptions of the source and output documents by throwing the verbose
 #    flag
 #
-# verbose = False
+verbose = False
 
-# -- the four main actions, probably ought not to be set in the config file
+# -- These are the main actions and they are mutually exclusive.  Pick any
+#    of them that you would like:
 #
+# publish = False
+# build = False
+# script = False
 # detail = False
 # summary = False
-# script = False
-# build = False
+# doctypes = False
+# statustypes = False
+#
 
 # -- Each of the document types may require different executables and/or data
-#    files to support processing of a specific document type.  The below
+#    files to support processing of the specific document type.  The below
 #    configuration file section fragments allow each document type processor
 #    to keep its own configurables separate from other document processors.
 #
 # -- The ldptool code uses $PATH (from the environment) to locate the
 #    executables, by default.  If the utilities are not installed in the
 #    system path, then it is possible to configure the full path to each
-#    executable, here, in this system-wide configuration file.
+#    executable in your own configuration file or in a system-wide
+#    configuration file (/etc/ldptool/ldptool.ini).
 #
-# -- Also, the data files, for example, the DocBook DSSSL and DocBook XSL
-#    stylesheets may be in a location that ldptool cannot find.  If so, it
-#    will skip building any document type if it is lacking the appropriate
-#    data files.  It is possible to configure the full path to the data files
-#    here, in this system-wide configuration file.
+# -- If specific data files are not discoverable, e.g. the DocBook DSSSL and
+#    DocBook XSL stylesheets, the ldptool will skip processing that document
+#    type.
 #
 
+[ldptool-linuxdoc]
+# htmldoc = /usr/bin/htmldoc
+# html2text = /usr/bin/html2text
+# sgml2html = /usr/bin/sgml2html
+# sgmlcheck = /usr/bin/sgmlcheck
+
+[ldptool-docbooksgml]
+# collateindex = /home/mabrown/bin/collateindex.pl
+# dblatex = /usr/bin/dblatex
+# docbookdsl = /usr/share/sgml/docbook/dsssl-stylesheets/html/docbook.dsl
+# html2text = /usr/bin/html2text
+# jw = /usr/bin/jw
+# ldpdsl = /usr/share/sgml/docbook/stylesheet/dsssl/ldp/ldp.dsl
+# openjade = /usr/bin/openjade
+
 [ldptool-docbook4xml]
-# xslchunk = /usr/share/xml/docbook/stylesheet/ldp/html/tldp-sections.xsl
 # fop = /usr/bin/fop
 # dblatex = /usr/bin/dblatex
-# xsltproc = /usr/bin/xsltproc
 # html2text = /usr/bin/html2text
+# xsltproc = /usr/bin/xsltproc
+# xslchunk = /usr/share/xml/docbook/stylesheet/ldp/html/tldp-sections.xsl
 # xslprint = /usr/share/xml/docbook/stylesheet/ldp/fo/tldp-print.xsl
 # xslsingle = /usr/share/xml/docbook/stylesheet/ldp/html/tldp-one-page.xsl
 
-[ldptool-linuxdoc]
-# sgml2html = /usr/bin/sgml2html
-# htmldoc = /usr/bin/htmldoc
-# html2text = /usr/bin/html2text
-
-[ldptool-docbooksgml]
-# ldpdsl = /usr/share/sgml/docbook/stylesheet/dsssl/ldp/ldp.dsl
-# jw = /usr/bin/jw
-# dblatex = /usr/bin/dblatex
-# html2text = /usr/bin/html2text
-# collateindex = /home/mabrown/bin/collateindex.pl
-# docbookdsl = /usr/share/sgml/docbook/dsssl-stylesheets/html/docbook.dsl
-# openjade = /usr/bin/openjade
-
 [ldptool-docbook5xml]
-# xsltproc = /usr/bin/xsltproc
 # dblatex = /usr/bin/dblatex
-# xslprint = /usr/share/xml/docbook/stylesheet/docbook-xsl-ns/fo/docbook.xsl
-# xmllint = /usr/bin/xmllint
-# xslsingle = /usr/share/xml/docbook/stylesheet/docbook-xsl-ns/html/docbook.xsl
-# xslchunk = /usr/share/xml/docbook/stylesheet/docbook-xsl-ns/html/chunk.xsl
-# rngfile = /usr/share/xml/docbook/schema/rng/5.0/docbook.rng
 # fop = /usr/bin/fop
 # jing = /usr/bin/jing
 # html2text = /usr/bin/html2text
+# rngfile = /usr/share/xml/docbook/schema/rng/5.0/docbook.rng
+# xmllint = /usr/bin/xmllint
+# xslchunk = /usr/share/xml/docbook/stylesheet/docbook-xsl-ns/html/chunk.xsl
+# xslprint = /usr/share/xml/docbook/stylesheet/docbook-xsl-ns/fo/docbook.xsl
+# xslsingle = /usr/share/xml/docbook/stylesheet/docbook-xsl-ns/html/docbook.xsl
+# xsltproc = /usr/bin/xsltproc
+
+[ldptool-asciidoc]
+# asciidoc = /usr/bin/asciidoc
+# xmllint = /usr/bin/xmllint
 
 # -- end of file