| 1 |
#use wml::templ::template title="FHS transition" author="Colin Watson, Martin Michlmayr"
|
| 2 |
|
| 3 |
<p>In September 1999, the Technical Committee
|
| 4 |
<a href="http://lists.debian.org/debian-ctte-9909/msg00023.html">approved</a> a
|
| 5 |
<a href="http://lists.debian.org/debian-ctte-9908/msg00038.html">proposal</a>
|
| 6 |
to move documentation to /usr/share/doc (as required by the
|
| 7 |
<a href="http://www.pathname.com/fhs/">Filesystem Hierarchy Standard</a>)
|
| 8 |
with a forest of symlinks from /usr/doc. This transition was finally completed
|
| 9 |
for woody in April 2002; the symlinks will be removed starting with sarge.</p>
|
| 10 |
|
| 11 |
<p>This list also includes packages containing files in /usr/man since the FHS
|
| 12 |
(Filesystem Hierarchy Standard) requires man pages to be in /usr/share/man.
|
| 13 |
However, this is not quite so important, as the problem of symlinks from
|
| 14 |
/usr/doc to /usr/share/doc doesn't arise, but it should be fixed for FHS
|
| 15 |
compatibility.</p>
|
| 16 |
|
| 17 |
<p>Note that the Contents-*.gz files used to generate this scoreboard may
|
| 18 |
be a little out of date, although some overrides are in place. Depending on
|
| 19 |
the architecture, many entries may be due to a newer version of the package
|
| 20 |
not having been ported yet. Only the full listing for i386 is shown below,
|
| 21 |
if you want the detailed listing for an alternative architecture, please
|
| 22 |
click on one of the following links.</p>
|
| 23 |
|
| 24 |
<p>These figures track etch, the current testing distribution.</p>
|
| 25 |
|
| 26 |
<p>
|
| 27 |
|
| 28 |
<:
|
| 29 |
|
| 30 |
open(DOC, "/org/qa.debian.org/data/doc-scoreboard.txt") || die "Cannot open doc-scoreboard.txt: $!";
|
| 31 |
$all = <DOC>;
|
| 32 |
print "<P>\n";
|
| 33 |
$line = <DOC>;
|
| 34 |
chomp($line);
|
| 35 |
while ($line) {
|
| 36 |
($arch, $number) = split(/:\s+/, $line);
|
| 37 |
print "<A HREF=\"http://people.debian.org/~cjwatson/doc-scoreboard.html",
|
| 38 |
"#$arch\">$arch</A>: $number\n";
|
| 39 |
|
| 40 |
$line = <DOC>;
|
| 41 |
chomp($line);
|
| 42 |
}
|
| 43 |
|
| 44 |
:>
|
| 45 |
|
| 46 |
<p>The rules are these: send in a patch through the
|
| 47 |
<a href="http://bugs.debian.org/">Bug Tracking System</a> (BTS) which performs
|
| 48 |
the transition from /usr/doc and /usr/man to /usr/share/{doc,man} and mention
|
| 49 |
that you will NMU in three weeks if the maintainer doesn't show any
|
| 50 |
activity until then.</p>
|
| 51 |
|
| 52 |
<p>If you are not a registered Debian developer, you can still submit
|
| 53 |
a patch to the BTS. If the maintainer has not made an upload with
|
| 54 |
your patch in 3 weeks, please contact debian-qa@lists.debian.org.
|
| 55 |
A Debian developer will then make an upload of the package using your
|
| 56 |
patch (and give you feedback and credit).</p>
|
| 57 |
|
| 58 |
|
| 59 |
<:
|
| 60 |
|
| 61 |
open REMOVALS, "/org/qa.debian.org/data/fhs/removals" or die "Cannot open removals: $!";
|
| 62 |
my %removals;
|
| 63 |
while (<REMOVALS>) {
|
| 64 |
next if /^#/;
|
| 65 |
chomp;
|
| 66 |
$removals{$_} = 1;
|
| 67 |
}
|
| 68 |
close REMOVALS;
|
| 69 |
|
| 70 |
print "<p>\n";
|
| 71 |
print "$all\n";
|
| 72 |
print "<p>\n";
|
| 73 |
|
| 74 |
print "<ol>\n";
|
| 75 |
while ($package = <DOC>) {
|
| 76 |
chomp($package);
|
| 77 |
print "<li><a href=\"http://packages.debian.org/$package\">$package</a>";
|
| 78 |
print " <a href=\"http://packages.debian.org/cgi-bin/search_contents.pl",
|
| 79 |
"?word=$package&case=insensitive&version=unstable&arch=i386",
|
| 80 |
"&directories=yes&searchmode=filelist\">(contents)</a>";
|
| 81 |
print " <a href=\"http://bugs.debian.org/cgi-bin/pkgreport.cgi",
|
| 82 |
"?pkg=$package&repeatmerged=yes\">(bugs)</a>";
|
| 83 |
print " (to be removed)" if $removals{$package};
|
| 84 |
print "<br>";
|
| 85 |
$maintainer = <DOC>;
|
| 86 |
$maintainer =~ s/</</g;
|
| 87 |
$maintainer =~ s/>/>/g;
|
| 88 |
print $maintainer;
|
| 89 |
}
|
| 90 |
print "</ol>\n";
|
| 91 |
|
| 92 |
close(DOC);
|
| 93 |
|
| 94 |
:>
|
| 95 |
|