[groff] 10/16: groff_mm(7): Relocate and recast `DF, `De`, `Df`.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 9541fdb680653d50976d58b09de47622a89bac33
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Oct 30 21:46:11 2022 -0500

    groff_mm(7): Relocate and recast `DF, `De`, `Df`.
    
    * Move discussion of `De` and `Df` registers to `Registers` section.
    * Use font alternation macros and output line continuation escape
      sequence rather than font selection escape sequences.
    * Tighten wording.
---
 contrib/mm/groff_mm.7.man | 132 +++++++++++++++++++++-------------------------
 1 file changed, 59 insertions(+), 73 deletions(-)

diff --git a/contrib/mm/groff_mm.7.man b/contrib/mm/groff_mm.7.man
index 3367c7d73..6c2287483 100644
--- a/contrib/mm/groff_mm.7.man
+++ b/contrib/mm/groff_mm.7.man
@@ -916,86 +916,30 @@ Ends a block of text or display that begins with
 or
 .BR DF .
 .
+.
 .TP
-.BI DF\  "\fR[\fPformat \fR[\fPfill \fR[\fPrindent\fR]]]\fP"
-Begin floating display (no nesting allowed).
+.BR DF\~ [\c
+.IR format \~[ fill \~[ rindent ]]]
+Begin floating display.
 .
 A floating display is saved in a queue and is printed in the order
 entered.
 .
-.IR Format ,
-.IR fill ,
+The arguments
+.I format,
+.I fill,
 and
 .I rindent
-are the same as in
+are handled as in
 .BR DS .
 .
-Floating displays are controlled by the registers
+Floating displays cannot be nested.
+.
+Floating display output is controlled by the registers
 .B De
 and
 .BR Df .
 .
-.IP
-.B De register
-.
-.RS
-.IP
-.TS
-tab(@);
-l lx.
-0@T{
-Nothing special, this is the default.
-T}
-1@T{
-A page eject occurs after each printed display,
-giving only one display per page and no text following it.
-T}
-.TE
-.RE
-.
-.IP
-.B Df register
-.
-.RS
-.IP
-.TS
-tab(@);
-l lx.
-0@T{
-Displays are printed at the end of each section
-(when section-page numbering is active)
-or at the end of the document.
-T}
-1@T{
-A new display is printed on the current page if there is enough space,
-otherwise it is printed at the end of the document.
-T}
-2@T{
-One display is printed at the top of each page
-(or column,
-in multi-column mode).
-T}
-3@T{
-Print one display if there is enough space for it,
-otherwise it is printed at the top of the next page or column.
-T}
-4@T{
-Print as many displays as possible in a new page or column.
-.
-A page break occurs between each display if
-.B De
-is not zero.
-T}
-5@T{
-Fill the current page with displays and the rest beginning at a new page
-or column.
-.
-(This is the default.)
-.
-A page break occurs between each display if \fBDe\fP is not zero.
-T}
-.TE
-.RE
 .
 .TP
 .BI DL\  \fR[\fPtext-indent\  "\fR[\fP\fB1\fP \fR[\fP\fB1\fP\fR]]]\fP"
@@ -4012,21 +3956,63 @@ A value of\~1 gives information about the progress of 
formatting.
 .
 Default is\~0.
 .
+.
 .TP
 .B De
-If set to\~1, eject after floating display is output.
+If\~1,
+eject page after a floating display is output.
 .
-Default is\~0.
+The default is\~0.
 .
 .
 .TP
 .B Df
-Control floating keep output.
+Configure the output of the floating keep macro
+.BR DF .
 .
-This is a number in the range 0 to 5, with a default value of\~5.
+The valid range is 0 to 5;
+the default is\~5.
+.
+.
+.RS
+.IP
+.TS
+tab(@);
+L Lx.
+0@T{
+Output displays at the end of each section
+when section-page numbering is active,
+or at the end of the document otherwise.
+T}
+1@T{
+Output a display on the current page if there is enough space,
+otherwise at the end of the document.
+T}
+2@T{
+Output one display at the top of each page or column.
+T}
+3@T{
+Output a display on the current page if there is enough space,
+otherwise at the top of the next page or column.
+T}
+4@T{
+Output as many displays as possible in a new page or column.
+.
+A page break occurs between each display if
+.B De
+is not zero.
+T}
+5@T{
+Fill the current page with displays and the rest beginning at a new page
+or column.
+.
+A page break occurs between each display if
+.B De
+is not zero.
+T}
+.TE
+.RE
 .
-See
-.BR .DF .
 .
 .TP
 .B Ds