From owner-freebsd-doc@FreeBSD.ORG Mon May 18 15:23:04 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 F06039B7 for ; Mon, 18 May 2015 15:23:04 +0000 (UTC) Received: from mail-yh0-x233.google.com (mail-yh0-x233.google.com [IPv6:2607:f8b0:4002:c01::233]) (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 AD37A1767 for ; Mon, 18 May 2015 15:23:04 +0000 (UTC) Received: by yhom41 with SMTP id m41so51342298yho.1 for ; Mon, 18 May 2015 08:23:03 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:sender:date:message-id:subject:from:to:content-type; bh=EWNPWjH4odjYoKe+bHg2oc8EClCxmRI9VdRbhGxKRRk=; b=XLX5Svac5Xjhg6Je9RfRfLlj9CdyxrOs0UtdRPsQtmqlh0NiOs/xLcPr86VKqruxVU sEAfvy5UZbotjlCM2wntdxXJ0unsCkbT26insBTpCtMozFTmjxFyhiC4l9FuZbVKaWHl fmA+epn5DslCsKKAO45set/3INxn5aO/W8TQXC79p2nUL9gbByEI/N7lKpi5bHYNaqiD pYPwgS+CEvnN/Q5plF47Tu4Ed62yHLNXyDySSv93+Wh/S4l6ITpMlO/LwQcyVPRQNdB0 2ZhOAbfSrBQGkL6yWy+qiFCfJzm7T5qNFYPUGDgLzkrJjW6o49y4C07XxPdGwK21Xhd7 W0Ng== MIME-Version: 1.0 X-Received: by 10.170.59.72 with SMTP id b69mr25376459ykb.10.1431962583775; Mon, 18 May 2015 08:23:03 -0700 (PDT) Sender: pkelsey@gmail.com Received: by 10.13.201.71 with HTTP; Mon, 18 May 2015 08:23:03 -0700 (PDT) Date: Mon, 18 May 2015 11:23:03 -0400 X-Google-Sender-Auth: Nli4AdEuT6V4IoBXPa5iqrYGQNc Message-ID: Subject: Improvement to pthread_getspecific(3) From: Patrick Kelsey To: freebsd-doc@freebsd.org Content-Type: multipart/mixed; boundary=001a1139a136235f0005165cc5c8 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 15:23:05 -0000 --001a1139a136235f0005165cc5c8 Content-Type: text/plain; charset=UTF-8 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. 2. Markup - should I be using .Pq instead of explicit parentheses? Thanks, Patrick --001a1139a136235f0005165cc5c8 Content-Type: text/plain; charset=US-ASCII; name="current-pthread_getspecific-from-destructor-man-page-note.diff" Content-Disposition: attachment; filename="current-pthread_getspecific-from-destructor-man-page-note.diff" Content-Transfer-Encoding: base64 X-Attachment-Id: f_i9u16q3e0 SW5kZXg6IHNoYXJlL21hbi9tYW4zL3B0aHJlYWRfZ2V0c3BlY2lmaWMuMwo9PT09PT09PT09PT09 PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09Ci0t LSBzaGFyZS9tYW4vbWFuMy9wdGhyZWFkX2dldHNwZWNpZmljLjMJKHJldmlzaW9uIDI4MjkzMykK KysrIHNoYXJlL21hbi9tYW4zL3B0aHJlYWRfZ2V0c3BlY2lmaWMuMwkod29ya2luZyBjb3B5KQpA QCAtNjQsNiArNjQsMTEgQEAKIFRoZQogLkZuIHB0aHJlYWRfZ2V0c3BlY2lmaWMKIGZ1bmN0aW9u IG1heSBiZSBjYWxsZWQgZnJvbSBhIHRocmVhZC1zcGVjaWZpYyBkYXRhIGRlc3RydWN0b3IgZnVu Y3Rpb24uCitBIGNhbGwgdG8KKy5GbiBwdGhyZWFkX2dldHNwZWNpZmljCitmb3IgdGhlIHRocmVh ZC1zcGVjaWZpYyBkYXRhIGtleSBiZWluZyBkZXN0cm95ZWQgcmV0dXJucyB0aGUgdmFsdWUgTlVM TCwKK3VubGVzcyB0aGUgdmFsdWUgaXMgY2hhbmdlZCAoYWZ0ZXIgdGhlIGRlc3RydWN0b3Igc3Rh cnRzKSBieSBhIGNhbGwgdG8KKy5GbiBwdGhyZWFkX3NldHNwZWNpZmljIC4KIC5TaCBSRVRVUk4g VkFMVUVTCiBUaGUKIC5GbiBwdGhyZWFkX2dldHNwZWNpZmljCg== --001a1139a136235f0005165cc5c8--