314 lines
7.3 KiB
HTML
314 lines
7.3 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of dpkg-genchanges</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>dpkg-genchanges</H1>
|
|
Section: dpkg suite (1)<BR>Updated: 2020-03-23<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
dpkg-genchanges - generate Debian .changes files
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>dpkg-genchanges</B>
|
|
|
|
[<I>option</I>...]
|
|
|
|
<BR>
|
|
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<B>dpkg-genchanges</B>
|
|
|
|
reads information from an unpacked and built Debian source tree and
|
|
from the files it has generated and generates a Debian upload control
|
|
file
|
|
(<B>.changes</B> file).
|
|
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>--build=</B><I>type</I>
|
|
|
|
<DD>
|
|
Specifies the build <I>type</I> from a comma-separated list of components
|
|
(since dpkg 1.18.5).
|
|
<P>
|
|
The allowed values are:
|
|
<DL COMPACT><DT id="2"><DD>
|
|
<DL COMPACT>
|
|
<DT id="3"><B>source</B>
|
|
|
|
<DD>
|
|
Upload the source package.
|
|
<DT id="4"><B>any</B>
|
|
|
|
<DD>
|
|
Upload the architecture specific binary packages.
|
|
<DT id="5"><B>all</B>
|
|
|
|
<DD>
|
|
Upload the architecture independent binary packages.
|
|
<DT id="6"><B>binary</B>
|
|
|
|
<DD>
|
|
Upload the architecture specific and independent binary packages.
|
|
This is an alias for <B>any,all</B>.
|
|
<DT id="7"><B>full</B>
|
|
|
|
<DD>
|
|
Upload everything.
|
|
This is alias for <B>source,any,all</B>, and the same as the default case
|
|
when no build option is specified.
|
|
</DL>
|
|
</DL>
|
|
|
|
<DT id="8"><B>-g</B>
|
|
|
|
<DD>
|
|
Equivalent to <B>--build=source,all</B> (since dpkg 1.17.11).
|
|
<DT id="9"><B>-G</B>
|
|
|
|
<DD>
|
|
Equivalent to <B>--build=source,any</B> (since dpkg 1.17.11).
|
|
<DT id="10"><B>-b</B>
|
|
|
|
<DD>
|
|
Equivalent to <B>--build=binary</B> or <B>--build=any,all</B>.
|
|
<DT id="11"><B>-B</B>
|
|
|
|
<DD>
|
|
Equivalent to <B>--build=any</B>.
|
|
<DT id="12"><B>-A</B>
|
|
|
|
<DD>
|
|
Equivalent to <B>--build=all</B>.
|
|
<DT id="13"><B>-S</B>
|
|
|
|
<DD>
|
|
Equivalent to <B>--build=source</B>.
|
|
</DL>
|
|
<P>
|
|
|
|
The <B>-s</B><I>x</I> options control whether the original source archive is
|
|
included in the upload if any source is being generated (i.e.
|
|
<B>-b</B> or <B>-B</B>
|
|
|
|
haven't been used).
|
|
<DL COMPACT>
|
|
<DT id="14"><B>-si</B>
|
|
|
|
<DD>
|
|
By default, or if specified, the original source will be included only if
|
|
the upstream version number (the version without epoch and without Debian
|
|
revision) differs from the upstream version number of the previous
|
|
changelog entry.
|
|
<DT id="15"><B>-sa</B>
|
|
|
|
<DD>
|
|
Forces the inclusion of the original source.
|
|
<DT id="16"><B>-sd</B>
|
|
|
|
<DD>
|
|
Forces the exclusion of the original source and includes only the diff.
|
|
|
|
<DT id="17"><B>-v</B><I>version</I>
|
|
|
|
<DD>
|
|
Causes changelog information from all versions strictly later than
|
|
<I>version</I>
|
|
|
|
to be used.
|
|
<DT id="18"><B>-C</B><I>changes-description</I>
|
|
|
|
<DD>
|
|
Read the description of the changes from the file
|
|
<I>changes-description</I>
|
|
|
|
rather than using the information from the source tree's changelog
|
|
file.
|
|
<DT id="19"><B>-m</B><I>maintainer-address</I>
|
|
|
|
<DD>
|
|
Use
|
|
<I>maintainer-address</I>
|
|
|
|
as the name and email address of the maintainer for this package,
|
|
rather than using the information from the source tree's control file.
|
|
<DT id="20"><B>-e</B><I>maintainer-address</I>
|
|
|
|
<DD>
|
|
Use
|
|
<I>maintainer-address</I>
|
|
|
|
as the name and email address of the maintainer for this upload,
|
|
rather than using the information from the source tree's changelog.
|
|
<DT id="21"><B>-V</B><I>name</I><B>=</B><I>value</I>
|
|
|
|
<DD>
|
|
Set an output substitution variable.
|
|
See <B><A HREF="/cgi-bin/man/man2html?5+deb-substvars">deb-substvars</A></B>(5) for a discussion of output substitution.
|
|
<DT id="22"><B>-T</B><I>substvars-file</I>
|
|
|
|
<DD>
|
|
Read substitution variables in
|
|
<I>substvars-file</I>;
|
|
|
|
the default is
|
|
<B>debian/substvars</B>.
|
|
|
|
No variable substitution is done on any of the fields that are output,
|
|
except for the contents extracted from each binary package <B>Description</B>
|
|
field (since dpkg 1.19.0), however the special variable <I>Format</I> will
|
|
override the field of the same name.
|
|
This option can be used multiple times to read substitution
|
|
variables from multiple files (since dpkg 1.15.6).
|
|
<P>
|
|
<DT id="23"><B>-D</B><I>field</I><B>=</B><I>value</I>
|
|
|
|
<DD>
|
|
Override or add an output control file field.
|
|
<DT id="24"><B>-U</B><I>field</I>
|
|
|
|
<DD>
|
|
Remove an output control file field.
|
|
<DT id="25"><B>-c</B><I>controlfile</I>
|
|
|
|
<DD>
|
|
Specifies the main source control file to read information from. The
|
|
default is
|
|
<B>debian/control</B>.
|
|
|
|
<DT id="26"><B>-l</B><I>changelog-file</I>
|
|
|
|
<DD>
|
|
Specifies the changelog file to read information from. The
|
|
default is
|
|
<B>debian/changelog</B>.
|
|
|
|
<DT id="27"><B>-f</B><I>files-list-file</I>
|
|
|
|
<DD>
|
|
Read the list of files to be uploaded here, rather than using
|
|
<B>debian/files</B>.
|
|
|
|
<DT id="28"><B>-F</B><I>changelog-format</I>
|
|
|
|
<DD>
|
|
Specifies the format of the changelog. See <B><A HREF="/cgi-bin/man/man2html?1+dpkg-parsechangelog">dpkg-parsechangelog</A></B>(1)
|
|
for information about alternative formats.
|
|
<DT id="29"><B>-u</B><I>upload-files-dir</I>
|
|
|
|
<DD>
|
|
Look for the files to be uploaded in
|
|
<I>upload-files-dir</I>
|
|
|
|
rather than
|
|
<B>..</B>
|
|
|
|
(<B>dpkg-genchanges</B>
|
|
|
|
needs to find these files so that it can include their sizes and
|
|
checksums in the
|
|
<B>.changes</B>
|
|
|
|
file).
|
|
<DT id="30"><B>-q</B>
|
|
|
|
<DD>
|
|
Usually
|
|
<B>dpkg-genchanges</B>
|
|
|
|
will produce informative messages on standard error, for example about
|
|
how many of the package's source files are being uploaded.
|
|
<B>-q</B>
|
|
|
|
suppresses these messages.
|
|
<DT id="31"><B>-O</B>[<I>filename</I>]
|
|
|
|
<DD>
|
|
Print the changes file to standard output (the default) or to <I>filename</I>
|
|
if specified (since dpkg 1.18.5).
|
|
<DT id="32"><B>-?</B>, <B>--help</B>
|
|
|
|
<DD>
|
|
Show the usage message and exit.
|
|
<DT id="33"><B>--version</B>
|
|
|
|
<DD>
|
|
Show the version and exit.
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>ENVIRONMENT</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="34"><B>DPKG_COLORS</B>
|
|
|
|
<DD>
|
|
Sets the color mode (since dpkg 1.18.5).
|
|
The currently accepted values are: <B>auto</B> (default), <B>always</B> and
|
|
<B>never</B>.
|
|
<DT id="35"><B>DPKG_NLS</B>
|
|
|
|
<DD>
|
|
If set, it will be used to decide whether to activate Native Language Support,
|
|
also known as internationalization (or i18n) support (since dpkg 1.19.0).
|
|
The accepted values are: <B>0</B> and <B>1</B> (default).
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>FILES</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="36"><B>debian/files</B>
|
|
|
|
<DD>
|
|
The list of generated files which are part of the upload being
|
|
prepared.
|
|
<B>dpkg-genchanges</B>
|
|
|
|
reads the data here when producing a
|
|
<B>.changes</B>
|
|
|
|
file.
|
|
</DL>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+deb-substvars">deb-substvars</A></B>(5),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+deb-src-control">deb-src-control</A></B>(5),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+deb-src-files">deb-src-files</A></B>(5),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+deb-changelog">deb-changelog</A></B>(5),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+deb-changes">deb-changes</A></B>(5).
|
|
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="37"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="38"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="39"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="40"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="41"><A HREF="#lbAF">ENVIRONMENT</A><DD>
|
|
<DT id="42"><A HREF="#lbAG">FILES</A><DD>
|
|
<DT id="43"><A HREF="#lbAH">SEE ALSO</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:11 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|