[Bug 2064360] Re: libpam-doc: doc-base reports missing files

[Dan Bungert]

I incorrectly ported this fix for 5ubuntu5.1.  Will reupload.

** Attachment added: "fixed-libpam-doc.debdiff.notapatch"
   https://bugs.launchpad.net/ubuntu/+source/pam/+bug/2064360/+attachment/5774163/+files/fixed-libpam-doc.debdiff.notapatch

-- 
You received this bug notification because you are a member of Ubuntu
Foundations Bugs, which is subscribed to pam in Ubuntu.
https://bugs.launchpad.net/bugs/2064360

Title:
  libpam-doc: doc-base reports missing files

Status in pam package in Ubuntu:
  Fix Committed
Status in pam source package in Noble:
  In Progress
Status in pam package in Debian:
  Fix Released

Bug description:
  [ Impact ]

   * In the pam 1.5.3-1 merge, documents formerly found in libpam-doc
     were omitted.  Just a few documents remain in a package that
     formerly had many in /usr/share/doc/libpam-doc/{html,txt}.
   * A debdiff of the dropped files can be found in attachment
     1.5.2-9.1ubuntu3_to_1.5.3-5ubuntu5_libpam-doc.debdiff
   * The fix takes the form of correcting a build dependency, which
     results in the docs being again available.

  [ Test Plan ]

   * debdiff
     * Obtain a copy of the current pam binary packages, perhaps with
       `pull-lp-debs libpam-doc 1.5.3-5ubuntu5`
     * Obtain a copy of the proposed pam binary packages, perhaps with
       `pull-lp-debs libpam-doc 1.5.3-5ubuntu5.1`
     * `debdiff libpam-doc_1.5.3-5ubuntu5{,.1}_all.deb`
       and verify that the documents are present
   * upgrade
     * Obtain a mantic test system - I personally used a mantic chroot
     * `apt install libpam-doc doc-base`
     * Adjust apt sources to change mantic to noble and ensure
       noble-proposed is present
     * `apt update; apt install libpam-doc/noble-proposed`
     * Verify that the "Error in /usr/share/doc-base" messages are no
       longer present

  [ Where problems could occur ]

   * As usual, no SRU has zero risk
   * Any change to pam risks problems in user logins failing, so that is
     reflected in the regression test plan on LP: #2064350

  [ Other Info ]

   * None at this time

  original description follows:
  ---

  Imported from Debian bug http://bugs.debian.org/1065064:

  Package: libpam-doc
  Version: 1.5.3-4
  Severity: normal

  An upgrade reported:

    Error in `/usr/share/doc-base/libpam-doc.pam-admin-guide', line 14: all `Format' sections are invalid.
    Error in `/usr/share/doc-base/libpam-doc.pam-applications-guide', line 17: all `Format' sections are invalid.
    Error in `/usr/share/doc-base/libpam-doc.pam-modules-guide', line 14: all `Format' sections are invalid.

  This is true; all of /usr/share/doc/libpam-doc/html/Linux-PAM_SAG.html,
  /usr/share/doc/libpam-doc/html/sag-*.html,
  /usr/share/doc/libpam-doc/txt/Linux-PAM_SAG.txt.gz,
  /usr/share/doc/libpam-doc/html/Linux-PAM_ADG.html,
  /usr/share/doc/libpam-doc/html/adg*.html,
  /usr/share/doc/libpam-doc/txt/Linux-PAM_ADG.txt.gz,
  /usr/share/doc/libpam-doc/html/Linux-PAM_MWG.html,
  /usr/share/doc/libpam-doc/html/mwg*.html, and
  /usr/share/doc/libpam-doc/txt/Linux-PAM_MWG.txt.gz are listed in those
  doc-base files but are in fact missing.  I don't know whether this is
  intentional (in which case the doc-base registrations should be removed
  to match), or an accidental build issue that should be fixed.

  -- System Information:
  Debian Release: trixie/sid
    APT prefers unstable
    APT policy: (500, 'unstable'), (1, 'experimental')
  Architecture: amd64 (x86_64)

  Kernel: Linux 6.6.0-14-generic (SMP w/4 CPU threads; PREEMPT)
  Kernel taint flags: TAINT_PROPRIETARY_MODULE, TAINT_FIRMWARE_WORKAROUND, TAINT_OOT_MODULE
  Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8), LANGUAGE=en_GB:en
  Shell: /bin/sh linked to /usr/bin/dash
  Init: unable to detect

  -- no debconf information

  --
  Colin Watson (he/him)                              [cjwatson at debian.org]

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/pam/+bug/2064360/+subscriptions