[PATCH 21/23] man/infocmp.1m: Relocate material.

[G. Branden Robinson]

Describe the default mode of operation (given no operands) first.
Simply obtaining the terminal description seems like a more basic user
task than scrutiny of differences in terminal descriptions, the name of
this utility notwithstanding.
---
 man/infocmp.1m | 167 +++++++++++++++++++++++++------------------------
 1 file changed, 84 insertions(+), 83 deletions(-)

diff --git a/man/infocmp.1m b/man/infocmp.1m
index bf61d2ac1..50abe4845 100644
--- a/man/infocmp.1m
+++ b/man/infocmp.1m
@@ -135,89 +135,6 @@ .SS "Default Options"
 assumes the
 .B \-d
 option.
-.SS "Entry Comparison Options [-d] [-c] [-n]"
-Given
-.BR \-c ,
-.BR \-d ,
-or
-.BR \-n ,
-.B @INFOCMP@
-compares the
-.I \%term\%info
-description of the first specified
-.I terminal-type
-with those of each of the subsequent operands.
-If fewer
-.I terminal-types
-than required are specified,
-.B @INFOCMP@
-uses the environment variable
-.I TERM
-in their place.
-.PP
-If a capability is defined for only one terminal type,
-the value reported depends on the capability's type:
-.bP
-.B F
-for missing Boolean variables
-.bP
-\fBNULL\fP for missing integer or string variables
-.PP
-The
-.B \-c
-and
-.B \-d
-options report string capability values
-between \*(``\*'\*('' characters.
-Use the
-.B \-q
-option to distinguish
-.I absent
-and
-.I canceled
-capabilities;
-see \fB\%terminfo\fP(5).
-.PP
-The comparison option selects the form of report.
-.TP 5
-.B \-d
-lists each capability that
-.I differs
-between two entries.
-Each capability name is followed by \*(``:\*(''
-and comma-separated capability values,
-then a period.
-.TP
-.B \-c
-lists each capability that two entries have in
-.IR common "."
-.B @INFOCMP@
-ignores capabilities missing from either entry.
-Each capability name is followed by \*(``=\*('',
-a space,
-and the capability value,
-then a period.
-.IP
-If the
-.B \-u
-option is further specified,
-.B @INFOCMP@
-rewrites the description of the first type
-employing \*(``use=\*('' syntax
-to use the second as a building block.
-.TP
-.B \-n
-lists capabilities that are in
-.I none
-of the given entries.
-Each capability name is preceded by \*(``!\*(''
-and followed by a period.
-.IP
-Normally only conventional capabilities are shown.
-Use the
-.B \-x
-option to add BSD-compatibility capabilities
-(names prefixed with \*(``OT\*('').
 .SS "Source Listing Options [\-I] [\-L] [\-C] [\-r]"
 The \fB\-I\fP, \fB\-L\fP, and \fB\-C\fP options will produce
 a source listing for each terminal named.
@@ -304,6 +221,90 @@ .SS "Source Listing Options [\-I] [\-L] [\-C] [\-r]"
 .\" hpgeneric cup
 %p2\fR\|.\|.\|.\|\fP%p1        %r      hpgeneric
 .TE
+.SS "Entry Comparison Options [-d] [-c] [-n]"
+Given
+.BR \-c ,
+.BR \-d ,
+or
+.BR \-n ,
+.B @INFOCMP@
+compares the
+.I \%term\%info
+description of the first specified
+.I terminal-type
+with those of each of the subsequent operands.
+If fewer
+.I terminal-types
+than required are specified,
+.B @INFOCMP@
+uses the environment variable
+.I TERM
+in their place.
+.PP
+If a capability is defined for only one terminal type,
+the value reported depends on the capability's type:
+.bP
+.B F
+for missing Boolean variables
+.bP
+.B NULL
+for missing integer or string variables
+.PP
+The
+.B \-c
+and
+.B \-d
+options report string capability values
+between \*(``\*'\*('' characters.
+Use the
+.B \-q
+option to distinguish
+.I absent
+and
+.I canceled
+capabilities;
+see \fB\%terminfo\fP(5).
+.PP
+The comparison option selects the form of report.
+.TP 5
+.B \-d
+lists each capability that
+.I differs
+between two entries.
+Each capability name is followed by \*(``:\*(''
+and comma-separated capability values,
+then a period.
+.TP
+.B \-c
+lists each capability that two entries have in
+.IR common "."
+.B @INFOCMP@
+ignores capabilities missing from either entry.
+Each capability name is followed by \*(``=\*('',
+a space,
+and the capability value,
+then a period.
+.IP
+If the
+.B \-u
+option is further specified,
+.B @INFOCMP@
+rewrites the description of the first type
+employing \*(``use=\*('' syntax
+to use the second as a building block.
+.TP
+.B \-n
+lists capabilities that are in
+.I none
+of the given entries.
+Each capability name is preceded by \*(``!\*(''
+and followed by a period.
+.IP
+Normally only conventional capabilities are shown.
+Use the
+.B \-x
+option to add BSD-compatibility capabilities
+(names prefixed with \*(``OT\*('').
 .SS "Use= Option [\-u]"
 The \fB\-u\fP option produces a \fBterminfo\fP source description of the first
 terminal \fIterminal-type\fP which is relative to the sum of the
-- 
2.30.2

signature.asc
Description: PGP signature