From owner-freebsd-doc@FreeBSD.ORG Mon May 18 21:16:34 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 B82C469C; Mon, 18 May 2015 21:16:34 +0000 (UTC) Received: from mail-yh0-x22c.google.com (mail-yh0-x22c.google.com [IPv6:2607:f8b0:4002:c01::22c]) (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 7461B1693; Mon, 18 May 2015 21:16:34 +0000 (UTC) Received: by yhrr66 with SMTP id r66so54905777yhr.3; Mon, 18 May 2015 14:16:33 -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=nKfh44tbJHS5MP6bmoNZ29U8J6iVE0VonTKT4ej4pQs=; b=PMiaOiCQJxsyJo8wP181iELHLpnFeZDI6OPVK0ZH0ENgKKoNULTdP3wMPBGgL6TIqk H6o0Pgc4yY6AG6Ghqq9kT2RwnQe/7t9T8BbP2shEHcKJ8U3VsuVub7ok2jDlzypJKWfH sL9ZUm+7jo2M2U3ukQvT2bjL7mzoNUoW1GLIpCuBIiYX9GbY6HMr5zqUZyaXSMHUzlo+ 2iu/YgEBej798OLM4VLgjQwxsHGRRkCLmPzLwLkquPcrMBXBWtsyJL0727azMlKg1zEj ZIyg0exeMn5XBmJfUIF2PzxGHiShqkn4ExdpcCGSzrmRao6/FFfohLtUaW6ff+yw7PKY hd0w== MIME-Version: 1.0 X-Received: by 10.170.186.86 with SMTP id c83mr27509240yke.19.1431983793419; Mon, 18 May 2015 14:16:33 -0700 (PDT) Sender: pkelsey@gmail.com Received: by 10.13.201.71 with HTTP; Mon, 18 May 2015 14:16:33 -0700 (PDT) In-Reply-To: References: <2830799.6adxqfxTR7@ralph.baldwin.cx> Date: Mon, 18 May 2015 17:16:33 -0400 X-Google-Sender-Auth: 2iJ8pcjyGFiVqTQSRqCNYKpw5UY Message-ID: Subject: Re: Improvement to pthread_getspecific(3) From: Patrick Kelsey To: Warren Block Cc: Benjamin Kaduk , 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 21:16:34 -0000 On Mon, May 18, 2015 at 5:04 PM, Warren Block wrote: > On Mon, 18 May 2015, Patrick Kelsey wrote: > > 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. >> > > That result gives the current state, which might not be the goal. To put > it another way, there are a lot of man pages which are not the best > examples. > I agree. These numbers were in the context of describing the 'large body of existing text using both forms', and not meant to be a 'majority rules' argument.