From owner-freebsd-doc@FreeBSD.ORG  Mon May 18 18:12:20 2015
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
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 C7C0ACDD;
 Mon, 18 May 2015 18:12:20 +0000 (UTC)
Received: from bigwig.baldwin.cx (bigwig.baldwin.cx [IPv6:2001:470:1f11:75::1])
 (using TLSv1 with cipher DHE-RSA-CAMELLIA256-SHA (256/256 bits))
 (Client did not present a certificate)
 by mx1.freebsd.org (Postfix) with ESMTPS id A28D01E0E;
 Mon, 18 May 2015 18:12:20 +0000 (UTC)
Received: from ralph.baldwin.cx (pool-173-54-116-245.nwrknj.fios.verizon.net
 [173.54.116.245])
 by bigwig.baldwin.cx (Postfix) with ESMTPSA id BC974B926;
 Mon, 18 May 2015 14:12:18 -0400 (EDT)
From: John Baldwin <jhb@freebsd.org>
To: freebsd-doc@freebsd.org
Cc: Benjamin Kaduk <bjk@freebsd.org>, Patrick Kelsey <pkelsey@freebsd.org>
Subject: Re: Improvement to pthread_getspecific(3)
Date: Mon, 18 May 2015 14:10:50 -0400
Message-ID: <2830799.6adxqfxTR7@ralph.baldwin.cx>
User-Agent: KMail/4.14.3 (FreeBSD/10.1-STABLE; KDE/4.14.3; amd64; ; )
In-Reply-To: <alpine.GSO.1.10.1505181403100.22210@multics.mit.edu>
References: <CAD44qMW3=axQypv3x=03kLUOraawsUW7Q1SToCwhnvhfcFs+QQ@mail.gmail.com>
 <alpine.GSO.1.10.1505181403100.22210@multics.mit.edu>
MIME-Version: 1.0
Content-Transfer-Encoding: 7Bit
Content-Type: text/plain; charset="us-ascii"
X-Greylist: Sender succeeded SMTP AUTH, not delayed by milter-greylist-4.2.7
 (bigwig.baldwin.cx); Mon, 18 May 2015 14:12:18 -0400 (EDT)
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.20
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc/>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Mon, 18 May 2015 18:12:20 -0000

On Monday, May 18, 2015 02:04:17 PM Benjamin Kaduk wrote:
> On Mon, 18 May 2015, Patrick Kelsey wrote:
> 
> > Hi,
> >
> > I'd like to make the attached improvement to pthread_getspecific(3), and
> > this is my first time through a man page edit/commit, so I have a couple of
> > questions and would like to catch whatever else I'm missing.
> >
> > 1. Attribution - I'm using a lightly edited line from
> > http://pubs.opengroup.org/onlinepubs/9699919799/functions/pthread_getspecific.html
> > (edited to account for the fact that we do not document both
> > pthread_getspecific() and pthread_setspecific() in the same man page).  I'm
> > assuming that this falls under whatever agreement covers the existing man
> > page (which was constructed in similar fashion), but there is currently no
> > attribution in pthread_getspecific(3) and I'm not aware of what agreement
> > may be in place that allows for this.
> 
> I'm not aware of what agreement may be in place, either.

There is something, but I think it requires explicit attribution when used?
Hopefully someone else remembers the details.

> In a somewhat related vein, I do note:
> .Sh STANDARDS
> The
> .Fn pthread_getspecific
> function conforms to
> .St -p1003.1-96 .
> 
> 
> > 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.

-- 
John Baldwin