fgets.3.patch   [plain text]


--- _SB/Libc/stdio/FreeBSD/fgets.3	2003-05-20 15:22:41.000000000 -0700
+++ _SB/Libc/stdio/FreeBSD/fgets.3.edit	2006-06-28 16:55:52.000000000 -0700
@@ -48,19 +48,19 @@
 .Sh SYNOPSIS
 .In stdio.h
 .Ft char *
-.Fn fgets "char * restrict str" "int size" "FILE * restrict stream"
+.Fn fgets "char *restrict s" "int n" "FILE *restrict stream"
 .Ft char *
-.Fn gets "char *str"
+.Fn gets "char *s"
 .Sh DESCRIPTION
 The
 .Fn fgets
 function
 reads at most one less than the number of characters specified by
-.Fa size
+.Fa n
 from the given
 .Fa stream
 and stores them in the string
-.Fa str .
+.Fa s .
 Reading stops when a newline character is found,
 at end-of-file or error.
 The newline, if any, is retained.
@@ -74,7 +74,7 @@
 is equivalent to
 .Fn fgets
 with an infinite
-.Fa size
+.Fa n
 and a
 .Fa stream
 of
@@ -102,7 +102,7 @@
 and
 .Fn gets
 functions
-do not distinguish between end-of-file and error, and callers must use
+do not distinguish between end-of-file and error; callers must use
 .Xr feof 3
 and
 .Xr ferror 3
@@ -152,11 +152,6 @@
 .Xr ferror 3 ,
 .Xr fgetln 3 ,
 .Xr fgetws 3
-.Rs
-.%T "The FreeBSD Security Architecture"
-.Re
-(See
-.Pa /usr/share/doc/{to be determined} . )
 .Sh STANDARDS
 The functions
 .Fn fgets