Module Name: src
Committed By: uwe
Date: Sat Jan 13 19:50:52 UTC 2018
Modified Files:
src/share/man/man4: wsdisplay.4
Log Message:
Try to improve markup.
To generate a diff of this commit:
cvs rdiff -u -r1.44 -r1.45 src/share/man/man4/wsdisplay.4
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/share/man/man4/wsdisplay.4
diff -u src/share/man/man4/wsdisplay.4:1.44 src/share/man/man4/wsdisplay.4:1.45
--- src/share/man/man4/wsdisplay.4:1.44 Sun Oct 25 23:00:00 2015
+++ src/share/man/man4/wsdisplay.4 Sat Jan 13 19:50:52 2018
@@ -1,4 +1,4 @@
-.\" $NetBSD: wsdisplay.4,v 1.44 2015/10/25 23:00:00 wiz Exp $
+.\" $NetBSD: wsdisplay.4,v 1.45 2018/01/13 19:50:52 uwe Exp $
.\"
.\" Copyright (c) 1999 Matthias Drochner.
.\" Copyright (c) 2002 Ben Harris.
@@ -78,7 +78,7 @@ In contrary, non-emulating displays can
like X servers.
.Pp
The
-.Em console
+.Cd console
locator in the configuration line refers to the device's use as the output
part of the operating system console.
A device specification containing a positive value here will only match if
@@ -91,7 +91,7 @@ instance.
display devices are usable as console.)
.Pp
The
-.Em kbdmux
+.Cd kbdmux
locator in the configuration line refers to the
.Xr wsmux 4
that will be used to get keyboard events.
@@ -99,8 +99,8 @@ If this locator is -1 no mux will be use
.Pp
The logical unit of an independent contents displayed on a display
(sometimes referred to as
-.Dq virtual terminal
-) is called a
+.Dq virtual terminal )
+is called a
.Dq screen
here.
If the underlying device driver supports it, multiple screens can
@@ -119,8 +119,11 @@ the keyboard input.
(In some cases \- if no screen is set up or if a screen
was just deleted \- it is possible that no focus is present at all.)
The focus can be switched by either special keyboard input (typically
-.Tn CTRL-ALT-F Ns Ar n, STOP-F Ns Ar n on Sun hardware, Command-F Ns Ar n
-on ADB keyboards )
+.Ao "Ctrl" Ac Ns \| Ns Ao "Alt" Ac Ns \| Ns Ao "F" Ns Ar "n" Ac ,
+.Ao "Stop" Ac Ns \| Ns Ao "F" Ns Ar "n" Ac
+on Sun hardware,
+.Ao "Command" Ac Ns \| Ns Ao "F" Ns Ar "n" Ac
+on ADB keyboards)
or an ioctl command issued by a user program.
Screens are created and deleted through the
.Pa /dev/ttyEcfg
@@ -143,7 +146,7 @@ Sets the border color at boot time.
Possible values are defined in
.Pa src/sys/dev/wscons/wsdisplayvar.h .
Defaults to
-.Sq WSCOL_BLACK .
+.Dv WSCOL_BLACK .
.It Cd options WSDISPLAY_CUSTOM_BORDER
Enables the
.Dv WSDISPLAYIO_GBORDER
@@ -170,9 +173,9 @@ utility is not wanted.
.It Cd options WSDISPLAY_SCROLLSUPPORT
Enables scrolling support.
The key combinations are
-.Ic LEFT SHIFT + PAGE UP
+.Ao "Left\ Shift" Ac Ns \| Ns Ao "Page\ Up" Ac
and
-.Ic LEFT SHIFT + PAGE DOWN
+.Ao "Left\ Shift" Ac Ns \| Ns Ao "Page\ Down" Ac
by default.
Please note that this function may not work under the system console and
is available depending on the framebuffer you are using.
@@ -242,7 +245,7 @@ and
.Va blue
members should each point to an array of
.Va count
-.Li u_char Ns s .
+.Vt u_char Ns No \^s .
On return, these will be filled in with the appropriate entries from the
color map.
On all displays that support this call, values range from 0 for minimum
@@ -364,7 +367,7 @@ This means that
and
.Va cmap . Ns Va blue
must each point to at least enough space to hold two
-.Li u_char Ns s .
+.Vt u_char Ns No \^s .
.It Dv WSDISPLAY_CURSOR_DOSHAPE
Get
.Va size , image ,
@@ -470,7 +473,7 @@ The
and
.Va kernel_attrs
variables are a combination of
-.Va WSATTR_*
+.Dv WSATTR_ Ns Ar *
bits, and specify the attributes used to draw messages.
The
.Va default_bg ,
@@ -483,7 +486,7 @@ variables specify the colors used to pri
for the background and
.Sq _fg
for the foreground; their values are one of all the
-.Va WSCOL_*
+.Dv WSCOL_ Ns Ar *
macros available.
.It Dv WSDISPLAYIO_SMSGATTRS Pq Li struct wsdisplay_msgattrs
Set the attributes (colors and flags) used to print console messages, including
@@ -523,9 +526,9 @@ and
are its colors and
.Va flags
is a combination of
-.Sq WSDISPLAY_CHAR_BRIGHT
+.Dv WSDISPLAY_CHAR_BRIGHT
and/or
-.Sq WSDISPLAY_CHAR_BLINK .
+.Dv WSDISPLAY_CHAR_BLINK .
.It Dv WSDISPLAYIO_PUTWSCHAR Pq Li struct wsdisplay_char
Puts a character on the screen.
The structure has the same meaning as described in
@@ -570,18 +573,15 @@ if (ioctl(fd, WSDISPLAYIO_SETVERSION, &v
.Ed
.El
.Sh FILES
-.Bl -item
-.It
-.Pa /dev/ttyE*
+.Bl -tag -width "/dev/ttyEstat" -compact
+.It Pa /dev/ttyE*
Terminal devices (per screen).
-.It
-.Pa /dev/ttyEcfg
+.It Pa /dev/ttyEcfg
Control device.
-.It
-.Pa /dev/ttyEstat
+.It Pa /dev/ttyEstat
Status device.
-.It
-.Pa /usr/include/dev/wscons/wsconsio.h
+.Pp
+.It Pa /usr/include/dev/wscons/wsconsio.h
.El
.Sh SEE ALSO
.Xr ioctl 2 ,
