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

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

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@debian.org>.  The software may be freely redistributed  under  the  terms  and
       conditions of the GNU General Public License, version 2.