1DEVSCRIPTS.CONF(5) File Formats Manual DEVSCRIPTS.CONF(5)
2
6 devscripts.conf - configuration file for the devscripts package
7
9 The devscripts package provides a collection of scripts which may be of
10 use to Debian developers and others wishing to build Debian packages.
11 Many of these have options which can be configured on a system-wide and
12 per-user basis.
13 Every script in the devscripts package which makes use of values from
15 these configuration files describes the specific settings recognised in
16 its own manpage. (For a list of the scripts, either see
17 /usr/share/doc/devscripts/README.gz or look at the output of dpkg -L
18 devscripts | grep /usr/bin.)
19 The two configuration files are /etc/devscripts.conf for system-wide
21 defaults and ~/.devscripts for per-user settings. They are written
22 with bash(1) syntax, but should only have comments and simple variable
23 assignments in them; they are both sourced (if present) by many of the
24 devscripts scripts. Variables corresponding to simple switches should
25 have one of the values yes and no; any other setting is regarded as
26 equivalent to the default setting.
27 All variable names are written in uppercase, and begin with the script
29 name. Package-wide variables begin with "DEVSCRIPTS", and are listed
30 below, as well as in the relevant manpages.
31 For a list of all of the available options variables, along with their
33 default settings, see the example configuration file
34 /usr/share/doc/devscripts/devscripts.conf.ex. This is copied to
35 /etc/devscripts.conf when the devscripts package is first installed.
36 Information about configuration options introduced in newer versions of
37 the package will be appended to /etc/devscripts.conf when the package
38 is upgraded.
39 Every script which reads the configuration files can be forced to
41 ignore them by using --no-conf as the first command-line option.
42
44 The currently recognised package-wide variables are:
45 DEVSCRIPTS_CHECK_DIRNAME_LEVEL, DEVSCRIPTS_CHECK_DIRNAME_REGEX
47 These variables control scripts which change directory to find a
48 debian/changelog file or suchlike, and some other miscellaneous
49 cases. In order to prevent unwanted, even possibly dangerous,
50 behaviour, these variables control when actions will be per‐
51 formed. The scripts which currently make use of these variables
52 are: debc, debchange/dch, debclean, debi, debrelease, debuild
53 and uscan, but this list may change with time (and I may not
54 remember to update this manpage). Please see the manpages of
55 individual scripts for details of the specific behaviour for
56 each script.
57
59 devscripts(1) and /usr/share/doc/devscripts/README.gz.
60
62 This manpage was written for the devscripts package by the package
63 maintainer Julian Gilbey <jdg@debian.org>.
64DEBIAN Debian Utilities DEVSCRIPTS.CONF(5)