1MASS-BUG(1)                                                        MASS-BUG(1)
2
3
4

NAME

6       mass-bug - mass-file a bug report against a list of packages
7

SYNOPSIS

9       mass-bug [options] --subject="bug subject" template package-list
10

DESCRIPTION

12       mass-bug assists in filing a mass bug report in the Debian BTS on a set
13       of packages. For each package in the package-list file (which should
14       list one package per line together with an optional version number
15       separated from the package name by an underscore), it fills out the
16       template, adds BTS pseudo-headers, and either displays or sends the bug
17       report.
18
19       Warning: Some care has been taken to avoid unpleasant and common
20       mistakes, but this is still a power tool that can generate massive
21       amounts of bug report mails. Use it with care, and read the
22       documentation in the Developer's Reference about mass filing of bug
23       reports first.
24

TEMPLATE

26       The template file is the body of the message that will be sent for each
27       bug report, excluding the BTS pseudo-headers. In the template,
28       #PACKAGE# is replaced with the name of the package. If a version was
29       specified for the package, #VERSION# will be replaced by that version.
30
31       The components of the version number may be specified using #EPOCH#,
32       #UPSTREAM_VERSION# and #REVISION#. #EPOCH# includes the trailing colon
33       and #REVISION# the leading dash so that
34       #EPOCH#UPSTREAM_VERSION##REVISION# is always the same as #VERSION#.
35
36       Note that text in the template will be automatically word-wrapped to 70
37       columns, up to the start of a signature (indicated by '-- ' at the
38       start of a line on its own). This is another reason to avoid including
39       BTS pseudo-headers in your template.
40

OPTIONS

42       mass-bug examines the devscripts configuration files as described
43       below.  Command line options override the configuration file settings,
44       though.
45
46       --severity=(wishlist|minor|normal|important|serious|grave|critical)
47           Specify the severity with which bugs should be filed. Default is
48           normal.
49
50       --display
51           Fill out the templates for each package and display them all for
52           verification. This is the default behavior.
53
54       --send
55           Actually send the bug reports.
56
57       --subject="bug subject"
58           Specify the subject of the bug report. The subject will be
59           automatically prefixed with the name of the package that the bug is
60           filed against.
61
62       --tags
63           Set the BTS pseudo-header for tags.
64
65       --user
66           Set the BTS pseudo-header for a usertags' user.
67
68       --usertags
69           Set the BTS pseudo-header for usertags.
70
71       --control=COMMAND
72           Add a BTS control command. This option may be repeated to add
73           multiple control commands. For example, if you are mass-bug-filing
74           "please stop depending on this deprecated package", and bug 123456
75           represents removal of the deprecated package, you could use:
76
77               mass-bug --control='block 123456 by -1' ...
78
79       --source
80           Specify that package names refer to source packages rather than
81           binary packages.
82
83       --sendmail=SENDMAILCMD
84           Specify the sendmail command.  The command will be split on white
85           space and will not be passed to a shell.  Default is
86           /usr/sbin/sendmail.
87
88       --no-wrap
89           Do not wrap the template to lines of 70 characters.
90
91       --no-conf, --noconf
92           Do not read any configuration files.  This can only be used as the
93           first option given on the command-line.
94
95       --help
96           Provide a usage message.
97
98       --version
99           Display version information.
100

ENVIRONMENT

102       DEBEMAIL and EMAIL can be set in the environment to control the email
103       address that the bugs are sent from.
104

CONFIGURATION VARIABLES

106       The two configuration files /etc/devscripts.conf and ~/.devscripts are
107       sourced by a shell in that order to set configuration variables.
108       Command line options can be used to override configuration file
109       settings.  Environment variable settings are ignored for this purpose.
110       The currently recognised variables are:
111
112       BTS_SENDMAIL_COMMAND
113           If this is set, specifies a sendmail command to use instead of
114           /usr/sbin/sendmail.  Same as the --sendmail command line option.
115
117       This program is Copyright (C) 2006 by Joey Hess <joeyh@debian.org>.
118
119       It is licensed under the terms of the GPL, either version 2 of the
120       License, or (at your option) any later version.
121

AUTHOR

123       Joey Hess <joeyh@debian.org>
124
125
126
127Debian Utilities                  2023-07-19                       MASS-BUG(1)
Impressum