1NMUDIFF(1) General Commands Manual NMUDIFF(1)
2
6 nmudiff - email an NMU diff to the Debian BTS
7
9 nmudiff [options]
10
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 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 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
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 --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 --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 --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 --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 --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 --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 --no-delay, --nodelay
74 Equivalent to --delay 0.
75 --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 --no-pending, --nopending
81 Do not add the pending tag.
82 --no-dd, --nodd
84 Mention in the email that you require sponsorship.
85 --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 --help Display a help message and exit successfully.
92 --version
94 Display version and copyright information and exit successfully.
95
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 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 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 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 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
128 debdiff(1), sensible-editor(1), devscripts.conf(5)
129
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.
135DEBIAN Debian Utilities NMUDIFF(1)