Re: [PATCH v2 2/6] string_list: add two new functions for splitting strings

From: Junio C Hamano <gitster@pobox.com>
Date: Sep 12, 2012, 17:55 UTC
Message-ID: <7vtxv3ceia.fsf@alter.siamese.dyndns.org>
In-Reply-To: <50508A44.1020008@alum.mit.edu>

Michael Haggerty <mhagger@alum.mit.edu> writes:

Show 21 quoted lines

> On 09/11/2012 12:33 AM, Junio C Hamano wrote:
>> Michael Haggerty <mhagger@alum.mit.edu> writes:
>> 
>>> +`string_list_split`, `string_list_split_in_place`::
>>> +
>>> +	Split a string into substrings on a delimiter character and
>>> +	append the substrings to a `string_list`.  If `maxsplit` is
>>> +	non-negative, then split at most `maxsplit` times.  Return the
>>> +	number of substrings appended to the list.
>> 
>> 
>> I recall that we favor
>> 
>> `A`::
>> `B`::
>> 
>> 	Description for A and B
>> 
>> for some reason but do not remember exactly why.
>
> Will change.  Thanks.

Thanks.  It comes from this one:

commit bf474e2402e51843e8230c064da6ccfdf3a8ff54
Author: Markus Heidelberg <markus.heidelberg@web.de>
Date:   Fri Jan 16 22:42:33 2009 +0100

    Documentation: let asciidoc align related options
    
    Command line options can share the same paragraph of description, if
    they are related or synonymous. In these cases they should be
    written among each other, so that asciidoc can format them itself.
    
    Signed-off-by: Markus Heidelberg <markus.heidelberg@web.de>
    Signed-off-by: Junio C Hamano <gitster@pobox.com>