[groff] 01/04: grotty.1.man: Rearrange material.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit c1859ca185bd25c06e1a48aa483a88e0708d2df6
Author: G. Branden Robinson <address@hidden>
Date:   Sun Jun 16 03:17:24 2019 +1000

    grotty.1.man: Rearrange material.
    
    Move text in preparation for further edits, and to sort items in
    Environment and Files sections lexicographically.
    
    Relocation only; no text changes were made.
---
 src/devices/grotty/grotty.1.man | 164 ++++++++++++++++++++--------------------
 1 file changed, 82 insertions(+), 82 deletions(-)

diff --git a/src/devices/grotty/grotty.1.man b/src/devices/grotty/grotty.1.man
index 1d9b5f8..d60ac7c 100644
--- a/src/devices/grotty/grotty.1.man
+++ b/src/devices/grotty/grotty.1.man
@@ -3,6 +3,11 @@
 grotty \- groff driver for typewriter-like devices
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr grotty_C \n[.C]
+.cp 0
+.
+.
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
@@ -25,11 +30,6 @@ grotty \- groff driver for typewriter-like devices
 .\" instead of in the original English.
 .
 .
-.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
-.do nr grotty_C \n[.C]
-.cp 0
-.
-.
 .\" ====================================================================
 .SH SYNOPSIS
 .\" ====================================================================
@@ -101,29 +101,6 @@ foreground and white for the background).
 .
 .
 .LP
-Use the
-.B \-c
-switch to revert to the old behaviour, printing a bold character
-.I c
-with the sequence
-.RI \[lq] c
-BACKSPACE
-.IR c \[rq]
-and an italic character
-.I c
-by the sequence
-.RB \[lq] _
-BACKSPACE
-.IR c \[rq].
-.
-At the same time, color output is disabled.
-.
-The same effect can be achieved by setting either the
-.I GROFF_NO_SGR
-environment variable or using the \[oq]sgr\[cq] X command (see below).
-.
-.
-.LP
 For SGR support, it is necessary to use the
 .B \-R
 option of
@@ -169,6 +146,29 @@ environment variable instead.
 .
 .
 .LP
+Use the
+.B \-c
+switch to revert to the old behaviour, printing a bold character
+.I c
+with the sequence
+.RI \[lq] c
+BACKSPACE
+.IR c \[rq]
+and an italic character
+.I c
+by the sequence
+.RB \[lq] _
+BACKSPACE
+.IR c \[rq].
+.
+At the same time, color output is disabled.
+.
+The same effect can be achieved by setting either the
+.I GROFF_NO_SGR
+environment variable or using the \[oq]sgr\[cq] X command (see below).
+.
+.
+.LP
 .BR grotty 's
 old output format can be displayed on a terminal
 by piping through
@@ -195,6 +195,40 @@ since
 never outputs reverse line feeds.
 .
 .
+.\" ====================================================================
+.SH USAGE
+.\" ====================================================================
+.
+.B grotty
+understands a single X command produced using the
+.B \[rs]X
+escape sequence.
+.
+.TP
+.BI \[rs]X'tty:\ sgr\  n '
+.
+If
+.I n
+is non-zero or missing, enable SGR output (this is the default),
+otherwise use the old drawing scheme for bold and underline.
+.
+.
+.LP
+If the
+.I DESC
+file contains the keyword
+.BR unicode ,
+.B grotty
+emits Unicode characters in UTF-8 encoding.
+.
+Otherwise, it emits characters in a single-byte encoding depending on
+the data in the font description files.
+.
+See the
+.BR groff_font (@MAN5EXT@)
+man page for more details.
+.
+.
 .LP
 The font description file may contain a command
 .
@@ -222,22 +256,6 @@ escape sequence in
 .BR troff .
 .
 .
-.LP
-If the
-.I DESC
-file contains the keyword
-.BR unicode ,
-.B grotty
-emits Unicode characters in UTF-8 encoding.
-.
-Otherwise, it emits characters in a single-byte encoding depending on
-the data in the font description files.
-.
-See the
-.BR groff_font (@MAN5EXT@)
-man page for more details.
-.
-.
 .\" ====================================================================
 .SH OPTIONS
 .\" ====================================================================
@@ -367,36 +385,10 @@ Print the version number.
 .
 .
 .\" ====================================================================
-.SH USAGE
-.\" ====================================================================
-.
-.B grotty
-understands a single X command produced using the
-.B \[rs]X
-escape sequence.
-.
-.TP
-.BI \[rs]X'tty:\ sgr\  n '
-.
-If
-.I n
-is non-zero or missing, enable SGR output (this is the default),
-otherwise use the old drawing scheme for bold and underline.
-.
-.
-.\" ====================================================================
 .SH ENVIRONMENT
 .\" ====================================================================
 .
 .TP
-.I GROFF_NO_SGR
-If set, the old drawing scheme for bold and underline (using the
-backspace character) is active.
-.
-Colors are disabled.
-.
-.
-.TP
 .I GROFF_FONT_PATH
 A list of directories in which to search for the
 .IR dev name
@@ -409,6 +401,14 @@ and
 for more details.
 .
 .
+.TP
+.I GROFF_NO_SGR
+If set, the old drawing scheme for bold and underline (using the
+backspace character) is active.
+.
+Colors are disabled.
+.
+.
 .\" ====================================================================
 .SH FILES
 .\" ====================================================================
@@ -428,45 +428,45 @@ of the
 device.
 .
 .TP
-.I @FONTDIR@/devlatin1/DESC
+.I @FONTDIR@/devcp1047/DESC
 Device description file for the
-.B latin1
+.B cp1047
 device.
 .
 .TP
-.IR @FONTDIR@/devlatin1/ F
+.IR @FONTDIR@/devcp1047/ F
 Font description file for font
 .I F
 of the
-.B latin1
+.B cp1047
 device.
 .
 .TP
-.I @FONTDIR@/devutf8/DESC
+.I @FONTDIR@/devlatin1/DESC
 Device description file for the
-.B utf8
+.B latin1
 device.
 .
 .TP
-.IR @FONTDIR@/devutf8/ F
+.IR @FONTDIR@/devlatin1/ F
 Font description file for font
 .I F
 of the
-.B utf8
+.B latin1
 device.
 .
 .TP
-.I @FONTDIR@/devcp1047/DESC
+.I @FONTDIR@/devutf8/DESC
 Device description file for the
-.B cp1047
+.B utf8
 device.
 .
 .TP
-.IR @FONTDIR@/devcp1047/ F
+.IR @FONTDIR@/devutf8/ F
 Font description file for font
 .I F
 of the
-.B cp1047
+.B utf8
 device.
 .
 .TP