On Mon, May 18, 2015 at 2:40 PM, Benjamin Kaduk <[email protected]> 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 > _______________________________________________ [email protected] mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "[email protected]"
