Happydoc is for python stuff. I fully agree with that.
However, this is not rare (at least in my case) that I
have other directories and files in my tree that do not
contain any trace of python code, but for which I'd
like to see something in the generated documentation.
I wish for instance that my data/ directory could show
up with a nice "Data files used by foo.py <b>please
check before using</b>".
2 suggestions :
. allow a flag to handle ANY README.txt in any
directory. Not only in directories where there is some
. allow (basic) handling of StructuredText found in
non-python things : script file, etc ... maybe by
focusing the parsing in the top header comments. I do
NOT ask for a separate perl/C/whatever parser in
happydoc. But maybe handling of a single line :
# Startup script, see **Borland** web site
if [ .....