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.
109
110       --use-default-cc
111           Add the addresses specified in the configuration file option
112           BTS_DEFAULT_CC to the list specified using --cc-addr.  This is the
113           default.
114
115       --no-use-default-cc
116           Do not add addresses specified in BTS_DEFAULT_CC to the carbon copy
117           list.
118
119       --sendmail=SENDMAILCMD
120           Specify the sendmail command.  The command will be split on white
121           space and will not be passed to a shell.  Default is
122           /usr/sbin/sendmail.  The -t option will be automatically added if
123           the command is /usr/sbin/sendmail or /usr/sbin/exim*.  For other
124           mailers, if they require a -t option, this must be included in the
125           SENDMAILCMD, for example: --sendmail="/usr/sbin/mymailer -t".
126
127       --mutt
128           Use mutt for sending of mails. Default is not to use mutt, except
129           for some commands.
130
131           Note that one of $DEBEMAIL or $EMAIL must be set in the environment
132           in order to use mutt to send emails.
133
134       --no-mutt
135           Don't use mutt for sending of mails.
136
137       --soap-timeout=SECONDS
138           Specify a timeout for SOAP calls as used by the select and status
139           commands.
140
141       --smtp-host=SMTPHOST
142           Specify an SMTP host.  If given, bts will send mail by talking
143           directly to this SMTP host rather than by invoking a sendmail
144           command.
145
146           The host name may be followed by a colon (":") and a port number in
147           order to use a port other than the default.  It may also begin with
148           "ssmtp://" or "smtps://" to indicate that SMTPS should be used.
149
150           If SMTPS not specified, bts will still try to use STARTTLS if it's
151           advertised by the SMTP host.
152
153           Note that one of $DEBEMAIL or $EMAIL must be set in the environment
154           in order to use direct SMTP connections to send emails.
155
156           Note that when sending directly via an SMTP host, specifying
157           addresses in --cc-addr or BTS_DEFAULT_CC that the SMTP host will
158           not relay will cause the SMTP host to reject the entire mail.
159
160           Note also that the use of the reassign command may, when either
161           --interactive or --force-interactive mode is enabled, lead to the
162           automatic addition of a Cc to $newpackage@packages.debian.org.  In
163           these cases, the note above regarding relaying applies.  The
164           submission interface (port 587) on reportbug.debian.org does not
165           support relaying and, as such, should not be used as an SMTP server
166           for bts under the circumstances described in this paragraph.
167
168       --smtp-username=USERNAME, --smtp-password=PASSWORD
169           Specify the credentials to use when connecting to the SMTP server
170           specified by --smtp-host.  If the server does not require
171           authentication then these options should not be used.
172
173           If a username is specified but not a password, bts will prompt for
174           the password before sending the mail.
175
176       --smtp-helo=HELO
177           Specify the name to use in the HELO command when connecting to the
178           SMTP server; defaults to the contents of the file /etc/mailname, if
179           it exists.
180
181           Note that some SMTP servers may reject the use of a HELO which
182           either does not resolve or does not appear to belong to the host
183           using it.
184
185       --bts-server
186           Use a debbugs server other than https://bugs.debian.org.
187
188       -f, --force-refresh
189           Download a bug report again, even if it does not appear to have
190           changed since the last cache command.  Useful if a
191           --cache-mode=full is requested for the first time (otherwise
192           unchanged bug reports will not be downloaded again, even if the
193           boring bits have not been downloaded).
194
195       --no-force-refresh
196           Suppress any configuration file --force-refresh option.
197
198       --only-new
199           Download only new bugs when caching. Do not check for updates in
200           bugs we already have.
201
202       --include-resolved
203           When caching bug reports, include those that are marked as
204           resolved.  This is the default behaviour.
205
206       --no-include-resolved
207           Reverse the behaviour of the previous option.  That is, do not
208           cache bugs that are marked as resolved.
209
210       --no-ack
211           Suppress acknowledgment mails from the BTS.  Note that this will
212           only affect the copies of messages CCed to bugs, not those sent to
213           the control bot.
214
215       --ack
216           Do not suppress acknowledgement mails.  This is the default
217           behaviour.
218
219       -i, --interactive
220           Before sending an e-mail to the control bot, display the content
221           and allow it to be edited, or the sending cancelled.
222
223       --force-interactive
224           Similar to --interactive, with the exception that an editor is
225           spawned before prompting for confirmation of the message to be
226           sent.
227
228       --no-interactive
229           Send control e-mails without confirmation.  This is the default
230           behaviour.
231
232       -q, --quiet
233           When running bts cache, only display information about newly cached
234           pages, not messages saying already cached.  If this option is
235           specified twice, only output error messages (to stderr).
236
237       --no-conf, --noconf
238           Do not read any configuration files.  This can only be used as the
239           first option given on the command-line.
240

COMMANDS

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

ENVIRONMENT VARIABLES

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

CONFIGURATION VARIABLES

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

SEE ALSO

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