Re: Re: Documentation for SVN extension
| From: | Jakub Vrana | Date: | Wed, 04 Apr 2007 08:32:08 +0000 |
| Subject: | Re: Re: Documentation for SVN extension | ||
| References: | 1 2 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969375989@lists.php.net to get a copy of this message | ||
Edward Z. Yang wrote:
> Version 2 attached. No new documentation, but skeleton files for the
> rest of the functions and all fixes (except for the entity-ization of
> the URLs) have been put into effect. With a little processing that
> removes the parameter segments of the undocumented functions, this could
> be committed (as per "Release Early, Release Often").
Instructions for documentors ("Its description", "What the function
returns") should be at least removed, better replaced with real
documentation.
Several return types are wrong (even in the source protos). But don't
worry about it, I'll fix that after commit with my tool.
It's not necessary to duplicate refpurpose to para after
methodsynopsis. It's better to shorten refpurpose and prolong this
para where possible (e.g. svn_diff).
Jakub Vrana