Hello,

here is the mail I made one week ago to vorlon stating that I did repackage
doc-rfc, closing most of its bugs on the way. I'm resending this to
debian-qa because I'm affraid that someone else dupplicate this work... 

Could someone please comment on this ?

Thanks, Mt.

----- Forwarded message from mquinson -----

Date: Tue, 8 Apr 2003 11:45:05 +0200
To: Steve Langasek <[EMAIL PROTECTED]>
Cc: Martin Quinson <[EMAIL PROTECTED]>
Subject: Re: doc-rfc package

[...]

Ok, I finnaly found my previous work on this package on an old and forgotten
computer, and continued a bit. The result is available on 
 deb http://www.ens-lyon.fr/~mquinson/debian unstable main non-free
when the web server of my school is up (every two days :( Those packages are
signed with the key I used in the NM process.

I decided to make all doc-rfc-* packages empty transitional package, and put
the RFCs in rfc-* packages. Here is the changelog entry:
>>>>>>>>>>>>>>>>>>>>>>>>>
rfc (20030405-1) unstable; urgency=low

  * Hijacked version because maintainer is MIA, and because the package have 
    a lot of bugs opened (some of them being RC) since almost two year.
  * Moved to non-free as long as #92810 isn't resolved with upstream.
  * RFC moved from one package to another again.
  * Now build from the source (closes: #133563).
  * Update to lastest RFCs (closes: #134524, #119589)
  * Clarify (closes: #117561) and spell check (closes: #124559) package
    description.
  * RFC2822 is now in std-proposed as it should. (closes: #172857, #133124)
  * Include a very simple searching tool, thanks to Christian Hammers for
    providing that (closes: #116567, #74385).
  
  * Still to do: 
    - the RFC are no longer installed in the doc-base mecanism. Given the
      amount of files, we should work on a category in doc-base, along man
      and info
    - handeling the editor queue
    - take care of the STD***** nicknames, but STO0051 is rfc1661 and
      rfc1662, so how to handle this?

 -- Martin Quinson <[EMAIL PROTECTED]>  Mon,  7 Apr 2003 18:07:18 +0200
<<<<<<<<<<<<<<<<<<<<<<<<<<<<


The build process is much cleaner now. No more error, and some stats about
how many RFCs are put in each package:
>>>>>>>>>>>>>>>>>>>
Parse the index... got 3254 installable entries.

Cleanup: Move old RFCs to regular package if no xxx-old package is to be built
  informational-old -> informational (92 files)
  bcp-old -> bcp (2 files)
  unclassified-old -> unclassified (162 files)
  experimental-old -> experimental (44 files)
  historic-old -> historic (73 files)
Moved 373 files.

Install RFCs
  installing rfc-informational (980 files)...
  (don't install bcp like other packages, but like fyi)
  installing rfc-standard (65 files)...
  installing rfc-standard-old (8 files)...
  installing rfc-proposed (694 files)...
  installing rfc-proposed-old (176 files)...
  installing rfc-draft (62 files)...
  installing rfc-draft-old (34 files)...
  installing rfc-unclassified (838 files)...
  installing rfc-experimental (199 files)...
  installing rfc-historic (132 files)...
Installed 3254 RFCs (out of 3254 entries).    (Fine, installed == entries)

Install the FYI serie (38 files)
Install the BCP serie (66 files)
FIXME: do install the STD serie (56 files)
<<<<<<<<<<<<<<<<<<<

The search script add is the one in #116567. That's a bit light, but I plan
to do better in another release, when the cruft disapear. It is far from
being good, since it doesn't handle the case when an rfc isn't compressed,
neither does it handle the lack of existance of a given file.
>>>>>>>>>>>>>>>>>>>
#! /usr/bin/perl

use strict;

my($DIR) = "/usr/share/doc/RFC/all";

my(%P) = (
            "dns"           => \%{ {"nr"=>1034, "off"=>1} },
            "ftp"           => \%{ {"nr"=>765,  "off"=>1} },
            "http11"        => \%{ {"nr"=>2068, "off"=>1} },
            "icmp"          => \%{ {"nr"=>792,  "off"=>1108} },
            "ip"            => \%{ {"nr"=>791,  "off"=>830} },
            "pop3"          => \%{ {"nr"=>1939, "off"=>1} },
            "requirements"  => \%{ {"nr"=>1122, "off"=>1} },
            "tcp"           => \%{ {"nr"=>793,  "off"=>1075} },
            "udp"           => \%{ {"nr"=>768,  "off"=>26} },
    );

if ((not defined @ARGV) or ($#ARGV!=0)) {
            printf("Usage: rfc <keyword>|<number>\n\n".
                               "Where keyword is one of:\n".
                               "%s\n",
                               join(" ", map { "$_ " } sort keys %P));
            exit(1);
    }

$PAGER = "zless";

if (defined $P{$ARGV[0]}) {
    system("$PAGER +".$P{$ARGV[0]}{"off"}." 
$DIR/rfc".$P{$ARGV[0]}{"nr"}.".txt.gz");
} else {
    system("$PAGER $DIR/rfc".$ARGV[0].".txt.gz");
}
<<<<<<<<<<<<<<<<<<<<<<<<<

I mail you because I fail to find the right update path to fix the previous
broken version. In debian/control, I've said that all doc-rfc* package
depend on the rfc-* package which now contain the corresponding RFCs. Then,
all rfc-* packages have:
Conflicts: doc-rfc (<< 20020901), doc-rfc-0001-0999 (<< 20020901),
 doc-rfc-1000-1999 (<< 20020901), doc-rfc-2000-2999 (<< 20020901),
 doc-rfc-3000-3999 (<< 20020901), doc-rfc-experimental (<< 20020901),
 doc-rfc-fyi-bcp (<< 20020901), doc-rfc-misc (<< 20020901), doc-rfc-old-std
 (<< 20020901), doc-rfc-std (<< 20020901), doc-rfc-std-proposed (<< 20020901)

Lastly, I've put this script as {pre,post}{rm,inst} script for all doc-rfc*
package. I know it's a bit overkilling, but it should work.
>>>>>>>>>>>>>>>>>>>>>
#! /bin/sh

#Removing old cruft if it's still there

install-docs -s rfc-0index >/dev/null 2>&1 && install-docs -r rfc-0index || true
install-docs -s rfc-best-current-practice >/dev/null 2>&1 && install-docs -r 
rfc-best-current-practice || true
install-docs -s rfc-drafts >/dev/null 2>&1 && install-docs -r rfc-drafts || true
install-docs -s rfc-draft-standard >/dev/null 2>&1 && install-docs -r 
rfc-draft-standard || true
install-docs -s rfc-for-your-information >/dev/null 2>&1 && install-docs -r 
rfc-for-your-information || true
install-docs -s rfc-informational >/dev/null 2>&1 && install-docs -r 
rfc-informational || true
install-docs -s rfc-old-draft-standard >/dev/null 2>&1 && install-docs -r 
rfc-old-draft-standard || true
install-docs -s rfc-old-experimental >/dev/null 2>&1 && install-docs -r 
rfc-old-experimental || true
install-docs -s rfc-old-historic >/dev/null 2>&1 && install-docs -r 
rfc-old-historic || true
install-docs -s rfc-old-proposed-standard >/dev/null 2>&1 && install-docs -r 
rfc-old-proposed-standard || true
install-docs -s rfc-old-standard >/dev/null 2>&1 && install-docs -r 
rfc-old-standard || true
install-docs -s rfc-proposed-standard >/dev/null 2>&1 && install-docs -r 
rfc-proposed-standard || true


#DEBHELPER#

<<<<<<<<<<<<<<<<<<<

By the way, could you repport upstream that the RFC3412 appears twice in
rfc-index.txt?

I can now install the old packages, and then install the new ones using
dpkg, but I didn't test apt yet since I fail to set my apt repository right
at the moment. But I don't see any possible error, do you?

As I said, there is still lot to do to get a really nice packaging of that
stuff, but I've changed so much stuff so far that I fail to see where I
stand. I'd like to update those packages, and go further once this bunch of
crap is away.

Thanks for ready 'till here.

Bye, Mt.

-- 
Freedom is not free.

Reply via email to