debian/backports/README

   1 This directory contains the debian directories for backports to other debian
   2 platforms.  These are built via the `3.0 (custom)' source format, which
   3 allows one to build a source package directly out of tarballs (e.g. an
   4 orig.tar.gz tarball and a debian.tar.gz file), at which point the format can
   5 be changed to a real format (e.g. `3.0 (quilt)').
   6
   7 Source packages are assembled via targets of the same name as the system to
   8 which the backport is done (e.g. `precise'), included in debian/rules.
   9
  10 To create a new debian backport:
  11
  12 * Add its name to `KNOWN_BACKPORTS', defined in debian/rules.
  13 * Create a directory of the same name in debian/backports.
  14 * Add the files `exclude', `versionext', and `debian/source/format' under
  15   this directory:
  16   * `exclude' contains whitespace-separated paths (relative to the root of
  17     the source dir) that should be excluded from the source package (e.g.
  18     debian/patches).
  19   * `versionext' contains the suffix added to the version number for this
  20     backport's build.  Distributions often have guidelines for what this
  21     should be. If left empty, no new debian/changelog entry is created.
  22   * `debian/source/format' should contain the source format of the resulting
  23     source package.  As of of the writing of this document the only supported
  24     format is `3.0 (quilt)'.
  25 * Add appropriate files under the `debian/' subdirectory.  These will be
  26   included in the source package, overriding any top-level `debian/' files
  27   with equivalent paths.
  28