examples/EXAMPLES

   1 This directory contains example packages using the config-package-dev
   2 system that you can start from in designing your own packages.
   3
   4 debathena-conffile-example-1.0:
   5     Displaces a configuration file and provides different configuration
   6 debathena-conffile-example-1.1:
   7     Transforms a configuration file if it exists at build time
   8 debathena-bin-example-1.0:
   9     Displaces a binary and provides a wrapper script
  10 debathena-bin-example-1.1:
  11     Upgrades debathena-bin-example-1.0 undoing one of the displacements
  12 debathena-transform-example-1.0:
  13     Transforms a configuration file
  14 debathena-cron-example-1.0:
  15     Hides a cron job
  16
  17 Both CDBS and Debhelper 7+ versions are provided, in the cdbs/ and
  18 debhelper/ directories, respectively.
  19
  20
  21 If you are trying to build these packages out of a config-package-dev
  22 source tree (e.g., because you are hacking on config-package-dev), note
  23 that you will need to set a few environment variables to make things
  24 work. For debuild, e.g., try the command
  25
  26 debuild -e PERL5LIB=../../.. -e DH_AUTOSCRIPTDIR=../../.. --prepend-path=../../..
  27
  28 This trick will not work for CDBS, since debian/rules hard-codes an
  29 absolute path to CDBS class and rules files.
  30
  31
  32 For the CDBS examples, note that if you want the control files to be
  33 regenerated from the control.in files, you need to add
  34
  35 DEB_AUTO_UPDATE_DEBIAN_CONTROL=1
  36
  37 to the debian/rules files (or e.g. set it in your environment).
  38
  39 We do not include DEB_AUTO_UPDATE_DEBIAN_CONTROL=1 in these example
  40 rules files because option is banned in official Debian packages (see
  41 the CDBS section of <http://ftp-master.debian.org/REJECT-FAQ.html>).
  42
  43
  44 config-package-dev supports older versions of debhelper, although
  45 examples are not given.  You can use it in your own packages by adding
  46 dh_configpackage into the list of dh_* commands in debian/rules, before
  47 dh_link.