Improvement to pthread_getspecific(3)

[Patrick Kelsey]

On Mon, May 18, 2015 at 5:04 PM, Warren Block <wblock at wonkity.com> wrote:

> On Mon, 18 May 2015, Patrick Kelsey wrote:
>
>  On Mon, May 18, 2015 at 2:40 PM, Benjamin Kaduk <bjk at freebsd.org> wrote:
>>
>>  On Mon, 18 May 2015, John Baldwin wrote:
>>>
>>>
>>>>>  2. Markup - should I be using .Pq instead of explicit parentheses?
>>>>>>
>>>>>
>>>>> We do not have a strong preference for Pq over explicit parentheses,
>>>>>
>>>> so I
>>>
>>>> would leave them in.
>>>>>
>>>>
>>>> Ah, I thought we preferred mdoc markup (Pq, Dq, etc.) when possible.
>>>>
>>>
>>> I don't think there are written style rules on this point, but there is a
>>> large body of existing text using both forms (for Pq in particular), and
>>> we're unlikely to get anywhere close to consolidation.
>>>
>>>
>> Based on cursory grep -r | wc on share/man, lines with explicit parens
>> outnumber lines with .Pq by about 4:1 with the delta being about 3.5k
>> lines.  That estimate is not perfect, but I did take some pains to exclude
>> counting among lines with explicit parens those with copyright symbols,
>> code examples, lines in comments (such as the license terms), etc.
>>
>
> That result gives the current state, which might not be the goal.  To put
> it another way, there are a lot of man pages which are not the best
> examples.
>

I agree.  These numbers were in the context of describing the 'large body
of existing text using both forms', and not meant to be a 'majority rules'
argument.