[bug #54101] documentation for .ss either incorrect or incomplete

[Dave]

Follow-up Comment #16, bug #54101 (project groff):

[comment #15 comment #15:]
> commit 3704a6b25e2886fae1491df08a6d6a25f6d4f7ad

This just about nails it.  One slight clarification could be made:

This commit adds the sentence, "The first argument, the inter-word space size,
is a minimum; if adjusted..."  The intended reading here is "if [the text is]
adjusted...," but given the context of the preceding clause, a reader could
reasonably interpret this as "if [the first argument is] adjusted..."

Possible fix 1: replace "if adjusted, it may increase" with "groff may use a
wider space in adjusted text," to make it abundantly clear we're talking about
adjustments groff does automatically.

Possible fix 2: remove the sentence altogether, since the concept is explained
a couple paragraphs later, in: "Additional inter-sentence space is not
adjusted, but the inter-word space that always precedes it may be."  The only
thing this explanation is missing is an explicit statement that the given
word-space size is a minimum; that is, that adjustment is always done by
expanding space, never contracting it (however much bug #40963 may wish
otherwise).  Changing this sentence's "adjusted" to "expanded" or "widened"
should cover this, though.

The issue discussed in comment #14 probably warrants a new bug report.

    _______________________________________________________

Reply to this item at:

  <https://savannah.gnu.org/bugs/?54101>

_______________________________________________
  Message sent via Savannah
  https://savannah.gnu.org/