Re: [Docutils-users] creating documentation of a python programm

[David G. <go...@us...>]

Arash Shahi wrote:
> is it possible to create a dokumentation( HTML, XML, ... ) of a
> python programm? I can't find any thing about it in the readme.

Sorry, this hasn't been implemented yet.  It is currently under
development.  There has been some work (see
http://docutils.sf.net/sandbox/tibs/pysource/), but it's probably out
of date.  I'm looking at the pysource code as well as at HappyDoc
(http://happydoc.sf.net/) for inspiration.  It's the next major task
on my list.  If you'd like to help, you'd be very welcome!

I will make a note in the README.

> I don't want all of my surcecode including in the documentation, and
> that's what happens when I create a html-file with buildhtml.py .

The buildhtml.py front end is not intended for use with .py files, and
it shouldn't read them.

-- 
David Goodger  <go...@us...>  Open-source projects:
  - Python Docutils: http://docutils.sourceforge.net/
    (includes reStructuredText: http://docutils.sf.net/rst.html)
  - The Go Tools Project: http://gotools.sourceforge.net/