pam-0.64-3, which came with Red Hat 5.2, used to have short guides in the directories under /usr/doc/pam-0.64/. In January, pam-0.64-4 was released to correct a minor possible bug, but it looks like the html/ps/txt guides (for how to write modules, what modules are available, how to configure the modules) were accidently left out: only the index.html (with invalid links) is left. This information really isn't in any other package, and there is no PAM HOWTO, so I assume this was an oversight.
*** Bug 1289 has been marked as a duplicate of this bug. *** All of the docementation meant to come with the pam package is missing.
As further info: when building the package from the source RPM all documentation comes include as expected. Maybe something broke during the build, like missing sgmltools on the build host?
Yes, you have diagnosed the problem correctly. Our current pam package in our latest build tree will not build in this case, so this problem will not happen again. We'll put a new pam package on our errata page; it is building now.