Re: finishing up the /usr/share/doc transition

[Joey Hess <joeyh@debian.org>]

Ben Collins wrote:
> I think we need to reevaluate this decision based on the fact that the bug
> in dpkg that forced this implementation (as opposed to a clean /usr/doc
> symlink to share/doc) has been gone for awhile now (the potato dpkg is
> fixed).
> 
> For those that do not remember, the bug in dpkg would have caused doc
> files to go missing if /usr/doc was a symlink to share/doc, once a package
> was upgraded from the latter to the former (docs in /usr/share/doc).
> 
> That is no longer the case, so I would hope that our efforts would be
> better spent writing a transition script to handle the move (moving things
> from /usr/doc to /usr/share/doc, if needed, and removing symlinks).

Well I guess that would be ok; it would certianly be easier.

> We just need a script/program that sanely does this transition, then
> creates the /usr/doc -> share/doc symlink.

So it will need to:

1. Remove all symlinks in /usr/doc that correspond to
   symlinks or directories with the same names in /usr/share/doc
2. If there are any directories with the same names in /usr/doc and
   /usr/share/doc, merge them. (And probably whine about it, since
   that's a bug.)
3. Move any remaining directories and symlinks that are in /usr/doc to
   /usr/share/doc
4. Move any files in /usr/doc to /usr/share/doc (shouldn't be necessary,
   but just in case). 
5. Remove /usr/doc
6. Link /usr/doc to /usr/share/doc

-- 
see shy jo