{ "content": [ { "type": "text", "text": "# nmudiff (man)\n\n## NAME\n\nnmudiff - email an NMU diff to the Debian BTS\n\n## SYNOPSIS\n\nnmudiff [options]\n\n## DESCRIPTION\n\nnmudiff is the tool to be used while preparing a Non-Maintainer Upload (NMU) to notify the\nmaintainer about the work being done.\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION**\n- **OPTIONS** (2 subsections)\n- **CONFIGURATION VARIABLES**\n- **SEE ALSO**\n- **AUTHOR**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n" } ], "structuredContent": { "command": "nmudiff", "section": "", "mode": "man", "summary": "nmudiff - email an NMU diff to the Debian BTS", "synopsis": "nmudiff [options]", "tldr_summary": null, "tldr_examples": [], "tldr_source": null, "flags": [ { "flag": "", "long": "--no-mutt", "arg": null, "description": "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." }, { "flag": "", "long": "--version", "arg": null, "description": "Display version and copyright information and exit successfully." } ], "examples": [], "see_also": [ { "name": "debdiff", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/debdiff/1/json" }, { "name": "sensible-editor", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/sensible-editor/1/json" }, { "name": "devscripts.conf", "section": "5", "url": "https://www.chedong.com/phpMan.php/man/devscripts.conf/5/json" } ], "section_outline": [ { "name": "NAME", "lines": 2, "subsections": [] }, { "name": "SYNOPSIS", "lines": 2, "subsections": [] }, { "name": "DESCRIPTION", "lines": 15, "subsections": [] }, { "name": "OPTIONS", "lines": 10, "subsections": [ { "name": "--no-mutt", "lines": 44, "long": "--no-mutt" }, { "name": "--version", "lines": 2, "long": "--version" } ] }, { "name": "CONFIGURATION VARIABLES", "lines": 25, "subsections": [] }, { "name": "SEE ALSO", "lines": 2, "subsections": [] }, { "name": "AUTHOR", "lines": 5, "subsections": [] } ], "sections": { "NAME": { "content": "nmudiff - email an NMU diff to the Debian BTS\n", "subsections": [] }, "SYNOPSIS": { "content": "nmudiff [options]\n", "subsections": [] }, "DESCRIPTION": { "content": "nmudiff is the tool to be used while preparing a Non-Maintainer Upload (NMU) to notify the\nmaintainer about the work being done.\n\nnmudiff should be run in the source tree of the package being NMUed, after the NMU is built.\nIt assumes that the source packages (specifically, the .dsc and any corresponding tar and\ndiff files) for both the previous version of the package and the newly built NMU version are\nin the parent directory. It then uses debdiff to generate a diff between the previous version\nand the current NMU, and either runs mutt or an editor (using sensible-editor) so that the\nmail message (including the diff) can be examined and modified; once you exit the editor the\ndiff will be mailed to the Debian BTS.\n\nThe default behaviour is that if exactly one bug is closed by this NMU, then that bug will be\nmailed, otherwise a new bug will be submitted. This behaviour may be changed by command line\noptions and configuration file options.\n", "subsections": [] }, "OPTIONS": { "content": "--new Instead of mailing the bug reports which are to be closed by this NMU, a new bug re‐\nport is submitted directly to the BTS.\n\n--old Send the bug report to all of the bugs which are being closed by this NMU, rather than\nopening a new bug report. This option has no effect if no bugs are being closed by\nthis NMU.\n\n--mutt Use mutt(1) (or neomutt(1)) for editing and sending the message to the BTS (default\nbehaviour). This can be controlled using a configuration file option (see below).\n", "subsections": [ { "name": "--no-mutt", "content": "Use sensible-editor(1) to edit the message and then mail it directly using\n/usr/bin/sendmail. This can be controlled using a configuration file option (see be‐\nlow).\n\n--sendmail SENDMAILCMD\nSpecify the sendmail command. The command will be split on white space and will be\ninterpreted by the shell. Default is /usr/sbin/sendmail. The -t option will be auto‐\nmatically added if the command is /usr/sbin/sendmail or /usr/sbin/exim*. For other\nmailers, if they require a -t option, this must be included in the SENDMAILCMD, for\nexample: --sendmail=\"/usr/sbin/mymailer -t\". This can also be set using the de‐\nvscripts configuration files; see below.\n\n--from EMAIL\nIf using the sendmail (--no-mutt) option, then the email to the BTS will be sent using\nthe name and address in the environment variables DEBEMAIL and DEBFULLNAME. If these\nare not set, then the variables EMAIL and NAME will be used instead. These can be\noverridden using the --from option. The program will not work in this case if an\nemail address cannot be determined.\n\n--delay DELAY\nIndicate in the generated mail that the NMU has been uploaded to the DELAYED queue,\nwith a delay of DELAY days. The default value is XX which adds a placeholder to the\ne-mail. A value of 0 indicates that the upload has not been sent to a delayed queue.\nThis can also be set using the devscripts configuration files; see below.\n\n--no-delay, --nodelay\nEquivalent to --delay 0.\n\n--no-conf, --noconf\nDo not read any configuration files. This can only be used as the first option given\non the command-line.\n\n--no-pending, --nopending\nDo not add the pending tag.\n\n--non-dd, --nondd\nMention in the email that you require sponsorship.\n\n--template TEMPLATEFILE\nUse content of TEMPLATEFILE for message body instead of default template. If TEM‐\nPLATEFILE does not exist, default template is applied.\n\n--help Display a help message and exit successfully.\n", "long": "--no-mutt" }, { "name": "--version", "content": "Display version and copyright information and exit successfully.\n", "long": "--version" } ] }, "CONFIGURATION VARIABLES": { "content": "The two configuration files /etc/devscripts.conf and ~/.devscripts are sourced in that order\nto set configuration variables. Command line options can be used to override configuration\nfile settings. Environment variable settings are ignored for this purpose. The currently\nrecognised variables are:\n\nNMUDIFFDELAY\nIf this is set to a number, e-mails generated by nmudiff will by default mention an\nupload to the DELAYED queue, delayed for the specified number of days. The value 0\nindicates that the DELAYED queue has not been used.\n\nNMUDIFFMUTT\nCan be yes (default) or no, and specifies whether to use mutt (or neomutt)to compose\nand send the message or not, as described above.\n\nNMUDIFFNEWREPORT\nThis option controls whether a new bug report is made, or whether the diff is sent to\nthe bugs closed by this NMU. Can be maybe (default), which sends to the existing bug\nreports if exactly one bug is being closed; yes, which always creates a new report, or\nno, which always sends to the reports of the bugs being closed (unless no bugs are be‐\ning closed, in which case a new report is always made).\n\nBTSSENDMAILCOMMAND\nIf this is set, specifies a sendmail command to use instead of /usr/sbin/sendmail.\nSame as the --sendmail command line option.\n", "subsections": [] }, "SEE ALSO": { "content": "debdiff(1), sensible-editor(1), devscripts.conf(5)\n", "subsections": [] }, "AUTHOR": { "content": "nmudiff was written and is copyright 2006 by Steinar H. Gunderson and modified by Julian\nGilbey . The software may be freely redistributed under the terms and condi‐\ntions of the GNU General Public License, version 2.\n\nDEBIAN Debian Utilities NMUDIFF(1)", "subsections": [] } } } }