[src/trunk]: src/usr.sbin/wsconscfg Sort options. New sentence, new line.

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

details:   https://anonhg.NetBSD.org/src/rev/d8be28d9c65b
branches:  trunk
changeset: 582940:d8be28d9c65b
user:      wiz <wiz%NetBSD.org@localhost>
date:      Tue Jul 12 08:45:03 2005 +0000

description:
Sort options. New sentence, new line.

diffstat:

 usr.sbin/wsconscfg/wsconscfg.8 |  104 +++++++++++++++++++++++-----------------
 1 files changed, 60 insertions(+), 44 deletions(-)

diffs (174 lines):

diff -r cde5560b19b2 -r d8be28d9c65b usr.sbin/wsconscfg/wsconscfg.8
--- a/usr.sbin/wsconscfg/wsconscfg.8    Tue Jul 12 08:28:42 2005 +0000
+++ b/usr.sbin/wsconscfg/wsconscfg.8    Tue Jul 12 08:45:03 2005 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: wsconscfg.8,v 1.15 2005/07/10 17:57:28 christos Exp $
+.\"    $NetBSD: wsconscfg.8,v 1.16 2005/07/12 08:45:03 wiz Exp $
 .\"
 .\" Copyright (c) 1999
 .\"    Matthias Drochner.  All rights reserved.
@@ -32,55 +32,53 @@
 .Nd configure and switch between virtual terminals on a wscons display
 .Sh SYNOPSIS
 .Nm
+.Op Fl e Ar emul
 .Op Fl f Ar ctldev
 .Op Fl t Ar type
-.Op Fl e Ar emul
 .Ar index
 .Nm
-.Op Fl f Ar ctldev
 .Fl d
 .Op Fl F
+.Op Fl f Ar ctldev
 .Ar index
 .Nm
-.Op Fl f Ar ctldev
-.Fl s
-.Ar index
-.Nm
-.Op Fl f Ar ctldev
 .Fl k | m
 .Op Fl d
+.Op Fl f Ar ctldev
 .Op Ar index
+.Nm
+.Fl s
+.Op Fl f Ar ctldev
+.Ar index
 .Sh DESCRIPTION
 The
 .Nm
-tool allows to create, delete and switch between virtual terminals on display
-devices controlled by the wscons terminal framework if the underlying display
-hardware driver supports multiple screens. Further it controls the assignment
-of keyboards to displays.
+tool allows to create, delete and switch between virtual terminals
+on display devices controlled by the wscons terminal framework if
+the underlying display hardware driver supports multiple screens.
+Further it controls the assignment of keyboards to displays.
 The
 .Ar index
-argument specifies which virtual terminal is to be configured; the allowed
-numbers are from 0 to an implementation-specified value (currently 7, allowing
-for 8 virtual terminals on a display).
+argument specifies which virtual terminal is to be configured; the
+allowed numbers are from 0 to an implementation-specified value
+(currently 7, allowing for 8 virtual terminals on a display).
 In keyboard configuration mode, it specifies the
 .Xr wskbd 4
 device to attach or detach.
-Without further option arguments, a virtual terminal is created with
-implementation specific properties and a default terminal emulation variant
-selected at kernel compile time.
+Without further option arguments, a virtual terminal is created
+with implementation specific properties and a default terminal
+emulation variant selected at kernel compile time.
 .Pp
 The options are:
 .Bl -tag -width xxxxxxxxx
-.It Fl f Ar ctldev
-Specify the control device of the wscons display to operate on.
-Default is
-.Pa /dev/ttyEcfg .
 .It Fl d
-Delete the specified terminal. A terminal opened by a program will not be
-deleted unless the
+Delete the specified terminal.
+A terminal opened by a program will not be deleted unless the
 .Fl F
-option is applied. Terminals used by the operating system console or a
-graphics program (X server) cannot be deleted. With the
+option is applied.
+Terminals used by the operating system console or a graphics program
+(X server) cannot be deleted.
+With the
 .Fl k
 flag, the keyboard specified by
 .Ar index
@@ -90,28 +88,42 @@
 flag, the multiplexor specified by
 .Ar index
 will be detached from the wscons display.
+.It Fl e Ar emul
+Specify the terminal emulation to use for the virtual terminal.
+The set of available terminal emulations is determined at kernel
+compile time.
+See
+.Xr wscons 4
+for details.
 .It Fl F
-Force deleting of a terminal even if it is in use by a user space program.
+Force deleting of a terminal even if it is in use by a user space
+program.
+.It Fl f Ar ctldev
+Specify the control device of the wscons display to operate on.
+Default is
+.Pa /dev/ttyEcfg .
 .It Fl k
 Do keyboard related operations instead of virtual screen configuration.
-Without other flags, a keyboard will be attached to the display device. The
+Without other flags, a keyboard will be attached to the display
+device.
+The
 .Ar index
-argument can be omitted, in this case the first free keyboard will be used.
+argument can be omitted, in this case the first free keyboard will
+be used.
 .It Fl m
-Do multiplexor related operations instead of virtual screen configuration.
-Without other flags, a multiplexor will be attached to the display device.
+Do multiplexor related operations instead of virtual screen
+configuration.
+Without other flags, a multiplexor will be attached to the display
+device.
 .It Fl s
 Switch to the specified virtual terminal.
 .It Fl t Ar type
-Specify a screen type to use. Screen types refer to display format, colour
-depth and other low-level display properties. Valid
+Specify a screen type to use.
+Screen types refer to display format, colour depth and other
+low-level display properties.
+Valid
 .Ar type
 arguments are defined by the underlying display device driver.
-.It Fl e Ar emul
-Specify the terminal emulation to use for the virtual terminal. The set of
-available terminal emulations is determined at kernel compile time. See
-.Xr wscons 4
-for details.
 .El
 .Pp
 Typically, the
@@ -126,14 +138,17 @@
 .Sh EXAMPLES
 .Dl wsconscfg -t 80x50 -e vt100 1
 .Pp
-Configure screen 1 (i.e. the second), it will get the type
+Configure screen 1 (i.e., the second), it will get the type
 .Ql 80x50
-and use the VT100 terminal emulation. (Note:
+and use the VT100 terminal emulation.
+(Note:
 .Ql 80x50
 is a screen type offered by the
 .Xr vga 4
-display driver. In this particular case, an 8\(mu8-font must be loaded
-before to make the screen useful. See
+display driver.
+In this particular case, an 8\(mu8-font must be loaded before to
+make the screen useful.
+See
 .Xr wsfontload 8 . )
 .Pp
 .Dl wsconscfg -k
@@ -157,5 +172,6 @@
 .Xr wsconsctl 8 ,
 .Xr wsfontload 8
 .Sh BUGS
-There should be an easy way to get a list of the screen types available
-on a display, and of the emulations supported by the kernel.
+There should be an easy way to get a list of the screen types
+available on a display, and of the emulations supported by the
+kernel.