From 8746d263e1451855025dc83dde5176cc9f1fbe3f Mon Sep 17 00:00:00 2001 From: ru Date: Wed, 18 Dec 2002 12:45:11 +0000 Subject: mdoc(7) police: "The .Fn function". --- lib/libc/stdio/fclose.3 | 2 ++ lib/libc/stdio/fwide.3 | 2 ++ lib/libc/stdio/mktemp.3 | 2 ++ lib/libc/stdio/printf.3 | 16 ++++++++++++---- lib/libc/stdio/tmpnam.3 | 4 +++- 5 files changed, 21 insertions(+), 5 deletions(-) (limited to 'lib/libc/stdio') diff --git a/lib/libc/stdio/fclose.3 b/lib/libc/stdio/fclose.3 index 6d71811..9d48228 100644 --- a/lib/libc/stdio/fclose.3 +++ b/lib/libc/stdio/fclose.3 @@ -77,7 +77,9 @@ for any of the errors specified for the routines or .Xr fflush 3 . .Sh NOTES +The .Fn fclose +function does not handle NULL arguments; they will result in a segmentation violation. This is intentional - it makes it easier to make sure programs written diff --git a/lib/libc/stdio/fwide.3 b/lib/libc/stdio/fwide.3 index 983e9b7..6ff8d92 100644 --- a/lib/libc/stdio/fwide.3 +++ b/lib/libc/stdio/fwide.3 @@ -73,7 +73,9 @@ is zero, and .Fa stream is unchanged. .Sh RETURN VALUES +The .Fn fwide +function returns a value according to orientation after the call of .Fn fwide ; a value less than zero if byte-oriented, a value greater than zero diff --git a/lib/libc/stdio/mktemp.3 b/lib/libc/stdio/mktemp.3 index 06fe894..5c9de2e 100644 --- a/lib/libc/stdio/mktemp.3 +++ b/lib/libc/stdio/mktemp.3 @@ -94,7 +94,9 @@ function acts the same as except it permits a suffix to exist in the template. The template should be of the form .Pa /tmp/tmpXXXXXXsuffix . +The .Fn mkstemps +function is told the length of the suffix string. .Pp The diff --git a/lib/libc/stdio/printf.3 b/lib/libc/stdio/printf.3 index 3f8e640..f5848dd 100644 --- a/lib/libc/stdio/printf.3 +++ b/lib/libc/stdio/printf.3 @@ -74,9 +74,11 @@ The family of functions produces output according to a .Fa format as described below. -.Fn Printf +The +.Fn printf and .Fn vprintf +functions write output to .Dv stdout , the standard output stream; @@ -120,9 +122,11 @@ were unlimited (again, not including the final .Ql \e0 ) . .Pp -.Fn Asprintf +The +.Fn asprintf and .Fn vasprintf +functions set .Fa *ret to be a pointer to a buffer sufficiently large to hold the formatted string. @@ -139,9 +143,11 @@ to be a .Dv NULL pointer. .Pp -.Fn Snprintf +The +.Fn snprintf and .Fn vsnprintf +functions will write at most .Fa size Ns \-1 of the characters printed into the output string @@ -155,9 +161,11 @@ argument, the string was too short and some of the printed characters were discarded. The output is always null-terminated. .Pp -.Fn Sprintf +The +.Fn sprintf and .Fn vsprintf +functions effectively assume an infinite .Fa size . .Pp diff --git a/lib/libc/stdio/tmpnam.3 b/lib/libc/stdio/tmpnam.3 index 9f8c18d..fd22bea 100644 --- a/lib/libc/stdio/tmpnam.3 +++ b/lib/libc/stdio/tmpnam.3 @@ -132,7 +132,9 @@ if .Pf non- Dv NULL , is used to specify a file name prefix, which will be the first part of the created file name. -.Fn Tempnam +The +.Fn tempnam +function allocates memory in which to store the file name; the returned pointer may be used as a subsequent argument to .Xr free 3 . -- cgit v1.1