DEVSCRIPTS.CONF(5) DEVSCRIPTS.CONF(5)
NAME
devscripts.conf - configuration file for the devscripts package
DESCRIPTION
The devscripts package provides a collection of scripts which may be of
use to Debian developers and others wishing to build Debian packages.
Many of these have options which can be configured on a system-wide and
per-user basis.
Every script in the devscripts package which makes use of values from
these configuration files describes the specific settings recognised in
its own manpage. (For a list of the scripts, either see
/usr/share/doc/devscripts/README.gz or look at the output of dpkg -L
devscripts | grep /usr/bin.)
The two configuration files are /etc/devscripts.conf for system-wide
defaults and ~/.devscripts for per-user settings. They are written
with bash(1) syntax, but should only have comments and simple variable
assignments in them; they are both sourced (if present) by many of the
devscripts scripts. Variables corresponding to simple switches should
have one of the values yes and no; any other setting is regarded as
equivalent to the default setting.
All variable names are written in uppercase, and begin with the script
name. Package-wide variables begin with "DEVSCRIPTS", and are listed
below, as well as in the relevant manpages.
For a list of all of the available options variables, along with their
default settings, see the example configuration file
/usr/share/doc/devscripts/devscripts.conf.ex. This is copied to
/etc/devscripts.conf when the devscripts package is first installed.
Information about configuration options introduced in newer versions of
the package will be appended to /etc/devscripts.conf when the package
is upgraded.
Every script which reads the configuration files can be forced to
ignore them by using --no-conf as the first command-line option.
PACKAGE-WIDE VARIABLES
The currently recognised package-wide variables are:
DEVSCRIPTS_CHECK_DIRNAME_LEVEL, DEVSCRIPTS_CHECK_DIRNAME_REGEX
These control scripts which change directory to find a
debian/changelog file or suchlike, and some other miscellaneous
cases. In order to prevent unwanted, even possibly dangerous,
behaviour, these variables control when actions will be per-
formed. The scripts which currently make use of these variables
are: debc, debchange/dch, debclean, debi, debrelease, debuild
and uscan, but this list may change with time (and I may not
remember to update this manpage). Please see the manpages of
individual scripts for details of the specific behaviour for
each script.
SEE ALSO
devscripts(1) and /usr/share/doc/devscripts/README.gz.
AUTHOR
This manpage was written for the devscripts package by the package
maintainer Julian Gilbey <jdg@debian.org>.
DEBIAN Debian Utilities DEVSCRIPTS.CONF(5)
