TODO

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

Bugs
----

  * when running --sourcedir $FILE, the error message is TERRIBLE;
    fix it;

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

  * add a manpage

  * add support for .epub3 (or just .epub?) [python-epub ?]

  * consider adding support for metadata extraction from documents

  * create TLDP customizations of DocBook 5.0 XSL (namespaced) files
    (if we wish to do so)

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

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

  * 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}