1BTS(1)                                                                  BTS(1)
2
3
4

NAME

6       bts - developers' command line interface to the Debian Bug Tracking
7       System
8

SYNOPSIS

10       bts [options] command [args] [#comment] [.|, command [args] [#comment]]
11       ...
12

DESCRIPTION

14       This is a command line interface to the Debian Bug Tracking System
15       (BTS), intended mainly for use by developers. It lets the BTS be
16       manipulated using simple commands that can be run at the prompt or in a
17       script, does various sanity checks on the input, and constructs and
18       sends a mail to the BTS control address for you. A local cache of web
19       pages and e-mails from the BTS may also be created and updated.
20
21       In general, the command line interface is the same as what you would
22       write in a mail to control@bugs.debian.org, just prefixed with "bts".
23       For example:
24
25        % bts severity 69042 normal
26        % bts merge 69042 43233
27        % bts retitle 69042 blah blah
28
29       A few additional commands have been added for your convenience, and
30       this program is less strict about what constitutes a valid bug number.
31       For example, "severity Bug#85942 normal" is understood, as is "severity
32       #85942 normal".  (Of course, your shell may regard "#" as a comment
33       character though, so you may need to quote it!)
34
35       Also, for your convenience, this program allows you to abbreviate
36       commands to the shortest unique substring (similar to how cvs lets you
37       abbreviate commands). So it understands things like "bts cl 85942".
38
39       It is also possible to include a comment in the mail sent to the BTS.
40       If your shell does not strip out the comment in a command like "bts
41       severity 30321 normal #inflated severity", then this program is smart
42       enough to figure out where the comment is, and include it in the email.
43       Note that most shells do strip out such comments before they get to the
44       program, unless the comment is quoted.  (Something like "bts severity
45       #85942 normal" will not be treated as a comment!)
46
47       You can specify multiple commands by separating them with a single dot,
48       rather like update-rc.d; a single comma may also be used; all the
49       commands will then be sent in a single mail. It is important the
50       dot/comma is surrounded by whitespace so it is not mistaken for part of
51       a command.  For example (quoting where necessary so that bts sees the
52       comment):
53
54        % bts severity 95672 normal , merge 95672 95673 \#they are the same!
55
56       The abbreviation "it" may be used to refer to the last mentioned bug
57       number, so you could write:
58
59        % bts severity 95672 wishlist , retitle it "bts: please add a --foo option"
60
61       Please use this program responsibly, and do take our users into
62       consideration.
63

OPTIONS

65       bts examines the devscripts configuration files as described below.
66       Command line options override the configuration file settings, though.
67
68       -o, --offline
69           Make bts use cached bugs for the show and bugs commands, if a cache
70           is available for the requested data. See the cache command, below
71           for information on setting up a cache.
72
73       --online, --no-offline
74           Opposite of --offline; overrides any configuration file directive
75           to work offline.
76
77       -n, --no-action
78           Do not send emails but print them to standard output.
79
80       --cache, --no-cache
81           Should we attempt to cache new versions of BTS pages when
82           performing show/bugs commands?  Default is to cache.
83
84       --cache-mode={min|mbox|full}
85           When running a bts cache command, should we only mirror the basic
86           bug (min), or should we also mirror the mbox version (mbox), or
87           should we mirror the whole thing, including the mbox and the boring
88           attachments to the BTS bug pages and the acknowledgement emails
89           (full)?  Default is min.
90
91       --cache-delay=seconds
92           Time in seconds to delay between each download, to avoid hammering
93           the BTS web server. Default is 5 seconds.
94
95       --mbox
96           Open a mail reader to read the mbox corresponding to a given bug
97           number for show and bugs commands.
98
99       --mailreader=READER
100           Specify the command to read the mbox.  Must contain a "%s" string
101           (unquoted!), which will be replaced by the name of the mbox file.
102           The command will be split on white space and will not be passed to
103           a shell.  Default is 'mutt -f %s'.  (Also, %% will be substituted
104           by a single % if this is needed.)
105
106       --cc-addr=CC_EMAIL_ADDRESS
107           Send carbon copies to a list of users. CC_EMAIL_ADDRESS should be a
108           comma-separated list of email addresses. Multiple options add more
109           CCs.
110
111       --use-default-cc
112           Add the addresses specified in the configuration file option
113           BTS_DEFAULT_CC to the list specified using --cc-addr.  This is the
114           default.
115
116       --no-use-default-cc
117           Do not add addresses specified in BTS_DEFAULT_CC to the carbon copy
118           list.
119
120       --sendmail=SENDMAILCMD
121           Specify the sendmail command.  The command will be split on white
122           space and will not be passed to a shell.  Default is
123           /usr/sbin/sendmail.  The -t option will be automatically added if
124           the command is /usr/sbin/sendmail or /usr/sbin/exim*.  For other
125           mailers, if they require a -t option, this must be included in the
126           SENDMAILCMD, for example: --sendmail="/usr/sbin/mymailer -t".
127
128       --mutt
129           Use mutt for sending of mails. Default is not to use mutt, except
130           for some commands.
131
132           Note that one of $DEBEMAIL or $EMAIL must be set in the environment
133           in order to use mutt to send emails.
134
135       --no-mutt
136           Don't use mutt for sending of mails.
137
138       --soap-timeout=SECONDS
139           Specify a timeout for SOAP calls as used by the select and status
140           commands.
141
142       --smtp-host=SMTPHOST
143           Specify an SMTP host.  If given, bts will send mail by talking
144           directly to this SMTP host rather than by invoking a sendmail
145           command.
146
147           The host name may be followed by a colon (":") and a port number in
148           order to use a port other than the default.  It may also begin with
149           "ssmtp://" or "smtps://" to indicate that SMTPS should be used.
150
151           If SMTPS not specified, bts will still try to use STARTTLS if it's
152           advertised by the SMTP host.
153
154           Note that one of $DEBEMAIL or $EMAIL must be set in the environment
155           in order to use direct SMTP connections to send emails.
156
157           Note that when sending directly via an SMTP host, specifying
158           addresses in --cc-addr or BTS_DEFAULT_CC that the SMTP host will
159           not relay will cause the SMTP host to reject the entire mail.
160
161           Note also that the use of the reassign command may, when either
162           --mutt or --force-interactive mode is enabled, lead to the
163           automatic addition of a Cc to $newpackage@packages.debian.org.  In
164           these cases, the note above regarding relaying applies.  The
165           submission interface (port 587) on reportbug.debian.org does not
166           support relaying and, as such, should not be used as an SMTP server
167           for bts under the circumstances described in this paragraph.
168
169       --smtp-username=USERNAME, --smtp-password=PASSWORD
170           Specify the credentials to use when connecting to the SMTP server
171           specified by --smtp-host.  If the server does not require
172           authentication then these options should not be used.
173
174           If a username is specified but not a password, bts will prompt for
175           the password before sending the mail.
176
177       --smtp-helo=HELO
178           Specify the name to use in the HELO command when connecting to the
179           SMTP server; defaults to the contents of the file /etc/mailname, if
180           it exists.
181
182           Note that some SMTP servers may reject the use of a HELO which
183           either does not resolve or does not appear to belong to the host
184           using it.
185
186       --bts-server
187           Use a debbugs server other than https://bugs.debian.org.
188
189       -f, --force-refresh
190           Download a bug report again, even if it does not appear to have
191           changed since the last cache command.  Useful if a
192           --cache-mode=full is requested for the first time (otherwise
193           unchanged bug reports will not be downloaded again, even if the
194           boring bits have not been downloaded).
195
196       --no-force-refresh
197           Suppress any configuration file --force-refresh option.
198
199       --only-new
200           Download only new bugs when caching. Do not check for updates in
201           bugs we already have.
202
203       --include-resolved
204           When caching bug reports, include those that are marked as
205           resolved.  This is the default behaviour.
206
207       --no-include-resolved
208           Reverse the behaviour of the previous option.  That is, do not
209           cache bugs that are marked as resolved.
210
211       --no-ack
212           Suppress acknowledgment mails from the BTS.  Note that this will
213           only affect the copies of messages CCed to bugs, not those sent to
214           the control bot.
215
216       --ack
217           Do not suppress acknowledgement mails.  This is the default
218           behaviour.
219
220       -i, --interactive
221           Before sending an e-mail to the control bot, display the content
222           and allow it to be edited, or the sending cancelled.
223
224       --force-interactive
225           Similar to --interactive, with the exception that an editor is
226           spawned before prompting for confirmation of the message to be
227           sent.
228
229       --no-interactive
230           Send control e-mails without confirmation.  This is the default
231           behaviour.
232
233       -q, --quiet
234           When running bts cache, only display information about newly cached
235           pages, not messages saying already cached.  If this option is
236           specified twice, only output error messages (to stderr).
237
238       --no-conf, --noconf
239           Do not read any configuration files.  This can only be used as the
240           first option given on the command-line.
241

COMMANDS

243       For full details about the commands, see the BTS documentation.
244       <https://www.debian.org/Bugs/server-control>
245
246       show [options] [bug number | package | maintainer | : ] [opt=val ...]
247       show [options] [src:package | from:submitter] [opt=val ...]
248       show [options] [tag:tag | usertag:tag ] [opt=val ...]
249       show [release-critical | release-critical/... | RC]
250           This is a synonym for bts bugs.
251
252       bugs [options] [bug_number | package | maintainer | : ] [opt=val ...]
253       bugs [options] [src:package | from:submitter] [opt=val ...]
254       bugs [options] [tag:tag | usertag:tag ] [opt=val ...]
255       bugs [release-critical | release-critical/... | RC]
256           Display the page listing the requested bugs in a web browser using
257           sensible-browser(1).
258
259           Options may be specified after the bugs command in addition to or
260           instead of options at the start of the command line: recognised
261           options at this point are: -o/--offline/--online, -m/--mbox,
262           --mailreader and --[no-]cache.  These are described earlier in this
263           manpage.  If either the -o or --offline option is used, or there is
264           already an up-to-date copy in the local cache, the cached version
265           will be used.
266
267           The meanings of the possible arguments are as follows:
268
269           (none)  If nothing is specified, bts bugs will display your bugs,
270                   assuming that either DEBEMAIL or EMAIL (examined in that
271                   order) is set to the appropriate email address.
272
273           bug_number
274                   Display bug number bug_number.
275
276           package Display the bugs for the package package.
277
278           src:package
279                   Display the bugs for the source package package.
280
281           maintainer
282                   Display the bugs for the maintainer email address
283                   maintainer.
284
285           from:submitter
286                   Display the bugs for the submitter email address submitter.
287
288           tag:tag Display the bugs which are tagged with tag.
289
290           usertag:tag
291                   Display the bugs which are tagged with usertag tag.  See
292                   the BTS documentation for more information on usertags.
293                   This will require the use of a users=email option.
294
295           :       Details of the bug tracking system itself, along with a
296                   bug-request page with more options than this script, can be
297                   found on https://bugs.debian.org/.  This page itself will
298                   be opened if the command 'bts bugs :' is used.
299
300           release-critical, RC
301                   Display the front page of the release-critical pages on the
302                   BTS.  This is a synonym for
303                   https://bugs.debian.org/release-critical/index.html.  It is
304                   also possible to say release-critical/debian/main.html and
305                   the like.  RC is a synonym for
306                   release-critical/other/all.html.
307
308           After the argument specifying what to display, you can optionally
309           specify options to use to format the page or change what it
310           displayed.  These are passed to the BTS in the URL downloaded. For
311           example, pass dist=stable to see bugs affecting the stable version
312           of a package, version=1.0 to see bugs affecting that version of a
313           package, or reverse=yes to display newest messages first in a bug
314           log.
315
316           If caching has been enabled (that is, --no-cache has not been used,
317           and BTS_CACHE has not been set to no), then any page requested by
318           bts show will automatically be cached, and be available offline
319           thereafter.  Pages which are automatically cached in this way will
320           be deleted on subsequent "bts show|bugs|cache" invocations if they
321           have not been accessed in 30 days.  Warning: on a filesystem
322           mounted with the "noatime" option, running "bts show|bugs" does not
323           update the cache files' access times; a cached bug will then be
324           subject to auto-cleaning 30 days after its initial download, even
325           if it has been accessed in the meantime.
326
327           Any other bts commands following this on the command line will be
328           executed after the browser has been exited.
329
330           The desired browser can be specified and configured by setting the
331           BROWSER environment variable.  The conventions follow those defined
332           by Eric Raymond at http://www.catb.org/~esr/BROWSER/; we here
333           reproduce the relevant part.
334
335           The value of BROWSER may consist of a colon-separated series of
336           browser command parts. These should be tried in order until one
337           succeeds. Each command part may optionally contain the string %s;
338           if it does, the URL to be viewed is substituted there. If a command
339           part does not contain %s, the browser is to be launched as if the
340           URL had been supplied as its first argument. The string %% must be
341           substituted as a single %.
342
343           Rationale: We need to be able to specify multiple browser commands
344           so programs obeying this convention can do the right thing in
345           either X or console environments, trying X first. Specifying
346           multiple commands may also be useful for people who share files
347           like .profile across multiple systems. We need %s because some
348           popular browsers have remote-invocation syntax that requires it.
349           Unless %% reduces to %, it won't be possible to have a literal %s
350           in the string.
351
352           For example, on most Linux systems a good thing to do would be:
353
354           BROWSER='mozilla -raise -remote "openURL(%s,new-window)":links'
355
356       select [key:value ...]
357           Uses the SOAP interface to output a list of bugs which match the
358           given selection requirements.
359
360           The following keys are allowed, and may be given multiple times.
361
362           package Binary package name.
363
364           source  Source package name.
365
366           maintainer
367                   E-mail address of the maintainer.
368
369           submitter
370                   E-mail address of the submitter.
371
372           severity
373                   Bug severity.
374
375           status  Status of the bug.  One of open, done, or forwarded.
376
377           tag     Tags applied to the bug. If users is specified, may include
378                   usertags in addition to the standard tags.
379
380           owner   Bug's owner.
381
382           correspondent
383                   Address of someone who sent mail to the log.
384
385           affects Bugs which affect this package.
386
387           bugs    List of bugs to search within.
388
389           users   Users to use when looking up usertags.
390
391           archive Whether to search archived bugs or normal bugs; defaults to
392                   0 (i.e. only search normal bugs). As a special case, if
393                   archive is both, both archived and unarchived bugs are
394                   returned.
395
396           For example, to select the set of bugs submitted by
397           jrandomdeveloper@example.com and tagged wontfix, one would use
398
399           bts select submitter:jrandomdeveloper@example.com tag:wontfix
400
401           If a key is used multiple times then the set of bugs selected
402           includes those matching any of the supplied values; for example
403
404           bts select package:foo severity:wishlist severity:minor
405
406           returns all bugs of package foo with either wishlist or minor
407           severity.
408
409       status [bug | file:file | fields:field[,field ...] | verbose] ...
410           Uses the SOAP interface to output status information for the given
411           bugs (or as read from the listed files -- use - to indicate STDIN).
412
413           By default, all populated fields for a bug are displayed.
414
415           If verbose is given, empty fields will also be displayed.
416
417           If fields is given, only those fields will be displayed.  No
418           validity checking is performed on any specified fields.
419
420       clone bug new_ID [new_ID ...]
421           The clone control command allows you to duplicate a bug report. It
422           is useful in the case where a single report actually indicates that
423           multiple distinct bugs have occurred. "New IDs" are negative
424           numbers, separated by spaces, which may be used in subsequent
425           control commands to refer to the newly duplicated bugs.  A new
426           report is generated for each new ID.
427
428       done bug [version]
429           Mark a bug as Done. This forces interactive mode since done
430           messages should include an explanation why the bug is being closed.
431           You should specify which version of the package closed the bug, if
432           possible.
433
434       reopen bug [submitter]
435           Reopen a bug, with optional submitter.
436
437       archive bug
438           Archive a bug that has previously been archived but is currently
439           not.  The bug must fulfill all of the requirements for archiving
440           with the exception of those that are time-based.
441
442       unarchive bug
443           Unarchive a bug that is currently archived.
444
445       retitle bug title
446           Change the title of the bug.
447
448       summary bug [messagenum]
449           Select a message number that should be used as the summary of a
450           bug.
451
452           If no message number is given, the summary is cleared.
453
454       submitter bug [bug ...] submitter-email
455           Change the submitter address of a bug or a number of bugs, with !
456           meaning `use the address on the current email as the new submitter
457           address'.
458
459       reassign bug [bug ...] package [version]
460           Reassign a bug or a number of bugs to a different package.  The
461           version field is optional; see the explanation at
462           <https://www.debian.org/Bugs/server-control>.
463
464       found bug [version]
465           Indicate that a bug was found to exist in a particular package
466           version.  Without version, the list of fixed versions is cleared
467           and the bug is reopened.
468
469       notfound bug version
470           Remove the record that bug was encountered in the given version of
471           the package to which it is assigned.
472
473       fixed bug version
474           Indicate that a bug was fixed in a particular package version,
475           without affecting the bug's open/closed status.
476
477       notfixed bug version
478           Remove the record that a bug was fixed in the given version of the
479           package to which it is assigned.
480
481           This is equivalent to the sequence of commands "found bug version",
482           "notfound bug version".
483
484       block bug by|with bug [bug ...]
485           Note that a bug is blocked from being fixed by a set of other bugs.
486
487       unblock bug by|with bug [bug ...]
488           Note that a bug is no longer blocked from being fixed by a set of
489           other bugs.
490
491       merge bug bug [bug ...]
492           Merge a set of bugs together.
493
494       forcemerge bug bug [bug ...]
495           Forcibly merge a set of bugs together. The first bug listed is the
496           master bug, and its settings (those which must be equal in a normal
497           merge) are assigned to the bugs listed next.
498
499       unmerge bug
500           Unmerge a bug.
501
502       tag bug [+|-|=] tag [tag ...]
503       tags bug [+|-|=] tag [tag ...]
504           Set or unset a tag on a bug. The tag may either be the exact tag
505           name or it may be abbreviated to any unique tag substring. (So
506           using fixed will set the tag fixed, not fixed-upstream, for
507           example, but fix would not be acceptable.) Multiple tags may be
508           specified as well. The two commands (tag and tags) are identical.
509           At least one tag must be specified, unless the = flag is used,
510           where the command
511
512             bts tags <bug> =
513
514           will remove all tags from the specified bug.
515
516           Adding/removing the security tag will add
517           "team\@security.debian.org" to the Cc list of the control email.
518
519           The list of valid tags and their significance is available at
520           <https://www.debian.org/Bugs/Developer#tags>. The current valid
521           tags are:
522
523           patch, wontfix, moreinfo, unreproducible, fixed, help, security,
524           upstream, pending, d-i, confirmed, ipv6, lfs, fixed-upstream, l10n,
525           newcomer, a11y, ftbfs
526
527           There is also a tag for each release of Debian since "potato". Note
528           that this list may be out of date, see the website for the most up
529           to date source.
530
531       affects bug [+|-|=] package [package ...]
532           Indicates that a bug affects a package other than that against
533           which it is filed, causing the bug to be listed by default in the
534           package list of the other package.  This should generally be used
535           where the bug is severe enough to cause multiple reports from users
536           to be assigned to the wrong package.  At least one package must be
537           specified, unless the = flag is used, where the command
538
539             bts affects <bug> =
540
541           will remove all indications that bug affects other packages.
542
543       user email
544           Specify a user email address before using the usertags command.
545
546       usertag bug [+|-|=] tag [tag ...]
547       usertags bug [+|-|=] tag [tag ...]
548           Set or unset a user tag on a bug. The tag must be the exact tag
549           name wanted; there are no defaults or checking of tag names.
550           Multiple tags may be specified as well. The two commands (usertag
551           and usertags) are identical.  At least one tag must be specified,
552           unless the = flag is used, where the command
553
554             bts usertags <bug> =
555
556           will remove all user tags from the specified bug.
557
558       claim bug [claim]
559           Record that you have claimed a bug (e.g. for a bug squashing
560           party).  claim should be a unique token allowing the bugs you have
561           claimed to be identified; an e-mail address is often used.
562
563           If no claim is specified, the environment variable DEBEMAIL or
564           EMAIL (checked in that order) is used.
565
566       unclaim bug [claim]
567           Remove the record that you have claimed a bug.
568
569           If no claim is specified, the environment variable DEBEMAIL or
570           EMAIL (checked in that order) is used.
571
572       severity bug severity
573           Change the severity of a bug. Available severities are: wishlist,
574           minor, normal, important, serious, grave, critical. The severity
575           may be abbreviated to any unique substring.
576
577       forwarded bug address
578           Mark the bug as forwarded to the given address (usually an email
579           address or a URL for an upstream bug tracker).
580
581       notforwarded bug
582           Mark a bug as not forwarded.
583
584       package [package ...]
585           The following commands will only apply to bugs against the listed
586           packages; this acts as a safety mechanism for the BTS.  If no
587           packages are listed, this check is turned off again.
588
589       limit [key[:value]] ...
590           The following commands will only apply to bugs which meet the
591           specified criterion; this acts as a safety mechanism for the BTS.
592           If no values are listed, the limits for that key are turned off
593           again.  If no keys are specified, all limits are reset.
594
595           submitter
596                   E-mail address of the submitter.
597
598           date    Date the bug was submitted.
599
600           subject Subject of the bug.
601
602           msgid   Message-id of the initial bug report.
603
604           package Binary package name.
605
606           source  Source package name.
607
608           tag     Tags applied to the bug.
609
610           severity
611                   Bug severity.
612
613           owner   Bug's owner.
614
615           affects Bugs affecting this package.
616
617           archive Whether to search archived bugs or normal bugs; defaults to
618                   0 (i.e. only search normal bugs). As a special case, if
619                   archive is both, both archived and unarchived bugs are
620                   returned.
621
622           For example, to limit the set of bugs affected by the subsequent
623           control commands to those submitted by jrandomdeveloper@example.com
624           and tagged wontfix, one would use
625
626           bts limit submitter:jrandomdeveloper@example.com tag:wontfix
627
628           If a key is used multiple times then the set of bugs selected
629           includes those matching any of the supplied values; for example
630
631           bts limit package:foo severity:wishlist severity:minor
632
633           only applies the subsequent control commands to bugs of package foo
634           with either wishlist or minor severity.
635
636       owner bug owner-email
637           Change the "owner" address of a bug, with ! meaning `use the
638           address on the current email as the new owner address'.
639
640           The owner of a bug accepts responsibility for dealing with it.
641
642       noowner bug
643           Mark a bug as having no "owner".
644
645       subscribe bug [email]
646           Subscribe the given email address to the specified bug report.  If
647           no email address is specified, the environment variable DEBEMAIL or
648           EMAIL (in that order) is used.  If those are not set, or ! is given
649           as email address, your default address will be used.
650
651           After executing this command, you will be sent a subscription
652           confirmation to which you have to reply.  When subscribed to a bug
653           report, you receive all relevant emails and notifications.  Use the
654           unsubscribe command to unsubscribe.
655
656       unsubscribe bug [email]
657           Unsubscribe the given email address from the specified bug report.
658           As with subscribe above, if no email address is specified, the
659           environment variables DEBEMAIL or EMAIL (in that order) is used.
660           If those are not set, or ! is given as email address, your default
661           address will be used.
662
663           After executing this command, you will be sent an unsubscription
664           confirmation to which you have to reply. Use the subscribe command
665           to, well, subscribe.
666
667       reportspam bug ...
668           The reportspam command allows you to report a bug report as
669           containing spam.  It saves one from having to go to the bug web
670           page to do so.
671
672       spamreport bug ...
673           spamreport is a synonym for reportspam.
674
675       cache [options] [maint_email | pkg | src:pkg | from:submitter]
676       cache [options] [release-critical | release-critical/... | RC]
677           Generate or update a cache of bug reports for the given email
678           address or package. By default it downloads all bugs belonging to
679           the email address in the DEBEMAIL environment variable (or the
680           EMAIL environment variable if DEBEMAIL is unset). This command may
681           be repeated to cache bugs belonging to several people or packages.
682           If multiple packages or addresses are supplied, bugs belonging to
683           any of the arguments will be cached; those belonging to more than
684           one of the arguments will only be downloaded once. The cached bugs
685           are stored in $XDG_CACHE_HOME/devscripts/bts/ or, if XDG_CACHE_HOME
686           is not set, in ~/.cache/devscripts/bts/.
687
688           You can use the cached bugs with the -o switch. For example:
689
690             bts -o bugs
691             bts -o show 12345
692
693           Also, bts will update the files in it in a piecemeal fashion as it
694           downloads information from the BTS using the show command. You
695           might thus set up the cache, and update the whole thing once a
696           week, while letting the automatic cache updates update the bugs you
697           frequently refer to during the week.
698
699           Some options affect the behaviour of the cache command.  The first
700           is the setting of --cache-mode, which controls how much bts
701           downloads of the referenced links from the bug page, including
702           boring bits such as the acknowledgement emails, emails to the
703           control bot, and the mbox version of the bug report.  It can take
704           three values: min (the minimum), mbox (download the minimum plus
705           the mbox version of the bug report) or full (the whole works).  The
706           second is --force-refresh or -f, which forces the download, even if
707           the cached bug report is up-to-date.  The --include-resolved option
708           indicates whether bug reports marked as resolved should be
709           downloaded during caching.
710
711           Each of these is configurable from the configuration file, as
712           described below.  They may also be specified after the cache
713           command as well as at the start of the command line.
714
715           Finally, -q or --quiet will suppress messages about caches being
716           up-to-date, and giving the option twice will suppress all cache
717           messages (except for error messages).
718
719           Beware of caching RC, though: it will take a LONG time!  (With
720           1000+ RC bugs and a delay of 5 seconds between bugs, you're looking
721           at a minimum of 1.5 hours, and probably significantly more than
722           that.)
723
724       cleancache package | src:package | maintainer
725       cleancache from:submitter | tag:tag | usertag:tag | number | ALL
726           Clean the cache for the specified package, maintainer, etc., as
727           described above for the bugs command, or clean the entire cache if
728           ALL is specified. This is useful if you are going to have permanent
729           network access or if the database has become corrupted for some
730           reason.  Note that for safety, this command does not default to the
731           value of DEBEMAIL or EMAIL.
732
733       listcachedbugs [number]
734           List cached bug ids (intended to support bash completion). The
735           optional number argument restricts the list to those bug ids that
736           start with that number.
737
738       version
739           Display version and copyright information.
740
741       help
742           Display a short summary of commands, suspiciously similar to parts
743           of this man page.
744

ENVIRONMENT VARIABLES

746       DEBEMAIL
747           If this is set, the From: line in the email will be set to use this
748           email address instead of your normal email address (as would be
749           determined by mail).
750
751       DEBFULLNAME
752           If DEBEMAIL is set, DEBFULLNAME is examined to determine the full
753           name to use; if this is not set, bts attempts to determine a name
754           from your passwd entry.
755
756       BROWSER
757           If set, it specifies the browser to use for the show and bugs
758           options.  See the description above.
759

CONFIGURATION VARIABLES

761       The two configuration files /etc/devscripts.conf and ~/.devscripts are
762       sourced by a shell in that order to set configuration variables.
763       Command line options can be used to override configuration file
764       settings.  Environment variable settings are ignored for this purpose.
765       The currently recognised variables are:
766
767       BTS_OFFLINE
768           If this is set to yes, then it is the same as the --offline command
769           line parameter being used.  Only has an effect on the show and bugs
770           commands.  The default is no.  See the description of the show
771           command above for more information.
772
773       BTS_CACHE
774           If this is set to no, then it is the same as the --no-cache command
775           line parameter being used.  Only has an effect on the show and bug
776           commands.  The default is yes.  Again, see the show command above
777           for more information.
778
779       BTS_CACHE_MODE={min,mbox,full}
780           How much of the BTS should we mirror when we are asked to cache
781           something?  Just the minimum, or also the mbox or the whole thing?
782           The default is min, and it has the same meaning as the --cache-mode
783           command line parameter.  Only has an effect on the cache.  See the
784           cache command for more information.
785
786       BTS_FORCE_REFRESH
787           If this is set to yes, then it is the same as the --force-refresh
788           command line parameter being used.  Only has an effect on the cache
789           command.  The default is no.  See the cache command for more
790           information.
791
792       BTS_MAIL_READER
793           If this is set, specifies a mail reader to use instead of mutt.
794           Same as the --mailreader command line option.
795
796       BTS_SENDMAIL_COMMAND
797           If this is set, specifies a sendmail command to use instead of
798           /usr/sbin/sendmail.  Same as the --sendmail command line option.
799
800       BTS_ONLY_NEW
801           Download only new bugs when caching. Do not check for updates in
802           bugs we already have.  The default is no.  Same as the --only-new
803           command line option.
804
805       BTS_SMTP_HOST
806           If this is set, specifies an SMTP host to use for sending mail
807           rather than using the sendmail command.  Same as the --smtp-host
808           command line option.
809
810           Note that this option takes priority over BTS_SENDMAIL_COMMAND if
811           both are set, unless the --sendmail option is used.
812
813       BTS_SMTP_AUTH_USERNAME, BTS_SMTP_AUTH_PASSWORD
814           If these options are set, then it is the same as the
815           --smtp-username and --smtp-password options being used.
816
817       BTS_SMTP_HELO
818           Same as the --smtp-helo command line option.
819
820       BTS_INCLUDE_RESOLVED
821           If this is set to no, then it is the same as the
822           --no-include-resolved command line parameter being used.  Only has
823           an effect on the cache command.  The default is yes.  See the cache
824           command for more information.
825
826       BTS_SUPPRESS_ACKS
827           If this is set to yes, then it is the same as the --no-ack command
828           line parameter being used.  The default is no.
829
830       BTS_INTERACTIVE
831           If this is set to yes or force, then it is the same as the
832           --interactive or --force-interactive command line parameter being
833           used.  The default is no.
834
835       BTS_DEFAULT_CC
836           Specify a list of e-mail addresses to which a carbon copy of the
837           generated e-mail to the control bot should automatically be sent.
838
839       BTS_SERVER
840           Specify the name of a debbugs server which should be used instead
841           of https://bugs.debian.org.
842

SEE ALSO

844       Please see <https://www.debian.org/Bugs/server-control> for more
845       details on how to control the BTS using emails and
846       <https://www.debian.org/Bugs/> for more information about the BTS.
847
848       querybts(1), reportbug(1), pts-subscribe(1), devscripts.conf(5)
849
851       This program is Copyright (C) 2001-2003 by Joey Hess
852       <joeyh@debian.org>.  Many modifications have been made, Copyright (C)
853       2002-2005 Julian Gilbey <jdg@debian.org> and Copyright (C) 2007 Josh
854       Triplett <josh@freedesktop.org>.
855
856       It is licensed under the terms of the GPL, either version 2 of the
857       License, or (at your option) any later version.
858
859
860
861Debian Utilities                  2023-02-05                            BTS(1)
Impressum