Path: csiph.com!xmission!news.snarked.org!news.linkpendium.com!news.linkpendium.com!panix!usenet.stanford.edu!not-for-mail From: Dave Newsgroups: gnu.groff.bug Subject: [bug #54101] documentation for .ss either incorrect or incomplete Date: Sun, 10 May 2020 09:28:11 -0400 (EDT) Lines: 38 Approved: bug-groff@gnu.org Message-ID: References: <20180612-014621.sv93119.14895@savannah.gnu.org> <20180613-095243.sv93119.92228@savannah.gnu.org> <20180616-170511.sv108747.63960@savannah.gnu.org> <20180616-133428.sv93119.4912@savannah.gnu.org> <20180616-235027.sv108747.41913@savannah.gnu.org> <20180618-061236.sv93119.46396@savannah.gnu.org> <20200507-020849.sv108747.13198@savannah.gnu.org> <20200507-020906.sv108747.30605@savannah.gnu.org> <20200507-022001.sv108747.42904@savannah.gnu.org> <20200507-024038.sv108747.99596@savannah.gnu.org> <20200507-221442.sv108747.71097@savannah.gnu.org> <20200508-042137.sv93119.89972@savannah.gnu.org> <20200508-092742.sv108747.69447@savannah.gnu.org> <20200508-220831.sv108747.71955@savannah.gnu.org> <20200508-231422.sv108747.78460@savannah.gnu.org> <20200509-010902.sv108747.83689@savannah.gnu.org> <20200508-201330.sv93119.81014@savannah.gnu.org> <20200509-011403.sv108747.50707@savannah.gnu.org> <20200510-082811.sv93119.9610@savannah.gnu.org> NNTP-Posting-Host: lists.gnu.org Mime-Version: 1.0 Content-Type: text/plain;charset=UTF-8 X-Trace: usenet.stanford.edu 1589117293 5382 209.51.188.17 (10 May 2020 13:28:13 GMT) X-Complaints-To: action@cs.stanford.edu To: "G. Branden Robinson" , Dave , bug-groff@gnu.org Envelope-to: bug-groff@gnu.org X-PHP-Originating-Script: 1001:sendmail.php X-Savane-Server: savannah.gnu.org:443 [2001:470:142::72] X-Savane-Project: groff X-Savane-Tracker: bugs X-Savane-Item-ID: 54101 User-Agent: Mozilla/5.0 (X11; Linux i686; rv:45.0) Gecko/20100101 Firefox/45.0 X-Apparently-From: 2605:a601:ab42:5b00:d79a:70a3:b6a4:34bf (Savane authenticated user barx) In-Reply-To: <20200509-011403.sv108747.50707@savannah.gnu.org> X-BeenThere: bug-groff@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "Bug reports for the GNU version of nroff, troff et al" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-Mailman-Original-Message-ID: <20200510-082811.sv93119.9610@savannah.gnu.org> X-Mailman-Original-References: <20180612-014621.sv93119.14895@savannah.gnu.org> <20180613-095243.sv93119.92228@savannah.gnu.org> <20180616-170511.sv108747.63960@savannah.gnu.org> <20180616-133428.sv93119.4912@savannah.gnu.org> <20180616-235027.sv108747.41913@savannah.gnu.org> <20180618-061236.sv93119.46396@savannah.gnu.org> <20200507-020849.sv108747.13198@savannah.gnu.org> <20200507-020906.sv108747.30605@savannah.gnu.org> <20200507-022001.sv108747.42904@savannah.gnu.org> <20200507-024038.sv108747.99596@savannah.gnu.org> <20200507-221442.sv108747.71097@savannah.gnu.org> <20200508-042137.sv93119.89972@savannah.gnu.org> <20200508-092742.sv108747.69447@savannah.gnu.org> <20200508-220831.sv108747.71955@savannah.gnu.org> <20200508-231422.sv108747.78460@savannah.gnu.org> <20200509-010902.sv108747.83689@savannah.gnu.org> <20200508-201330.sv93119.81014@savannah.gnu.org> <20200509-011403.sv108747.50707@savannah.gnu.org> Xref: csiph.com gnu.groff.bug:1855 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: _______________________________________________ Message sent via Savannah https://savannah.gnu.org/