svn commit: r273996 - in stable: 10/share/man/man3 8/share/man/man3 9/share/man/man3

[John Baldwin]

Author: jhb
Date: Sun Nov  2 23:22:22 2014
New Revision: 273996
URL: https://svnweb.freebsd.org/changeset/base/273996

Log:
  MFC 273644,273738:
  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 at pacbell.net

Modified:
  stable/9/share/man/man3/pthread_cleanup_pop.3
  stable/9/share/man/man3/pthread_cleanup_push.3
Directory Properties:
  stable/9/share/man/man3/   (props changed)

Changes in other areas also in this revision:
Modified:
  stable/10/share/man/man3/pthread_cleanup_pop.3
  stable/10/share/man/man3/pthread_cleanup_push.3
  stable/8/share/man/man3/pthread_cleanup_pop.3
  stable/8/share/man/man3/pthread_cleanup_push.3
Directory Properties:
  stable/10/   (props changed)
  stable/8/share/man/man3/   (props changed)

Modified: stable/9/share/man/man3/pthread_cleanup_pop.3
==============================================================================
--- stable/9/share/man/man3/pthread_cleanup_pop.3	Sun Nov  2 22:58:30 2014	(r273995)
+++ stable/9/share/man/man3/pthread_cleanup_pop.3	Sun Nov  2 23:22:22 2014	(r273996)
@@ -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_pop
+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: stable/9/share/man/man3/pthread_cleanup_push.3
==============================================================================
--- stable/9/share/man/man3/pthread_cleanup_push.3	Sun Nov  2 22:58:30 2014	(r273995)
+++ stable/9/share/man/man3/pthread_cleanup_push.3	Sun Nov  2 23:22:22 2014	(r273996)
@@ -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