nmudiff - Online in the Cloud

PROGRAM:

NAME

nmudiff - email an NMU diff to the Debian BTS

SYNOPSIS

nmudiff [options]

DESCRIPTION

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 Debian BTS.

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 options.

OPTIONS

--new Instead of mailing the bug reports which are to be closed by this NMU, a new bug
report is submitted directly to the BTS.

--old 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.

--mutt Use mutt(1) for editing and sending the message to the BTS (default behaviour).
This can be controlled using a configuration file option (see below).

--no-mutt
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.

--help Display a help message and exit successfully.

--version
Display version and copyright information and exit successfully.

CONFIGURATION VARIABLES

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:

NMUDIFF_DELAY
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.

NMUDIFF_MUTT
Can be yes (default) or no, and specifies whether to use mutt to compose and send
the message or not, as described above.

NMUDIFF_NEWREPORT
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).

BTS_SENDMAIL_COMMAND
If this is set, specifies a sendmail command to use instead of /usr/sbin/sendmail.
Same as the --sendmail command line option.

Use nmudiff online using onworks.net services