1dpkg-genchanges(1) dpkg suite dpkg-genchanges(1)
2
3
4
6 dpkg-genchanges - generate Debian .changes files
7
9 dpkg-genchanges [option...]
10
12 dpkg-genchanges reads information from an unpacked and built Debian
13 source tree and from the files it has generated and generates a Debian
14 upload control file (.changes file).
15
17 --build=type
18 Specifies the build type from a comma-separated list of components
19 (since dpkg 1.18.5).
20
21 The allowed values are:
22
23 source
24 Upload the source package.
25
26 any Upload the architecture specific binary packages.
27
28 all Upload the architecture independent binary packages.
29
30 binary
31 Upload the architecture specific and independent binary
32 packages. This is an alias for any,all.
33
34 full
35 Upload everything. This is alias for source,any,all, and the
36 same as the default case when no build option is specified.
37
38 -g Equivalent to --build=source,all (since dpkg 1.17.11).
39
40 -G Equivalent to --build=source,any (since dpkg 1.17.11).
41
42 -b Equivalent to --build=binary or --build=any,all.
43
44 -B Equivalent to --build=any.
45
46 -A Equivalent to --build=all.
47
48 -S Equivalent to --build=source.
49
50 The -sx options control whether the original source archive is included
51 in the upload if any source is being generated (i.e. -b or -B haven't
52 been used).
53
54 -si By default, or if specified, the original source will be included
55 only if the upstream version number (the version without epoch and
56 without Debian revision) differs from the upstream version number
57 of the previous changelog entry.
58
59 -sa Forces the inclusion of the original source.
60
61 -sd Forces the exclusion of the original source and includes only the
62 diff.
63
64 -vversion
65 Causes changelog information from all versions strictly later than
66 version to be used.
67
68 -Cchanges-description
69 Read the description of the changes from the file changes-
70 description rather than using the information from the source
71 tree's changelog file.
72
73 -mmaintainer-address
74 Use maintainer-address as the name and email address of the
75 maintainer for this package, rather than using the information from
76 the source tree's control file.
77
78 -emaintainer-address
79 Use maintainer-address as the name and email address of the
80 maintainer for this upload, rather than using the information from
81 the source tree's changelog.
82
83 -Vname=value
84 Set an output substitution variable. See deb-substvars(5) for a
85 discussion of output substitution.
86
87 -Tsubstvars-file
88 Read substitution variables in substvars-file; the default is
89 debian/substvars. No variable substitution is done on any of the
90 fields that are output, except for the contents extracted from each
91 binary package Description field (since dpkg 1.19.0), however the
92 special variable Format will override the field of the same name.
93 This option can be used multiple times to read substitution
94 variables from multiple files (since dpkg 1.15.6).
95
96 -Dfield=value
97 Override or add an output control file field.
98
99 -Ufield
100 Remove an output control file field.
101
102 -ccontrolfile
103 Specifies the main source control file to read information from.
104 The default is debian/control.
105
106 -lchangelog-file
107 Specifies the changelog file to read information from. The default
108 is debian/changelog.
109
110 -ffiles-list-file
111 Read the list of files to be uploaded here, rather than using
112 debian/files.
113
114 -Fchangelog-format
115 Specifies the format of the changelog. See dpkg-parsechangelog(1)
116 for information about alternative formats.
117
118 -uupload-files-dir
119 Look for the files to be uploaded in upload-files-dir rather than
120 .. (dpkg-genchanges needs to find these files so that it can
121 include their sizes and checksums in the .changes file).
122
123 -q Usually dpkg-genchanges will produce informative messages on
124 standard error, for example about how many of the package's source
125 files are being uploaded. -q suppresses these messages.
126
127 -O[filename]
128 Print the changes file to standard output (the default) or to
129 filename if specified (since dpkg 1.18.5).
130
131 -?, --help
132 Show the usage message and exit.
133
134 --version
135 Show the version and exit.
136
138 DPKG_COLORS
139 Sets the color mode (since dpkg 1.18.5). The currently accepted
140 values are: auto (default), always and never.
141
142 DPKG_NLS
143 If set, it will be used to decide whether to activate Native
144 Language Support, also known as internationalization (or i18n)
145 support (since dpkg 1.19.0). The accepted values are: 0 and 1
146 (default).
147
149 debian/files
150 The list of generated files which are part of the upload being
151 prepared. dpkg-genchanges reads the data here when producing a
152 .changes file.
153
155 deb-substvars(5), deb-src-control(5), deb-src-files(5), deb-
156 changelog(5), deb-changes(5).
157
158
159
1601.21.21 2023-02-25 dpkg-genchanges(1)