Bug#102199: Next stage in usr/doc -> usr/share/doc transition
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
Anthony Towns <aj@azure.humbug.org.au> wrote:
>I think the most efficient way of handling usr/doc for woody will be to
>have everything reference /usr/share/doc, and require all packages to
>put their files in /usr/share/doc, and to make symlinks in /usr/doc. The
>latter is mainly for partial upgrades.
>
>To achieve this, we only need two changes: one, programs that access docs
>need to do so via /usr/share/doc, and two, we need to upgrade any existing
>bugs about usr/doc to serious (note that current policy already lists this as
>a "must", so this is a change in spirit not letter).
I would prefer to see only bugs about placement upgraded to serious;
what some man page or other refers to hardly seems RC to me. (Or maybe
that's what you meant.)
>The packages this affects are (roughly):
http://qa.debian.org/fhs.html has counts of what the current Contents
files say on each arch, with the full list for i386.
>--- policy.sgml.orig Fri Jun 1 19:40:16 2001
>+++ policy.sgml Mon Jun 25 20:29:29 2001
>@@ -6481,14 +6481,7 @@
>
> <p>
> HTML documents for a package are stored in
>- <tt>/usr/share/doc/<var>package</var></tt> but should
>- be accessed via symlinks as
>- <tt>/usr/doc/<var>package</var></tt><footnote>
>- <p>
>- for backward compatibility; see <ref
>- id="usrdoc">
>- </p>
>- </footnote>
>+ <tt>/usr/share/doc/<var>package</var></tt>
> and can be referred to as
> <example compact="compact">
> http://localhost/doc/<var>package</var>/<var>filename</var>
>@@ -7747,7 +7740,7 @@
> </example>
> To view the copyright file for a package you could use this command:
> <example>
>- dpkg --fsys-tarfile <var>filename</var>.deb | tar xof usr/doc/<var>\*</var>copyright | less
>+ dpkg --fsys-tarfile <var>filename</var>.deb | tar xof usr/share/doc/<var>\*</var>copyright | less
> </example>
> </p>
> </sect>
Seconded.
- --
Colin Watson [cjwatson@flatline.org.uk]
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.6 (GNU/Linux)
Comment: Colin Watson <cjwatson@debian.org> -- Debian GNU/Linux developer
iD8DBQE7NztuMVrRHkkXpRQRAhrdAJ9mkvoRqnzkLiwAyIGnhCXESEkIeACfXIVX
P0MfOUDEdgkNbbREd74M/SQ=
=W9F8
-----END PGP SIGNATURE-----
Reply to: