[Author Prev][Author Next][Thread Prev][Thread Next][Author Index][Thread Index]

Re: [pygame] pygame documentation



On Fri, 21 May 2004, Jasper Phillips wrote:

>
>On Thu, 20 May 2004, Pete Shinners wrote:
>
>> enrike wrote:
>> > opensource style of documentation and he was asking all the time for an
>> > API documentation like the one with pyOpenGL for example.
>>
>> What part of the pyopengl documentation do you mean? I see a long list
>> of all functions and each function has a list of the arguments needed
>> and a paragraph or two on documentation.
>
>Overall I find the pygame docs much more succinct, although the pyopengl
>docs are more comprehensive.  The main thing the pyopengl docs have that
>pygame docs don't are links to examples using the methods in question.  This
>is very nice, e.g.
>
>http://pyopengl.sourceforge.net/documentation/manual/glTexImage2D.3G.xml
>
>One particular pygame doc pet peeve!  Where are the args to
>Surface.__init__() described, and why isn't it here?:

I create surfaces using pygame.Surface(), and the flags are documented
just fine there:

	http://pygame.org/docs/ref/pygame.html#Surface

-- 
You've got a lot of time for abstract thought when you've got your hand
    stuck up a dead badger.
                                 -- Terry Pratchett, Johnny and the Bomb