mirror_frr/debianpkg/backports
smccroskey 9782a8db77 debianpkg: normalize rules files
downstream packagers prefer to change defaults in a trackable way by
changing the rules file directly, rather than setting environment
variables.  Use '?=' (set if not already set in the environment or on
the make cmdline) to set defaults rather than alternating between
ifeq/ifneq clauses, which is harder to follow and edit.  Change any
existing `ifneq(...,0)' cases to `ifeq(...,1)', and get rid of any
ifdef/ifndefs, as ?= guarantees he value will be defined in one way or
another.  This allows the old behavior of overriding via the
environment while simplifying the workflow for anyone editing or
extending the current logic and defaults.

Portability note about '?=': it is GNU-make specific, but so is
ifeq/ifneq, which is/was used in this file, and this file is specific
to debian-based system as it is, so I don't consider it to be a
problem in this case.

Added any missing defaults (WANT_SNMP, WANT_CUMULUS_NODE) and
made it so that USE_XXX is always set for the sake of consistency.
Also brought a few changes from base debianpkg/rules into the
backports versions of the files where they were missing.

Signed-off-by: Silas McCroskey <smccroskey@cumulusnetworks.com>
2018-01-31 14:57:47 -08:00
..
debian8 debianpkg: Fix Date format in changelog and version numbering to make sure custom build is newer 2017-11-17 17:55:31 -08:00
debian9 debianpkg: Add Debian 9 Package support 2017-11-17 17:55:33 -08:00
ubuntu12.04 debianpkg: normalize rules files 2018-01-31 14:57:47 -08:00
ubuntu14.04 debianpkg: normalize rules files 2018-01-31 14:57:47 -08:00
ubuntu16.04 debianpkg: Fix Date format in changelog and version numbering to make sure custom build is newer 2017-11-17 17:55:31 -08:00
ubuntu17.10 debianpkg: Add Debian backport for Ubuntu 17.10 2017-12-05 00:30:30 -08:00
.gitignore debian->debianpkg: Move debian files from debian dir to debianpkg dir. 2017-11-17 17:55:30 -08:00
README debian->debianpkg: Move debian files from debian dir to debianpkg dir. 2017-11-17 17:55:30 -08:00
rules debianpkg: Fix 'make backports' warning about autopkgtest 2017-11-17 17:55:32 -08:00

This directory contains the debian directories for backports to other debian
platforms.  These are built via the `3.0 (custom)' source format, which
allows one to build a source package directly out of tarballs (e.g. an
orig.tar.gz tarball and a debian.tar.gz file), at which point the format can
be changed to a real format (e.g. `3.0 (quilt)').

Source packages are assembled via targets of the same name as the system to
which the backport is done (e.g. `precise'), included in debian/rules.

To create a new debian backport:

* Add its name to `KNOWN_BACKPORTS', defined in debian/rules.
* Create a directory of the same name in debian/backports.
* Add the files `exclude', `versionext', and `debian/source/format' under
  this directory:
  * `exclude' contains whitespace-separated paths (relative to the root of
    the source dir) that should be excluded from the source package (e.g.
    debian/patches).
  * `versionext' contains the suffix added to the version number for this
    backport's build.  Distributions often have guidelines for what this
    should be. If left empty, no new debian/changelog entry is created.
  * `debian/source/format' should contain the source format of the resulting
    source package.  As of of the writing of this document the only supported
    format is `3.0 (quilt)'.
* Add appropriate files under the `debian/' subdirectory.  These will be
  included in the source package, overriding any top-level `debian/' files
  with equivalent paths.