Re: [pygame] Experimental, Classic Look, sphinx generated XHTML docs for Pygame 1.9.2a

[Lenard Lindstrom <len-l@xxxxxxxxx>]

Hello,

On 22/03/11 08:33 PM, Ian Mallett wrote:
> Hi,
>
> From a VERY quick pass:
> -In pygame.draw.aalines, the function is listed incorrectly as 
> "pygame.draw.pygame.draw.aalines".
This was caused by a missing line the Pygame .doc file.

> -Maybe nicer formatting for pygame.key?
The <pre /> block style wasn't set to a monospace font.

> -pygame.font.Font.metrics; typo on this line, should be "passed"
> -Typo: "Module" in pygame.math
> -pygame.surfarray.use_arraytype, probably should specify that the 
> argument is a string
Good to know. These will be corrected in the Pygame .doc files.

> On Chrome 10.0.648.151:
> -In many places, where there's plenty of space, the last word in a 
> line is wrapped around to a new line; e.g., "applications" in 
> pygame.event.set_grab, "fonts" in pygame.fonts.SysFont, "library" in 
> pygame.freetype.quit, "file." in pygame.freetype.Font, etc.
reST requires definite column widths. The algorithm for calculating them 
was a little too clever. Also I didn't allow for the em-dash in the 
right column.

> -Displays HTML instead of a link in pygame.movie (confirmed on Firefox 
> 3.6.15).
> -Weird blocks in the pygame, pygame.sprite module (confirmed on 
> Firefox).  Are these intentional?
Some fixes will have to be done in reST should the document sources be 
moved to reST.

Lenard