diff options
author | G. Branden Robinson <g.branden.robinson@gmail.com> | 2023-05-14 01:32:03 -0500 |
---|---|---|
committer | G. Branden Robinson <g.branden.robinson@gmail.com> | 2023-05-14 23:58:10 -0500 |
commit | 1c39f5d80d047969a4a8b52ab3284ccfed0f88bb (patch) | |
tree | d934f60c4577dcfefa3af02d2eff0250de93dc4b /doc/groff.texi | |
parent | 3024b328cdb08d111e23d064b3d2f68e7576ae05 (diff) | |
download | groff-git-1c39f5d80d047969a4a8b52ab3284ccfed0f88bb.tar.gz |
[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.
Diffstat (limited to 'doc/groff.texi')
-rw-r--r-- | doc/groff.texi | 19 |
1 files changed, 11 insertions, 8 deletions
diff --git a/doc/groff.texi b/doc/groff.texi index 819bcf17b..414e40bc9 100644 --- a/doc/groff.texi +++ b/doc/groff.texi @@ -3340,7 +3340,9 @@ Use headings to create a sequential or hierarchical structure for your document. The @file{ms} macros print headings in @strong{bold} using the same font family and, by default, type size as the body text. Headings are available with and without automatic numbering. Text on -input lines following the macro call becomes the heading's title. +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. @DefmacList {NH, [@Var{depth}], ms} @DefmacListEnd {NH, @t{S} @Var{heading-depth-index} @dots{}, ms} @@ -3916,13 +3918,14 @@ End any display. @endDefmac The distance stored in the @code{DD} register is inserted before and -after each pair of display macros, replacing any adjacent -inter-paragraph distance; this is a Berkeley extension. The @code{DI} -register is a GNU extension; its value is an indentation applied to -displays created with @samp{.DS} and @samp{.ID} without arguments, to -@samp{.DS I} without an indentation argument, and to indented equations -set with @samp{.EQ}. Changes to either register take effect at the next -display boundary. +after each pair of display macros; this is a Berkeley extension. In +@code{groff} @file{ms}, this distance replaces any adjacent +inter-paragraph distance or subsequent spacing prior to a section +heading. The @code{DI} register is a GNU extension; its value is an +indentation applied to displays created with @samp{.DS} and @samp{.ID} +without arguments, to @samp{.DS I} without an indentation argument, and +to indented equations set with @samp{.EQ}. Changes to either register +take effect at the next display boundary. @c --------------------------------------------------------------------- |