doc-rfc for Debian
------------------

This package has multiple upstream sources:

- the actual tarball of all non-draft RFCs
- many draft RFCs, downloaded from upstream rsync
- html files showing each RFC's status, download from upstream website

Creating a new version:

The script debian/update-package.sh works on a local subdirectory tmp/
to retrieve the various materials used to create this package and
create the upstream tarballs. Note: This directory should *not* go
into either source or binary package!

The RFC-all.tar.gz will be used as
`doc-rfc_<filedate>.orig.tar.gz`. The other files (`*.txt`, `*.html`,
`rfc-index.xml`, etc.) are put under tmp/extra and will be archived
into an 'extra' component (see dpkg-source) to be unpacked into the
top-level 'extra/' directory. With git-buildpackage, this means (after
the archives are created by the script):

    $ gbp import-orig --component=extra /path/to/tarball
    $ gbp build-package --git-component=extra ...

Note that there is a `debian/gbp.conf` file which enables those
arguments by default, so in practice they don't need to be passed (but
are documented here since the config is not obvious).

 -- Iustin Pop <iustin@debian.org>, Wed,  2 Jan 2019 13:52:48 +0100

If you run git-import-orig make sure your /tmp partition is large enough.
Otherwise pristine-tar may fail. See also bug #600724. My tmpfs was ~600MB and
still too small. So I ran pristine tar manually:

mkdir -p ~/tmp && TMPDIR=~/tmp \
 pristine-tar debian/tmp/doc-rfc_20111105.orig.tar.gz upstream
