Jed: Policy violation section 12.3

[Jörg Sommer]

Hi,

I propose the following patch, because policy section 12.3 says:

,----------
|12.3. Additional documentation
|------------------------------
|[…]
|     Packages must not require the existence of any files in
|     `/usr/share/doc/' in order to function [1].  Any files that are
|     referenced by programs but are also useful as stand alone
|     documentation should be installed under `/usr/share/<package>/' with
|     symbolic links from `/usr/share/doc/<package>'.
|[…]
|
|[1]  The system administrator should be able to delete files in
|     `/usr/share/doc/' without causing any programs to break.
`----------

A definition for break is not given, but I think we should move the help
files (menu Help->Browse Docs) back to /usr/share/jed/doc.

Index: changelog
===================================================================
--- changelog	(Revision 869)
+++ changelog	(Arbeitskopie)
@@ -1,3 +1,13 @@
+jed (1:0.99.18+dfsg.1-9) UNREALEASED; urgency=low
+
+  * debian/rules:
+    + Policy 12.3 requires that programs stay working after removing of
+      /usr/share/doc/. Due to this we can't move the internal help files
+      to /usr/share/doc. Now, they are back in /usr/share/jed/doc and a
+      symlink is placed in /usr/share/doc/jed. [JS]
+
+ -- Rafael Laboissiere <rafael at debian.org>  Wed, 5 Sep 2007 15:07:19 +0200
+
 jed (1:0.99.18+dfsg.1-8) unstable; urgency=low
 
   * debian/jed.menu, debian/xjed.menu:
Index: rules
===================================================================
--- rules	(Revision 869)
+++ rules	(Arbeitskopie)
@@ -74,10 +74,8 @@
 	# fill up /usr/share/doc/jed-common
 	dh_installchangelogs -pjed-common changes.txt
 
-	mv $(jed-common)/usr/share/jed/doc/* \
-	    $(jed-common)/usr/share/doc/jed-common
-	rmdir $(jed-common)/usr/share/jed/doc
-	dh_link -pjed-common usr/share/doc/jed-common usr/share/jed/doc
+	dh_link -pjed-common usr/share/jed/doc/hlp usr/share/doc/jed-common
+	dh_link -pjed-common usr/share/jed/doc/txt usr/share/doc/jed-common
 	dh_installdocs -pjed-common debian/README.Debian \
 	    debian/init.d/README.Debian-startup \
 	    debian/Debian-Jed-Policy.txt

Bye, Jörg.
-- 
“UNIX was not designed to stop people from doing stupid things, because
 that would also stop them from doing clever things.”
            (Doug Gwyn)
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: not available
Url : http://lists.alioth.debian.org/pipermail/pkg-jed-devel/attachments/20070905/0091f15f/attachment.pgp