Bug#973604: lintian reports spare-manual-page on PAM and NSS modules
nicoo <nicoo@debian.org> writes:
> - libpam-afs-session: /usr/share/man/man5/pam_afs_session.5.gz
> libpam-heimdal: /usr/share/man/man5/pam_krb5.5.gz
> libpam-krb5: /usr/share/man/man5/pam_krb5.5.gz
> libpam-ldap: /usr/share/man/man5/pam_ldap.5.gz
> Indeed PAM modules
The first three are all mine, so don't represent three independent
decisions. I don't remember my thought process at the time (it was about
15 years ago now). Maybe my thought was that most of what the man page
for a PAM module documents is what should go into the PAM configuration
files for invoking the module, and thus it's effectively configuration
file documentation?
Linux PAM itself documents all of its modules in section 8, so that's a
reasonable precedent to follow, although it looks like everyone, like me,
made their own decisions. None of the sections fit all that naturally
(which would explain the folks who picked 7).
--
Russ Allbery (rra@debian.org) <https://www.eyrie.org/~eagle/>
Reply to: