[22923] | 1 | # -*- mode: makefile; coding: utf-8 -*- |
---|
| 2 | # Copyright © 2007-2008 Anders Kaseorg <andersk@mit.edu> and |
---|
| 3 | # Tim Abbott <tabbott@mit.edu> |
---|
| 4 | # |
---|
| 5 | # This program is free software; you can redistribute it and/or |
---|
| 6 | # modify it under the terms of the GNU General Public License as |
---|
| 7 | # published by the Free Software Foundation; either version 2, or (at |
---|
| 8 | # your option) any later version. |
---|
| 9 | # |
---|
| 10 | # This program is distributed in the hope that it will be useful, but |
---|
| 11 | # WITHOUT ANY WARRANTY; without even the implied warranty of |
---|
| 12 | # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
---|
| 13 | # General Public License for more details. |
---|
| 14 | # |
---|
| 15 | # You should have received a copy of the GNU General Public License |
---|
| 16 | # along with this program; if not, write to the Free Software |
---|
| 17 | # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA |
---|
| 18 | # 02111-1307 USA. |
---|
| 19 | |
---|
[23076] | 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. |
---|
| 23 | # |
---|
| 24 | # |
---|
| 25 | # Most variables are lists, so one can |
---|
| 26 | # |
---|
| 27 | # DEB_DIVERT_FILES_package += /path1/file1.divert \ |
---|
| 28 | # /path2/file2.divert \ |
---|
| 29 | # /path3/file3.divert |
---|
| 30 | # |
---|
| 31 | # We use += in the examples |
---|
| 32 | # |
---|
| 33 | # The config-package-dev system supports the following variables: |
---|
| 34 | # |
---|
| 35 | # DEB_DIVERT_EXTENSION |
---|
| 36 | # |
---|
| 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. |
---|
| 41 | # |
---|
| 42 | # DEB_DIVERT_FILES_package += /path/file.divert |
---|
| 43 | # |
---|
| 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. |
---|
| 51 | # |
---|
| 52 | # DEB_TRANSFORM_FILES_package += /path/file.divert |
---|
| 53 | # |
---|
| 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 |
---|
| 57 | # |
---|
| 58 | # $(DEB_TRANSFORM_SCRIPT_path/file.divert) < $(DEB_CHECK_FILES_SOURCE_/path/file.divert) |
---|
| 59 | # |
---|
| 60 | # These variables have the following defaults: |
---|
| 61 | # |
---|
| 62 | # DEB_TRANSFORM_SCRIPT_path/file.divert = debian/transform_file.divert |
---|
| 63 | # DEB_CHECK_FILES_SOURCE_/path/file.divert = path/file |
---|
| 64 | # |
---|
| 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. |
---|
| 72 | # |
---|
| 73 | # DEB_REMOVE_FILES_package += /path/file |
---|
| 74 | # |
---|
| 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 |
---|
| 85 | # DEB_DIVERT_FILES. |
---|
| 86 | # |
---|
| 87 | # DEB_UNDIVERT_FILES_package += /path/file.divert |
---|
| 88 | # |
---|
| 89 | # List of absolute paths to files whose diversions caused by |
---|
[24906] | 90 | # DEB_DIVERT_FILES are to be removed upon installing this package, if |
---|
| 91 | # the diversions have been made on the target system. This is |
---|
| 92 | # primarily useful for removing a now-unecessary diversion provided by |
---|
| 93 | # a previous version of this package on an upgrade. |
---|
[23076] | 94 | # |
---|
| 95 | # DEB_UNREMOVE_FILES_package += /path/file |
---|
| 96 | # |
---|
| 97 | # This works like DEB_UNDIVERT_FILES_package, except that it only |
---|
[24906] | 98 | # removes the diversion (not a symlink). |
---|
[23076] | 99 | |
---|
[22923] | 100 | ifndef _cdbs_rules_config_package |
---|
| 101 | _cdbs_rules_config_package = 1 |
---|
| 102 | |
---|
[23076] | 103 | # transform-files.mk includes the other config-package-dev fragments. |
---|
[22923] | 104 | include /usr/share/cdbs/1/rules/transform-files.mk |
---|
| 105 | |
---|
| 106 | endif |
---|