[groff] 09/23: [docs]: De-document `spacewidth` as mandatory.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 1517db0a1ce0442e076db81b34916bdd804d17ff
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Thu Sep 23 10:26:14 2021 +1000

    [docs]: De-document `spacewidth` as mandatory.
    
    See, e.g., our devps `EURO` font.  It's probably still a good idea to
    have a `spacewidth` directive for any font that will be current when a
    space is encountered in *roff input.  (Not necessarily a "symbol" or
    "special" font; `EURO` is neither of these.)
---
 doc/groff.texi       |  5 ++++-
 man/groff_font.5.man | 16 ++++++++++++++--
 2 files changed, 18 insertions(+), 3 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 7f052dd..4bb40ca 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -18092,7 +18092,10 @@ The width of a normal, unadjusted space is 
@var{n}@tie{}basic units at
 a type size of @var{unit-width} points.
 @end table
 
-The above directives are mandatory; the remaining ones in the first
+The @code{name} directive is mandatory, and @code{spacewidth} is
+recommended for any font expected to be current when a space is
+encountered in @code{roff} input.@footnote{Thus, ``symbol'' or
+``dingbats'' fonts might safely omit it.}  Other directives in this
 section are optional.
 
 @table @code
diff --git a/man/groff_font.5.man b/man/groff_font.5.man
index aa76a97..64aaf76 100644
--- a/man/groff_font.5.man
+++ b/man/groff_font.5.man
@@ -571,8 +571,20 @@ units at a type size of
 .
 .
 .P
-The above directives are mandatory;
-the remaining ones in the first section are optional.
+The
+.B name
+directive is mandatory,
+and
+.B spacewidth
+is recommended for any font expected to be current when a space is
+encountered in
+.I roff
+input.
+.
+(Thus,
+\[lq]symbol\[rq] or \[lq]dingbats\[rq] fonts might safely omit it.)
+.
+Other directives in this section are optional.
 .
 .
 .TP