From owner-freebsd-doc@FreeBSD.ORG Mon May 18 18:14:47 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 48F4AD47; Mon, 18 May 2015 18:14:47 +0000 (UTC) Received: from mail-yh0-x22a.google.com (mail-yh0-x22a.google.com [IPv6:2607:f8b0:4002:c01::22a]) (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 06CEA1E26; Mon, 18 May 2015 18:14:47 +0000 (UTC) Received: by yhrr66 with SMTP id r66so53527375yhr.3; Mon, 18 May 2015 11:14:46 -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=dWQ+WUj3EtaWu0VQSGWxLyJO9gwWhT/QLTZ309XR4YM=; b=RngeWI9NRvQEns0xLQZ09s931C9f6OW5dMBAGBmwLVGvho7WbeHhiEE10p2zH3Uvd2 AVt/hxI4VBSmeDveMs4uE58NWnhxVHhlbWQVUgkrqRDuxjc63Gon3PQVvNMtD0p+Jf0R 8HRRXQ05ZmqQx4raUvwUDa4i1G0+54ZbN6R24C1cs7UkZLFg7U1yx9C7JF4qGV/pc1Ca i5DPIl10RyFY7Zf7CSvkPMHc8znzjHM3+Rg0EA12hxazRXLkEQ6LbTzEQopkTCWKqycB PglbWqWytrjVoSWw56T0nAE4mNIhLpiClqipSsHkRLkeWLrblAzv187aeZ7Ve3zxdMH8 5POQ== MIME-Version: 1.0 X-Received: by 10.170.136.200 with SMTP id d191mr26097406ykc.59.1431972886078; Mon, 18 May 2015 11:14:46 -0700 (PDT) Sender: pkelsey@gmail.com Received: by 10.13.201.71 with HTTP; Mon, 18 May 2015 11:14:45 -0700 (PDT) In-Reply-To: <2830799.6adxqfxTR7@ralph.baldwin.cx> References: <2830799.6adxqfxTR7@ralph.baldwin.cx> Date: Mon, 18 May 2015 14:14:45 -0400 X-Google-Sender-Auth: n7kRq_jFp9vjFAcs_woTnUbzdAY Message-ID: Subject: Re: Improvement to pthread_getspecific(3) From: Patrick Kelsey To: John Baldwin Cc: freebsd-doc@freebsd.org, Benjamin Kaduk 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 18:14:47 -0000 On Mon, May 18, 2015 at 2:10 PM, John Baldwin wrote: > 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. > I found this press release which describes the agreement: http://www6.opengroup.org/comm/press/01jun04.htm It would be nice to know we have a local record of that somewhere, as the first few attempts at turning something like this up resulted in dead links into the open group site. > > > 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 >