summaryrefslogtreecommitdiffstats
path: root/share/man/man4/pcvt.4
diff options
context:
space:
mode:
authorsheldonh <sheldonh@FreeBSD.org>2000-03-01 14:50:24 +0000
committersheldonh <sheldonh@FreeBSD.org>2000-03-01 14:50:24 +0000
commitb45b9e3cde3c8b803fc2c4fbdb784fc378ced24d (patch)
tree0b7d3487005ae5a1da0062d675a3bf21249410eb /share/man/man4/pcvt.4
parent46cac19efdca36bb719c540488e5b984e7370eca (diff)
downloadFreeBSD-src-b45b9e3cde3c8b803fc2c4fbdb784fc378ced24d.zip
FreeBSD-src-b45b9e3cde3c8b803fc2c4fbdb784fc378ced24d.tar.gz
Remove single-space hard sentence breaks. These degrade the quality
of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
Diffstat (limited to 'share/man/man4/pcvt.4')
-rw-r--r--share/man/man4/pcvt.4105
1 files changed, 70 insertions, 35 deletions
diff --git a/share/man/man4/pcvt.4 b/share/man/man4/pcvt.4
index 038a8ee..89c5fc9 100644
--- a/share/man/man4/pcvt.4
+++ b/share/man/man4/pcvt.4
@@ -73,7 +73,8 @@ the probably most important is an emulation of a wide range
of DEC VT-220
.if t \(tm
.if n (TM)
-functionality. See
+functionality.
+See
.Sx Features
for a detailed description.
.Pp
@@ -213,23 +214,28 @@ release, you should define
The
.Nm pcvt
driver has been designed to be highly configurable in order to satisfy
-everyone's needs. The preferred way for those configurations is to
+everyone's needs.
+The preferred way for those configurations is to
provide appropriate
.Em options
lines within the config file, possibly overriding the built-in default
-values. Therefore it is possible to compile several distinct kernels
+values.
+Therefore it is possible to compile several distinct kernels
with different driver behaviour on a single machine.
The following list gives a short overview of the available configuration
-options. Refer to the file
+options.
+Refer to the file
.Pa i386/isa/pcvt/pcvt_hdr.h
in the kernel source tree for detailed documentation.
Note: the following conventions apply to all the Boolean options.
If an option is given with no value, a value of 1
.Pq activated
-is substituted. If an option value is given as 0, this options is
-deactivated. Any other value is substituted by 1, too. If an option
+is substituted.
+If an option value is given as 0, this options is
+deactivated. Any other value is substituted by 1, too.
+If an option
is omitted, a built-in default is assumed.
.Bl -tag -width indent -compact
@@ -241,7 +247,8 @@ Default: 8
.It Em PCVT_VT220KEYB
If activated, a keyboard layout resembling a DEC VT200 (TM) is generated.
-If deactivated, a mixture between VT220 and HP is used. See the files
+If deactivated, a mixture between VT220 and HP is used.
+See the files
.Pa Keyboard.VT
and
.Pa Keyboard.HP
@@ -257,7 +264,8 @@ Enables the builtin screensaver feature.
Default: on
.It Em PCVT_PRETTYSCRNS
-If enabled, a blinking-star screensaver is used. If disabled, the screen
+If enabled, a blinking-star screensaver is used.
+If disabled, the screen
is simply blanked
.Pq which might be useful for energy-saving monitors .
.br
@@ -293,7 +301,8 @@ utility.
Default: off
.It Em PCVT_EMU_MOUSE
-Emulate a three-button mouse via the keypad. Useful for notebooks when
+Emulate a three-button mouse via the keypad.
+Useful for notebooks when
running XFree86. See
.Sx Mouse emulation
below.
@@ -305,7 +314,8 @@ If enabled, a sequence composed of
.Aq Em esc ,
followed by the normal key code is emitted if a key is pressed with the
.Aq Em Alt
-key modifier. If disabled, then normal key code with the value
+key modifier.
+If disabled, then normal key code with the value
.Em 0x80
added is sent.
.br
@@ -314,7 +324,8 @@ Default: off
.El
Note that there are further options available which are mainly used for
-debugging purposes or as a workaround for hardware problems. They are
+debugging purposes or as a workaround for hardware problems.
+They are
found in
.Pa i386/isa/pcvt/pcvt_hdr.h
along with their documentation.
@@ -351,10 +362,12 @@ set current typematic value, similar to above command.
Symbolic values are available for the appropriate constants.
To specify the initial typematic delay time, they are
KBD_TPD250 for 250 ms through
-KBD_TPD1000 for 1000 ms, in steps of 250 ms. The typematic repeat
+KBD_TPD1000 for 1000 ms, in steps of 250 ms.
+The typematic repeat
rates are
KBD_TPM300, specifying 30.0 characters per second through
-KBD_TPM20 for 2.0 characters per second. The intermediate values
+KBD_TPM20 for 2.0 characters per second.
+The intermediate values
are: 30.0, 26.7, 24.0, 21.8, 20.0, 18.5, 17.1, 16.0, 15.0, 13.3,
12.0, 10.9, 10.0, 9.2, 8.6, 8.0, 7.5, 6.7, 6.0, 5.5, 5.0, 4.6, 4.3,
4.0, 3.7, 3.3, 3.0, 2.7, 2.5, 2.3, 2.1, 2.0 characters per second.
@@ -367,7 +380,8 @@ get key repetition switch, and
set key repetition switch
.El
-again take a pointer to int as argument. They manipulate the
+again take a pointer to int as argument.
+They manipulate the
drivers internal keyboard repetition flag, possible values are:
KBD_REPEATOFF or KBD_REPEATON.
@@ -411,9 +425,11 @@ set new key assignment values, and
get original key assignment values
.El
-arrange those functions. The take a pointer to a
+arrange those functions.
+The take a pointer to a
.Em struct kbd_ovlkey
-as argument as described below. In addition,
+as argument as described below.
+In addition,
.Bl -tag -width 20n -offset indent -compact
.It KBDRMKEY
@@ -493,23 +509,28 @@ key is bound to a function.
The mouse emulator
.Pq if configured in
-fakes a three-button mouse using the Mouse Systems protocol. The first
+fakes a three-button mouse using the Mouse Systems protocol.
+The first
.Nm pcvt
-device node not used by a virtual screen is the mouse device. I.\& e.,
+device node not used by a virtual screen is the mouse device.
+I.\& e.,
for the default value of 8 virtual screens,
.Pa /dev/ttyv0
through
.Pa /dev/ttyv7
would refer to the virtual screens, and
.Pa /dev/ttyv8
-were the mouse emulator device. The mouse emulation is turned on by
+were the mouse emulator device.
+The mouse emulation is turned on by
pressing the
.Aq Em NumLock
key. The pointer is moved by the numerical keypad keys, into the
-obvious directions. The pointer is initially moved in single steps,
+obvious directions.
+The pointer is initially moved in single steps,
and is accelerated after an adjustable time
.Pq default: 500 ms
-by about 6 times. The mouse buttons are emulated by three normal
+by about 6 times.
+The mouse buttons are emulated by three normal
keys, by default the function keys
.Aq Em \&F1 ,
.Aq Em \&F2 ,
@@ -517,9 +538,11 @@ and
.Aq Em \&F3 .
There are two selectable flavors available: normal and
.Dq sticky
-buttons. Normal buttons behave as expected.
+buttons.
+Normal buttons behave as expected.
.Dq Sticky
-buttons are notified as button-press on the first keypress. They
+buttons are notified as button-press on the first keypress.
+They
.Dq stick
until the key is pressed again
.Pq or another button-emulating key instead .
@@ -557,7 +580,8 @@ struct mousedefs {
.Em Downloadable character set interface
EGA and VGA video adaptors provide the capability of downloadable
-software fonts. Since the
+software fonts.
+Since the
.Sq native character set
of any IBM-compatible PC video board does not allow the full interpretation
of DEC multinational character set or ISO Latin-1
@@ -572,7 +596,8 @@ get font attr
.El
are used to manipulate the drivers information about a downloaded
-font. The take a pointer to a
+font.
+The take a pointer to a
.Em struct vgafontattr
as argument:
.Bd -literal
@@ -654,7 +679,8 @@ get screen info,
provide an interface to some general driver internal variables
which might modify the behaviour of the screens,
or which might simply be used to force the driver to switch
-to one certain screen. Their argument is a pointer to the structure:
+to one certain screen.
+Their argument is a pointer to the structure:
.Bd -literal
struct screeninfo {
int adaptor_type; /* type of video adaptor installed */
@@ -704,7 +730,8 @@ sets the number of columns for the current screen,
its parameter is a pointer to an integer containing either a value of 80,
or a value of 132. Note that setting the number of columns to 132 is
-only supported on VGA adaptors. Any unsupported numbers cause the ioctl
+only supported on VGA adaptors.
+Any unsupported numbers cause the ioctl
to fail with
.Em errno
.Pq see Xr intro 2
@@ -719,7 +746,8 @@ for each of the 256 internal color codes, each lying in the range of
0 through 63 (with 63 representing the brightest value for a base color).
Thus, these adaptors map each color code to a color of a
.Dq palette
-out of 262144 colors. The commands
+out of 262144 colors.
+The commands
.Bl -tag -width 20n -offset indent -compact
.It VGAREADPEL
@@ -728,7 +756,8 @@ read VGA palette entry, and
write VGA palette entry
.El
-establish an interface to these palette registers. Their argument is
+establish an interface to these palette registers.
+Their argument is
a pointer to:
.Bd -literal
struct vgapel {
@@ -794,7 +823,8 @@ struct pcvtinfo {
Depending on the configuration of a
.Nm pcvt
-driver, their might be a simple screen saver available. It is controlled
+driver, their might be a simple screen saver available.
+It is controlled
by the command
.Bl -tag -width 20n -offset indent -compact
@@ -802,7 +832,8 @@ by the command
set timeout for screen saver in seconds; 0 turns it off,
.El
-taking a pointer to an integer as argument. Despite of its command name,
+taking a pointer to an integer as argument.
+Despite of its command name,
this is available on
.Em any
kind of adaptor if configured in by the
@@ -815,13 +846,16 @@ option
Release 3.00 of this
.Nm pcvt
driver supports a subset of the USL-style commands used to control
-the virtual terminal interface. This feature is mainly intended to
+the virtual terminal interface.
+This feature is mainly intended to
allow
.Em XFree86 ,
release 2.0 or higher, to switch between virtual screens even when
-running an X server. They are ugly with respect to the implied semantics
+running an X server.
+They are ugly with respect to the implied semantics
.Pq i.\& e., they break Berkeley semantics
-and are therefore not recommended for common use. See the file
+and are therefore not recommended for common use.
+See the file
.Pa i386/include/pcvt_ioctl.h
for their documentation.
@@ -881,7 +915,8 @@ implementation
.Xr config 8 ,
.Xr ispcvt 8
.Sh BUGS
-Certainly existent. See the file
+Certainly existent.
+See the file
.Pa BugList
in the Documentation directory for an up-to-date list.
OpenPOWER on IntegriCloud