Improvement to pthread_getspecific(3)

[Patrick Kelsey]

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.



>
> For the other quotes (Dq, Sq, etc.) I agree with you --it makes more sense
> to care about Dq and Sq than Pq, since the rendering of Pq is unlikely to
> change, no matter what output format the mdoc is being compiled to.
>
> -Ben
>