-
Notifications
You must be signed in to change notification settings - Fork 4
/
config-package.mk
112 lines (108 loc) · 4.77 KB
/
config-package.mk
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
# -*- mode: makefile; coding: utf-8 -*-
# Copyright © 2007-2008 Anders Kaseorg <[email protected]> and
# Tim Abbott <[email protected]>
#
# This program is free software; you can redistribute it and/or
# modify it under the terms of the GNU General Public License as
# published by the Free Software Foundation; either version 2, or (at
# your option) any later version.
#
# This program is distributed in the hope that it will be useful, but
# WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
# General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
# 02111-1307 USA.
# /usr/share/cdbs/1/rules/config-package.mk is the externally-facing
# makefile fragment for config-package-dev. It should be included
# after the following variables are set in debian/rules.
#
#
# Most variables are lists, so one can
#
# DEB_DISPLACE_FILES_package += /path1/file1.divert \
# /path2/file2.divert \
# /path3/file3.divert
#
# We use += in the examples
#
# The config-package-dev system supports the following variables:
#
# DEB_DISPLACE_EXTENSION
#
# Extension used for all config-package-dev diversions (defaults to
# .divert, which we will use in examples). This field is difficult to
# change on package upgrades; we recommend picking a value to use for
# all packages at your site.
#
# DEB_DISPLACE_FILES_package += /path/file.divert
#
# List of absolute paths to files to be replaced at package install
# time by being diverted from /path/file to /path/file.divert-orig
# (DEB_DISPLACE_EXTENSION should be part of the path, but need not
# appear at the end); a symlink /path/file -> /path/file.divert will
# be installed in its place. The user is responsible for installing
# /path/file.divert. This is best for diverting binaries and most
# configuration files.
#
# DEB_TRANSFORM_FILES_package += /path/file.divert
#
# This works like DEB_DISPLACE_FILES, but additionally the file to be
# installed to /path/file.divert will be generated at package build
# time as the standard output from
#
# $(DEB_TRANSFORM_SCRIPT_path/file.divert) < $(DEB_CHECK_FILES_SOURCE_/path/file.divert)
#
# These variables have the following defaults:
#
# DEB_TRANSFORM_SCRIPT_path/file.divert = debian/transform_file.divert
# DEB_CHECK_FILES_SOURCE_/path/file.divert = /path/file
#
# If DEB_CHECK_FILES_SOURCE_/path/file.divert does not match the
# md5sums shipped with the package containing it, the package build
# will abort. DEB_TRANSFORM_FILES is targeted at making changes to a
# (potentially long) configuration file that will work on several
# Debian versions. We recommend using DEB_TRANSFORM_FILES in
# conjunction with pbuilder, sbuild, or another tool for building
# Debian packages in a clean environment. (That said, if /path/file is
# diverted on the running system, DEB_CHECK_FILES_SOURCE does
# reverse-resolve the diversion and default to the original version of
# the file, to allow you to rebuild a package using DEB_TRANSFORM_FILES
# that is currently installed, in most cases.)
#
# DEB_HIDE_FILES_package += /path/file
#
# List of absolute paths to files to be diverted to a unique path in
# /usr/share/package/. No symlink or replacement file will be
# installed. This system is useful for disabling files in /etc/cron.d
# or similar .d directories where the normal divert-and-symlink
# approach would result in (e.g.) the old cron job still being run,
# and any new cron job being run twice. Note that for technical
# reasons related to how dpkg unpacks files, you cannot also install a
# replacement file to /etc/cron.d/file; you must install it to some
# other path (which should be fine in a .d directory). If you want to
# install a replacement file with the same name, you probably want
# DEB_DISPLACE_FILES.
#
# DEB_UNDISPLACE_FILES_package += /path/file.divert
#
# List of absolute paths to files whose diversions caused by
# DEB_DISPLACE_FILES are to be removed upon installing this package, if
# the diversions have been made on the target system. This is
# primarily useful for removing a now-unnecessary displacement provided by
# a previous version of this package on an upgrade.
#
# DEB_UNHIDE_FILES_package += /path/file
#
# This works like DEB_UNDISPLACE_FILES_package, except that it undoes
# the work of a previous DEB_HIDE_FILES. In particular, it only removes
# the diversion, whereas DEB_UNDISPLACE_FILES first removes the symlink
# generated by DEB_DISPLACE_FILES.
ifndef _cdbs_rules_config_package
_cdbs_rules_config_package = 1
# transform-files.mk includes the other config-package-dev fragments.
include /usr/share/cdbs/1/rules/transform-files.mk
endif