setterm: order man page items alphabetically

Signed-off-by: Jari Aalto <jari.aalto@cante.net>

1 files changed, 67 insertions, 85 deletions

diff --git a/term-utils/setterm.1 b/term-utils/setterm.1
index 3eac3485f..cde41143a 100644
--- a/term-utils/setterm.1
+++ b/term-utils/setterm.1
@@ -1,4 +1,4 @@
-.\" Copyright 1990 Gordon Irlam (gordoni@cs.ua.oz.au)
+\" Copyright 1990 Gordon Irlam (gordoni@cs.ua.oz.au)
 .\" Copyright 1992 Rickard E. Faith (faith@cs.unc.edu)
 .\" Most of this was copied from the source code.
 .\" Do not restrict distribution.
@@ -42,77 +42,47 @@ consoles, though the results of setting multiple modes (for example,
 .BR \-underline " and " \-half-bright )
 are hardware-dependent.
 .TP
-.BR \-term " terminal_name"
-Overrides the TERM environment variable.
-.TP
-.B \-reset
-Displays the terminal reset string, which typically resets the terminal to
-its power on state.
-.TP
-.B \-initialize
-Displays the terminal initialization string, which typically sets the
-terminal's rendering options, and other attributes to the default values.
-.TP
-.BR \-cursor " [" on | off ]
-Turns the terminal's cursor on or off.
-.TP
-.BR \-repeat " [" on | off "] (virtual consoles only)"
-Turns keyboard repeat on or off.
-.TP
 .BR \-appcursorkeys " [" on | off "] (virtual consoles only)"
 Sets Cursor Key Application Mode on or off. When on, ESC O A, ESC O B, etc.
 will be sent for the cursor keys instead of ESC [ A, ESC [ B, etc.  See the
 "vi and Cursor-Keys" section of the Text-Terminal-HOWTO for how this can
 cause problems for vi users.
 .TP
-.BR \-linewrap " [" on | off "] (virtual consoles only)"
-Turns automatic line-wrapping on or off.
-.TP
-.B \-default
-Sets the terminal's rendering options to the default values.
-.TP
-\fB\-foreground\fP \fI8-color\fP|\fBdefault\fP (virtual consoles only)
-Sets the foreground text color.
+.BR \-append " [\fI1-NR_CONS\fP]"
+Like \fB\-dump\fP, but appends to the snapshot file instead of overwriting
+it.  Only works if no \fB\-dump\fP options are given.
 .TP
 \fB\-background\fP \fI8-color\fP|\fBdefault\fP (virtual consoles only)
 Sets the background text color.
 .TP
-\fB\-ulcolor\fP \fI16-color\fP (virtual consoles only)
-Sets the color for underlined characters.
-.TP
-\fB\-hbcolor\fP \fI16-color\fP (virtual consoles only)
-Sets the color for half-bright characters.
-.TP
-.BR \-inversescreen " [" on | off "] (virtual consoles only)"
-Inverts the screen colors.  Foreground and background are swapped, as are
-underline and half-brightness.
+.BR \-blank " [\fI0-60\fP|\fBforce\fP|\fBpoke\fP] (virtual consoles only)"
+Sets the interval of inactivity, in minutes, after which the screen will be
+automatically blanked (using APM if available).  Without an argument, gets the
+blank status (returns which vt was blanked or zero for unblanked vt).
+
+The
+.B force
+option keeps screen blank even if a key is pressed.
+
+The
+.B poke
+option unblank the screen.
 .TP
-.BR \-bold " [" on | off ]
-Turns bold (extra bright) mode on or off.  Except at a virtual console,
-\fB\-bold off\fP turns off all attributes (bold, half-brightness, blink,
-reverse).
+.BR \-bfreq " [\fIfreqnumber\fP]"
+Sets the bell frequency in Hz.  Without an argument, defaults to 0.
 .TP
-.BR \-half-bright " [" on | off ]
-Turns dim (half-brightness) mode on or off (see \fB\-hbcolor\fP). Except at
-a virtual console, \fB\-half-bright off\fP turns off all attributes (bold,
-half-brightness, blink, reverse).
+.BR \-blength " [\fI0-2000\fP]"
+Sets the bell duration in milliseconds.  Without an argument, defaults to 0.
 .TP
 .BR \-blink " [" on | off ]
 Turns blink mode on or off.  Except at a virtual console, \fB\-blink off\fP
 turns off all attributes (bold, half-brightness, blink, reverse).
 .TP
-.BR \-reverse " [" on | off ]
-Turns reverse video mode on or off.  Except at a virtual console,
-\fB\-reverse off\fP turns off all attributes (bold, half-brightness, blink,
+.BR \-bold " [" on | off ]
+Turns bold (extra bright) mode on or off.  Except at a virtual console,
+\fB\-bold off\fP turns off all attributes (bold, half-brightness, blink,
 reverse).
 .TP
