Don't abuse mdoc(7) Tn for structs

[nabijaczleweli]

The rest of the code variably uses Ft/Vt

[dang]

mdoc(7) says that Tn is a "Trade or type name", which is what these are. Vt is a "Variable type (Fortran only)", which these are not. Why change them?

[nabijaczleweli]

.Tn has never been used for "type names", that's a documentation blunder backsolved from the macro name. The correct usage corresponds to the correct documentation: "Tn macro - Trade Name Macro" (4.4BSD tmac/doc) — i.e. you use it to get a smaller font, most often for an acronym.
No clue where you're getting the Fortran thing.

[dang]

https://linux.die.net/man/7/mdoc

[nabijaczleweli]

Great. That text appeared spontaneously in 1999 and got killed from the groff distribution in 2001, because it has no basis in fact, instead replaced with the modern-day-equivalent "The ‘.Vt’ macro may be used whenever a type is referenced."

[dang]

Hmm... Groff doesn't seem to document either tn or vt. Can you point me to the docs for these? Not that it matters much, since the man pages for ntirpc are largely unmaintained, and not installed.

[nabijaczleweli]

https://manpages.debian.org/bullseye/groff/groff_mdoc.7.en.html#Trade_Names_(or_Acronyms_and_Type_Names) (but do note that groff's mdoc(7) descends from the 4.4BSD one and so inherits the "type names" backsolve) and https://manpages.debian.org/bullseye/mandoc/mandoc_mdoc.7.en.html#Tn

[ffilz]

I've referenced this from #325 noting that a general documentation effort is necessary.

Probably this patch is not worthwhile and instead we should write new documentation...

This may take awhile...