[sphinx-dev] Re: autodoc: how are dependencies determined?

2009-09-09 Thread Pat LeSmithe
Georg Brandl wrote: > Pat LeSmithe schrieb: >> By the way, is possible somehow to take advantage of multiple cores >> during the reading phase? > > That could be tricky. For that kind of parallel processing, I assume > that multiprocessing would be the way to go since parsing reST isn't > very I

[sphinx-dev] inheritance_graph_attrs

2009-09-09 Thread Christopher Burns
I'd like to flip my inheritance diagrams so they flow vertically instead of horizontally. I tried setting the inheritance_graph_attrs in my conf.py but it does not appear to effect anything. Am I doing something wrong, I've tried the following different settings (independently): inheritance_gra

[sphinx-dev] automodule and the toctree

2009-09-09 Thread jhayes
Is there any way to get module members that are found when using automodule to show up in a toctree in an automatic way? Thanks! - Jason --~--~-~--~~~---~--~~ You received this message because you are subscribed to the Google Groups "sphinx-dev" group. To post to

[sphinx-dev] Re: documenting the return types of functions and methods

2009-09-09 Thread Patrick Vergain
Hello, On Wed, Sep 9, 2009 at 4:42 PM, Chris Withers wrote: > > Georg Brandl wrote: > > For Python methods, neither return nor parameter types are supported in > > a special way. (This will change; I intend to allow 3k-style annotations > > at some point which could be used for type info.) >

[sphinx-dev] Re: documenting the return types of functions and methods

2009-09-09 Thread Chris Withers
Georg Brandl wrote: > For Python methods, neither return nor parameter types are supported in > a special way. (This will change; I intend to allow 3k-style annotations > at some point which could be used for type info.) > > One convention, other than simply putting it into the prose, is to put

[sphinx-dev] Re: documenting the return types of functions and methods

2009-09-09 Thread Georg Brandl
Chris Withers schrieb: > Hi All, > > In Sphinx docs, how would I go about documenting the return type of a > function or method? > > Specifically, if a method returns an instance of a class, how can I link > to that class's documentation in the documentation for the return type > of the metho

[sphinx-dev] documenting the return types of functions and methods

2009-09-09 Thread Chris Withers
Hi All, In Sphinx docs, how would I go about documenting the return type of a function or method? Specifically, if a method returns an instance of a class, how can I link to that class's documentation in the documentation for the return type of the method? cheers, Chris -- Simplistix - Co

[sphinx-dev] Re: A book typeset using sphinx and rst2pdf

2009-09-09 Thread Roberto Alsina
On Wednesday 09 September 2009 03:36:55 Guenter Milde wrote: > On 2009-09-08, Roberto Alsina wrote: > > On Tuesday 08 September 2009 05:04:20 Gael Varoquaux wrote: > >> On Mon, Sep 07, 2009 at 06:01:31PM -0300, Roberto Alsina wrote: > >> > On Monday 07 September 2009 15:53:41 Santiago Suarez OrdoƱ

[sphinx-dev] uses for setup.cfg and extracting data from it

2009-09-09 Thread Chris Withers
Hi All, Do people generally source control their package's setup.cfg? http://docs.python.org/distutils/configfile.html sort of implies it should be editable by the person installing the package, but I've never personally used a package where that's the case... Assuming the distutils docs are

[sphinx-dev] Re: Hosting Sphinx-generated manual

2009-09-09 Thread Georg Brandl
Gael Varoquaux schrieb: > On Wed, Sep 09, 2009 at 09:45:49AM +0100, Chris Withers wrote: > >> Gael Varoquaux wrote: >> > The one thing I find I miss from PyPI, is the ability to upload a >> > sphinx-generated set of HTML pages for the documentation. > >> But PyPI *has* this feature ;-) > > I s

[sphinx-dev] Re: Hosting Sphinx-generated manual

2009-09-09 Thread Gael Varoquaux
On Wed, Sep 09, 2009 at 09:45:49AM +0100, Chris Withers wrote: > Gael Varoquaux wrote: > > The one thing I find I miss from PyPI, is the ability to upload a > > sphinx-generated set of HTML pages for the documentation. > But PyPI *has* this feature ;-) I sort of hoped it had. This is why I was

[sphinx-dev] Re: Hosting Sphinx-generated manual

2009-09-09 Thread Chris Withers
Gael Varoquaux wrote: > The one thing I find I miss from PyPI, is the ability to upload a > sphinx-generated set of HTML pages for the documentation. But PyPI *has* this feature ;-) Log in and go to a package you own, right down the bottom is a little set of controls to allow you to upload a .

[sphinx-dev] Hosting Sphinx-generated manual

2009-09-09 Thread Gael Varoquaux
Hi list, This is not a purely Sphinx-related question, but I though people here might have an opinion... Over the time, I have settle down to doing project management as light as I can. It's down to distributed version code for the source code, and PyPI for distribution. I could use more fancy s