python-tldp TODO
================

user-visible needs
------------------

  * add a manpage

  * add support for .epub3 (or just .epub?)

  * add option --builddir (default to ${pubdir}/../ldp-builddir/

  * adjust the OutputDirectory to have output.builddir

  * separate the logic of --publish and --build in the generate()
    function

  * add option --publish (synonym to --build, but also rename into
    live output dir)

  * add support for asciidoc; instantiate a new instance of Docbook4XML 
    with a SourceDocument of the generated result of asciidoc --backend
    docbook
  
  * consider adding support for metadata extraction from documents


  * create TLDP DocBook 5.0 XSL files (if we care)

code internals
--------------

  * generate contrib/tldp.spec at build time (?)

  * figure out suppression of system configuration (testing borkage)

  * SourceDocument and OutputDirectory both have nearly-identical
    methods called detail() which define a format string; probably
    should be defined once in a parent class or something


CascadingConfig
---------------
  * consider replacing CascadingConfig with something (better?) from PyPI

  * factor out CascadingConfig into its own project

  * smart_bool for config handling; /usr/lib64/python2.7/ConfigParser.py
    around line 364ff.
    _boolean_states = {'1': True, 'yes': True, 'true': True, 'on': True,
                       '0': False, 'no': False, 'false': False, 'off': False}