On Sun, Jul 04, 1999 at 02:27:01AM +0200, Roland Rosenfeld wrote: > 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. Why do we need a smooth way? Some packages (including many of mine at the moment) are outta Policy compliance... If it's not a release critical bug, it doesn't have to be fixed before Potato goes out. The FHS has a preferd way to make the transition... it's a symlink. There might be reasons you don't want it on *your* computer, but what is wrong with that track as a default for Debian? > > > 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 > > > -- > To UNSUBSCRIBE, email to debian-policy-request@lists.debian.org > with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org > -- Please cc all mailing list replies to me, also. ========================================================================= * http://benham.net/index.html <gecko@benham.net> <>< * * -------------------- * -----------------------------------------------* * Debian Developer, Debian Project Secretary, Debian Webmaster * * <gecko@debian.org> <secretary@debian.org> <lintian-maint@debian.org> * * <webmaster@debian.org> <gecko@fortunet.com> <webmaster@spi-inc.org> * =========================================================================
Attachment:
pgpUNrURICP6V.pgp
Description: PGP signature