1DEVSCRIPTS.CONF(5)            File Formats Manual           DEVSCRIPTS.CONF(5)
2
3
4

NAME

6       devscripts.conf - configuration file for the devscripts package
7

DESCRIPTION

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
14       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
20       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
28       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
32       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
40       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

PACKAGE-WIDE VARIABLES

44       The currently recognised package-wide variables are:
45
46       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

SEE ALSO

59       devscripts(1) and /usr/share/doc/devscripts/README.gz.
60

AUTHOR

62       This manpage was written for the  devscripts  package  by  the  package
63       maintainer Julian Gilbey <jdg@debian.org>.
64
65
66
67DEBIAN                         Debian Utilities             DEVSCRIPTS.CONF(5)
Impressum