Libc-997.1.1.tar.gz

[apple/libc.git] / stdio / FreeBSD / fputs.3

diff --git a/stdio/FreeBSD/fputs.3 b/stdio/FreeBSD/fputs.3
index c0feb0cfdb0f06450734d022a4518cfe7e1d83b7..4c4ca1ee898251e5b42e94a2be7094eeb2fabe01 100644 (file)
--- a/stdio/FreeBSD/fputs.3
+++ b/stdio/FreeBSD/fputs.3
@@ -44,14 +44,19 @@
 .Sh SYNOPSIS
 .In stdio.h
 .Ft int
 .Sh SYNOPSIS
 .In stdio.h
 .Ft int

-.Fn fputs "const char *str" "FILE *stream"
+.Fo fputs
+.Fa "const char *restrict s"
+.Fa "FILE *restrict stream"
+.Fc

 .Ft int
 .Ft int

-.Fn puts "const char *str"
+.Fo puts
+.Fa "const char *s"
+.Fc

 .Sh DESCRIPTION
 The function
 .Fn fputs
 writes the string pointed to by
 .Sh DESCRIPTION
 The function
 .Fn fputs
 writes the string pointed to by

-.Fa str
+.Fa s

 to the stream pointed to by
 .Fa stream .
 .\" The terminating
 to the stream pointed to by
 .Fa stream .
 .\" The terminating


@@ -61,7 +66,7 @@ to the stream pointed to by
 The function
 .Fn puts
 writes the string
 The function
 .Fn puts
 writes the string

-.Fa str ,
+.Fa s ,

 and a terminating newline character,
 to the stream
 .Dv stdout .
 and a terminating newline character,
 to the stream
 .Dv stdout .


@@ -90,6 +95,14 @@ may also fail and set
 .Va errno
 for any of the errors specified for the routines
 .Xr write 2 .
 .Va errno
 for any of the errors specified for the routines
 .Xr write 2 .

+.Sh COMPATIBILITY
+.Fn fputs
+now returns a non-negative number (as opposed to 0)
+on successful completion.
+As a result, many tests (e.g., "fputs() == 0", "fputs() != 0")
+do not give the desired result.
+Use "fputs() != EOF" or "fputs() == EOF"
+to determine success or failure.

 .Sh SEE ALSO
 .Xr ferror 3 ,
 .Xr fputws 3 ,
 .Sh SEE ALSO
 .Xr ferror 3 ,
 .Xr fputws 3 ,


@@ -102,3 +115,13 @@ and
 .Fn puts
 conform to
 .St -isoC .
 .Fn puts
 conform to
 .St -isoC .

+While not mentioned in the standard, both
+.Fn fputs
+and
+.Fn puts
+print
+.Ql (null)
+if
+.Fa str
+is
+.Dv NULL .