Print this page
11622 clean up rarer mandoc lint warnings
*** 5,24 ****
.\" 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
--- 5,21 ----
*** 189,200 ****
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
--- 186,195 ----
*** 221,241 ****
.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
--- 216,226 ----
*** 244,254 ****
.RS 9n
Write error to \fIstream\fR.
.RE
.SH EXAMPLES
- .LP
\fBExample 1 \fRExample of \fBpfmt()\fR function.
.sp
.LP
Example 1:
--- 229,238 ----
*** 290,305 ****
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
--- 274,285 ----
*** 310,319 ****
_
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)
--- 290,297 ----