[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#322762: marked as done (/usr/doc may still exist on upgrade of old systems)

Your message dated Thu, 25 Sep 2008 10:45:49 +0200
with message-id <200809251045.57628.holger@layer-acht.org>
and subject line happy birthday! /usr/doc is finally gone
has caused the Debian Bug report #322762,
regarding /usr/doc may still exist on upgrade of old systems
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 this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact owner@bugs.debian.org

322762: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=322762
Debian Bug Tracking System
Contact owner@bugs.debian.org with problems
--- Begin Message ---
Package: general
Severity: normal

In 1999, Debian began moving /usr/doc to /usr/share/doc to comply with
the FHS. Due to unfortunate dpkg issues at the time, we couldn't simply
move the directory and be done with it, but decided to move things
peicemeil by updating all packages. Due to some silly concerns about
users having to look in two places during the transition, we decided to
start by making /usr/doc/<package> -> /usr/share/doc/<package> symlinks.

In 2001, putting any documentation in /usr/doc became a serious policy
violation. The symlinks were still allowed.

In 2002, we completed the first stage of the transition, released woody
with complete /usr/share/doc and /usr/doc directories, and policy was
changed to not require the /usr/doc symlinks. debhelper was changed to
stop adding postinst and postrm fragments to manage the links, and so
most packages only needed a recompile to finish the transition.

We are now in the final, worst stages of this transition, when the few
remaining links in /usr/doc are due to packages that either use
debhelper and are so unmaintained they've not been updated since 2002,
or do not use debhelper and have not been modified to remove the code,
or worst, have been modified to remove the code, but botched it.

Policy is expected to be changed soon to make any files in /usr/doc a
serious bug. For now it is a normal bug.

A typical Debian unstable system today will have a dozen or two of these
symlinks left. This tracking bug is here because that is ugly and we
should completely finish the transition.

Set any bugs about /usr/doc stuff to being blockers of this bug report.
Use this as a tracking/coordination bug for the remainder of the transition.

Note that once this transition is complete we will need to do something
in base-files to remove the /usr/doc directory, if it is empty. It won't
be empty in all cases, for example a user might have non-debian or old
packages that have not transitioned still installed. This bug can be
reassigned to base-files to deal with that last step once it is no
longer blocked by any other bugs.

see shy jo

Attachment: signature.asc
Description: Digital signature

--- End Message ---
--- Begin Message ---

In 1999, Debian began moving /usr/doc to /usr/share/doc to comply with
the FHS. 

In 2005 Joey Hess picked up the leftovers from this task, which in turn where 
picked up by Amaya in 2006. Today I have the honor and fun to close this 
blocker bug, which was used to track this transition and to wish Amaya the 
very best and much more for her birthday :-) I love you! Mucho!

Have a great day and many many more happy days to come! :-)


P.S.: there is a lintian check in place to prevent /usr/doc issues to come 
http://lintian.debian.org/tags/postinst-should-not-set-usr-doc-link.html - 
the last remaining package has been fixed in unstable and is awaiting either 
migration or removal to/from testing.

I don't bother about 
http://lintian.debian.org/tags/readme-debian-mentions-usr-doc.html though I 
think that still speaking about /usr/doc is a sure sign of being behind the 
times... Policy is your friend. Trust the Policy. Love the Policy. Obey the 

Attachment: pgpmNQghsb52W.pgp
Description: PGP signature

--- End Message ---

Reply to: