Hi Jeremie,
Jeremie Courreges-Anglas wrote on Mon, Aug 28, 2017 at 02:29:18PM +0200:
> Also, mandoc -Tlint warns:
> mandoc: strtok.3:90:2: STYLE: useless macro: Tn
> s/Tn/Li/ ?
No. The messages printed by mandoc -Tlint are terse, but
the mandoc(1) manual is intended to provide enough detail
to help people fix the issues:
$ man mandoc | col -b | grep -A2 'useless macro'
useless macro
(mdoc) A Bt, Tn, or Ud macro was found. Simply delete it: it
serves no useful purpose.
> Other manpages are affected.
True. Getting rid of .Tn isn't high priority, and doing it
systematically would consume some time. No developer wanted to do
it yet. Non-developers should not send diffs for it, checking such
diffs causes even more work than doing it from scratch.
Unless you are terribly bored, the right time for deleting .Tn is
when you look at a page anyway, so i just did it for strtok(3),
also removing the pointless word "ASCII": just "a NUL character"
is the normal wording, without any markup.
Yours,
Ingo
