From owner-freebsd-doc@FreeBSD.ORG Mon May 18 19:00:09 2015 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 9D17633B; Mon, 18 May 2015 19:00:09 +0000 (UTC) Received: from mail-yh0-x22f.google.com (mail-yh0-x22f.google.com [IPv6:2607:f8b0:4002:c01::22f]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client CN "smtp.gmail.com", Issuer "Google Internet Authority G2" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 5A2431468; Mon, 18 May 2015 19:00:09 +0000 (UTC) Received: by yhom41 with SMTP id m41so53025820yho.1; Mon, 18 May 2015 12:00:08 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:sender:in-reply-to:references:date:message-id:subject :from:to:cc:content-type; bh=QcJuIJBb4jsfcchdRbtycTC6QIgJhGkI7n432RnJ5PY=; b=tKx+eoTOAS7QqeFY7ZR/IXQFOULZw6OwvBmqoT0jikc3r4CNPJWwbyX04GZj9dqyME QowI02F6lDAAOlIeR7S/JdhEAb2HDSsBKHOw8jqPMnWiS646qYcf4UvYZ4V+oMcvKtSN gURQXGFfFgru8okgIRVNfXx6WVtdVMO7NLBNM2TpEarkRBvAD1bGjYAt9qhL4JBX+xgw 4HxkVLTs8K9IH7d/yKXlt3UUFJFlUg8MhWh+1I4itYVuOYNF+z6nCRHOdzh1QdcbA08n 58KpcWx0fh8TeLk7AhAe2ocCNU/1WFHl3aPGmcVIQiO2+xOeoI2Fa/PyzZ/pelGM53zc T3oA== MIME-Version: 1.0 X-Received: by 10.236.32.136 with SMTP id o8mr24025749yha.162.1431975608368; Mon, 18 May 2015 12:00:08 -0700 (PDT) Sender: pkelsey@gmail.com Received: by 10.13.201.71 with HTTP; Mon, 18 May 2015 12:00:08 -0700 (PDT) In-Reply-To: References: <2830799.6adxqfxTR7@ralph.baldwin.cx> Date: Mon, 18 May 2015 15:00:08 -0400 X-Google-Sender-Auth: uuopRenOziWLB1ARKFh723ziym4 Message-ID: Subject: Re: Improvement to pthread_getspecific(3) From: Patrick Kelsey To: Benjamin Kaduk Cc: John Baldwin , freebsd-doc@freebsd.org Content-Type: text/plain; charset=UTF-8 X-Content-Filtered-By: Mailman/MimeDel 2.1.20 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.20 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 18 May 2015 19:00:09 -0000 On Mon, May 18, 2015 at 2:40 PM, Benjamin Kaduk 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 >