17
17
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
20
# /usr/share/cdbs/1/rules/config-package.mk is the externally-facing
21
# makefile fragment for config-package-dev. It should be included
22
# after the following variables are set in debian/rules.
25
# Most variables are lists, so one can
27
# DEB_DIVERT_FILES_package += /path1/file1.divert \
28
# /path2/file2.divert \
31
# We use += in the examples
33
# The config-package-dev system supports the following variables:
35
# DEB_DIVERT_EXTENSION
37
# Extension used for all config-package-dev diversions (defaults to
38
# .divert, which we will use in examples). This field is difficult to
39
# change on package upgrades; we recommend picking a value to use for
40
# all packages at your site.
42
# DEB_DIVERT_FILES_package += /path/file.divert
44
# List of absolute paths to files to be replaced at package install
45
# time by being diverted from /path/file to /path/file.divert-orig
46
# (DEB_DIVERT_EXTENSION should be part of the path, but need not
47
# appear at the end); a symlink /path/file -> /path/file.divert will
48
# be installed in its place. The user is responsible for installing
49
# /path/file.divert. This is best for diverting binaries and most
50
# configuration files.
52
# DEB_TRANSFORM_FILES_package += /path/file.divert
54
# This works like DEB_DIVERT_FILES, but additionally the file to be
55
# installed to /path/file.divert will be generated at package build
56
# time as the standard output from
58
# $(DEB_TRANSFORM_SCRIPT_path/file.divert) < $(DEB_CHECK_FILES_SOURCE_/path/file.divert)
60
# These variables have the following defaults:
62
# DEB_TRANSFORM_SCRIPT_path/file.divert = debian/transform_file.divert
63
# DEB_CHECK_FILES_SOURCE_/path/file.divert = path/file
65
# If DEB_CHECK_FILES_SOURCE_/path/file.divert does not match the
66
# md5sums shipped with the package containing it, the package build
67
# will abort. DEB_TRANSFORM_FILES is targeted at making changes to a
68
# (potentially long) configuration file that will work on several
69
# Debian versions. We recommend using DEB_TRANSFORM_FILES in
70
# conjunction with pbuilder, sbuild, or another tool for building
71
# Debian packages in a clean environment.
73
# DEB_REMOVE_FILES_package += /path/file
75
# List of absolute paths to files to be diverted to a unique path in
76
# /usr/share/package/. No symlink or replacement file will be
77
# installed. This system is useful for disabling files in /etc/cron.d
78
# or similar .d directories where the normal divert-and-symlink
79
# approach would result in (e.g.) the old cron job still being run,
80
# and any new cron job being run twice. Note that for technical
81
# reasons related to how dpkg unpacks files, you cannot also install a
82
# replacement file to /etc/cron.d/file; you must install it to some
83
# other path (which should be fine in a .d directory). If you want to
84
# install a replacement file with the same name, you probably want
87
# DEB_UNDIVERT_FILES_package += /path/file.divert
88
# DEB_UNDIVERT_VERSION_/path/file.divert = 1.0-1
90
# List of absolute paths to files whose diversions caused by
91
# DEB_DIVERT_FILES are to be removed upon installing this package.
92
# This is primarily useful for removing a now-unecessary diversion
93
# provided by a previous version of this package on an upgrade.
95
# The DEB_UNDIVERT_VERSION_file variable should be set to the
96
# version number of this package at which you added
97
# DEB_UNDIVERT_FILES_path/file.divert; it is used to avoid attempting
98
# to remove the diversions again on future upgrades.
100
# DEB_UNREMOVE_FILES_package += /path/file
101
# DEB_UNREMOVE_VERSION_/path/file = 1.0-1
103
# This works like DEB_UNDIVERT_FILES_package, except that it only
104
# removes the diversion (not a symlink) and the version number is
105
# specified with DEB_UNREMOVE_VERSION_/path/file.
20
107
ifndef _cdbs_rules_config_package
21
108
_cdbs_rules_config_package = 1
110
# transform-files.mk includes the other config-package-dev fragments.
23
111
include /usr/share/cdbs/1/rules/transform-files.mk