Improvement to pthread_getspecific(3)

Benjamin Kaduk bjk at freebsd.org
Mon May 18 18:45:34 UTC 2015


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.

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


More information about the freebsd-doc mailing list