From 24f916d83fdb51fac38261f6bc07b997421992a7 Mon Sep 17 00:00:00 2001
From: Manoj Srivastava <srivasta@debian.org>
Date: Thu, 16 Jun 2005 05:36:51 +0000
Subject: [PATCH] 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

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
---
 debian/changelog         | 2 ++
 policy.sgml              | 6 ++++++
 upgrading-checklist.html | 4 ++++
 3 files changed, 12 insertions(+)

diff --git a/debian/changelog b/debian/changelog
index 3d55cee..ab0d713 100644
--- 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 4e2c7a0..b4a33bf 100644
--- 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 aa56254..0451f4b 100644
--- 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
 
-- 
2.39.5