nmudiff(1)
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.
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.
Opportunity
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
Free Books
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Education
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.
