Fix problems with formatting man pages

Reported-by: Helge Kreutzmann <debian@helgefjell.de>
Signed-off-by: Alexey Gladkov <gladkov.alexey@gmail.com>

14 files changed, 62 insertions, 36 deletions

diff --git a/docs/man/man1/dumpkeys.1.in b/docs/man/man1/dumpkeys.1.in
index 7dcce71b..62b780f6 100644
--- a/docs/man/man1/dumpkeys.1.in
+++ b/docs/man/man1/dumpkeys.1.in
@@ -213,11 +213,10 @@ loadkeys how to interpret the keymap. (For example, "division" is
 Prints version number and exits.
 .LP
 .SH FILES
-.PD 0
-.TP 20
+.TP
 .I @DATADIR@/keymaps
-recommended directory for keytable files
-.PD
+The recommended directory for keytable files.
+.LP
 .SH "SEE ALSO"
 .BR loadkeys (1),
 .BR keymaps (5)
diff --git a/docs/man/man1/kbd_mode.1 b/docs/man/man1/kbd_mode.1
index f605c02a..947c3a54 100644
--- a/docs/man/man1/kbd_mode.1
+++ b/docs/man/man1/kbd_mode.1
@@ -31,7 +31,8 @@ Of course the "\-a" is only traditional, and the code used can be any
 8-bit character set.  With "\-u" a 16-bit character set is expected,
 and these chars are transmitted to the kernel as 1, 2, or 3 bytes
 (following the UTF-8 coding).
-In these latter two modes the key mapping defined by loadkeys(1)
+In these latter two modes the key mapping defined by
+.BR loadkeys (1)
 is used.
 
 kbd_mode operates on the console specified by the "\-C" option; if there
diff --git a/docs/man/man1/loadkeys.1.in b/docs/man/man1/loadkeys.1.in
index b5bb7e56..3688f80d 100644
--- a/docs/man/man1/loadkeys.1.in
+++ b/docs/man/man1/loadkeys.1.in
@@ -218,11 +218,12 @@ bindings may not be what the user expects.
 .SH FILES
 .TP
 .I @DATADIR@/keymaps
-default directory for keymaps
+default directory for keymaps.
 .LP
 .TP
 .I /usr/src/linux/drivers/char/defkeymap.map
-default kernel keymap
+default kernel keymap.
+.LP
 .SH "SEE ALSO"
 .BR dumpkeys (1),
 .BR keymaps (5)
diff --git a/docs/man/man1/openvt.1 b/docs/man/man1/openvt.1
index 6817e1b0..2a65816e 100644
--- a/docs/man/man1/openvt.1
+++ b/docs/man/man1/openvt.1
@@ -84,7 +84,7 @@ Earlier,
 .B openvt
 was called
 .BR open .
-It was written by Jon Tombs <jon@gtex02.us.es or jon@robots.ox.ac.uk>.
+It was written by Jon Tombs <jon@gtex02.us.es> or <jon@robots.ox.ac.uk>.
 The \fI\-w\fR idea is from "sam".
 
 .SH "SEE ALSO"
diff --git a/docs/man/man1misc/screendump.1 b/docs/man/man1misc/screendump.1
index c2b20167..018bd345 100644
--- a/docs/man/man1misc/screendump.1
+++ b/docs/man/man1misc/screendump.1
@@ -48,7 +48,7 @@ permissions, or run
 as root.
 
 .SH SEE ALSO
-setterm(1)
+.BR setterm (1)
 
 .\" .SH AUTHORS
 .\" Andries Brouwer <aeb@cwi.nl>
diff --git a/docs/man/man1misc/splitfont.1 b/docs/man/man1misc/splitfont.1
index 60e1b1dd..88af0592 100644
--- a/docs/man/man1misc/splitfont.1
+++ b/docs/man/man1misc/splitfont.1
@@ -25,4 +25,4 @@ The character range is of the form
 .RE
 
 .SH "SEE ALSO"
-setfont(8).
+.BR setfont (8)
diff --git a/docs/man/man5/keymaps.5 b/docs/man/man5/keymaps.5
index 82d5903f..4800843f 100644
--- a/docs/man/man5/keymaps.5
+++ b/docs/man/man5/keymaps.5
@@ -77,7 +77,9 @@ Each of the
 represent keyboard actions, of which up to 256 can be bound to a single
 key. The actions available include outputting character codes or
 character sequences, switching consoles or keymaps, booting the machine
-etc. (The complete list can be obtained from dumpkeys(1) by saying
+etc. (The complete list can be obtained from
+.BR dumpkeys (1)
+by saying
 .B " dumpkeys -l"
 \&.)
 .LP
diff --git a/docs/man/man8/getkeycodes.8 b/docs/man/man8/getkeycodes.8
index bb816c65..758a494b 100644
--- a/docs/man/man8/getkeycodes.8
+++ b/docs/man/man8/getkeycodes.8
@@ -11,6 +11,6 @@ command prints the kernel scancode-to-keycode mapping table.
 .SH OPTIONS
 None.
 .SH "SEE ALSO"
-.I "setkeycodes (8)"
+.BR setkeycodes (8)
 
 
diff --git a/docs/man/man8/loadunimap.8.in b/docs/man/man8/loadunimap.8.in
index eb5658f0..10096c9c 100644
--- a/docs/man/man8/loadunimap.8.in
+++ b/docs/man/man8/loadunimap.8.in
@@ -16,7 +16,8 @@ loadunimap \- load the kernel unicode-to-font mapping table
 .SH DESCRIPTION
 The
 .B loadunimap
-command is obsolete - its function is now built-in into setfont.
+command is obsolete - its function is now built-in into
+.BR setfont (8).
 However, for backwards compatibility it is still available
 as a separate command.
 .LP
@@ -25,7 +26,7 @@ The program
 loads the specified map in the kernel unicode-to-font mapping table.
 If no map is given
 .I def
-is assumed.
+mapping table is assumed.
 The default extension (that can be omitted) is
 .IR .uni .
 .LP
@@ -41,10 +42,16 @@ option.
 Usually one does not call
 .B loadunimap
 directly - its function is also built into
-.BR setfont .
+.BR setfont (8).
 .SH FILES
+.TP
 .I @DATADIR@/unimaps
-is the default directory for unicode mappings.
+The default directory for unicode mappings.
+.LP
+.TP
+.I @DATADIR@/unimaps/def.uni
+The default mapping file.
+.LP
 .SH "SEE ALSO"
 .BR mapscrn (8),
 .BR setfont (8)
diff --git a/docs/man/man8/mapscrn.8.in b/docs/man/man8/mapscrn.8.in
index 56c6aad9..b9668133 100644
--- a/docs/man/man8/mapscrn.8.in
+++ b/docs/man/man8/mapscrn.8.in
@@ -104,8 +104,10 @@ Prints version number and exits.
 .B \-v
 Be verbose.
 .SH FILES
+.TP
 .I @DATADIR@/consoletrans
-is the default directory for screen mappings.
+The default directory for screen mappings.
+.LP
 .SH "SEE ALSO"
 .IR setfont (8)
 .SH AUTHOR
diff --git a/docs/man/man8/setfont.8.in b/docs/man/man8/setfont.8.in
index 8d22c7bf..b9ae148b 100644
--- a/docs/man/man8/setfont.8.in
+++ b/docs/man/man8/setfont.8.in
@@ -242,12 +242,18 @@ glyphs in the font. So, if the font has more than 256 glyphs,
 the console will be reduced to 8 (instead of 16) colors.
 
 .SH FILES
+.TP
 .I @DATADIR@/consolefonts
-is the default font directory.
+The default font directory.
+.LP
+.TP
 .I @DATADIR@/unimaps
-is the default directory for Unicode maps.
+The default directory for Unicode maps.
+.LP
+.TP
 .I @DATADIR@/consoletrans
-is the default directory for screen mappings.
+The default directory for screen mappings.
+.LP
 The default font is a file
 .I default
 (or
diff --git a/docs/man/man8/setkeycodes.8 b/docs/man/man8/setkeycodes.8
index 8cad1626..c78baef7 100644
--- a/docs/man/man8/setkeycodes.8
+++ b/docs/man/man8/setkeycodes.8
@@ -20,8 +20,9 @@ recognize.
 .SH THEORY
 The usual PC keyboard produces a series of scancodes for each
 key press and key release. (Scancodes are shown by
-\fBshowkey \-s\fP, see showkey(1).)
-The kernel parses this stream of scancodes, and converts it to
+\fBshowkey \-s\fP, see
+.BR showkey (1)
+) The kernel parses this stream of scancodes, and converts it to
 a stream of keycodes (key press/release events).
 (Keycodes are shown by \fBshowkey\fP.)
 Apart from a few scancodes with special meaning, and apart from
@@ -32,12 +33,15 @@ scancodes xx (7 bits) and escaped scancodes e0 xx (8+7 bits).
 To these scancodes or scancode pairs, a corresponding keycode can be
 assigned (in the range 1-127).
 For example, if you have a Macro key that produces e0 6f according
-to showkey(1), the command
+to
+.BR showkey (1),
+the command
 .RS
 .B "setkeycodes e06f 112"
 .RE
-will assign the keycode 112 to it, and then loadkeys(1) can be used
-to define the function of this key.
+will assign the keycode 112 to it, and then
+.BR loadkeys (1)
+can be used to define the function of this key.
 .LP
 Some older kernels might hardwire a low scancode range to the
 equivalent keycodes; setkeycodes will fail when you try to remap
@@ -57,6 +61,7 @@ None.
 The keycodes of X have nothing to do with those of Linux.
 Unusual keys can be made visible under Linux, but not under X.
 .SH "SEE ALSO"
-.I "dumpkeys (1), loadkeys (1), showkey (1), getkeycodes (8)"
-
-
+.BR dumpkeys (1),
+.BR loadkeys (1),
+.BR showkey (1),
+.BR getkeycodes (8)
diff --git a/docs/man/man8/showconsolefont.8 b/docs/man/man8/showconsolefont.8
index 2e93d23a..a100bdd6 100644
--- a/docs/man/man8/showconsolefont.8
+++ b/docs/man/man8/showconsolefont.8
@@ -19,13 +19,16 @@ showconsolefont \- Show the current EGA/VGA console screen font
 .SH DESCRIPTION
 The
 .B showconsolefont
-command outputs the current console font to stdout.
-The option \-v prints additional information, while
-the option \-V prints the program version number.
-The option \-i doesn't print out the font table,
-just shows ROWSxCOLSxCOUNT and exits.
-On Linux 2.6.1 and later, the option \-C allows one
-to indicate the console involved. Its argument is a pathname.
+command outputs the current console font to stdout. The option
+.B \-v
+prints additional information, while the option
+.B \-V
+prints the program version number. The option
+.B \-i
+doesn't print out the font table, just shows ROWSxCOLSxCOUNT and exits.
+On Linux 2.6.1 and later, the option
+.B \-C
+allows one to indicate the console involved. Its argument is a pathname.
 
 .SH "SEE ALSO"
 .BR setfont (8)
diff --git a/docs/man/man8misc/setlogcons.8 b/docs/man/man8misc/setlogcons.8
index 92dc67be..c7ea4a1c 100644
--- a/docs/man/man8misc/setlogcons.8
+++ b/docs/man/man8misc/setlogcons.8
@@ -23,4 +23,4 @@ was originally written by Andries Brouwer for the kbd package.
 .P
 This manual page was written by Alastair McKinstry.
 .SH "SEE ALSO"
-dmesg(1)
+.BR dmesg (1)