Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 24 Oct 2001 11:31:18 +0200
From:      Sheldon Hearn <sheldonh@starjuice.net>
To:        Jonathan Lemon <jlemon@FreeBSD.org>
Cc:        cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org
Subject:   Re: cvs commit: src/sbin/conscontrol conscontrol.8 Makefile 
Message-ID:  <56510.1003915878@axl.seasidesoftware.co.za>
In-Reply-To: Your message of "Tue, 23 Oct 2001 15:13:34 MST." <200110232213.f9NMDYV02873@freefall.freebsd.org> 

next in thread | previous in thread | raw e-mail | index | archive | help


On Tue, 23 Oct 2001 15:13:34 MST, Jonathan Lemon wrote:

>   Modified files:
>     sbin/conscontrol     Makefile 
>   Added files:
>     sbin/conscontrol     conscontrol.8 
>   Log:
>   Add a manual page.

Excellent!

Please consider the attached patch, which fixes some mdoc stuff,
clarifies that console muting applies to all consoles and corrects the
HISTORY section.  The HISTORY section should be updated immediately
prior to MFC.

Ciao,
Sheldon.

Index: conscontrol.8
===================================================================
RCS file: /home/ncvs/src/sbin/conscontrol/conscontrol.8,v
retrieving revision 1.1
diff -u -d -r1.1 conscontrol.8
--- conscontrol.8	23 Oct 2001 22:13:34 -0000	1.1
+++ conscontrol.8	24 Oct 2001 09:28:56 -0000
@@ -33,31 +33,39 @@
 .Nd control physical console devices
 .Sh SYNOPSIS
 .Nm
-.Op list
+.Op Cm list
 .Nm 
-.Ic mute
-.Ar on|off
+.Cm mute on | off
 .Nm
-.Ic add|delete
+.Cm add | delete
 .Ar console
 .Sh DESCRIPTION
-.Nm Conscontrol
-is used to examine and modify the physical devices which back
+The
+.Nm
+utility is used to examine and modify the physical devices which back
 the virtual console console devices.
-If no arguments are specified
+If no arguments
 (or only the
-.Ar list
-argument),
+.Cm list
+command)
+are specified,
 the current console settings are shown.
 .Pp
 There are two types of logical consoles; a high level console which
-is represented by /dev/console, and a low level console.
-The low level console is used for kernel printfs and debugger support,
-while the high level console is used by user programs like syslog.
-Multiple device support is implemented only for the low level console,
+is represented by
+.Pa /dev/console , and a low level console.
+The low level console is used for kernel
+.Xr printf 9
+and
+.Xr ddb 4
+debugger support,
+while the high level console is used by user programs like
+.Xr syslogd 8 .
+Multiple device support is implemented only for the low level console;
 the high level console is set to the first device in the console list.
 .Pp
 Multiple console support may be invoked by passing the kernel the
+.\" XXX The Fl macro doesn't really apply here
 -D
 flag from the boot loader, or by using
 .Nm
@@ -65,23 +73,24 @@
 .Pp
 The following options are available:
 .Bl -tag -width indent
-.It Cm add|delete Ar console
+.It Cm add | delete Ar console
 Add or delete a physical device from the logical console.
 The device must support low-level console operations.
 Adding a device will place it at the front of the list of console
 devices; the first device is used for the high level console.
-.It Cm mute Ar on|off
-Change the state of the console muting.
+.It Cm mute Cm on | off
+Change the state of console muting.
+All console output is suppressed when console muting is on.
 .El
 .Sh SEE ALSO
-.Xr boot 8 ,
-.Xr loader 8 ,
 .Xr sio 4 ,
-.Xr syscons 4
+.Xr syscons 4 ,
+.Xr boot 8 ,
+.Xr loader 8
 .Sh HISTORY
 The
 .Nm
 command first appeared in
-.Fx 4.5 .
+.Fx 5.0 .
 .Sh AUTHORS
 .An Jonathan Lemon

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe cvs-all" in the body of the message




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?56510.1003915878>