ubuntu-packaging-guide-team team mailing list archive

[Andrew Starr-Bochicchio <a.starr.b@xxxxxxxxx>]

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