Re: [Python-Dev] [Doc-SIG] The docs, reloaded

2007-05-19 Thread Lea Wiemann
Georg Brandl wrote: > over the last few weeks I've hacked on a new approach to Python's > documentation. > As Python already has an excellent documentation framework, the docutils, > with a > readable yet extendable markup format, reST, I thought that it should be > possible to use those instead

Re: [Python-Dev] [Doc-SIG] The docs, reloaded

2007-05-20 Thread Lea Wiemann
[Georg Brandl] > The highlighting is actually done with Pygments, which cannot be > included in the stdlib as-is. Perhaps a stripped-down version? No need to; we can just fall back to no syntax highlighting if Pygments is not installed on the user's system. [Gael Varoquaux] >> - The html synt

Re: [Python-Dev] [Doc-SIG] The docs, reloaded

2007-05-20 Thread Lea Wiemann
Martin Blais wrote: > e.g. are you still marking classes as classes > and functions as functions in the ReST source It seems so (modulo XXX's and TODO's in Georg's implementation, probably ^_^) -- all of the pages have "show source" links, so you can see for yourself. I'm not an expert with the