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

[René Dudfield <renesd@xxxxxxxxx>]

Hi again,

An anchor, rather than an id is probably needed for the urls anyway.
I can use that to place the comments... if that's easier than adding
an id.  eg, from the current html... <a
name="pygame.mixer.music.pause">


On Wed, Mar 23, 2011 at 11:16 AM, René Dudfield <renesd@xxxxxxxxx> wrote:
>
> Nice one!
>
> I haven't looked at them yet... but there's two other things we need to check.
>
> - urls
>     - if the urls are different, we will need to make a map from the current urls to the new urls.
>         - eg, http://www.pygame.org/docs/ref/music.html#pygame.mixer.music.load
>         - it would be best if they were the same urls of course, but if it's too hard then we can make a mapping.
>
> - comments.
>     - I'll need to change the code on the server which inserts the comment block (and the search google code button).
>     - if there is an id like "pygame.mixer.music.load" on each block, so I can easily add in the comment blocks into the relevant place inside the html.
>
>
> cya.
>
>
>
> On Wed, Mar 23, 2011 at 5:36 AM, Lenard Lindstrom <len-l@xxxxxxxxx> wrote:
>>
>> 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
>>
>