haussli / rancid

RANCiD
Other
114 stars 42 forks source link

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

Open RolandRosenfeld opened 3 years ago

RolandRosenfeld commented 3 years ago

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.