Andrew Starr-Bochicchio has proposed merging lp:~andrewsomething/ubuntu-packaging-guide/lp-792386 into lp:ubuntu-packaging-guide.
Requested reviews: Andrew Starr-Bochicchio (andrewsomething) Related bugs: Bug #792386 in Ubuntu Packaging Guide: "Source Format Discussion Inaccurate" https://bugs.launchpad.net/ubuntu-packaging-guide/+bug/792386 For more details, see: https://code.launchpad.net/~andrewsomething/ubuntu-packaging-guide/lp-792386/+merge/79869 -- https://code.launchpad.net/~andrewsomething/ubuntu-packaging-guide/lp-792386/+merge/79869 Your team Ubuntu Packaging Guide Team is subscribed to branch lp:ubuntu-packaging-guide.
=== modified file 'debian-dir-overview.rst' --- debian-dir-overview.rst 2011-07-12 15:52:55 +0000 +++ debian-dir-overview.rst 2011-11-08 03:12:23 +0000 @@ -328,22 +328,33 @@ The source/format file ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -This file indicates the format of the source package. Currently, the package -source format defaults to 1.0 if this file does not exist. You are encouraged -to use the newer 3.0 source format. In this case, the file should contain a -single line indicating the desired format: +This file indicates the format of the source package. It should contain +a single line indicating the desired format: -* ``3.0 (native)`` for Debian native packages (no upstream version) or +* ``3.0 (native)`` for Debian native packages (no upstream version) * ``3.0 (quilt)`` for packages with a separate upstream tarball -If for some reason, you wish to keep using the old format, please create this -file and put ``1.0`` in it to be explicit about the source package version. -This allows for the future removal of the 1.0 default for the package source -format. - -http://wiki.debian.org/Projects/DebSrc3.0 summarizes information concerning and -the benefits of the switch to the 3.0 source package formats. +* ``1.0`` for packages wishing to explicitly declare the default format + +Currently, the package source format will default to 1.0 if this file does not +exist. You can make this explicit in the source/format file. If you choose not +to use this file to define the source format, Lintian will warn about the +missing file. This warning is informational only and may be safely ignored. + +You are encouraged to use the newer 3.0 source format. It provides +a number of new features: + +* Support for additional compression formats: bzip2, lzma and xz + +* Support for multiple upstream tarballs + +* Not necessary to repack the upstream tarball to strip the debian directory + +* Debian-specific changes are no longer stored in a single .diff.gz but in multiple patches compatible with quilt under ``debian/patches/`` + +http://wiki.debian.org/Projects/DebSrc3.0 summarizes additional information +concerning the switch to the 3.0 source package formats. See ``man dpkg-source`` and the `source/format section (Section 5.21) <http://www.debian.org/doc/manuals/maint-guide/dother.en.html#sourcef>`_ of
_______________________________________________ Mailing list: https://launchpad.net/~ubuntu-packaging-guide-team Post to : [email protected] Unsubscribe : https://launchpad.net/~ubuntu-packaging-guide-team More help : https://help.launchpad.net/ListHelp
