On 12/22/20, Peter Schaffter <pe...@schaffter.ca> wrote: > So, yes, it's worth re-working the info .ss entry. Perhaps begin > with something like: "Change the size of the space between words > and sentences. The space between sentences is derived by adding > WORD_SPACE_SIZE and SENTENCE_SPACE_SIZE. Thus '.ss 12 0' results in > no additional space being added between sentences, whereas '.ss 12 12' > results in an additional 12 units of space between sentences."
It seems like a lot of clarity could be achieved by just not naming the second parameter something misleading like SENTENCE_SPACE_SIZE. There's a lack of parity between WORD_SPACE_SIZE, which does specify the width of a word space, and SENTENCE_SPACE_SIZE, which does not specify the width of a sentence space. A name like SENTENCE_SPACE_ADDITION or ADDITIONAL_SPACE_BETWEEN_SENTENCES makes it clear that the parameter is not specifying the size of a sentence space on its own. (Neither of those names is very good, but you get the idea and can maybe come up with something better.) This could allow the first paragraph to not need the explicit examples Peter proposes above, allowing it to focus more on the request's high-level overview.
