documentation about Wig & Pen source format (dpkg source format 2.0)
is there any documentation or howto about Wig & Pen source format (dpkg source
format 2.0) ? Maybe an update to the NMG could be helpfull ?
the bits from dpkg maintainer was too short for me ;) :
Wig & Pen source format
The Wig & Pen ("Format: 2.0") source format is an evolutionary (rather
than revolutionary) change to the current source package format.
Brendan O'Dea's work on providing _unpack_ support has been integrated
into dpkg-source. Support for building these formats will be added as
it matures and solidifies.
Existing source packages ("Format: 1.0") are supported without
The basics of the new format are:
* Multiple upstream tarballs are supported:
The orig.tar.gz is unpacked as normal, additional upstream
tarballs are named orig-XXX.tar.gz and unpacked into the XXX
sub-directory of the source.
Thus glibc might be unpacked as:
glibc-2.3.2.ds1 (from glibc_2.3.2.ds1.orig.tar.gz)
glibc-2.3.2.ds1/nptl (from glibc_2.3.2.ds1.orig-nptl.tar.gz)
* The "Debian Diff" may be replaced by the "Debian Tar":
Instead of placing your changes and Debian directory as a patch
against the upstream tarball in a diff.gz, you may instead ship
the Debian directory as a debian.tar.gz. This is unpacked into
the debian sub-directory of the source.
Changes to upstream may then be stored as separate patches in
the debian/patches directory, and are applied automatically
(with the same rules as run-parts) to the upstream source when
the package is unpacked.
Thus glibc would be unpacked as:
glibc-2.3.2.ds1/debian (from glibc_2.3.2.ds1-20.debian.tar.gz)
* Bzip2 compression is supported as an alternative to gzip.
This can be picked on a file by file basis, you might choose to
compress the upstream source with bzip2 and the debian tarball
with gzip to get the best results.
Further improvements may be made to this format in later 1.13 releases,
and as build support is added.