nmudiff - email an NMU diff to the Debian BTS
nmudiff should be run in the source tree of the package being NMUed,
after the NMU is built. It assumes that the source packages (specifically, the
.dsc and any corresponding tar and diff files) for both
the previous version of the package and the newly built NMU version are in the
parent directory. It then uses debdiff to generate a diff between the
previous version and the current NMU, and either runs mutt or an editor (using
sensible-editor) so that the mail message (including the diff) can be
examined and modified; once you exit the editor the diff will be mailed to the
The default behaviour is that if exactly one bug is closed by this
NMU, then that bug will be mailed, otherwise a new bug will be submitted.
This behaviour may be changed by command line options and configuration file
- Instead of mailing the bug reports which are to be closed by this NMU, a
new bug report is submitted directly to the BTS.
- Send the bug report to all of the bugs which are being closed by this NMU,
rather than opening a new bug report. This option has no effect if no bugs
are being closed by this NMU.
- Use mutt(1) (or neomutt(1)) for editing and sending the
message to the BTS (default behaviour). This can be controlled using a
configuration file option (see below).
- Use sensible-editor(1) to edit the message and then mail it
directly using /usr/bin/sendmail. This can be controlled using a
configuration file option (see below).
- --sendmail SENDMAILCMD
- Specify the sendmail command. The command will be split on white
space and will be interpreted by the shell. Default is
/usr/sbin/sendmail. The -t option will be automatically
added if the command is /usr/sbin/sendmail or
/usr/sbin/exim*. For other mailers, if they require a -t
option, this must be included in the SENDMAILCMD, for example:
--sendmail="/usr/sbin/mymailer -t". This can also be set
using the devscripts configuration files; see below.
- --from EMAIL
- If using the sendmail (--no-mutt) option, then the email to
the BTS will be sent using the name and address in the environment
variables DEBEMAIL and DEBFULLNAME. If these are not set,
then the variables EMAIL and NAME will be used instead.
These can be overridden using the --from option. The program will
not work in this case if an email address cannot be determined.
- --delay DELAY
- Indicate in the generated mail that the NMU has been uploaded to the
DELAYED queue, with a delay of DELAY days. The default value is
XX which adds a placeholder to the e-mail. A value of 0
indicates that the upload has not been sent to a delayed queue. This can
also be set using the devscripts configuration files; see below.
- --no-delay, --nodelay
- Equivalent to --delay 0.
- --no-conf, --noconf
- Do not read any configuration files. This can only be used as the first
option given on the command-line.
- --template TEMPLATEFILE
- Use content of TEMPLATEFILE for message body instead of default template.
If TEMPLATEFILE does not exist, default template is applied.
- Display a help message and exit successfully.
- Display version and copyright information and exit successfully.
The two configuration files /etc/devscripts.conf and ~/.devscripts
are sourced in that order to set configuration variables. Command line options
can be used to override configuration file settings. Environment variable
settings are ignored for this purpose. The currently recognised variables are:
- If this is set to a number, e-mails generated by nmudiff will by
default mention an upload to the DELAYED queue, delayed for the specified
number of days. The value 0 indicates that the DELAYED queue has
not been used.
- Can be yes (default) or no, and specifies whether to use
mutt (or neomut)to compose and send the message or not, as
- This option controls whether a new bug report is made, or whether the diff
is sent to the bugs closed by this NMU. Can be maybe (default),
which sends to the existing bug reports if exactly one bug is being
closed; yes, which always creates a new report, or no, which
always sends to the reports of the bugs being closed (unless no bugs are
being closed, in which case a new report is always made).
- If this is set, specifies a sendmail command to use instead of
/usr/sbin/sendmail. Same as the --sendmail command line
debdiff(1), sensible-editor(1), devscripts.conf(5)
nmudiff was written and is copyright 2006 by Steinar H. Gunderson and
modified by Julian Gilbey <email@example.com>. The software may be freely
redistributed under the terms and conditions of the GNU General Public
License, version 2.