pydoctor may be something you're looking for. I don't know if it supports exporting to PDF like Sphinx does.
As you've no doubt figured out by now, Sphinx doesn't revolve around the Python files themselves, but rather .rst files in which you can indeed instruct Sphinx to just go and document a module. On Sun, Sep 25, 2016, 02:26 <chitt...@uah.edu> wrote: > On Sunday, September 11, 2016 at 3:56:36 PM UTC-5, chit...@uah.edu wrote: > (about being frustrated with sphinx) > > I _remain_ frustrated - even as I finally figured out how to use it > (thanks to a complete example from a friend) > > sphinx is very picky about spaces, lines - I had a line with some math > formula spaces and tabs (after r''' - and sphinx kept ignoring that line > > when it works, the documentation (my preference is LaTeX) is great - the > procedure for embedding the documentation as doctrings can be difficult, at > times > > noweb is considerably simpler - but does not allow for the extraction > of docstrings/comments - and does provide for a fairly painless way to > combine comments, documentation along with code > -- > https://mail.python.org/mailman/listinfo/python-list > -- Yann Kaiser kaiser.y...@gmail.com yann.kai...@efrei.net +33 6 51 64 01 89 https://github.com/epsy -- https://mail.python.org/mailman/listinfo/python-list
