Re: [libvirt] [PATCH] docs: remove "returns" word from beginning of lines
On Fri, Apr 08, 2011 at 04:31:38PM -0600, Eric Blake wrote:
On 04/07/2011 02:47 AM, Jean-Baptiste Rouault wrote:
> Move "returns" keyword from beginning of API doc lines
> when it does not describe return values.
ACK, and pushed.
> Maybe the API doc extractor could be changed to look for
> "returns: " to avoid such confusion.
Probably, but I'm no python wizard, so I'm not writing that patch.
Anyone else want to help?
I looked at it upon receiving the patch, it's trivial from a python
puoint of view, the problem is that we then need to change all function
descriptions to use "Returns:" instead of "Returns" and I'm not
sure
it's really teh right thing to do,
Daniel
--
Daniel Veillard | libxml Gnome XML XSLT toolkit http://xmlsoft.org/
daniel(a)veillard.com | Rpmfind RPM search engine http://rpmfind.net/
http://veillard.com/ | virtualization library http://libvirt.org/