On 02/13/2018 01:18 PM, Matthew Wilcox wrote:
> On Tue, Feb 13, 2018 at 01:03:18PM -0800, Randy Dunlap wrote:
>> As long as the examples don't dictate style...
>> E.g., Matthew likes to use:
>>
>> +  * @gfp: Memory allocation flags.
>>
>> a. Capitalize the first word after @param:
>> b. end with a period (even though it's not a sentence)
>>
>> I disagree with both of those.
> 
> OK, so which do you think looks better:
> 
> https://www.kernel.org/doc/html/latest/core-api/idr.html#c.idr_get_cursor
> https://www.kernel.org/doc/html/latest/core-api/idr.html#c.idr_alloc_u32

I can't tell. I don't mind your way but I don't think it should be something
that is codified/enforced.

> (yes, I have failed to be consistent.  I shall apply appropriate amounts
> of self-flagellation and fix them shortly.)

TMI :)


-- 
~Randy
--
To unsubscribe from this list: send the line "unsubscribe linux-doc" in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Reply via email to