summaryrefslogtreecommitdiffstats
path: root/lib/libc/stdio
diff options
context:
space:
mode:
authorru <ru@FreeBSD.org>2002-12-18 12:45:11 +0000
committerru <ru@FreeBSD.org>2002-12-18 12:45:11 +0000
commit8746d263e1451855025dc83dde5176cc9f1fbe3f (patch)
treeee7f7ba4650cadf44410ca9a44676c72c96739b7 /lib/libc/stdio
parent160081aef68b0dc49b79d3b7702b75671d9c06ff (diff)
downloadFreeBSD-src-8746d263e1451855025dc83dde5176cc9f1fbe3f.zip
FreeBSD-src-8746d263e1451855025dc83dde5176cc9f1fbe3f.tar.gz
mdoc(7) police: "The .Fn function".
Diffstat (limited to 'lib/libc/stdio')
-rw-r--r--lib/libc/stdio/fclose.32
-rw-r--r--lib/libc/stdio/fwide.32
-rw-r--r--lib/libc/stdio/mktemp.32
-rw-r--r--lib/libc/stdio/printf.316
-rw-r--r--lib/libc/stdio/tmpnam.34
5 files changed, 21 insertions, 5 deletions
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 .
OpenPOWER on IntegriCloud