Re: [sphinx-dev] Beginner's Guide?

2011-02-21 Thread TP
On Mon, Feb 21, 2011 at 8:08 AM, werner wrote: > On 21/02/2011 16:44, TP wrote: >> >> For one example of how to document a Python method see >> >> http://tpgit.github.com/MDIImageViewer/imageviewer.html#imageviewer.ImageViewer.scaleImage. >> Click on the [source] link on the right to see the actua

Re: [sphinx-dev] Beginner's Guide?

2011-02-21 Thread TP
On Fri, Feb 18, 2011 at 5:00 AM, Burhan wrote: > Hello: > >  I am new to Sphinx, and am going to use it for a python project to > generate HTML documentation.  My problem is rather basic, I'm not sure > how to format my docstrings so that Sphinx can extract the > information. > >  I understand abo

Re: [sphinx-dev] Beginner's Guide?

2011-02-21 Thread werner
On 21/02/2011 16:44, TP wrote: For one example of how to document a Python method see http://tpgit.github.com/MDIImageViewer/imageviewer.html#imageviewer.ImageViewer.scaleImage. Click on the [source] link on the right to see the actual Python method (along with its docstring that generated the d

[sphinx-dev] autodocumenting warning with 1.0.7

2011-02-21 Thread werner
Just upgraded to 1.0.7 and I get lots of these: source/headings.txt:4: (WARNING/2) don't know which module to import for autodocumenting u'__init__' (try placing a "module" or "currentmodule" directive in the document, or giving an explicit module name) My first 7 lines in headings.txt are: