remove needless examples/ path component for packages whose whole purpose is to provi...

Author: joy
Date: 2003/02/16 03:01:22
remove needless examples/ path component for packages whose whole purpose is to provide examples, according to 2.5 years old, yet entirely non-controversial #69864

git-archimport-id: srivasta@debian.org--etch/debian-policy--devel--3.0--patch-181

diff --git a/debian/changelog b/debian/changelog
index 3d55ceee424bfca7fa257fec66a6cc5351ab28d0..ab0d713076b3a67f0046ef6600a838e07ffce476 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -30,6 +30,8 @@ debian-policy (3.5.9.0) unstable; urgency=low
   * Rearranged the shared library information properly, closes: #109166.
     This change also centralizes the info on how to ship static libraries
     in one place (hopefully not too ambiguous), closes: #93975.
+  * Allow examples to be placed in /usr/share/doc/package/ in packages
+    that are meant to provide examples, closes: #69864.
 
  -- 
 

diff --git a/policy.sgml b/policy.sgml
index 4e2c7a0098c7c0dae47272a59120377893107fef..b4a33bf897f95d1644c89e2ab9882af1d3e333da 100644 (file)
--- a/policy.sgml
+++ b/policy.sgml
@@ -7810,6 +7810,12 @@ install-info --quiet --remove /usr/share/info/foobar.info
          latter directory itself may be a symbolic link to the
          former.
        </p>
+
+       <p>
+         If the purpose of a package to provide examples, then the
+         example files may be installed into
+         <file>/usr/share/doc/<var>package</var></file>.
+       </p>
       </sect>
 
       <sect id="changelogs">

diff --git a/upgrading-checklist.html b/upgrading-checklist.html
index aa56254de3364d0e156f3d24382aa64feceb0ce0..0451f4b8f83c6a124768fec6075fc8bc5268fff7 100644 (file)
--- a/upgrading-checklist.html
+++ b/upgrading-checklist.html
@@ -62,6 +62,10 @@ picking your way through this list.
        and related fields (i.e. it's just optional). [2.4.2]
      - When asked to restart a service that isn't already running,
        the init script should start the service. [10.3.2]
+     - If the purpose of a package is to provide examples, then the
+       example files can be installed into <tt>/usr/share/doc/package</tt>
+       (rather than <tt>/usr/share/doc/package/examples</tt>). [13.6]
+
 
 3.5.8.0                    Nov 02