1NMUDIFF(1)                  General Commands Manual                 NMUDIFF(1)
2
3
4

NAME

6       nmudiff - email an NMU diff to the Debian BTS
7

SYNOPSIS

9       nmudiff [options]
10

DESCRIPTION

12       nmudiff  is the tool to be used while preparing a Non-Maintainer Upload
13       (NMU) to notify the maintainer about the work being done.
14
15       nmudiff should be run in the source tree of the  package  being  NMUed,
16       after  the  NMU is built. It assumes that the source packages (specifi‐
17       cally, the .dsc and any corresponding tar and diff files) for both  the
18       previous  version of the package and the newly built NMU version are in
19       the parent directory. It then uses debdiff to generate a  diff  between
20       the  previous  version  and the current NMU, and either runs mutt or an
21       editor (using sensible-editor) so that the mail message (including  the
22       diff)  can  be examined and modified; once you exit the editor the diff
23       will be mailed to the Debian BTS.
24
25       The default behaviour is that if exactly one bug is closed by this NMU,
26       then  that  bug  will be mailed, otherwise a new bug will be submitted.
27       This behaviour may be changed by command line options and configuration
28       file options.
29

OPTIONS

31       --new  Instead  of  mailing  the  bug reports which are to be closed by
32              this NMU, a new bug report is submitted directly to the BTS.
33
34       --old  Send the bug report to all of the bugs which are being closed by
35              this NMU, rather than opening a new bug report.  This option has
36              no effect if no bugs are being closed by this NMU.
37
38       --mutt Use mutt(1) (or neomutt(1)) for editing and sending the  message
39              to  the BTS (default behaviour).  This can be controlled using a
40              configuration file option (see below).
41
42       --no-mutt
43              Use sensible-editor(1) to edit the  message  and  then  mail  it
44              directly  using /usr/bin/sendmail.  This can be controlled using
45              a configuration file option (see below).
46
47       --sendmail SENDMAILCMD
48              Specify the sendmail command.  The  command  will  be  split  on
49              white  space  and  will be interpreted by the shell.  Default is
50              /usr/sbin/sendmail.  The -t option will be  automatically  added
51              if  the  command  is /usr/sbin/sendmail or /usr/sbin/exim*.  For
52              other mailers, if  they  require  a  -t  option,  this  must  be
53              included    in    the    SENDMAILCMD,   for   example:   --send‐
54              mail="/usr/sbin/mymailer -t".  This can also be  set  using  the
55              devscripts configuration files; see below.
56
57       --from EMAIL
58              If  using the sendmail (--no-mutt) option, then the email to the
59              BTS will be sent using the name and address in  the  environment
60              variables  DEBEMAIL and DEBFULLNAME.  If these are not set, then
61              the variables EMAIL and NAME will be used instead.  These can be
62              overridden  using  the --from option.  The program will not work
63              in this case if an email address cannot be determined.
64
65       --delay DELAY
66              Indicate in the generated mail that the NMU has been uploaded to
67              the  DELAYED  queue,  with  a  delay of DELAY days.  The default
68              value is XX which adds a placeholder to the e-mail.  A value  of
69              0  indicates  that  the  upload  has  not been sent to a delayed
70              queue.  This can also be set using the devscripts  configuration
71              files; see below.
72
73       --no-delay, --nodelay
74              Equivalent to --delay 0.
75
76       --no-conf, --noconf
77              Do  not  read any configuration files.  This can only be used as
78              the first option given on the command-line.
79
80       --no-pending, --nopending
81              Do not add the pending tag.
82
83       --no-dd, --nodd
84              Mention in the email that you require sponsorship.
85
86       --template TEMPLATEFILE
87              Use content of TEMPLATEFILE for message body instead of  default
88              template.   If  TEMPLATEFILE does not exist, default template is
89              applied.
90
91       --help Display a help message and exit successfully.
92
93       --version
94              Display version and copyright information and exit successfully.
95

CONFIGURATION VARIABLES

97       The two configuration files /etc/devscripts.conf and ~/.devscripts  are
98       sourced  in  that  order  to set configuration variables.  Command line
99       options can be used to override configuration file settings.   Environ‐
100       ment  variable  settings  are  ignored for this purpose.  The currently
101       recognised variables are:
102
103       NMUDIFF_DELAY
104              If this is set to a number, e-mails generated by nmudiff will by
105              default  mention an upload to the DELAYED queue, delayed for the
106              specified number of  days.   The  value  0  indicates  that  the
107              DELAYED queue has not been used.
108
109       NMUDIFF_MUTT
110              Can  be  yes  (default) or no, and specifies whether to use mutt
111              (or neomut)to compose and send the message or not, as  described
112              above.
113
114       NMUDIFF_NEWREPORT
115              This  option  controls  whether  a  new  bug  report is made, or
116              whether the diff is sent to the bugs closed by this NMU.  Can be
117              maybe  (default),  which  sends  to  the existing bug reports if
118              exactly one bug is being closed; yes, which always creates a new
119              report,  or  no,  which  always sends to the reports of the bugs
120              being closed (unless no bugs are being closed, in which  case  a
121              new report is always made).
122
123       BTS_SENDMAIL_COMMAND
124              If  this  is set, specifies a sendmail command to use instead of
125              /usr/sbin/sendmail.  Same as the --sendmail command line option.
126

SEE ALSO

128       debdiff(1), sensible-editor(1), devscripts.conf(5)
129

AUTHOR

131       nmudiff was written and is copyright 2006 by Steinar H.  Gunderson  and
132       modified by Julian Gilbey <jdg@debian.org>.  The software may be freely
133       redistributed under the terms and conditions of the GNU General  Public
134       License, version 2.
135
136
137
138DEBIAN                         Debian Utilities                     NMUDIFF(1)
Impressum