[PATCH 0 of 1 STABLE] keyword: correct grammar in iskwfile docstring

Matt Mackall mpm at selenic.com
Thu Oct 20 12:40:03 CDT 2011


On Thu, 2011-10-20 at 12:02 +0100, Christian Ebert wrote:
> Hi,
> 
> The convention for the first line of function docstrings seems to
> be:
> 
> '''return subset of candidates which are configured for keyword
> expansion but are not symbolic links'''
> 
> (all lowercase, no full stop at the end)
> 
> instead of:
> 
> '''Returns subset of candidates which are configured for keyword
> expansion but are not symbolic links.'''
> 
> While to my taste this is a bit exaggerating the lowercasing
> obsession ;-) I'm fine with adapting the docstrings in the
> extension to the general style/taste. Should I go ahead with it?

I don't care, and I'd rather wait till after the release.

-- 
Mathematics is the supreme nostalgia of our time.




More information about the Mercurial-devel mailing list