rancid icon indicating copy to clipboard operation
rancid copied to clipboard

Man page fixup (.ID, .El, .Bl, .Pp)

Open RolandRosenfeld opened this issue 4 years ago • 0 comments

When running man --warnings -E UTF-8 -l -Tutf8 -Z manpage.man > /dev/null on all man pages in rancid on a Debian system, this results in several warnings like

warning: macro 'El' not defined
warning: macro 'Bl' not defined
warning: macro 'ID' not defined
warning: macro 'Pp' not defined

Here .Pp seems to be a simple typo (should be .PP).

.El and .Bl are not defined in the standard man page macro set, but only in BSD -mdoc macro set, which isn't used in standard Linux man processing and if I fully understood the documentation, they always should be used as a .Bl / .El pair, which doesn't happen in the rancid man pages. From my point of view, both can simply be removed from all man pages.

Last but not least router.db(5) uses ".ID 15n", which also isn't defined in the standard Linux man macro set, but can also be removed without loosing information.

RolandRosenfeld avatar Oct 11 '20 11:10 RolandRosenfeld