docs/man/man1: Fix warnings from "groff" and some other formatting
PATCH 1/1 docs/man/man1: Fix warnings from "groff" and some other formatting
1) Remove space at end of lines
2) Fix some wrong fonts
3) Fix warnings from test-groff.
Output is from: test-groff -b -e -mandoc -T utf8 -rF0 -t -w w -z
[ "test-groff" is a developmental version of "groff" ]
Input file is ./dumpkeys.1.in
<dumpkeys.1.in>:218 (macro BI): only 1 argument, but more are expected
####
Input file is ./fgconsole.1
<fgconsole.1>:8 (macro BI): only 1 argument, but more are expected <fgconsole.1>:42 (macro IR): only 1 argument, but more are expected
####
Input file is ./loadkeys.1.in
<loadkeys.1.in>:220 (macro BI): only 1 argument, but more are expected <loadkeys.1.in>:224 (macro BI): only 1 argument, but more are expected
####
Input file is ./openvt.1
<openvt.1>:12 (macro BR): only 1 argument, but more are expected <openvt.1>:67 (macro BR): only 0 argument, but more are expected <openvt.1>:83 (macro BR): only 0 argument, but more are expected
####
Input file is ./psfxtable.1
<psfxtable.1>:34 (macro IR): only 1 argument, but more are expected
####
Input file is ./setleds.1
troff: <setleds.1>:63: warning: escape character ignored before '+'
troff: <setleds.1>:69: warning: escape character ignored before '+'
troff: <setleds.1>:75: warning: escape character ignored before '+'
####
Input file is ./unicode_start.1
<unicode_start.1>:38 (macro BR): only 1 argument, but more are expected
####
Input file is ./unicode_stop.1
<unicode_stop.1>:19 (macro BR): only 1 argument, but more are expected
####
--- docs/man/man1/dumpkeys.1.in | 4 ++-- docs/man/man1/fgconsole.1 | 18 +++++++++--------- docs/man/man1/loadkeys.1.in | 10 +++++----- docs/man/man1/openvt.1 | 15 ++++++--------- docs/man/man1/psfxtable.1 | 4 ++-- docs/man/man1/setleds.1 | 8 ++++---- docs/man/man1/unicode_start.1 | 4 ++-- docs/man/man1/unicode_stop.1 | 4 ++-- 8 files changed, 32 insertions(+), 35 deletions(-)
docs/man/man1/dumpkeys.1.in +2 -2
@@ -16,7 +16,7 @@ dumpkeys \- dump keyboard translation tables .B \-v \-\-verbose \-V \-\-version ] .SH DESCRIPTION -.IX "dumpkeys command" "" "\fLdumpkeys\fR command" +.IX "dumpkeys command" "" "\fLdumpkeys\fR command" .LP .B dumpkeys writes, to the standard output, the current contents of the keyboard
@@ -215,7 +215,7 @@ Prints version number and exits. .SH FILES .PD 0 .TP 20 -.BI @DATADIR@/keymaps +.I @DATADIR@/keymaps recommended directory for keytable files .PD .SH "SEE ALSO"
docs/man/man1/fgconsole.1 +9 -9
@@ -5,12 +5,12 @@ fgconsole \- print the number of the active VT. .SH SYNOPSIS .B fgconsole -.BI [ -\-h \-\-help +[ +.B \-h \-\-help | -\-V \-\-version +.B \-V \-\-version | -\-n \-\-next-available +.B \-n \-\-next-available ] .SH DESCRIPTION If the active Virtual Terminal is
@@ -19,8 +19,8 @@ then prints .I N on standard output. -If the console is a serial console, then -"serial" +If the console is a serial console, then +"serial" is printed instead. .TP .I \-h \-\-help
@@ -35,11 +35,11 @@ terminals are allocated, with number 7 used for X; this will return "8" in this case. .SH NOTES -Under +Under .IR devfs , -the consoles are in +the consoles are in .IR /dev/vc/N . -.IR devfsd +.I devfsd may maintain symlinks for compatibility. .SH "SEE ALSO" .BR chvt (1).
docs/man/man1/loadkeys.1.in +5 -5
@@ -37,7 +37,7 @@ loadkeys \- load keyboard translation tables ] .LP .SH DESCRIPTION -.IX "loadkeys command" "" "\fLloadkeys\fR command" +.IX "loadkeys command" "" "\fLloadkeys\fR command" .LP The program .B loadkeys
@@ -45,7 +45,7 @@ reads the file or files specified by .IR filename... . Its main purpose is to load the kernel keymap for the console. You can specify console device by the -.I -C +.I -C (or .I --console ) option.
@@ -131,7 +131,7 @@ in the keymap. The default bindings for the function keys are certain escape sequences mostly inspired by the VT100 terminal. .SH "CREATE KERNEL SOURCE TABLE" -If the +If the .I -m (or .I --mktable
@@ -217,11 +217,11 @@ outlive your session. This means that even at the login prompt the key bindings may not be what the user expects. .SH FILES .TP -.BI @DATADIR@/keymaps +.I @DATADIR@/keymaps default directory for keymaps .LP .TP -.BI /usr/src/linux/drivers/char/defkeymap.map +.I /usr/src/linux/drivers/char/defkeymap.map default kernel keymap .SH "SEE ALSO" .BR dumpkeys (1),
docs/man/man1/openvt.1 +6 -9
@@ -4,14 +4,14 @@ .SH NAME openvt \- start a program on a new virtual terminal (VT). .SH SYNOPSIS -.B openvt +.B openvt [\-c vtnumber] [OPTIONS] [\-\-] command .SH DESCRIPTION .B openvt -will find the first available VT, and run on it the given -.BR command -with the given -.BR "command options", +will find the first available VT, and run on it the given +.B command +with the given +.B "command options", standard input, output and error are directed to that terminal. The current search path ($PATH) is used to find the requested command. If no command is specified then the environment variable $SHELL is used.
@@ -55,7 +55,7 @@ print program version and exit; .I "\-h, \-\-help" show this text and exit. .TP -.I "\-\-" +.I "\-\-" end of options to .BR openvt . .SH NOTE
@@ -64,7 +64,6 @@ If is compiled with a getopt_long() and you wish to set options to the command to be run, then you must supply the end of options \-\- flag before the command. -.BR .SH EXAMPLES .B openvt can be used to start a shell on the next free VT, by using the command:
@@ -80,8 +79,6 @@ To start the shell as a login shell, use: To get a long listing you must supply the \-\- separator: .TP .I "openvt -- ls -l" -.BR - .SH HISTORY Earlier, .B openvt
docs/man/man1/psfxtable.1 +2 -2
@@ -14,7 +14,7 @@ psfxtable \- handle Unicode character tables for console fonts .IR outtable ] .RB [ \-nt ] .SH DESCRIPTION -.IX "psfxtable command" "" "\fLpsfxtable\fR command" +.IX "psfxtable command" "" "\fLpsfxtable\fR command" .LP .B psfxtable handles the embedded Unicode character table for .psf format
@@ -31,7 +31,7 @@ Each of the filenames .IR outfont , .IR intable , and -.IR outtable +.I outtable may be replaced by a single dash (\-), in which case standard input or standard output is used. If no \-i option is given, the font is read from standard input.
docs/man/man1/setleds.1 +4 -4
@@ -7,7 +7,7 @@ setleds \- set the keyboard leds .RI [ "-v" "] [" "-L" "] [" "-D" "] [" "-F" ] .RI [ {+|-}num "] [" {+|-}caps "] [" {+|-}scroll ] .SH DESCRIPTION -.IX "setleds command" "" "\fLsetleds\fR command" +.IX "setleds command" "" "\fLsetleds\fR command" .LP .B Setleds reports and changes the led flag settings of a VT
@@ -60,19 +60,19 @@ done .in -5m .SH OPTIONS .TP -\-num \+num +\-num +num Clear or set NumLock. (At present, the NumLock setting influences the interpretation of keypad keys. Pressing the NumLock key complements the NumLock setting.) .TP -\-caps \+caps +\-caps +caps Clear or set CapsLock. (At present, the CapsLock setting complements the Shift key when applied to letters. Pressing the CapsLock key complements the CapsLock setting.) .TP -\-scroll \+scroll +\-scroll +scroll Clear or set ScrollLock. (At present, pressing the ScrollLock key (or ^S/^Q) stops/starts console output.)
docs/man/man1/unicode_start.1 +2 -2
@@ -6,7 +6,7 @@ unicode_start \- put keyboard and console in unicode mode .B unicode_start .RI [ font " [" umap ]] .SH DESCRIPTION -.IX "unicode_start command" "" "\fLunicode_start\fR command" +.IX "unicode_start command" "" "\fLunicode_start\fR command" .LP The .B unicode_start
@@ -35,5 +35,5 @@ However, usually the font and keymap is common to all consoles. .BR kbd_mode (1), .BR loadkeys (1), .BR unicode_stop (1), -.BR utf-8(7), +.BR utf-8 (7), .BR setfont (8)
docs/man/man1/unicode_stop.1 +2 -2
@@ -5,7 +5,7 @@ unicode_stop \- revert keyboard and console from unicode mode .SH SYNOPSIS .B unicode_stop .SH DESCRIPTION -.IX "unicode_stop command" "" "\fLunicode_stop\fR command" +.IX "unicode_stop command" "" "\fLunicode_stop\fR command" .LP The .B unicode_stop
@@ -16,5 +16,5 @@ the console UTF-8 mode. .SH "SEE ALSO" .BR kbd_mode (1), .BR unicode_start (1), -.BR utf-8(7), +.BR utf-8 (7), .BR setfont (8)
Signature · 1 line
2.25.1