Commit | Line | Data |
---|---|---|
1479465f GJ |
1 | .\" dpkg manual page - dpkg-genchanges(1) |
2 | .\" | |
3 | .\" Copyright © 1995-1996 Ian Jackson <ijackson@chiark.greenend.org.uk> | |
4 | .\" Copyright © 2000 Wichert Akkerman <wakkerma@debian.org> | |
5 | .\" Copyright © 2006-2016 Guillem Jover <guillem@debian.org> | |
6 | .\" Copyright © 2008-2010 Raphaël Hertzog <hertzog@debian.org> | |
7 | .\" | |
8 | .\" This is free software; you can redistribute it and/or modify | |
9 | .\" it under the terms of the GNU General Public License as published by | |
10 | .\" the Free Software Foundation; either version 2 of the License, or | |
11 | .\" (at your option) any later version. | |
12 | .\" | |
13 | .\" This is distributed in the hope that it will be useful, | |
14 | .\" but WITHOUT ANY WARRANTY; without even the implied warranty of | |
15 | .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
16 | .\" GNU General Public License for more details. | |
17 | .\" | |
18 | .\" You should have received a copy of the GNU General Public License | |
19 | .\" along with this program. If not, see <https://www.gnu.org/licenses/>. | |
20 | . | |
21 | .TH dpkg\-genchanges 1 "%RELEASE_DATE%" "%VERSION%" "dpkg suite" | |
22 | .nh | |
23 | .SH NAME | |
24 | dpkg\-genchanges \- generate Debian .changes files | |
25 | . | |
26 | .SH SYNOPSIS | |
27 | .B dpkg\-genchanges | |
28 | .RI [ option ...] | |
29 | .br | |
30 | . | |
31 | .SH DESCRIPTION | |
32 | .B dpkg\-genchanges | |
33 | reads information from an unpacked and built Debian source tree and | |
34 | from the files it has generated and generates a Debian upload control | |
35 | file | |
36 | .RB ( .changes " file)." | |
37 | . | |
38 | .SH OPTIONS | |
39 | .TP | |
40 | .BI \-\-build= type | |
41 | Specifies the build \fItype\fP from a comma-separated list of components | |
42 | (since dpkg 1.18.5). | |
43 | ||
44 | The allowed values are: | |
45 | .RS | |
46 | .TP | |
47 | .B source | |
48 | Upload the source package. | |
49 | .TP | |
50 | .B any | |
51 | Upload the architecture specific binary packages. | |
52 | .TP | |
53 | .B all | |
54 | Upload the architecture independent binary packages. | |
55 | .TP | |
56 | .B binary | |
57 | Upload the architecture specific and independent binary packages. | |
58 | This is an alias for \fBany,all\fP. | |
59 | .TP | |
60 | .B full | |
61 | Upload everything. | |
62 | This is alias for \fBsource,any,all\fP, and the same as the default case | |
63 | when no build option is specified. | |
64 | .RE | |
65 | .TP | |
66 | .B \-g | |
67 | Equivalent to \fB\-\-build=source,all\fP (since dpkg 1.17.11). | |
68 | .TP | |
69 | .B \-G | |
70 | Equivalent to \fB\-\-build=source,any\fP (since dpkg 1.17.11). | |
71 | .TP | |
72 | .B \-b | |
73 | Equivalent to \fB\-\-build=binary\fP or \fB\-\-build=any,all\fP. | |
74 | .TP | |
75 | .B \-B | |
76 | Equivalent to \fB\-\-build=any\fP. | |
77 | .TP | |
78 | .B \-A | |
79 | Equivalent to \fB\-\-build=all\fP. | |
80 | .TP | |
81 | .B \-S | |
82 | Equivalent to \fB\-\-build=source\fP. | |
83 | .PP | |
84 | The \fB\-s\fP\fIx\fP options control whether the original source archive is | |
85 | included in the upload if any source is being generated (i.e. | |
86 | .BR \-b " or " \-B | |
87 | haven't been used). | |
88 | .TP | |
89 | .B \-si | |
90 | By default, or if specified, the original source will be included only if | |
91 | the upstream version number (the version without epoch and without Debian | |
92 | revision) differs from the upstream version number of the previous | |
93 | changelog entry. | |
94 | .TP | |
95 | .B \-sa | |
96 | Forces the inclusion of the original source. | |
97 | .TP | |
98 | .B \-sd | |
99 | Forces the exclusion of the original source and includes only the diff. | |
100 | .fi | |
101 | .TP | |
102 | .BI \-v version | |
103 | Causes changelog information from all versions strictly later than | |
104 | .I version | |
105 | to be used. | |
106 | .TP | |
107 | .BI \-C changes-description | |
108 | Read the description of the changes from the file | |
109 | .I changes-description | |
110 | rather than using the information from the source tree's changelog | |
111 | file. | |
112 | .TP | |
113 | .BI \-m maintainer-address | |
114 | Use | |
115 | .I maintainer-address | |
116 | as the name and email address of the maintainer for this package, | |
117 | rather than using the information from the source tree's control file. | |
118 | .TP | |
119 | .BI \-e maintainer-address | |
120 | Use | |
121 | .I maintainer-address | |
122 | as the name and email address of the maintainer for this upload, | |
123 | rather than using the information from the source tree's changelog. | |
124 | .TP | |
125 | .BI \-V name = value | |
126 | Set an output substitution variable. | |
127 | See \fBdeb\-substvars\fP(5) for a discussion of output substitution. | |
128 | .TP | |
129 | .BI \-T substvars-file | |
130 | Read substitution variables in | |
131 | .IR substvars-file ; | |
132 | the default is | |
133 | .BR debian/substvars . | |
134 | No variable substitution is done on any of the fields that are output, | |
135 | however the special variable \fIFormat\fR will override the field of the | |
136 | same name. This option can be used multiple times to read substitution | |
137 | variables from multiple files (since dpkg 1.15.6). | |
138 | ||
139 | .TP | |
140 | .BI \-D field = value | |
141 | Override or add an output control file field. | |
142 | .TP | |
143 | .BI \-U field | |
144 | Remove an output control file field. | |
145 | .TP | |
146 | .BI \-c controlfile | |
147 | Specifies the main source control file to read information from. The | |
148 | default is | |
149 | .BR debian/control . | |
150 | .TP | |
151 | .BI \-l changelog-file | |
152 | Specifies the changelog file to read information from. The | |
153 | default is | |
154 | .BR debian/changelog . | |
155 | .TP | |
156 | .BI \-f files-list-file | |
157 | Read the list of files to be uploaded here, rather than using | |
158 | .BR debian/files . | |
159 | .TP | |
160 | .BI \-F changelog-format | |
161 | Specifies the format of the changelog. See \fBdpkg\-parsechangelog\fP(1) | |
162 | for information about alternative formats. | |
163 | .TP | |
164 | .BI \-u upload-files-dir | |
165 | Look for the files to be uploaded in | |
166 | .I upload-files-dir | |
167 | rather than | |
168 | .B .. | |
169 | .RB ( dpkg\-genchanges | |
170 | needs to find these files so that it can include their sizes and | |
171 | checksums in the | |
172 | .B .changes | |
173 | file). | |
174 | .TP | |
175 | .B \-q | |
176 | Usually | |
177 | .B dpkg\-genchanges | |
178 | will produce informative messages on standard error, for example about | |
179 | how many of the package's source files are being uploaded. | |
180 | .B \-q | |
181 | suppresses these messages. | |
182 | .TP | |
183 | .BR \-O [\fIfilename\fP] | |
184 | Print the changes file to standard output (the default) or to \fIfilename\fP | |
185 | if specified (since dpkg 1.18.5). | |
186 | .TP | |
187 | .BR \-? ", " \-\-help | |
188 | Show the usage message and exit. | |
189 | .TP | |
190 | .BR \-\-version | |
191 | Show the version and exit. | |
192 | . | |
193 | .SH FILES | |
194 | .TP | |
195 | .B debian/files | |
196 | The list of generated files which are part of the upload being | |
197 | prepared. | |
198 | .B dpkg\-genchanges | |
199 | reads the data here when producing a | |
200 | .B .changes | |
201 | file. | |
202 | . | |
203 | .SH SEE ALSO | |
204 | .ad l | |
205 | .BR deb\-substvars (5), | |
206 | .BR deb\-src\-control (5), | |
207 | .BR deb\-src\-files (5), | |
208 | .BR deb\-changelog (5), | |
209 | .BR deb\-changes (5). |