-.BR \-underline " [" on | off ]
-Turns underline mode on or off (see \fB\-ulcolor\fP).
-.TP
-.BR \-store " (virtual consoles only)"
-Stores the terminal's current rendering options (foreground and
-background colors) as the values to be used at reset-to-default.
-.TP
 .BR \-clear " [" all ]
 Clears the screen and "homes" the cursor, as
 .BR clear (1).
@@ -120,30 +90,15 @@ Clears the screen and "homes" the cursor, as
 .B \-clear rest
 Clears from the current cursor position to the end of the screen.
 .TP
-.BR \-tabs " [\fItab1 tab2 tab3\fP ...] (virtual consoles only)"
-Sets tab stops at the given horizontal cursor positions, in the range 1-160.
-Without arguments, shows the current tab stop settings.
-.TP
 .BR \-clrtabs " [\fItab1 tab2 tab3\fP ...] (virtual consoles only)"
 Clears tab stops from the given horizontal cursor positions, in the range
 1-160.  Without arguments, clears all tab stops.
 .TP
-.BR \-regtabs " [\fI1-160\fP] (virtual consoles only)"
-Clears all tab stops, then sets a regular tab stop pattern, with one tab
-every specified number of positions.  Without an argument, defaults to 8.
+.BR \-cursor " [" on | off ]
+Turns the terminal's cursor on or off.
 .TP
-.BR \-blank " [\fI0-60\fP|\fBforce\fP|\fBpoke\fP] (virtual consoles only)"
-Sets the interval of inactivity, in minutes, after which the screen will be
-automatically blanked (using APM if available).  Without an argument, gets the
-blank status (returns which vt was blanked or zero for unblanked vt).
-
-The
-.B force
-option keeps screen blank even if a key is pressed.
-
-The
-.B poke
-option unblank the screen.
+.B \-default
+Sets the terminal's rendering options to the default values.
 .TP
 .BR \-dump " [\fI1-NR_CONS\fP]"
 Writes a snapshot of the given virtual console (with attributes) to the file
@@ -173,29 +128,56 @@ will print all kernel messages.
 .BR klogd (8)
 may be a more convenient interface to the logging of kernel messages.
 .TP
+.BR \-powerdown " [\fI0-60\fP]"
+Sets the VESA powerdown interval in minutes.  Without an argument, defaults
+to 0 (disable powerdown).  If the console is blanked or the monitor is in
+suspend mode, then the monitor will go into vsync suspend mode or powerdown
+mode respectively after this period of time has elapsed.
+.TP
+.BR \-underline " [" on | off ]
+Turns underline mode on or off (see \fB\-ulcolor\fP).
+.TP
+.BR \-powersave " [" off "]"
+Turns off monitor VESA powersaving features.
+.TP
 .BR "\-powersave on" | vsync
 Puts the monitor into VESA vsync suspend mode.
 .TP
+.B \-powersave powerdown
+Puts the monitor into VESA powerdown mode.
+.TP
 .B \-powersave hsync
 Puts the monitor into VESA hsync suspend mode.
 .TP
-.B \-powersave powerdown
-Puts the monitor into VESA powerdown mode.
+.BR \-regtabs " [\fI1-160\fP] (virtual consoles only)"
+Clears all tab stops, then sets a regular tab stop pattern, with one tab
+every specified number of positions.  Without an argument, defaults to 8.
 .TP
-.BR \-powersave " [" off "]"
-Turns off monitor VESA powersaving features.
+.BR \-repeat " [" on | off "] (virtual consoles only)"
+Turns keyboard repeat on or off.
 .TP
-.BR \-powerdown " [\fI0-60\fP]"
-Sets the VESA powerdown interval in minutes.  Without an argument, defaults
-to 0 (disable powerdown).  If the console is blanked or the monitor is in
-suspend mode, then the monitor will go into vsync suspend mode or powerdown
-mode respectively after this period of time has elapsed.
+.B \-reset
+Displays the terminal reset string, which typically resets the terminal to
+its power on state.
 .TP
-.BR \-blength " [\fI0-2000\fP]"
-Sets the bell duration in milliseconds.  Without an argument, defaults to 0.
+.BR \-reverse " [" on | off ]
+Turns reverse video mode on or off.  Except at a virtual console,
+\fB\-reverse off\fP turns off all attributes (bold, half-brightness, blink,
+reverse).
 .TP
-.BR \-bfreq " [\fIfreqnumber\fP]"
-Sets the bell frequency in Hz.  Without an argument, defaults to 0.
+.BR \-store " (virtual consoles only)"
+Stores the terminal's current rendering options (foreground and
+background colors) as the values to be used at reset-to-default.
+.TP
+.BR \-tabs " [\fItab1 tab2 tab3\fP ...] (virtual consoles only)"
+Sets tab stops at the given horizontal cursor positions, in the range 1-160.
+Without arguments, shows the current tab stop settings.
+.TP
+.BR \-term " terminal_name"
+Overrides the TERM environment variable.
+.TP
+\fB\-ulcolor\fP \fI16-color\fP (virtual consoles only)
+Sets the color for underlined characters.
 .TP
 .BR \-version
 Output version information and exit.