1BTS(1) BTS(1)
2
3
4
6 bts - developers' command line interface to the Debian Bug Tracking
7 System
8
10 bts [options] command [args] [#comment] [.|, command [args] [#comment]]
11 ...
12
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
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
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
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
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
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 2019-01-30 BTS(1)