Print this page
11622 clean up rarer mandoc lint warnings
@@ -5,20 +5,17 @@
.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
.TH PFMT 3C "Dec 29, 1996"
.SH NAME
pfmt \- display error message in standard format
.SH SYNOPSIS
-.LP
.nf
#include <pfmt.h>
\fBint\fR \fBpfmt\fR(\fBFILE *\fR\fIstream\fR, \fBlong\fR \fIflags\fR, \fBchar *\fR\fIformat\fR, \fB\&... /*\fR \fIarg */\fR);
.fi
.SH DESCRIPTION
-.sp
-.LP
The \fBpfmt()\fR retrieves a format string from a locale-specific message
database (unless \fBMM_NOGET\fR is specified) and uses it for \fBprintf\fR(3C)
style formatting of \fIargs\fR. The output is displayed on \fIstream\fR.
.sp
.LP
@@ -189,12 +186,10 @@
Specify an action message. Any severity value is superseded and replaced by a
localized version of \fBTO FIX\fR.
.RE
.SH STANDARD ERROR MESSAGE FORMAT
-.sp
-.LP
The \fBpfmt()\fR function displays error messages in the following format:
.sp
.in +2
.nf
\fIlabel\fR: \fIseverity\fR: \fItext\fR
@@ -221,21 +216,11 @@
.nf
\fIlabel\fR: \fIseverity\fR: \fItext\fR\fIlabel\fR: TO FIX: \fItext\fR
.fi
.in -2
-.br
-.in +2
-
-.in -2
-.br
-.in +2
-
-.in -2
.SH RETURN VALUES
-.sp
-.LP
Upon success, \fBpfmt()\fR returns the number of bytes transmitted. Upon
failure, it returns a negative value:
.sp
.ne 2
.na
@@ -244,11 +229,10 @@
.RS 9n
Write error to \fIstream\fR.
.RE
.SH EXAMPLES
-.LP
\fBExample 1 \fRExample of \fBpfmt()\fR function.
.sp
.LP
Example 1:
@@ -290,16 +274,12 @@
UX:test: TO FIX: Usage ...
.fi
.in -2
.SH USAGE
-.sp
-.LP
Since it uses \fBgettxt\fR(3C), \fBpfmt()\fR should not be used.
.SH ATTRIBUTES
-.sp
-.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp
.sp
.TS
@@ -310,10 +290,8 @@
_
MT-Level MT-safe
.TE
.SH SEE ALSO
-.sp
-.LP
\fBaddsev\fR(3C), \fBgettxt\fR(3C), \fBlfmt\fR(3C), \fBprintf\fR(3C),
\fBsetcat\fR(3C), \fBsetlabel\fR(3C), \fBsetlocale\fR(3C), \fBattributes\fR(5),
\fBenviron\fR(5)