stdio/FreeBSD/ungetc.3.patch

   1 --- _SB/Libc/stdio/FreeBSD/ungetc.3     2003-05-20 15:22:44.000000000 -0700
   2 +++ _SB/Libc/stdio/FreeBSD/ungetc.3.edit        2006-06-28 16:55:52.000000000 -0700
   3 @@ -47,7 +47,10 @@
   4  .Sh SYNOPSIS
   5  .In stdio.h
   6  .Ft int
   7 -.Fn ungetc "int c" "FILE *stream"
   8 +.Fo ungetc
   9 +.Fa "int c"
  10 +.Fa "FILE *stream"
  11 +.Fc
  12  .Sh DESCRIPTION
  13  The
  14  .Fn ungetc
  15 @@ -56,20 +59,20 @@
  16  (converted to an unsigned char)
  17  back onto the input stream pointed to by
  18  .Fa stream .
  19 -The pushed-back characters will be returned by subsequent reads on the
  20 -stream (in reverse order).
  21 -A successful intervening call,
  22 -using the same stream,
  23 +The pushed-back characters will be returned (in reverse order)
  24 +by subsequent reads on the stream.
  25 +A successful intervening call
  26  to one of the file positioning functions
  27  .Xr ( fseek 3 ,
  28  .Xr fsetpos 3 ,
  29  or
  30 -.Xr rewind 3 )
  31 -will discard the pushed back characters.
  32 +.Xr rewind 3 ) ,
  33 +using the same stream,
  34 +will discard the pushed-back characters.
  35  .Pp
  36 -One character of push-back is guaranteed,
  37 +Only one character of push-back is guaranteed,
  38  but as long as there is sufficient memory,
  39 -an effectively infinite amount of pushback is allowed.
  40 +an effectively infinite amount of push-back is allowed.
  41  .Pp
  42  If a character is successfully pushed-back,
  43  the end-of-file indicator for the stream is cleared.