Re: sphinx (or other means to document python)

2016-10-24 Thread Dan Stromberg
On Sat, Sep 24, 2016 at 6:30 PM, Yann Kaiser wrote: > 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 whic

Re: sphinx (or other means to document python)

2016-09-26 Thread jmp
On 09/25/2016 03:20 AM, 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 a

Re: sphinx (or other means to document python)

2016-09-24 Thread Yann Kaiser
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 mod

Re: sphinx (or other means to document python)

2016-09-24 Thread chitturk
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 f

sphinx (or other means to document python)

2016-09-11 Thread chitturk
Excuse me for being frustrated (!) (with documenting python with Sphinx) I have a source file myfile.py which contains documentation with "docstrings" I am trying to have Sphinx create the pdf (from latex) I have run through sphinx-quickstart - which creates build, source (there is some conf.py