From owner-svn-src-head@FreeBSD.ORG Sat Oct 25 20:11:38 2014 Return-Path: Delivered-To: svn-src-head@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 68FE5AB8; Sat, 25 Oct 2014 20:11:38 +0000 (UTC) Received: from mho-02-ewr.mailhop.org (mho-02-ewr.mailhop.org [204.13.248.72]) (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 2B017331; Sat, 25 Oct 2014 20:11:38 +0000 (UTC) Received: from [73.34.117.227] (helo=ilsoft.org) by mho-02-ewr.mailhop.org with esmtpsa (TLSv1:AES256-SHA:256) (Exim 4.72) (envelope-from ) id 1Xi7gX-000AKH-3H; Sat, 25 Oct 2014 20:11:37 +0000 Received: from [172.22.42.240] (revolution.hippie.lan [172.22.42.240]) by ilsoft.org (8.14.9/8.14.9) with ESMTP id s9PKBaIx072808; Sat, 25 Oct 2014 14:11:36 -0600 (MDT) (envelope-from ian@FreeBSD.org) X-Mail-Handler: Dyn Standard SMTP by Dyn X-Originating-IP: 73.34.117.227 X-Report-Abuse-To: abuse@dyndns.com (see http://www.dyndns.com/services/sendlabs/outbound_abuse.html for abuse reporting information) X-MHO-User: U2FsdGVkX1+7zj/cN6prOY2+ZU8JLbpr X-Authentication-Warning: paranoia.hippie.lan: Host revolution.hippie.lan [172.22.42.240] claimed to be [172.22.42.240] Subject: Re: svn commit: r273644 - head/share/man/man3 From: Ian Lepore To: John Baldwin In-Reply-To: <201410251931.s9PJVYIk080552@svn.freebsd.org> References: <201410251931.s9PJVYIk080552@svn.freebsd.org> Content-Type: text/plain; charset="us-ascii" Date: Sat, 25 Oct 2014 14:11:36 -0600 Message-ID: <1414267896.12052.652.camel@revolution.hippie.lan> Mime-Version: 1.0 X-Mailer: Evolution 2.32.1 FreeBSD GNOME Team Port Content-Transfer-Encoding: 7bit Cc: svn-src-head@freebsd.org, svn-src-all@freebsd.org, src-committers@freebsd.org X-BeenThere: svn-src-head@freebsd.org X-Mailman-Version: 2.1.18-1 Precedence: list List-Id: SVN commit messages for the src tree for head/-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 25 Oct 2014 20:11:38 -0000 On Sat, 2014-10-25 at 19:31 +0000, John Baldwin wrote: > Author: jhb > Date: Sat Oct 25 19:31:34 2014 > New Revision: 273644 > URL: https://svnweb.freebsd.org/changeset/base/273644 > > Log: > Clarify that pthread_cleanup_push()/pop() are implemented as macros that > create a new code block and thus must be balanced at the same lexical > scope. (This is also a requirement in POSIX.) > > PR: 194280 > Submitted by: dr2867.business@pacbell.net > MFC after: 1 week > > Modified: > head/share/man/man3/pthread_cleanup_pop.3 > head/share/man/man3/pthread_cleanup_push.3 > > Modified: head/share/man/man3/pthread_cleanup_pop.3 > ============================================================================== > --- head/share/man/man3/pthread_cleanup_pop.3 Sat Oct 25 19:01:02 2014 (r273643) > +++ head/share/man/man3/pthread_cleanup_pop.3 Sat Oct 25 19:31:34 2014 (r273644) > @@ -27,7 +27,7 @@ > .\" > .\" $FreeBSD$ > .\" > -.Dd July 30, 1998 > +.Dd October 25, 2014 > .Dt PTHREAD_CLEANUP_POP 3 > .Os > .Sh NAME > @@ -50,6 +50,14 @@ If there is no cleanup routine > then > .Fn pthread_cleanup_pop > does nothing. > +.Pp > +The > +.Fn pthread_cleanup_push Should be pop? -- Ian > +function is implemented as a macro that closes a block. > +Invocations of this function must appear as standalone statements that are > +paired with an earlier call of > +.Xr pthread_cleanup_push 3 > +in the same lexical scope. > .Sh RETURN VALUES > The > .Fn pthread_cleanup_pop > > Modified: head/share/man/man3/pthread_cleanup_push.3 > ============================================================================== > --- head/share/man/man3/pthread_cleanup_push.3 Sat Oct 25 19:01:02 2014 (r273643) > +++ head/share/man/man3/pthread_cleanup_push.3 Sat Oct 25 19:31:34 2014 (r273644) > @@ -27,7 +27,7 @@ > .\" > .\" $FreeBSD$ > .\" > -.Dd July 30, 1998 > +.Dd October 25, 2014 > .Dt PTHREAD_CLEANUP_PUSH 3 > .Os > .Sh NAME > @@ -52,6 +52,14 @@ When > is called, it is passed > .Fa arg > as its only argument. > +.Pp > +The > +.Fn pthread_cleanup_push > +function is implemented as a macro that opens a new block. > +Invocations of this function must appear as standalone statements that are > +paired with a later call of > +.Xr pthread_cleanup_pop 3 > +in the same lexical scope. > .Sh RETURN VALUES > The > .Fn pthread_cleanup_push >