[groff] 08/17: [ms]: Doc multi-column interaction w/ other feats.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 0476e85cc3a6d2157c6c7ac530916a3ed9c43200
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Jul 17 20:13:47 2022 -0500

    [ms]: Doc multi-column interaction w/ other feats.
    
    Document interation of multiple columns with other features.
    
    Also fix a terminology nit: a macro and its call are not the same thing.
---
 doc/groff.texi      | 10 ++++++----
 doc/ms.ms           | 11 ++++++++++-
 tmac/groff_ms.7.man | 11 ++++++++++-
 3 files changed, 26 insertions(+), 6 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 344f9109..e6e79683 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -3452,9 +3452,9 @@ immediately subsequent paragraph that must be kept on the 
same page as
 the heading.  If insufficient space remains on the current page to
 accommodate the heading and this number of lines of paragraph text, a
 page break is forced before the heading is printed.  Any display macro
-or @code{tbl}, @code{pic}, or @code{eqn} region between the heading and
-the subsequent paragraph suppresses this grouping.  @xref{ms keeps and
-displays} and @ref{ms Insertions}.
+call or @code{tbl}, @code{pic}, or @code{eqn} region between the heading
+and the subsequent paragraph suppresses this grouping.  @xref{ms keeps
+and displays} and @ref{ms Insertions}.
 
 @c ---------------------------------------------------------------------
 
@@ -4278,7 +4278,9 @@ margin.
 @file{ms} can set text in as many columns as reasonably fit on the page.
 The following macros force a page break if a multi-column layout is
 active when they are called.  The @code{MINGW} register stores the
-default minimum gutter width; it is a GNU extension.
+default minimum gutter width; it is a GNU extension.  When multiple
+columns are in use, keeps and the @code{HORPHANS} and @code{PORPHANS}
+registers work with respect to column breaks instead of page breaks.
 
 @Defmac {1C, , ms}
 Arrange page text in a single column (the default).
diff --git a/doc/ms.ms b/doc/ms.ms
index 68556021..e3a93a31 100644
--- a/doc/ms.ms
+++ b/doc/ms.ms
@@ -1442,7 +1442,7 @@ If insufficient space remains on the current page to 
accommodate the
 heading and this number of lines of paragraph text,
 a page break is forced before the heading is printed.
 .
-Any display macro or
+Any display macro call or
 .I tbl ,
 .I pic ,
 or
@@ -3243,6 +3243,15 @@ active when they are called.
 is the default minimum gutter width;
 it is a GNU extension.
 .
+When multiple columns are in use,
+keeps
+and the
+.CW \%HORPHANS
+and
+.CW \%PORPHANS
+registers
+work with respect to column breaks instead of page breaks.
+.
 .
 .TS
 box;
diff --git a/tmac/groff_ms.7.man b/tmac/groff_ms.7.man
index dc91b4de..58eecd89 100644
--- a/tmac/groff_ms.7.man
+++ b/tmac/groff_ms.7.man
@@ -995,7 +995,7 @@ If insufficient space remains on the current page to 
accommodate the
 heading and this number of lines of paragraph text,
 a page break is forced before the heading is printed.
 .
-Any display macro or
+Any display macro call or
 .IR tbl ,
 .IR pic ,
 or
@@ -1950,6 +1950,15 @@ active when they are called.
 is the default minimum gutter width;
 it is a GNU extension.
 .
+When multiple columns are in use,
+keeps
+and the
+.B \%HORPHANS
+and
+.B \%PORPHANS
+registers
+work with respect to column breaks instead of page breaks.
+.
 .
 .TP
 .B .1C