Bug#95065: Checklist is wrong on location of examples files

[David Z Maze <dmaze@debian.org>]

Package: debian-policy
Version: 3.5.3.0
Severity: normal

According to /usr/share/doc/debian-policy/upgrading-checklist.txt.gz:

      - Examples and templates should now live in
        /usr/share/<package> or /usr/lib/<package>, with
        symbolic links from /usr/share/doc//<package>/examples as
        needed.

However, section 13.7 of policy states:

    Any examples (configurations, source files, whatever), should be
    installed in a directory /usr/share/doc/package/examples. These files
    should not be referenced by any program--they're there for the benefit
    of the system administrator and users, as documentation only.
    Architecture-specific example files should be installed in a directory
    /usr/lib/package/examples, and files in /usr/share/doc/package/examples
    symlink to files in it. Or the latter directory may be a symlink to the
    former. 

Since policy is deemed to be authoritative over the checklist, I'd
propose changing the checklist text to the following:

      - Arch-dependent examples and templates should now live in
        /usr/lib/<package>, with symbolic links from
        /usr/share/doc/<package> as needed.

- System Information
Debian Release: testing/unstable
Architecture: i386
Kernel: Linux extant-streetcar-line.sixtyone 2.2.19 #1 Thu Apr 19 20:39:14 EDT 2001 i686

Versions of packages debian-policy depends on:
ii  fileutils                     4.0.43-1   GNU file management utilities.