[ms]: Fix content nits in documentation.

* Explicitly tell the reader how to end section heading text.
* Describe the handling of display distance in more detail.

1 files changed, 9 insertions, 2 deletions

diff --git a/tmac/groff_ms.7.man b/tmac/groff_ms.7.man
index 1aa22b994..07832ddaf 100644
--- a/tmac/groff_ms.7.man
+++ b/tmac/groff_ms.7.man
@@ -834,6 +834,9 @@ Headings are available with and without automatic numbering.
 Text on input lines following the macro call becomes the heading's
 title.
 .
+Call a paragraphing macro to end the heading text and start the
+section's content.
+.
 .
 .TP
 .BR .NH \~[\c
@@ -1439,10 +1442,14 @@ End any display.
 .P
 The distance stored in
 .B \[rs]n[DD]
-is inserted before and after each pair of display macros,
-replacing any adjacent inter-paragraph distance;
+is inserted before and after each pair of display macros;
 this is a Berkeley extension.
 .
+In
+.IR "groff ms" ,
+this distance replaces any adjacent inter-paragraph distance
+or subsequent spacing prior to a section heading.
+.
 The
 .B DI
 register is a GNU extension;