Bjarni,
Nice, tight analysis and proposed solutions. Thank you.
Mike Bianchi
On Thu, Apr 02, 2020 at 11:58:01PM +0000, Bjarni Ingi Gislason wrote:
snip
> 1) The missing part is information.
> Solution:
> a) Provide a message (warning, error), if "\snn" is in the input.
> b) Augment the documentation to tell the readers,
> that "\snn" is deprecated, obsolete, out of date, etc.
> and what they should use instead.
>
> 2) About the "\snn" problem.
> The current executing code is not the problem.
> The current existing roff-files are not the problem.
> The problem is the people who (still, will) write "\snn"
> instead of "\s(nn" (portability) or "\s[nn]" (for "groff" and
> compatibles).
snip
> 3) Other things.
> a) A missing part of messages is the name of the culprit,
> in this case the s-escape (\s).
> Solution: Provide the name ("\\s escape" is already used once in the
> subroutine).
> b) Adding details of the argument of the escape in messages is not
> necessary.
> c) Adding specific code to report specific syntax errors is not
> necessary.
snip