Date: Mon, 18 May 2015 14:40:21 -0400 (EDT) From: Benjamin Kaduk <bjk@freebsd.org> To: John Baldwin <jhb@freebsd.org> Cc: freebsd-doc@freebsd.org, Patrick Kelsey <pkelsey@freebsd.org> Subject: Re: Improvement to pthread_getspecific(3) Message-ID: <alpine.GSO.1.10.1505181437200.22210@multics.mit.edu> In-Reply-To: <2830799.6adxqfxTR7@ralph.baldwin.cx> References: <CAD44qMW3=axQypv3x=03kLUOraawsUW7Q1SToCwhnvhfcFs%2BQQ@mail.gmail.com> <alpine.GSO.1.10.1505181403100.22210@multics.mit.edu> <2830799.6adxqfxTR7@ralph.baldwin.cx>
next in thread | previous in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?alpine.GSO.1.10.1505181437200.22210>