]> git.ipfire.org Git - thirdparty/man-pages.git/blobdiff - man3/fpurge.3
man*/: srcfix (Use .P instead of .PP or .LP)
[thirdparty/man-pages.git] / man3 / fpurge.3
index 627ffa364d3f9b7b03a57e046b1bbf2c3f0cd1fe..8b928f5f37570ecce8e574e9a713f3fd33cc81b3 100644 (file)
@@ -1,42 +1,25 @@
+'\" t
 .\" Copyright (C) 2001 Andries Brouwer <aeb@cwi.nl>.
 .\"
-.\" %%%LICENSE_START(VERBATIM)
-.\" Permission is granted to make and distribute verbatim copies of this
-.\" manual provided the copyright notice and this permission notice are
-.\" preserved on all copies.
+.\" SPDX-License-Identifier: Linux-man-pages-copyleft
 .\"
-.\" Permission is granted to copy and distribute modified versions of this
-.\" manual under the conditions for verbatim copying, provided that the
-.\" entire resulting derived work is distributed under the terms of a
-.\" permission notice identical to this one.
-.\"
-.\" Since the Linux kernel and libraries are constantly changing, this
-.\" manual page may be incorrect or out-of-date.  The author(s) assume no
-.\" responsibility for errors or omissions, or for damages resulting from
-.\" the use of the information contained herein.  The author(s) may not
-.\" have taken the same level of care in the production of this manual,
-.\" which is licensed free of charge, as they might when working
-.\" professionally.
-.\"
-.\" Formatted or processed versions of this manual, if unaccompanied by
-.\" the source, must acknowledge the copyright and authors of this work.
-.\" %%%LICENSE_END
-.\"
-.TH FPURGE 3  2015-07-23 "" "Linux Programmer's Manual"
+.TH fpurge 3 (date) "Linux man-pages (unreleased)"
 .SH NAME
 fpurge, __fpurge \- purge a stream
+.SH LIBRARY
+Standard C library
+.RI ( libc ", " \-lc )
 .SH SYNOPSIS
 .nf
 /* unsupported */
 .B #include <stdio.h>
-.PP
+.P
 .BI "int fpurge(FILE *" stream );
-
+.P
 /* supported */
 .B #include <stdio.h>
-.br
 .B #include <stdio_ext.h>
-.PP
+.P
 .BI "void  __fpurge(FILE *" stream );
 .fi
 .SH DESCRIPTION
@@ -51,7 +34,7 @@ this includes any text pushed back via
 .BR ungetc (3).
 See also
 .BR fflush (3).
-.LP
+.P
 The function
 .BR __fpurge ()
 does precisely the same, but without returning a value.
@@ -61,7 +44,7 @@ Upon successful completion
 returns 0.
 On error, it returns \-1 and sets
 .I errno
-appropriately.
+to indicate the error.
 .SH ERRORS
 .TP
 .B EBADF
@@ -72,22 +55,25 @@ For an explanation of the terms used in this section, see
 .BR attributes (7).
 .TS
 allbox;
-lb lb lb
+lbx lb lb
 l l l.
 Interface      Attribute       Value
 T{
+.na
+.nh
 .BR __fpurge ()
 T}     Thread safety   MT-Safe race:stream
 .TE
-.sp 1
-.SH CONFORMING TO
-These functions are nonstandard and not portable.
-The function
+.SH STANDARDS
+None.
+.SH HISTORY
+.TP
 .BR fpurge ()
-was introduced in 4.4BSD and is not available under Linux.
-The function
+4.4BSD.
+Not available under Linux.
+.TP
 .BR __fpurge ()
-was introduced in Solaris, and is present in glibc 2.1.95 and later.
+Solaris, glibc 2.1.95.
 .SH NOTES
 Usually it is a mistake to want to discard input buffers.
 .SH SEE ALSO