Bug#318214: debian-policy: Unclear wording of ldconfig requirements in section 8.1.1

[Ben Finney <ben@benfinney.id.au>]

Package: debian-policy
Version: 3.6.1.1
Severity: minor
Tags: patch

As discussed on debian-mentors recently (though apparently not in the
list archives as of this writing), the wording of a package's ldconfig
requirements are unclear.

The following patch rewords the unclear paragraph.

--- orig/policy.sgml
+++ mod/policy.sgml
@@ -4503,15 +4503,18 @@
        </p>

        <p>
-         The package must call <prgn>ldconfig</prgn> in the
-         <prgn>postinst</prgn> script if the first argument is
-         <tt>configure</tt>; the <prgn>postinst</prgn> script may
-         optionally invoke <prgn>ldconfig</prgn> at other times.  The
-         package should call <prgn>ldconfig</prgn> in the
-         <prgn>postrm</prgn> script if the first argument is
-         <tt>remove</tt>.  The maintainer scripts must not invoke
-         <prgn>ldconfig</prgn> under any circumstances other than those
-         described in this paragraph.<footnote>
+         The package maintainer scripts must only call
+         <prgn>ldconfig</prgn> under these circumstances:
+           <list compact="compact">
+             <item>When the <prgn>postinst</prgn> script is run with a
+             first argument of <tt>configure</tt>, the script must call
+             <prgn>ldconfig</prgn>, and may optionally invoke
+             <prgn>ldconfig</prgn> at other times.</item>
+             <item>When the <prgn>postrm</prgn> script is run with a
+             first argument of <tt>remove</tt>, the script should call
+             <prgn>ldconfig</prgn>.</item>
+           </list>
+         <footnote>
            <p>
              During install or upgrade, the preinst is called before
              the new files are installed, so calling "ldconfig" is