Dirk Meyer wrote:
> Duncan Webb wrote:
>> -    @param bg_redraw : set background to original screen bg when finished
>> +    @cvar background: Surface Background (screen)
>> +    @cvar next_updat: timestamp for next update
> [...]
>> +        @ivar rectstyle : the rectangle defining the position on the screen 
>> (pygame)
> 
> I can't find the doc about cvar and ivar and the doc I see still uses
> param.

There are two pages, the second one is a bit tricky to find:

http://epydoc.sourceforge.net/epytext.html
http://epydoc.sourceforge.net/fields.html#fields

> 
>> -        """
>> -        Helper for creating surfaces
>> -        """
>> +        """ Helper for creating surfaces """
> 
> What is wrong with the extra linebreaks?

When the docstring is only one line then why not keeps the code 
succinct, when the docstring is over multiple lines then definitely the 
first.

BTW it looks line this:
https://www.linuxowl.com/apidocs/freevo-1/src.animation.base.BaseAnimation.html

Duncan

-------------------------------------------------------------------------
This SF.net email is sponsored by the 2008 JavaOne(SM) Conference 
Don't miss this year's exciting event. There's still time to save $100. 
Use priority code J8TL2D2. 
http://ad.doubleclick.net/clk;198757673;13503038;p?http://java.sun.com/javaone
_______________________________________________
Freevo-devel mailing list
Freevo-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/freevo-devel

Reply via email to