Bug#40706: marked as done ([REJECTED 21/7/99] /usr/share/doc vs. /usr/doc transition)
Your message dated Thu, 22 Feb 2001 00:01:17 +0000
with message-id <20010222000117.A1237@polya>
and subject line This is now solved
has caused the attached Bug report to be marked as done.
This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.
(NB: If you are a system administrator and have no idea what I am
talking about this indicates a serious mail system misconfiguration
somewhere. Please contact me immediately.)
Darren Benham
(administrator, Debian Bugs database)
--------------------------------------
Received: (at submit) by bugs.debian.org; 4 Jul 1999 00:29:18 +0000
Received: (qmail 24468 invoked from network); 4 Jul 1999 00:29:17 -0000
Received: from aiur.rhein.de (HELO postfix.rhein.de) (193.175.27.2)
by master.debian.org with SMTP; 4 Jul 1999 00:29:17 -0000
Received: by postfix.rhein.de (Postfix, from userid 5)
id D567C12869; Sun, 4 Jul 1999 02:29:15 +0200 (MET DST)
Received: from luv (luv)
by aiur (rbsmtp 2.3pl8bMS);
Sun Jul 4 02:29:15 1999
using /var/spool/bsmtp/out/q07965.05.931048155
Received: from spinnaker.rhein.de (roland@spinnaker.rhein.de [193.175.27.129])
by luv.rhein.de (8.9.3/8.9.3/Debian/GNU) with ESMTP id CAA24192;
Sun, 4 Jul 1999 02:27:05 +0200
Received: (from roland@localhost)
by spinnaker.rhein.de (8.9.3/8.9.3/Debian/GNU) id CAA16411;
Sun, 4 Jul 1999 02:27:02 +0200
Date: Sun, 4 Jul 1999 02:27:01 +0200
From: Roland Rosenfeld <roland@spinnaker.de>
To: submit@bugs.debian.org
Subject: /usr/share/doc vs. /usr/doc
Message-ID: <19990704022701.E15240@spinnaker.rhein.de>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
User-Agent: Mutt/0.96.3i
Sender: roland@spinnaker.rhein.de
Package: debian-policy
Version: 3.0.0.0
Severity: important
debian-policy 3.0.0.0 is now out and mentions to use
/usr/share/doc/<package> instead of /usr/doc/<package>.
This is principally the right way (according to FHS), but we cannot
recompile all packages now but we need a smooth way from one directory
to the other.
We need an official way (noted in the policy or at least in
upgrading-checklist) to migrate from /usr/doc to /usr/share/doc,
otherwise the package maintainers will distribute the document files
between the two directories and users have to search both directories
to find the correct location of the files and web servers are no
longer able to detect the documentation as
http://localhost/doc/<package>.
So please let us handle this question with high priority, before there
are packages uploaded, with documentation which cannot be found as
/usr/doc/<package>.
I don't have an optimal solution for this question, but the following
seems to do the job:
- New packages should use /usr/share/doc/<package> and create a
symlink /usr/doc/<package> pointing to /usr/share/doc/<package>.
- The symlink allows us to access every documentation as
/usr/doc/<package> in the transitional period.
- After the transitional period (when every package places its
documentation under /usr/share/doc/<package>), we can find every
package documentation as /usr/share/doc/<package>.
- At this time we can begin removing the symlinks when new packages
are uploaded.
I would like to hear of better methods for a smooth transition, but I
did not see any better solution yet (other ideas intend to tell the
web sever to search both directories, but this doesn't help the user
who is searching the correct directory).
Ciao
Roland
--
* roland@spinnaker.de * http://www.spinnaker.de/ *
PGP: 1024/DD08DD6D 2D E7 CC DE D5 8D 78 BE 3C A0 A4 F1 4B 09 CE AF
---------------------------------------
Received: (at 40706-done) by bugs.debian.org; 22 Feb 2001 00:01:23 +0000
>From J.D.Gilbey@qmw.ac.uk Wed Feb 21 18:01:23 2001
Return-path: <J.D.Gilbey@qmw.ac.uk>
Received: from mserv1d.vianw.co.uk [::ffff:195.102.240.96]
by master.debian.org with esmtp (Exim 3.12 1 (Debian))
id 14VjCF-0007Bv-00; Wed, 21 Feb 2001 18:01:23 -0600
Received: from p89.nas1.is3.u-net.net ([195.102.196.89] helo=polya)
by mserv1d.vianw.co.uk with esmtp (Exim 3.22 #5)
id 14VjCC-000161-00
for 40706-done@bugs.debian.org; Thu, 22 Feb 2001 00:01:20 +0000
Received: from jdg by polya with local (Exim 3.22 #1 (Debian))
id 14VjCA-0000K6-00; Thu, 22 Feb 2001 00:01:18 +0000
Date: Thu, 22 Feb 2001 00:01:17 +0000
From: Julian Gilbey <J.D.Gilbey@qmw.ac.uk>
To: 40706-done@bugs.debian.org
Subject: This is now solved
Message-ID: <20010222000117.A1237@polya>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.3.15i
Sender: Julian Gilbey <J.D.Gilbey@qmw.ac.uk>
Delivered-To: 40706-done@bugs.debian.org
This has been solved long ago; closing the bug report.
Julian
--
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
Julian Gilbey, Dept of Maths, Queen Mary, Univ. of London
Debian GNU/Linux Developer, see http://people.debian.org/~jdg
Donate free food to the world's hungry: see http://www.thehungersite.com/
Reply to: