Mailman 3 November 2006 - Doc-SIG

beginner: the missing .cls
by pipehappy Dec. 1, 2006

Dec. 1, 2006

Hi everyone I have read the document 'documenting python' but am still confused. I know LaTex, the mark described in the document and the required tool. But when I just try to feed the doc.tex to LaTex, it tells me missing 'howto.cls'. And there are five or six men at Python.org to convert the collected plain text into tex format. So I guess the source tarball doesn't provide whole story. Can some one tell me where I can find the missing file? Thanks very much! Yue

2 1

ANN: the pyfaq wiki has moved; pyfaq 1.0b1 is available
by Fredrik Lundh Nov. 15, 2006

Nov. 15, 2006

(portions of this was posted to c.l.py a while ago) Back in April, I posted a copy of the Python FAQ over at infogami.com, to collect comments and new FAQ entries for python.org. Since infogami.com development has ceased, and the server's been hit by spam lately, I've decided to move the material over to a hopefully more reliable site: http://effbot.org/pyfaq/ This move was completed just over two weeks ago. After the move, I've gotten tons of useful comments from the Python community, and incorporated more than 60 comments into the articles. Several new articles have also been added, and more are on their way. For the adventurous, there's also a pre-processed distribution archive available: http://effbot.org/pyfaq.xml which contains all pages from the FAQ as XHTML fragments. The format is described here: http://effbot.org/zone/pyzone-archive.htm </F>

1 0

code-block directive
by Gael Varoquaux Nov. 13, 2006

Nov. 13, 2006

Hello, I have added python-code syntax-highlighting. This feature has been hand coded in extensions like the trac extension, or in rest2web. This leads to variants of rest that are not compatible with docutils. I have thus added a crude version of syntax-highlighting. The new directive follows the trac directive: .. code-block:: python I have not coded support for other language than python, and the directive default to a literal block if the language isn't python. For the latex2e writer, where I was able to use the listings package, and thus get free support for other languages. For the newlatex2e it is impossible to use the listings package, as the code cannot be passed as macro arguments (see section 5.1 of the listings manual). This is a first draft and is probably of a lower quality then other directive. I would like to push for inclusion of this new directive even if it doesn't support all the features it could to regain language compatibility with trac. Comments on the patch are welcome. Regards, Gaël

1 0