[groff] 19/22: [ms]: Document DI register.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 188856679cafb7cde9eede1dee602d4fab10c88c
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Thu May 13 17:44:06 2021 +1000

    [ms]: Document DI register.
    
    * doc/groff.texi (ms Document Control Settings) <DI>:
    * doc/ms.ms (Document control settings, Displays and keeps) <DI>:
    * tmac/groff_ms.7.man (Document control settings, Displays and keeps)
      <DI>: Document this register; it had been mentioned only in passing.
---
 ChangeLog           |  9 +++++++++
 doc/groff.texi      | 13 ++++++++++++-
 doc/ms.ms           | 22 ++++++++++++++++++++--
 tmac/groff_ms.7.man | 33 +++++++++++++++++++++++++++++++--
 4 files changed, 72 insertions(+), 5 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index bdb57ed..6157210 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,14 @@
 2021-05-13  G. Branden Robinson <g.branden.robinson@gmail.com>
 
+       * doc/groff.texi (ms Document Control Settings) <DI>:
+       * doc/ms.ms (Document control settings, Displays and keeps)
+       <DI>:
+       * tmac/groff_ms.7.man (Document control settings, Displays and
+       keeps) <DI>: Document this register; it had been mentioned only
+       in passing.
+
+2021-05-13  G. Branden Robinson <g.branden.robinson@gmail.com>
+
        * doc/groff.texi (ms Document Control Settings) <DD>:
        * doc/ms.ms (Document control settings) <DD>:
        * tmac/groff_ms.7.man (Document control settings) <DD>: Fix
diff --git a/doc/groff.texi b/doc/groff.texi
index e3c1adf..7e36f83 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -2809,7 +2809,7 @@ otherwise.
 Default: @math{11/12}.
 @endDefstr
 
-@unnumberedsubsubsec Other Settings
+@unnumberedsubsubsec Display Settings
 
 @Defmpreg {DD, ms}
 Sets the vertical spacing before and after a display, a @code{tbl}
@@ -2821,6 +2821,17 @@ Effective: next display boundary.
 Default: 0.5@dmn{v}.
 @endDefmpreg
 
+@Defmpreg {DI, ms}
+Sets the amount by which to indent a display started with @samp{.DS I}
+or @code{ID}.  This is a GNU extension.
+
+Effective: next indented display.
+
+Default: 0.5@dmn{i}.
+@endDefmpreg
+
+@unnumberedsubsubsec Other Settings
+
 @Defmpreg {MINGW, ms}
 Defines the minimum width between columns in a multi-column document.
 This is a GNU extension.
diff --git a/doc/ms.ms b/doc/ms.ms
index c693df5..373e04c 100644
--- a/doc/ms.ms
+++ b/doc/ms.ms
@@ -345,8 +345,10 @@ Footnotes  \[rs]n[FI]      Indentation     next footnote   
2n
 \^     \[rs]n[FPD]     Paragraph spacing       next footnote   \[rs]n[PD]/2
 \^     \[rs]*[FR]      Line length ratio       special 11/12
 _
-Other  \[rs]n[DD]      Display distance (spacing)      disp-boundary   0.5v
-\^     \[rs]n[MINGW]   Minimum gutter width    next page       2n
+Displays       \[rs]n[DD]      Display distance (spacing)      special 0.5v
+\^     \[rs]n[DI]      Display indentation     special 0.5i
+_
+Other  \[rs]n[MINGW]   Minimum gutter width    next page       2n
 .TE
 .
 .
@@ -357,6 +359,9 @@ take effect with the next footnote written in single-column
 arrangements,
 but on the next page in multiple-column contexts.
 .
+For entries marked \[lq]special\[rq] in the \[lq]Effective\[rq] column,
+see the discussion in the applicable section below.
+.
 .
 .\" ------------------------
 .bp
@@ -1699,6 +1704,19 @@ and
 .
 .
 .PP
+The
+.CW \[rs]n[DI]
+indentation is applied to only to displays created with
+.CW ".DS I" \[rq] \[lq]
+and
+.B .ID .
+.
+Changes take effect at the next display boundary.
+.
+This is a GNU extension.
+.
+.
+.PP
 On occasion, you may want to
 .I keep
 other text together on a page.
diff --git a/tmac/groff_ms.7.man b/tmac/groff_ms.7.man
index 7e9fe6e..0427031 100644
--- a/tmac/groff_ms.7.man
+++ b/tmac/groff_ms.7.man
@@ -183,6 +183,11 @@ macro.
 .
 .
 .LP
+For entries marked \[lq]special\[rq] in the \[lq]Effective\[rq] column,
+see the discussion in the applicable section below.
+.
+.
+.LP
 .TS
 cb    s  s  s
 cb   cb cb cb
@@ -280,7 +285,19 @@ arrangements,
 but on the next page in multiple-column contexts.
 .
 .
-.LP
+.TS
+cb   s  s  s
+cb   cb cb cb
+lfCR lx  l  lfCR.
+Display settings
+Parameter      Definition      Effective       Default
+_
+\[rs]n[DD]     Display distance (spacing)      special 0.5v
+\[rs]n[DI]     Display indentation     special 0.5i
+_
+.TE
+.
+.
 .TS
 cb   s  s  s
 cb   cb cb cb
@@ -288,7 +305,6 @@ lfCR lx  l  lfCR.
 Other settings
 Parameter      Definition      Effective       Default
 _
-\[rs]n[DD]     Display distance (spacing)      disp-boundary   0.5v
 \[rs]n[MINGW]  Minimum gutter width    next page       2n
 _
 .TE
@@ -1050,6 +1066,19 @@ macro to end any display type.
 .
 .
 .PP
+The
+.B \[rs]n[DI]
+indentation is applied to only to displays created with
+.RB \[lq] ".DS I" \[rq]
+and
+.BR .ID .
+.
+Changes take effect at the next display boundary.
+.
+This is a GNU extension.
+.
+.
+.PP
 To
 .I keep
 text together on a page,