gen/FreeBSD/err.3.patch

   1 --- err.3.orig  2009-11-07 14:51:37.000000000 -0800
   2 +++ err.3       2009-11-07 14:51:40.000000000 -0800
   3 @@ -28,7 +28,7 @@
   4  .\"    From: @(#)err.3 8.1 (Berkeley) 6/9/93
   5  .\" $FreeBSD: src/lib/libc/gen/err.3,v 1.24 2008/10/31 15:14:40 rwatson Exp $
   6  .\"
   7 -.Dd March 6, 1999
   8 +.Dd May 20, 2008
   9  .Dt ERR 3
  10  .Os
  11  .Sh NAME
  12 @@ -45,6 +45,9 @@
  13  .Nm warnx ,
  14  .Nm vwarnx ,
  15  .Nm err_set_exit ,
  16 +#ifdef UNIFDEF_BLOCKS
  17 +.Nm err_set_exit_b ,
  18 +#endif
  19  .Nm err_set_file
  20  .Nd formatted error messages
  21  .Sh LIBRARY
  22 @@ -55,6 +58,10 @@
  23  .Fn err "int eval" "const char *fmt" "..."
  24  .Ft void
  25  .Fn err_set_exit "void (*exitf)(int)"
  26 +#ifdef UNIFDEF_BLOCKS
  27 +.Ft void
  28 +.Fn err_set_exit_b "void (^exitb)(int)"
  29 +#endif
  30  .Ft void
  31  .Fn err_set_file "void *vfp"
  32  .Ft void
  33 @@ -165,6 +172,24 @@ function can be used to specify a functi
  34  to perform any necessary cleanup; passing a null function pointer for
  35  .Va exitf
  36  resets the hook to do nothing.
  37 +#ifdef UNIFDEF_BLOCKS
  38 +The
  39 +.Fn err_set_exit_b
  40 +function is like
  41 +.Fn err_set_exit
  42 +except it takes a block pointer instead of a function pointer.
  43 +.Bd -ragged -offset indent
  44 +Note: The
  45 +.Fn Block_copy
  46 +function (defined in
  47 +.In Blocks.h )
  48 +is used by
  49 +.Fn err_set_exit_b
  50 +to make a copy of the block, especially for the case when a stack-based
  51 +block might go out of scope when the subroutine returns.
  52 +.Ed
  53 +.Pp
  54 +#endif
  55  The
  56  .Fn err_set_file
  57  function sets the output stream used by the other functions.
  58 @@ -231,3 +256,8 @@ and
  59  .Fn warnc
  60  functions first appeared in
  61  .Fx 3.0 .
  62 +#ifdef UNIFDEF_BLOCKS
  63 +The
  64 +.Fn err_set_exit_b
  65 +function first appeared in Mac OS X 10.6.
  66 +#endif