From owner-freebsd-doc@FreeBSD.ORG Mon May 18 18:45:34 2015 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 649E3D77; Mon, 18 May 2015 18:45:34 +0000 (UTC) Received: from dmz-mailsec-scanner-6.mit.edu (dmz-mailsec-scanner-6.mit.edu [18.7.68.35]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id CCBB41298; Mon, 18 May 2015 18:45:33 +0000 (UTC) X-AuditID: 12074423-f79536d000000e74-7f-555a32185477 Received: from mailhub-auth-4.mit.edu ( [18.7.62.39]) (using TLS with cipher DHE-RSA-AES256-SHA (256/256 bits)) (Client did not present a certificate) by dmz-mailsec-scanner-6.mit.edu (Symantec Messaging Gateway) with SMTP id D3.8C.03700.8123A555; Mon, 18 May 2015 14:40:24 -0400 (EDT) Received: from outgoing.mit.edu (outgoing-auth-1.mit.edu [18.9.28.11]) by mailhub-auth-4.mit.edu (8.13.8/8.9.2) with ESMTP id t4IIeNK6022435; Mon, 18 May 2015 14:40:24 -0400 Received: from multics.mit.edu (system-low-sipb.mit.edu [18.187.2.37]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.8/8.12.4) with ESMTP id t4IIeLhG014066 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Mon, 18 May 2015 14:40:23 -0400 Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id t4IIeL4t016998; Mon, 18 May 2015 14:40:21 -0400 (EDT) Date: Mon, 18 May 2015 14:40:21 -0400 (EDT) From: Benjamin Kaduk X-X-Sender: kaduk@multics.mit.edu To: John Baldwin cc: freebsd-doc@freebsd.org, Patrick Kelsey Subject: Re: Improvement to pthread_getspecific(3) In-Reply-To: <2830799.6adxqfxTR7@ralph.baldwin.cx> Message-ID: References: <2830799.6adxqfxTR7@ralph.baldwin.cx> User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFmpkleLIzCtJLcpLzFFi42IRYrdT15Uwigo1mLVf2eLUmS5Wi71HrjNb HL2b78DsMePTfJYAxigum5TUnMyy1CJ9uwSujM3Nl1kLXrJW/NuyiK2B8TBLFyMnh4SAicTb 1SuYIWwxiQv31rOB2EICi5kkjhw16WLkArI3Mkos+riIFcI5xCTxZFsfO0RVA6PEnwciIDaL gLbEgrfHwaayCahJPN7bzAoxVVFi86lJQBs4OEQElCSmflMDCTMLOEqc3N7ACBIWFjCS2Lld G8TkBDHv1YFU8AJVLGk9xQKxdQ3QokN7we4UFdCRWL1/CgtEkaDEyZlPWCBGakksn76NZQKj 0CwkqVlIUgsYmVYxyqbkVunmJmbmFKcm6xYnJ+blpRbpmunlZpbopaaUbmIEh66L8g7GPweV DjEKcDAq8fBOeBcRKsSaWFZcmXuIUZKDSUmUt00vKlSILyk/pTIjsTgjvqg0J7X4EKMEB7OS CO8+RaAcb0piZVVqUT5MSpqDRUmcd9MPvhAhgfTEktTs1NSC1CKYrAwHh5IE7ykDoEbBotT0 1Iq0zJwShDQTByfIcB6g4edAaniLCxJzizPTIfKnGHU57kz5v4hJiCUvPy9VSpw3FaRIAKQo ozQPbg4s5bxiFAd6S5jXE6SKB5iu4Ca9AlrCBLTEZFskyJKSRISUVAMjZ3bqB4X9szYnVfjK ebnbVQe6bv2r27P8bL9v3NU192sKg7mW/C1KC3dMvpd96pHKyXa/g+8/L2Sbd/NLZK3FnoOi 0yauUhRWv8o7e8/DRqVH+g4itpv6Y6c9OrjScEWpZ0605/bL+nIhp5YWHBU17BdPi/pUHeDr KMLi+C/q5rnbDBcS/ogpsRRnJBpqMRcVJwIAQR3waRQDAAA= 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 18:45:34 -0000 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