File: README.source

package info (click to toggle)
doc-rfc 20181229-2
  • links: PTS, VCS
  • area: non-free
  • in suites: buster
  • size: 570,944 kB
  • sloc: xml: 285,646; sh: 107; python: 90; perl: 42; makefile: 14
file content (38 lines) | stat: -rw-r--r-- 1,537 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
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