Module Name: src
Committed By: jruoho
Date: Mon Apr 11 05:59:11 UTC 2011
Modified Files:
src/lib/libc/gen: fmtmsg.3
Log Message:
Markup improvements.
To generate a diff of this commit:
cvs rdiff -u -r1.6 -r1.7 src/lib/libc/gen/fmtmsg.3
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/lib/libc/gen/fmtmsg.3
diff -u src/lib/libc/gen/fmtmsg.3:1.6 src/lib/libc/gen/fmtmsg.3:1.7
--- src/lib/libc/gen/fmtmsg.3:1.6 Wed Apr 30 13:10:50 2008
+++ src/lib/libc/gen/fmtmsg.3 Mon Apr 11 05:59:11 2011
@@ -1,4 +1,4 @@
-.\" $NetBSD: fmtmsg.3,v 1.6 2008/04/30 13:10:50 martin Exp $
+.\" $NetBSD: fmtmsg.3,v 1.7 2011/04/11 05:59:11 jruoho Exp $
.\"
.\" Copyright (c) 1999 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -27,7 +27,7 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd September 10, 1999
+.Dd April 11, 2011
.Dt FMTMSG 3
.Os
.Sh NAME
@@ -56,7 +56,7 @@
from the condition causing the message and where to display the message
is specified in
.Fa classification .
-.Ss classification
+.Ss Classification
The
.Fa classification
argument consists of a major classification and several sub-classifications.
@@ -65,8 +65,8 @@
may be specified for each (sub-)classification.
The following classifications
are available:
-.Bl -tag -width MessageXSourceXSub-classificationsXX
-.It Major Classifications
+.Bl -tag -width "XXX"
+.It Em Major classifications
The source of the condition.
Available identifiers are:
.Dv MM_HARD
@@ -75,7 +75,7 @@
(software), and
.Dv MM_FIRM
(firmware).
-.It Message Source Sub-classifications
+.It Em Message source sub-classifications
The type of software detecting the condition.
Available identifiers are:
.Dv MM_APPL
@@ -84,14 +84,14 @@
(utility), and
.Dv MM_OPSYS
(operating system).
-.It Display Sub-classifications
+.It Em Display sub-classifications
The displays the formatted messages is to be written to.
Available identifiers are:
.Dv MM_PRINT
(standard error stream) and
.Dv MM_CONSOLE
(system console).
-.It Status Sub-classifications
+.It Em Status sub-classifications
The capability of the calling software to recover from the condition.
Available identifiers are:
.Dv MM_RECOVER
@@ -105,7 +105,7 @@
is to be supplied,
.Dv MM_NULLMC
must be specified.
-.Ss label
+.Ss Label
The
.Fa label
argument identifies the source of the message.
@@ -117,12 +117,12 @@
is to be supplied,
.Dv MM_NULLLBL
must be specified.
-.Ss severity
+.Ss Severity
The seriousness of the condition causing the message.
The following
.Fa severity
levels are available:
-.Bl -tag -width MM_WARNINGXX
+.Bl -tag -width MM_WARNING -offset indent
.It Dv MM_HALT
The software has encountered a severe fault and is halting.
.It Dv MM_ERROR
@@ -138,7 +138,7 @@
level is to be supplied,
.Dv MM_NOSEV
must be specified.
-.Ss text
+.Ss Text
The description of the condition the software encountered.
The character
string is not limited to a specific size.
@@ -148,7 +148,7 @@
is to be supplied,
.Dv MM_NOTXT
must be specified.
-.Ss action
+.Ss Action
The first step to be taken to recover from the condition the software
encountered; it will be preceded by the prefix
.Dq TO FIX: .
@@ -159,7 +159,7 @@
is to be supplied,
.Dv MM_NOACT
must be specified.
-.Ss tag
+.Ss Tag
The on-line documentation which provides further information about the
condition and the message, such as
.Dq Xr fmtmsg 3 .
