Re: [Python-Dev] Sphinx version for Python 2.x docs

2011-08-16 Thread Nick Coghlan
On Wed, Aug 17, 2011 at 12:08 PM, Chris Withers wrote: > On 16/08/2011 16:05, Sandro Tosi wrote: >> I think what's needed first is to run a pilot: take the current 2.7 >> doc, > > Where does that live? > Where are the instructions for building the docs? (dependencies needed, etc) 'make html' in t

Re: [Python-Dev] Sphinx version for Python 2.x docs

2011-08-16 Thread Chris Withers
On 16/08/2011 16:05, Sandro Tosi wrote: Hello Chris, On Wed, Aug 17, 2011 at 00:58, Chris Withers wrote: Hi All, Any chance the version of sphinx used to generate the docs on docs.python.org could be updated? I think what's needed first is to run a pilot: take the current 2.7 doc, Where d

Re: [Python-Dev] Sphinx version for Python 2.x docs

2011-08-16 Thread Sandro Tosi
Hello Chris, On Wed, Aug 17, 2011 at 00:58, Chris Withers wrote: > Hi All, > > Any chance the version of sphinx used to generate the docs on > docs.python.org could be updated? I think what's needed first is to run a pilot: take the current 2.7 doc, update sphinx and look at what breaks, and eva

[Python-Dev] Sphinx version for Python 2.x docs

2011-08-16 Thread Chris Withers
Hi All, Any chance the version of sphinx used to generate the docs on docs.python.org could be updated? I'd love to take advantage of the "new format" intersphinx mapping: http://sphinx.pocoo.org/ext/intersphinx.html#confval-intersphinx_mapping ...but since it looks like docs.python.org uses

Re: [Python-Dev] [Python-checkins] peps: Add Alexandre's suggestions

2011-08-16 Thread Nick Coghlan
On Tue, Aug 16, 2011 at 9:23 PM, Antoine Pitrou wrote: > On Tue, 16 Aug 2011 20:15:51 +1000 > Nick Coghlan wrote: >> > >> > Oops, I admit I hadn't read PEP 395. >> > PEP 395 focuses on module aliasing, while the suggestion above focuses >> > on the path of objects in modules. How can we reconcile

Re: [Python-Dev] peps: Add Alexandre's suggestions

2011-08-16 Thread Antoine Pitrou
On Tue, 16 Aug 2011 20:15:51 +1000 Nick Coghlan wrote: > > > > Oops, I admit I hadn't read PEP 395. > > PEP 395 focuses on module aliasing, while the suggestion above focuses > > on the path of objects in modules. How can we reconcile the two? Do we > > want __qualname__ to be a relative "path" in

Re: [Python-Dev] [Python-checkins] peps: Add Alexandre's suggestions

2011-08-16 Thread Nick Coghlan
On Tue, Aug 16, 2011 at 7:25 PM, Antoine Pitrou wrote: > On Tue, 16 Aug 2011 12:35:48 +1000 > Nick Coghlan wrote: >> On Tue, Aug 16, 2011 at 11:30 AM, antoine.pitrou >> wrote: >> > +Serializing "pseudo-global" objects >> > +--- >> > + >> > +Objects which are not m

Re: [Python-Dev] [Python-checkins] peps: Add Alexandre's suggestions

2011-08-16 Thread Antoine Pitrou
On Tue, 16 Aug 2011 12:35:48 +1000 Nick Coghlan wrote: > On Tue, Aug 16, 2011 at 11:30 AM, antoine.pitrou > wrote: > > +Serializing "pseudo-global" objects > > +--- > > + > > +Objects which are not module-global, but should be treated in a similar > > +fashion -- s