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 variables 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  performed.   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>.