stdio/FreeBSD/setbuf.3.patch

   1 --- _SB/Libc/stdio/FreeBSD/setbuf.3     2004-11-25 11:38:35.000000000 -0800
   2 +++ _SB/Libc/stdio/FreeBSD/setbuf.3.edit        2006-06-28 16:55:52.000000000 -0700
   3 @@ -50,21 +50,37 @@
   4  .Sh SYNOPSIS
   5  .In stdio.h
   6  .Ft void
   7 -.Fn setbuf "FILE * restrict stream" "char * restrict buf"
   8 +.Fo setbuf
   9 +.Fa "FILE *restrict stream"
  10 +.Fa "char *restrict buf"
  11 +.Fc
  12  .Ft void
  13 -.Fn setbuffer "FILE *stream" "char *buf" "int size"
  14 +.Fo setbuffer
  15 +.Fa "FILE *stream"
  16 +.Fa "char *buf"
  17 +.Fa "int size"
  18 +.Fc
  19  .Ft int
  20 -.Fn setlinebuf "FILE *stream"
  21 +.Fo setlinebuf
  22 +.Fa "FILE *stream"
  23 +.Fc
  24  .Ft int
  25 -.Fn setvbuf "FILE * restrict stream" "char * restrict buf" "int mode" "size_t size"
  26 +.Fo setvbuf
  27 +.Fa "FILE *restrict stream"
  28 +.Fa "char *restrict buf"
  29 +.Fa "int type"
  30 +.Fa "size_t size"
  31 +.Fc
  32  .Sh DESCRIPTION
  33 -The three types of buffering available are unbuffered, block buffered,
  34 -and line buffered.
  35 +Three types of buffering are available:
  36 +unbuffered, block buffered, and line buffered.
  37  When an output stream is unbuffered, information appears on the
  38  destination file or terminal as soon as written;
  39 -when it is block buffered many characters are saved up and written as a block;
  40 -when it is line buffered characters are saved up until a newline is
  41 -output or input is read from any stream attached to a terminal device
  42 +when it is block buffered,
  43 +many characters are saved up and written as a block;
  44 +when it is line buffered,
  45 +characters are saved up until a newline is output
  46 +or input is read from any stream attached to a terminal device
  47  (typically
  48  .Dv stdin ) .
  49  The function
  50 @@ -73,17 +89,16 @@
  51  (See
  52  .Xr fclose 3 . )
  53  .Pp
  54 -Normally all files are block buffered.
  55 +Normally, all files are block buffered.
  56  When the first
  57  .Tn I/O
  58  operation occurs on a file,
  59  .Xr malloc 3
  60 -is called,
  61 -and an optimally-sized buffer is obtained.
  62 +is called and an optimally-sized buffer is obtained.
  63  If a stream refers to a terminal
  64  (as
  65  .Dv stdout
  66 -normally does) it is line buffered.
  67 +normally does), it is line buffered.
  68  The standard error stream
  69  .Dv stderr
  70  is always unbuffered.
  71 @@ -93,7 +108,7 @@
  72  function
  73  may be used to alter the buffering behavior of a stream.
  74  The
  75 -.Fa mode
  76 +.Fa type
  77  argument must be one of the following three macros:
  78  .Bl -tag -width _IOFBF -offset indent
  79  .It Dv _IONBF