gbranden pushed a commit to branch master
in repository groff.
commit 11f05ea25c8c4ed74145d17a5583961546db3c61
Author: G. Branden Robinson <[email protected]>
AuthorDate: Mon Jul 20 23:37:18 2026 -0500
[ms]: Resync doc of `[HP]ORPHANS` registers.
Also break Texinfo input lines in convenient places for roffing and
diffing.
---
doc/groff.texi.in | 21 +++++++++++----------
doc/ms.ms.in | 10 +++++-----
tmac/groff_ms.7.man | 10 +++++-----
3 files changed, 21 insertions(+), 20 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index d5e6e62b9..67fa714b7 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -3582,11 +3582,13 @@ Default: 5@dmn{n}.
@endDefmpreg
@Defmpreg {PORPHANS, ms}
-Defines the minimum number of initial lines of any paragraph that must
-be kept together to avoid isolated lines at the bottom of a page. If a
-new paragraph is started close to the bottom of a page,
+Defines the minimum number of initial lines of any paragraph
+that must be kept together
+to avoid isolated lines at the bottom of a page.
+If a new paragraph starts close to the bottom of a page,
and there is insufficient space to accommodate
@code{PORPHANS}
+lines before an automatic page break,
@code{groff} @file{ms}
forces a page break before formatting the paragraph.
This is a GNU extension.
@@ -3624,13 +3626,12 @@ Default: 0.
@endDefmpreg
@Defmpreg {HORPHANS, ms}
-Defines the minimum number of lines of an immediately succeeding
-paragraph that should be kept together with any heading introduced by
-the @code{NH} or @code{SH} macros. If a heading is placed close to the
-bottom of a page, and there is insufficient space to accommodate both
-the heading and at least @code{HORPHANS} lines of the following
-paragraph, before an automatic page break, then the page break is forced
-before the heading. This is a GNU extension.
+Defines the minimum number of lines of the subsequent paragraph
+that must be kept on the same page as a section heading.
+If insufficient space remains on the current page
+to accommodate the heading and this number of lines of paragraph text,
+@code{groff} @file{ms}
+forces a page break before setting the heading.
Effective: next paragraph.
diff --git a/doc/ms.ms.in b/doc/ms.ms.in
index 924ac2df7..9fc59c55c 100644
--- a/doc/ms.ms.in
+++ b/doc/ms.ms.in
@@ -1168,8 +1168,8 @@ vee.
The
.CW PORPHANS
register defines the minimum number of initial lines of any paragraph
-that must be kept together to avoid isolated lines at the bottom of a
-page.
+that must be kept together
+to avoid isolated lines at the bottom of a page.
.
If a new paragraph starts close to the bottom of a page,
and there is insufficient space to accommodate
@@ -1654,10 +1654,10 @@ macros consult the
register to prevent the output of isolated headings at the bottom of a
page;
it specifies the minimum number of lines of the subsequent paragraph
-that must be kept on the same page as the heading.
+that must be kept on the same page as a section heading.
.
-If insufficient space remains on the current page to accommodate the
-heading and this number of lines of paragraph text,
+If insufficient space remains on the current page
+to accommodate the heading and this number of lines of paragraph text,
.I "groff ms"
forces a page break before setting the heading.
.
diff --git a/tmac/groff_ms.7.man b/tmac/groff_ms.7.man
index 1d00a8ae0..f592f6d94 100644
--- a/tmac/groff_ms.7.man
+++ b/tmac/groff_ms.7.man
@@ -745,8 +745,8 @@ or adjacent to displays.
The
.B PORPHANS
register defines the minimum number of initial lines of any paragraph
-that must be kept together to avoid isolated lines at the bottom of a
-page.
+that must be kept together
+to avoid isolated lines at the bottom of a page.
.
If a new paragraph starts close to the bottom of a page,
and there is insufficient space to accommodate
@@ -1072,10 +1072,10 @@ macros consult the
register to prevent the output of isolated headings at the bottom of a
page;
it specifies the minimum number of lines of the subsequent paragraph
-that must be kept on the same page as the heading.
+that must be kept on the same page as a section heading.
.
-If insufficient space remains on the current page to accommodate the
-heading and this number of lines of paragraph text,
+If insufficient space remains on the current page
+to accommodate the heading and this number of lines of paragraph text,
.I "groff ms"
forces a page break before setting the heading.
.
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
