documentation about Wig & Pen source format (dpkg source format 2.0)

[Fathi BOUDRA <fboudra@uxp.fr>]

hi,

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
modification.

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)
        glibc-2.3.2.ds1/posixthreads (from 
glibc_2.3.2.ds1.orig-posixthreads.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.