Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 747796 - sys-libs/pam-1.4.0_p20200829: Missing pam.conf(5) manual page
Summary: sys-libs/pam-1.4.0_p20200829: Missing pam.conf(5) manual page
Status: RESOLVED FIXED
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: Current packages (show other bugs)
Hardware: All Linux
: Normal normal (vote)
Assignee: Mikle Kolyada (RETIRED)
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2020-10-11 12:00 UTC by Petr Pisar
Modified: 2020-11-13 17:06 UTC (History)
5 users (show)

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Petr Pisar 2020-10-11 12:00:41 UTC
After upgrading sys-libs/pam from 1.3.1_p20200128-r1 to 1.4.0_p20200829, pam.conf(5) manual page disappeared:

$ qlist -Iv sys-libs/pam
sys-libs/pam-1.3.1_p20200128-r1
$ man -aw pam.conf
/usr/share/man/man5/pam.conf.5.bz2

$ qlist -IUv sys-libs/pam
sys-libs/pam-1.4.0_p20200829 -abi_mips_n32 -abi_mips_n64 -abi_mips_o32 -abi_s390_32 -abi_s390_64 -abi_x86_32 abi_x86_64 -abi_x86_x32 -audit -berkdb -debug filecaps -nis pie -selinux split-usr
$ man -aw pam.conf
No manual entry for pam.conf

pam-e42e178c71c11bb25740a5177eed110ee17b8af2.tar.gz contains the page in doc/man/pam.conf.5.xml. The page is probably missing from a pregenerated pam-1.4.0_p20200809-doc.tar.xz archive.

(I can see that an upstream requires a web browser for converting Linux-PAM_SAG from an HTML format to a plain text format. But since Gentoo does not deliver that manual, it could make sense to patch the build script to skip targets in doc/{sag,mwg,adg} directories. A dependency on libxslt2 and docbook-xsl-stylesheets required for the manual pages should not have been an obstacle.)
Comment 1 Alexander Bezrukov 2020-10-21 10:27:16 UTC
It seems that documentation in doc/man directory is not built anymore, instead some external (to the upstream pam project) archive https://dev.gentoo.org/~zlogene/distfiles/${CATEGORY}/${PN}/${PN}-1.4.0_p20200809-doc.tar.xz is expanded.

Not only pam.conf(5) is missing. This is a regression.
Comment 2 Mikle Kolyada (RETIRED) archtester Gentoo Infrastructure gentoo-dev Security 2020-11-13 17:06:37 UTC
Fixed in stable.