man > nmudiff(1)

NMUDIFF(1)                             General Commands Manual                            NMUDIFF(1)

NAME
       nmudiff - email an NMU diff to the Debian BTS

SYNOPSIS
       nmudiff [options]

DESCRIPTION
       nmudiff  is  the  tool to be used while preparing a Non-Maintainer Upload (NMU) to notify the
       maintainer about the work being done.

       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 re‐
              port 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)  (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).

       --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 be‐
              low).

       --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 auto‐
              matically  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 de‐
              vscripts 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.

       --no-pending, --nopending
              Do not add the pending tag.

       --non-dd, --nondd
              Mention in the email that you require sponsorship.

       --template TEMPLATEFILE
              Use  content  of  TEMPLATEFILE  for message body instead of default template.  If TEM‐
              PLATEFILE does not exist, default template is applied.

       --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 (or neomutt)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 be‐
              ing 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.

SEE ALSO
       debdiff(1), sensible-editor(1), devscripts.conf(5)

AUTHOR
       nmudiff  was  written  and  is  copyright 2006 by Steinar H. Gunderson and modified by Julian
       Gilbey <jdg AT debian.org>.  The software may be freely redistributed under the terms and condi‐
       tions of the GNU General Public License, version 2.

DEBIAN                                    Debian Utilities                                NMUDIFF(1)