[src/trunk]: src/share/man/man5 Improve mdoc, and correct the example of how ...

[wiz <wiz%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/7ff5495fca76
branches:  trunk
changeset: 532224:7ff5495fca76
user:      wiz <wiz%NetBSD.org@localhost>
date:      Sun Jun 02 19:07:25 2002 +0000

description:
Improve mdoc, and correct the example of how to create mixerctl.conf.

diffstat:

 share/man/man5/mixerctl.conf.5 |  24 +++++++++++++++---------
 1 files changed, 15 insertions(+), 9 deletions(-)

diffs (44 lines):

diff -r 88fe04233991 -r 7ff5495fca76 share/man/man5/mixerctl.conf.5
--- a/share/man/man5/mixerctl.conf.5    Sun Jun 02 19:06:02 2002 +0000
+++ b/share/man/man5/mixerctl.conf.5    Sun Jun 02 19:07:25 2002 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: mixerctl.conf.5,v 1.2 2002/06/02 19:05:09 jmcneill Exp $
+.\"    $NetBSD: mixerctl.conf.5,v 1.3 2002/06/02 19:07:25 wiz Exp $
 .\"
 .\" Copyright 2002 Jared D. McNeill <jmcneill%netbsd.org@localhost>
 .\" All rights reserved.
@@ -36,20 +36,26 @@
 .Sh DESCRIPTION
 The
 .Pa /etc/mixerctl.conf
-file consists of mixerctl(1) variables to set at boot time.
-.Pp
-To generate a mixerctl.conf from the current mixer settings, execute:
+file consists of
+.Xr mixerctl 1
+variables to set at boot time.
+Each line of
+.Nm
+has the following format:
+.Dl variable=value
 .Pp
-.Bl -tag -width "mixerctl -a >/etc/mixerctl.conf"
-.It Pa mixerctl.conf -a >/etc/mixerctl.conf
-.El
-.Pp
+To generate a
+.Nm
+from the current mixer settings, execute:
+.Dl Ic mixerctl -a \*[Gt] /etc/mixerctl.conf
 .Sh FILES
 .Bl -tag -width /etc/mixerctl.conf -compact
 .It Pa /etc/mixerctl.conf
 .El
 .Sh EXAMPLES
-Example mixer settings for an esa(4) audio adapter.
+Example mixer settings for an
+.Xr esa 4
+audio adapter:
 .Bd -literal
 outputs.master=255,255
 outputs.master.mute=off