1DEBRELEASE(1) General Commands Manual DEBRELEASE(1)
2
3
4
6 debrelease - a wrapper around dupload or dput
7
9 debrelease [debrelease options] [dupload/dput options]
10
12 debrelease is a simple wrapper around dupload or dput. It is called
13 from within the source code tree of a package, and figures out the cur‐
14 rent version of a package. It then looks for the corresponding
15 .changes file (which lists the files needed to upload in order to
16 release the package) in the parent directory of the source code tree
17 and calls dupload or dput with the .changes file as parameter in order
18 to perform the actual uploading.
19
20 Options may be given to debrelease; except for the ones listed below,
21 they are passed on unchanged to dupload or dput. The devscripts con‐
22 figuration files are also read by debrelease as described below.
23
25 In common with several other scripts in the devscripts package, debre‐
26 lease will climb the directory tree until it finds a debian/changelog
27 file. As a safeguard against stray files causing potential problems,
28 it will examine the name of the parent directory once it finds the
29 debian/changelog file, and check that the directory name corresponds to
30 the package name. Precisely how it does this is controlled by two con‐
31 figuration file variables DEVSCRIPTS_CHECK_DIRNAME_LEVEL and
32 DEVSCRIPTS_CHECK_DIRNAME_REGEX, and their corresponding command-line
33 options --check-dirname-level and --check-dirname-regex.
34
35 DEVSCRIPTS_CHECK_DIRNAME_LEVEL can take the following values:
36
37 0 Never check the directory name.
38
39 1 Only check the directory name if we have had to change directory
40 in our search for debian/changelog. This is the default behav‐
41 iour.
42
43 2 Always check the directory name.
44
45 The directory name is checked by testing whether the current directory
46 name (as determined by pwd(1)) matches the regex given by the configu‐
47 ration file option DEVSCRIPTS_CHECK_DIRNAME_REGEX or by the command
48 line option --check-dirname-regex regex. Here regex is a Perl regex
49 (see perlre(3perl)), which will be anchored at the beginning and the
50 end. If regex contains a '/', then it must match the full directory
51 path. If not, then it must match the full directory name. If regex
52 contains the string ´PACKAGE', this will be replaced by the source
53 package name, as determined from the changelog. The default value for
54 the regex is: ´PACKAGE(-.+)?', thus matching directory names such as
55 PACKAGE and PACKAGE-version.
56
58 --dupload, --dput
59 This specifies which uploader program to use; the default is
60 dupload.
61
62 -S If this option is used, or the default .changes file is not
63 found but a source-only .changes file is present, then this
64 source-only .changes file will be uploaded instead of an arch-
65 specific one.
66
67 -adebian-architecture, -tGNU-system-type
68 See dpkg-architecture(1) for a description of these options.
69 They affect the search for the .changes file. They are provided
70 to mimic the behaviour of dpkg-buildpackage when determining the
71 name of the .changes file. If a plain -t is given, it is taken
72 to be the dupload host-specifying option, and therefore signi‐
73 fies the end of the debrelease-specific options.
74
75 --multi
76 Multiarch .changes mode: This signifies that debrelease should
77 use the most recent file with the name pattern package_ver‐
78 sion_*+*.changes as the .changes file, allowing for the .changes
79 files produced by dpkg-cross.
80
81 --debs-dir directory
82 Look for the .changes and .deb files in directory instead of the
83 parent of the source directory. This should either be an abso‐
84 lute path or relative to the top of the source directory.
85
86 --check-dirname-level N
87 See the above section Directory name checking for an explanation
88 of this option.
89
90 --check-dirname-regex regex
91 See the above section Directory name checking for an explanation
92 of this option.
93
94 --no-conf, --noconf
95 Do not read any configuration files. This can only be used as
96 the first option given on the command-line.
97
98 --help, -h
99 Display a help message and exit successfully.
100
101 --version
102 Display version and copyright information and exit successfully.
103
105 The two configuration files /etc/devscripts.conf and ~/.devscripts are
106 sourced in that order to set configuration variables. Command line
107 options can be used to override configuration file settings. Environ‐
108 ment variable settings are ignored for this purpose. The currently
109 recognised variables are:
110
111 DEBRELEASE_UPLOADER
112 The currently recognised values are dupload and dput, and it
113 specifies which uploader program should be used. It corresponds
114 to the --dupload and --dput command line options.
115
116 DEBRELEASE_DEBS_DIR
117 This specifies the directory in which to look for the .changes
118 and .deb files, and is either an absolute path or relative to
119 the top of the source tree. This corresponds to the --debs-dir
120 command line option. This directive could be used, for example,
121 if you always use pbuilder or svn-buildpackage to build your
122 packages. Note that it also affects debc(1) and debi(1).
123
124 DEVSCRIPTS_CHECK_DIRNAME_LEVEL, DEVSCRIPTS_CHECK_DIRNAME_REGEX
125 See the above section Directory name checking for an explanation
126 of these variables. Note that these are package-wide configura‐
127 tion variables, and will therefore affect all devscripts scripts
128 which check their value, as described in their respective man‐
129 pages and in devscripts.conf(5).
130
132 dput(1), dupload(1), devscripts.conf(5)
133
135 Julian Gilbey <jdg@debian.org>, based on the original release script by
136 Christoph Lameter <clameter@debian.org>.
137
138
139
140DEBIAN Debian Utilities DEBRELEASE(1)