Flag proposal

[Nick Sabalausky]

"Andrei Alexandrescu" <SeeWebsiteForEmail at erdani.org> wrote in message 
news:it1c0f$1uup$1 at digitalmars.com...
> On 06/11/2011 03:52 PM, Nick Sabalausky wrote:
>> "Andrei Alexandrescu"<SeeWebsiteForEmail at erdani.org>  wrote in message
>> news:it07ni$1pvj$1 at digitalmars.com...
>>>
>>> Anyway, that was the first thing "grep yes std/*" found. Let's see the
>>> next one:
>>>
>>> /**
>>> Specifies whether the output of certain algorithm is desired in sorted
>>> format.
>>>   */
>>> enum SortOutput {
>>>      no,  /// Don't sort output
>>>      yes, /// Sort output
>>> }
>>>
>>> This already is very unpleasant because "certain" is as imprecise as it
>>> gets. Plus one for Flag, I hope you agree.
>>>
>>
>> Flag -= 1
>> s/output of certain algorithm/output of an algorithm/ += 1
>>
>> That one-word doc change makes it all perfectly clear.
>
> Not at all. The typo in the original text must have confused you: it 
> should be "certain algorithms" because SortOutput is used in four distinct 
> algorithms (one of which has two overloads). Grep std/algorithm.d.
>
> Flag += 2
>

Not that I consider quibbling over small English wording differences a major 
thing, but I fail to see how:

"Specifies whether the output of an algorithm is desired in sorted format."

is significantly different from:

"Specifies whether the output of certain algorithms are desired in sorted 
format."

In either case, I don't see anything problematically imprecise.