# SOME DESCRIPTIVE TITLE # Copyright (C) YEAR Free Software Foundation, Inc. # This file is distributed under the same license as the PACKAGE package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "POT-Creation-Date: 2026-01-12 11:51+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. type: TH #: ../scripts/annotate-output.1:1 #, no-wrap msgid "ANNOTATE-OUTPUT" msgstr "" #. type: TH #: ../scripts/annotate-output.1:1 ../scripts/archpath.1:1 #: ../scripts/checkbashisms.1:1 ../scripts/dcmd.1:1 ../scripts/debc.1:1 #: ../scripts/debchange.1:1 ../scripts/debclean.1:1 ../scripts/debdiff.1:1 #: ../scripts/debdiff-apply.1:15 ../scripts/debi.1:1 ../scripts/debrelease.1:1 #: ../scripts/debrsign.1:1 ../scripts/debsign.1:1 ../scripts/debuild.1:1 #: ../scripts/dep3changelog.1:1 ../scripts/dep-14-convert-git-branch-names.1:1 #: ../doc/devscripts.7:1 ../scripts/dpkg-genbuilddeps.1:1 ../doc/edit-patch.1:1 #: ../scripts/dscextract.1:1 ../scripts/dscverify.1:1 #: ../scripts/getbuildlog.1:1 ../scripts/grep-excuses.1:1 #: ../scripts/list-unreleased.1:1 ../scripts/manpage-alert.1:1 #: ../scripts/mergechanges.1:1 ../scripts/nmudiff.1:1 #: ../scripts/plotchangelog.1:1 ../scripts/pts-subscribe.1:1 #: ../scripts/rc-alert.1:1 ../doc/suspicious-source.1:15 ../scripts/uupdate.1:1 #: ../scripts/whodepends.1:1 ../scripts/who-uploads.1:1 #: ../scripts/wnpp-alert.1:1 ../scripts/wnpp-check.1:1 #: ../doc/wrap-and-sort.1:15 ../doc/devscripts.conf.5:1 #, no-wrap msgid "Debian Utilities" msgstr "" #. type: TH #: ../scripts/annotate-output.1:1 ../scripts/archpath.1:1 #: ../scripts/checkbashisms.1:1 ../scripts/dcmd.1:1 ../scripts/debc.1:1 #: ../scripts/debchange.1:1 ../scripts/debclean.1:1 ../scripts/debdiff.1:1 #: ../scripts/debdiff-apply.1:15 ../scripts/debi.1:1 ../scripts/debrelease.1:1 #: ../scripts/debrsign.1:1 ../scripts/debsign.1:1 ../scripts/debuild.1:1 #: ../scripts/dep3changelog.1:1 ../scripts/dep-14-convert-git-branch-names.1:1 #: ../doc/devscripts.7:1 ../scripts/dpkg-depcheck.1:1 #: ../scripts/dpkg-genbuilddeps.1:1 ../doc/edit-patch.1:1 #: ../scripts/dscextract.1:1 ../scripts/dscverify.1:1 #: ../scripts/getbuildlog.1:1 ../scripts/grep-excuses.1:1 #: ../scripts/list-unreleased.1:1 ../scripts/manpage-alert.1:1 #: ../scripts/mergechanges.1:1 ../scripts/nmudiff.1:1 #: ../scripts/plotchangelog.1:1 ../scripts/pts-subscribe.1:1 #: ../scripts/rc-alert.1:1 ../doc/suspicious-source.1:15 ../scripts/uupdate.1:1 #: ../scripts/whodepends.1:1 ../scripts/who-uploads.1:1 #: ../scripts/wnpp-alert.1:1 ../scripts/wnpp-check.1:1 #: ../doc/wrap-and-sort.1:15 ../doc/devscripts.conf.5:1 #, no-wrap msgid "DEBIAN" msgstr "" #. type: SH #: ../scripts/annotate-output.1:2 ../scripts/archpath.1:2 ../scripts/bts.pl:39 #: ../scripts/build-rdeps.pl:22 ../scripts/chdist.pl:18 #: ../scripts/checkbashisms.1:2 ../scripts/cowpoke.1:18 ../scripts/dcmd.1:2 #: ../scripts/dd-list.1:18 ../scripts/deb2apptainer.1:3 #: ../scripts/deb2docker.1:3 ../scripts/debc.1:2 ../scripts/debchange.1:2 #: ../scripts/debcheckout.pl:24 ../scripts/debclean.1:2 #: ../scripts/debcommit.pl:3 ../scripts/debdiff.1:2 #: ../scripts/debdiff-apply.1:17 ../scripts/debi.1:2 #: ../scripts/debian-watch.pod:3 ../scripts/debian-watch-4.pod:3 #: ../scripts/debrepro.pod:1 ../scripts/debrelease.1:2 #: ../scripts/deb-why-removed.pl:196 ../scripts/debrsign.1:2 #: ../scripts/debsign.1:2 ../scripts/debsnap.1:3 ../scripts/debuild.1:2 #: ../scripts/dep3changelog.1:2 ../scripts/dep-14-convert-git-branch-names.1:2 #: ../doc/devscripts.7:2 ../scripts/dget.pl:573 ../scripts/diff2patches.1:2 #: ../scripts/dpkg-depcheck.1:2 ../scripts/dpkg-genbuilddeps.1:2 #: ../doc/edit-patch.1:2 ../scripts/dscextract.1:2 ../scripts/dscverify.1:2 #: ../scripts/getbuildlog.1:2 ../scripts/grep-excuses.1:2 #: ../scripts/hardening-check.pl:532 ../scripts/list-unreleased.1:2 #: ../scripts/ltnu.pod:1 ../scripts/manpage-alert.1:2 ../scripts/mass-bug.pl:21 #: ../scripts/mergechanges.1:2 ../scripts/mk-build-deps.pl:24 #: ../scripts/mk-origtargz.pl:25 ../scripts/namecheck.pl:3 #: ../scripts/nmudiff.1:2 ../scripts/origtargz.pl:20 #: ../scripts/plotchangelog.1:2 ../scripts/pts-subscribe.1:2 #: ../scripts/rc-alert.1:2 ../scripts/rmadison.pl:261 ../scripts/sadt.pod:17 #: ../scripts/salsa.pl:3 ../doc/suspicious-source.1:17 ../scripts/svnpath.pl:3 #: ../scripts/tagpending.pl:80 ../scripts/transition-check.pl:23 #: ../scripts/uscan.pl:34 ../scripts/uupdate.1:2 ../scripts/whodepends.1:2 #: ../scripts/who-uploads.1:2 ../scripts/who-permits-upload.pl:48 #: ../scripts/wnpp-alert.1:2 ../scripts/wnpp-check.1:2 #: ../doc/wrap-and-sort.1:16 ../doc/devscripts.conf.5:2 #, no-wrap msgid "NAME" msgstr "" #. type: Plain text #: ../scripts/annotate-output.1:4 msgid "annotate-output - annotate program output with time and stream" msgstr "" #. type: SH #: ../scripts/annotate-output.1:4 ../scripts/archpath.1:4 ../scripts/bts.pl:211 #: ../scripts/build-rdeps.pl:26 ../scripts/chdist.pl:22 #: ../scripts/checkbashisms.1:4 ../scripts/cowpoke.1:20 ../scripts/dcmd.1:4 #: ../scripts/dd-list.1:21 ../scripts/deb2apptainer.1:7 #: ../scripts/deb2docker.1:6 ../scripts/debc.1:4 ../scripts/debchange.1:4 #: ../scripts/debcheckout.pl:28 ../scripts/debclean.1:4 #: ../scripts/debcommit.pl:7 ../scripts/debdiff.1:4 #: ../scripts/debdiff-apply.1:20 ../scripts/debi.1:4 ../scripts/debrepro.pod:5 #: ../scripts/debrelease.1:4 ../scripts/deb-why-removed.pl:200 #: ../scripts/debrsign.1:4 ../scripts/debsign.1:4 ../scripts/debsnap.1:6 #: ../scripts/debuild.1:4 ../scripts/dep3changelog.1:4 #: ../scripts/dep-14-convert-git-branch-names.1:30 ../scripts/dget.pl:577 #: ../scripts/dpkg-depcheck.1:4 ../scripts/dpkg-genbuilddeps.1:4 #: ../doc/edit-patch.1:6 ../scripts/dscextract.1:4 ../scripts/dscverify.1:4 #: ../scripts/getbuildlog.1:4 ../scripts/grep-excuses.1:4 #: ../scripts/hardening-check.pl:536 ../scripts/list-unreleased.1:4 #: ../scripts/ltnu.pod:5 ../scripts/manpage-alert.1:4 ../scripts/mass-bug.pl:25 #: ../scripts/mergechanges.1:4 ../scripts/mk-build-deps.pl:28 #: ../scripts/mk-origtargz.pl:29 ../scripts/nmudiff.1:4 #: ../scripts/origtargz.pl:24 ../scripts/plotchangelog.1:4 #: ../scripts/pts-subscribe.1:4 ../scripts/rc-alert.1:4 #: ../scripts/rmadison.pl:265 ../scripts/sadt.pod:21 ../scripts/salsa.pl:7 #: ../doc/suspicious-source.1:21 ../scripts/svnpath.pl:7 #: ../scripts/tagpending.pl:84 ../scripts/transition-check.pl:27 #: ../scripts/uscan.pl:38 ../scripts/uupdate.1:4 ../scripts/whodepends.1:4 #: ../scripts/who-uploads.1:4 ../scripts/who-permits-upload.pl:52 #: ../scripts/wnpp-alert.1:4 ../scripts/wnpp-check.1:4 #: ../doc/wrap-and-sort.1:18 #, no-wrap msgid "SYNOPSIS" msgstr "" #. type: Plain text #: ../scripts/annotate-output.1:6 msgid "B [I ...] [--] I [I ...]" msgstr "" #. type: SH #: ../scripts/annotate-output.1:6 ../scripts/archpath.1:12 #: ../scripts/bts.pl:376 ../scripts/build-rdeps.pl:30 ../scripts/chdist.pl:33 #: ../scripts/checkbashisms.1:8 ../scripts/cowpoke.1:24 ../scripts/dcmd.1:6 #: ../scripts/dd-list.1:26 ../scripts/deb2apptainer.1:18 #: ../scripts/deb2docker.1:10 ../scripts/debc.1:6 ../scripts/debchange.1:8 #: ../scripts/debcheckout.pl:40 ../scripts/debclean.1:6 #: ../scripts/debcommit.pl:11 ../scripts/debdiff.1:15 #: ../scripts/debdiff-apply.1:27 ../scripts/debi.1:6 #: ../scripts/debian-watch.pod:7 ../scripts/debian-watch-4.pod:7 #: ../scripts/debrepro.pod:9 ../scripts/debrelease.1:6 #: ../scripts/deb-reversion.dbk:82 ../scripts/deb-why-removed.pl:204 #: ../scripts/debrsign.1:7 ../scripts/debsign.1:6 ../scripts/debsnap.1:14 #: ../scripts/debuild.1:10 ../scripts/dep3changelog.1:6 #: ../scripts/dep-14-convert-git-branch-names.1:4 ../doc/devscripts.7:4 #: ../scripts/dget.pl:587 ../scripts/diff2patches.1:10 #: ../scripts/dpkg-depcheck.1:6 ../scripts/dpkg-genbuilddeps.1:6 #: ../doc/edit-patch.1:11 ../scripts/dscextract.1:6 ../scripts/dscverify.1:6 #: ../scripts/getbuildlog.1:8 ../scripts/grep-excuses.1:6 #: ../scripts/hardening-check.pl:543 ../scripts/list-unreleased.1:6 #: ../scripts/ltnu.pod:13 ../scripts/manpage-alert.1:6 #: ../scripts/mass-bug.pl:29 ../scripts/mergechanges.1:6 #: ../scripts/mk-build-deps.pl:34 ../scripts/mk-origtargz.pl:39 #: ../scripts/nmudiff.1:6 ../scripts/origtargz.pl:34 #: ../scripts/plotchangelog.1:7 ../scripts/pts-subscribe.1:8 #: ../scripts/rc-alert.1:8 ../scripts/rmadison.pl:273 ../scripts/sadt.pod:25 #: ../scripts/salsa.pl:31 ../doc/suspicious-source.1:24 #: ../scripts/svnpath.pl:17 ../scripts/tagpending.pl:88 #: ../scripts/transition-check.pl:33 ../scripts/uscan.pl:42 #: ../scripts/uupdate.1:10 ../scripts/whodepends.1:6 ../scripts/who-uploads.1:6 #: ../scripts/who-permits-upload.pl:56 ../scripts/wnpp-alert.1:8 #: ../scripts/wnpp-check.1:8 ../doc/wrap-and-sort.1:22 #: ../doc/devscripts.conf.5:4 #, no-wrap msgid "DESCRIPTION" msgstr "" #. type: Plain text #: ../scripts/annotate-output.1:11 msgid "" "B executes I with I as arguments and " "prepends printed lines with a format string followed by an indicator for the " "stream on which the line was printed followed by a colon and a single space." msgstr "" #. type: Plain text #: ../scripts/annotate-output.1:15 msgid "" "The stream indicators are B for information from B as " "well as B for STDOUT and B for STDERR from I." msgstr "" #. type: SH #: ../scripts/annotate-output.1:17 ../scripts/bts.pl:602 #: ../scripts/build-rdeps.pl:48 ../scripts/chdist.pl:40 #: ../scripts/checkbashisms.1:23 ../scripts/cowpoke.1:29 ../scripts/dcmd.1:15 #: ../scripts/dd-list.1:58 ../scripts/deb2apptainer.1:30 #: ../scripts/deb2docker.1:22 ../scripts/debc.1:64 ../scripts/debchange.1:149 #: ../scripts/debcheckout.pl:68 ../scripts/debclean.1:63 #: ../scripts/debcommit.pl:19 ../scripts/debdiff.1:52 #: ../scripts/debdiff-apply.1:61 ../scripts/debi.1:64 #: ../scripts/debrepro.pod:92 ../scripts/debrelease.1:56 #: ../scripts/deb-reversion.dbk:128 ../scripts/deb-why-removed.pl:209 #: ../scripts/debrsign.1:30 ../scripts/debsign.1:39 ../scripts/debsnap.1:26 #: ../scripts/debuild.1:256 ../scripts/dep3changelog.1:15 #: ../scripts/dget.pl:631 ../scripts/diff2patches.1:16 #: ../scripts/dpkg-depcheck.1:15 ../scripts/dscextract.1:14 #: ../scripts/dscverify.1:18 ../scripts/getbuildlog.1:24 #: ../scripts/grep-excuses.1:14 ../scripts/hardening-check.pl:613 #: ../scripts/list-unreleased.1:12 ../scripts/ltnu.pod:27 #: ../scripts/manpage-alert.1:12 ../scripts/mass-bug.pl:63 #: ../scripts/mk-build-deps.pl:44 ../scripts/mk-origtargz.pl:63 #: ../scripts/nmudiff.1:24 ../scripts/origtargz.pl:100 #: ../scripts/plotchangelog.1:43 ../scripts/pts-subscribe.1:18 #: ../scripts/rc-alert.1:17 ../scripts/rmadison.pl:282 ../scripts/sadt.pod:42 #: ../scripts/salsa.pl:517 ../doc/suspicious-source.1:34 #: ../scripts/tagpending.pl:94 ../scripts/transition-check.pl:42 #: ../scripts/uupdate.1:54 ../scripts/whodepends.1:10 #: ../scripts/who-uploads.1:15 ../scripts/who-permits-upload.pl:62 #: ../scripts/wnpp-alert.1:17 ../scripts/wnpp-check.1:16 #: ../doc/wrap-and-sort.1:35 #, no-wrap msgid "OPTIONS" msgstr "" #. type: TP #: ../scripts/annotate-output.1:18 #, no-wrap msgid "B<+FORMAT>" msgstr "" #. type: Plain text #: ../scripts/annotate-output.1:24 msgid "" "A format string that may use the conversion specifiers from the " "B(1)-utility. The printed string is separated from the following " "stream indicator by a single space. May be overridden by later options that " "specify the format string." msgstr "" #. type: Plain text #: ../scripts/annotate-output.1:26 msgid "Defaults to \"%H:%M:%S\"." msgstr "" #. type: TP #: ../scripts/annotate-output.1:26 #, no-wrap msgid "B<--raw-date-format> I" msgstr "" #. type: Plain text #: ../scripts/annotate-output.1:32 msgid "" "A format string that may use the conversion specifiers from the " "B(1)-utility. There is no separator between the printed string and the " "following stream indicator. May be overridden by later options that specify " "the format string." msgstr "" #. type: TP #: ../scripts/annotate-output.1:32 #, no-wrap msgid "B<-->" msgstr "" #. type: Plain text #: ../scripts/annotate-output.1:35 msgid "Ends option parsing (unless it is itself an argument to an option)." msgstr "" #. type: TP #: ../scripts/annotate-output.1:35 ../scripts/chdist.pl:44 #: ../scripts/dd-list.1:59 ../scripts/debcheckout.pl:96 #: ../scripts/debdiff-apply.1:62 ../scripts/debsnap.1:73 #: ../scripts/dep-14-convert-git-branch-names.1:42 ../scripts/dget.pl:691 #: ../scripts/dpkg-depcheck.1:96 ../scripts/getbuildlog.1:25 #: ../scripts/mk-build-deps.pl:111 ../scripts/rmadison.pl:306 #: ../scripts/sadt.pod:64 ../doc/suspicious-source.1:35 #: ../doc/wrap-and-sort.1:36 #, no-wrap msgid "B<-h>, B<--help>" msgstr "" #. type: Plain text #: ../scripts/annotate-output.1:38 msgid "Display a help message." msgstr "" #. type: SH #: ../scripts/annotate-output.1:39 ../scripts/debrepro.pod:144 #: ../scripts/debsnap.1:102 ../scripts/dscextract.1:20 #: ../scripts/transition-check.pl:54 ../scripts/uscan.pl:653 #: ../scripts/wnpp-check.1:28 #, no-wrap msgid "EXIT STATUS" msgstr "" #. type: Plain text #: ../scripts/annotate-output.1:43 msgid "" "If I is invoked, the exit status of B shall be the " "exit status of I; otherwise, B shall exit with one " "of the following values:" msgstr "" #. type: TP #: ../scripts/annotate-output.1:43 ../scripts/dscextract.1:21 #: ../scripts/wnpp-check.1:29 #, no-wrap msgid "0" msgstr "" #. type: Plain text #: ../scripts/annotate-output.1:46 msgid "B<-h> or B<--help> was used." msgstr "" #. type: TP #: ../scripts/annotate-output.1:46 #, no-wrap msgid "125" msgstr "" #. type: Plain text #: ../scripts/annotate-output.1:49 msgid "An error occurred in B." msgstr "" #. type: TP #: ../scripts/annotate-output.1:49 #, no-wrap msgid "126" msgstr "" #. type: Plain text #: ../scripts/annotate-output.1:52 msgid "I was found but could not be invoked." msgstr "" #. type: TP #: ../scripts/annotate-output.1:52 #, no-wrap msgid "127" msgstr "" #. type: Plain text #: ../scripts/annotate-output.1:55 msgid "I could not be found or was not specified." msgstr "" #. type: =head1 #: ../scripts/annotate-output.1:56 ../scripts/bts.pl:298 #: ../scripts/dscextract.1:30 ../scripts/ltnu.pod:84 #, no-wrap msgid "EXAMPLE" msgstr "" #. type: Plain text #: ../scripts/annotate-output.1:66 #, no-wrap msgid "" "$ annotate-output make\n" "21:41:21 I: Started make\n" "21:41:21 O: gcc -Wall program.c\n" "21:43:18 E: program.c: Couldn't compile, and took me ages to find out\n" "21:43:19 E: collect2: ld returned 1 exit status\n" "21:43:19 E: make: *** [all] Error 1\n" "21:43:19 I: Finished with exitcode 2\n" msgstr "" #. type: SH #: ../scripts/annotate-output.1:68 #, no-wrap msgid "CAVEATS AND BUGS" msgstr "" #. type: Plain text #: ../scripts/annotate-output.1:72 msgid "" "Since STDOUT and STDERR are processed in parallel, it can happen that some " "lines received on STDOUT will show up before later-printed STDERR lines (and " "vice-versa)." msgstr "" #. type: Plain text #: ../scripts/annotate-output.1:77 msgid "" "This is unfortunately very hard to fix with the current annotation " "strategy. A fix would involve switching to PTRACE'ing the process. Giving " "nice a (much) higher priority over I could however cause this " "behaviour to show up less frequently." msgstr "" #. type: Plain text #: ../scripts/annotate-output.1:80 msgid "" "B expects I to output (text) lines (as specified " "by POSIX) to STDOUT and STDERR." msgstr "" #. type: Plain text #: ../scripts/annotate-output.1:85 msgid "" "In particular, it leads to undefined behaviour when lines are printed that " "contain NUL bytes. It further may lead to undefined behaviour when lines " "are printed that contain bytes that do not form valid characters in the " "current locale." msgstr "" #. type: Plain text #: ../scripts/annotate-output.1:89 msgid "" "When an interactive I asks for input, the question might not be " "shown until after you have answered it. This will give the impression that " "I has hung, while it has not." msgstr "" #. type: Plain text #: ../scripts/annotate-output.1:96 msgid "" "B is implemented as a script in the Shell Command " "Language. Shells typically set various (shell) variables when started and " "may set the `export` attribute on some of them. They further initialise " "(shell) variables from their own environment (as set by the caller of the " "shell respectively the caller of B) and set the `export` " "attribute on them." msgstr "" #. type: Plain text #: ../scripts/annotate-output.1:100 msgid "" "It follows from this, that when the caller of B wants to " "set the environment (variables) of I, they may get overridden or " "additional ones may get added by the shell." msgstr "" #. type: Plain text #: ../scripts/annotate-output.1:106 msgid "" "Further, environment variables are in principle allowed to have names (for " "example `.`) that are not valid shell variable names. POSIX does not specify " "whether or not such environment variables are exported to programs invoked " "from the shell. No assumptions can thus be made on whether such environment " "variables will be exported correctly or at all to I." msgstr "" #. type: SH #: ../scripts/annotate-output.1:107 ../scripts/bts.pl:5724 #: ../scripts/checkbashisms.1:72 ../scripts/cowpoke.1:379 ../scripts/dcmd.1:110 #: ../scripts/deb2apptainer.1:136 ../scripts/deb2docker.1:106 #: ../scripts/debc.1:125 ../scripts/debchange.1:486 #: ../scripts/debcheckout.pl:231 ../scripts/debclean.1:110 #: ../scripts/debcommit.pl:976 ../scripts/debdiff.1:269 #: ../scripts/debdiff-apply.1:111 ../scripts/debi.1:131 #: ../scripts/debian-watch.pod:1600 ../scripts/debian-watch-4.pod:1412 #: ../scripts/debrepro.pod:171 ../scripts/debrelease.1:132 #: ../scripts/deb-reversion.dbk:247 ../scripts/deb-why-removed.pl:247 #: ../scripts/debrsign.1:66 ../scripts/debsign.1:132 ../scripts/debsnap.1:138 #: ../scripts/debuild.1:447 ../scripts/dep3changelog.1:28 #: ../scripts/dep-14-convert-git-branch-names.1:48 ../scripts/dget.pl:764 #: ../scripts/diff2patches.1:45 ../scripts/dpkg-depcheck.1:118 #: ../scripts/dpkg-genbuilddeps.1:30 ../scripts/dscverify.1:81 #: ../scripts/grep-excuses.1:61 ../scripts/hardening-check.pl:704 #: ../scripts/list-unreleased.1:19 ../scripts/ltnu.pod:105 #: ../scripts/mk-origtargz.pl:214 ../scripts/nmudiff.1:127 #: ../scripts/origtargz.pl:162 ../scripts/plotchangelog.1:124 #: ../scripts/pts-subscribe.1:51 ../scripts/rc-alert.1:121 #: ../scripts/rmadison.pl:406 ../scripts/sadt.pod:74 ../scripts/salsa.pl:1217 #: ../scripts/tagpending.pl:149 ../scripts/uscan.pl:837 #: ../scripts/uupdate.1:189 ../scripts/who-permits-upload.pl:167 #: ../scripts/wnpp-alert.1:29 ../scripts/wnpp-check.1:26 #: ../doc/devscripts.conf.5:54 #, no-wrap msgid "SEE ALSO" msgstr "" #. type: Plain text #: ../scripts/annotate-output.1:109 msgid "B(1)" msgstr "" #. type: SH #: ../scripts/annotate-output.1:110 #, no-wrap msgid "SUPPORT" msgstr "" #. type: Plain text #: ../scripts/annotate-output.1:114 msgid "" "B is community-supported (meaning: you'll need to fix it " "yourself). Patches are however appreciated, as is any feedback (positive or " "negative)." msgstr "" #. type: SH #: ../scripts/annotate-output.1:115 ../scripts/archpath.1:54 #: ../scripts/build-rdeps.pl:749 ../scripts/checkbashisms.1:74 #: ../scripts/cowpoke.1:385 ../scripts/dcmd.1:113 ../scripts/dd-list.1:107 #: ../scripts/debc.1:129 ../scripts/debchange.1:493 #: ../scripts/debcheckout.pl:236 ../scripts/debclean.1:113 #: ../scripts/debcommit.pl:972 ../scripts/debdiff.1:277 ../scripts/debi.1:133 #: ../scripts/debian-watch.pod:1605 ../scripts/debian-watch-4.pod:1416 #: ../scripts/debrepro.pod:175 ../scripts/debrelease.1:136 #: ../scripts/deb-reversion.dbk:292 ../scripts/debrsign.1:70 #: ../scripts/debsign.1:143 ../scripts/debuild.1:459 #: ../scripts/dep3changelog.1:26 ../scripts/dget.pl:756 #: ../scripts/diff2patches.1:48 ../scripts/dpkg-genbuilddeps.1:36 #: ../scripts/dscextract.1:32 ../scripts/dscverify.1:85 #: ../scripts/getbuildlog.1:41 ../scripts/grep-excuses.1:63 #: ../scripts/hardening-check.pl:692 ../scripts/list-unreleased.1:21 #: ../scripts/manpage-alert.1:28 ../scripts/mass-bug.pl:596 #: ../scripts/mergechanges.1:28 ../scripts/mk-build-deps.pl:141 #: ../scripts/mk-origtargz.pl:218 ../scripts/namecheck.pl:24 #: ../scripts/nmudiff.1:131 ../scripts/origtargz.pl:166 #: ../scripts/plotchangelog.1:126 ../scripts/pts-subscribe.1:56 #: ../scripts/rc-alert.1:125 ../scripts/rmadison.pl:410 #: ../scripts/salsa.pl:1221 ../scripts/svnpath.pl:96 #: ../scripts/transition-check.pl:81 ../scripts/uscan.pl:842 #: ../scripts/uupdate.1:196 ../scripts/whodepends.1:19 #: ../scripts/who-uploads.1:73 ../scripts/who-permits-upload.pl:162 #: ../scripts/wnpp-alert.1:31 ../scripts/wnpp-check.1:36 #: ../doc/devscripts.conf.5:58 #, no-wrap msgid "AUTHOR" msgstr "" #. type: Plain text #: ../scripts/annotate-output.1:120 msgid "" "This manual page was written by Jeroen van Wolffelaar " "Ejeroen@wolffelaar.nlE and can be redistributed under the terms of " "the GPL version 2. The B script itself was re-written by " "Johannes Schauer Marin Rodrigues Ejosch@debian.orgE and can be " "redistributed under the terms of the Expat license." msgstr "" #. type: TH #: ../scripts/archpath.1:1 #, no-wrap msgid "ARCHPATH" msgstr "" #. type: Plain text #: ../scripts/archpath.1:4 msgid "archpath - output arch (tla/Bazaar) archive names, with support for branches" msgstr "" #. type: Plain text #: ../scripts/archpath.1:6 msgid "B" msgstr "" #. type: Plain text #: ../scripts/archpath.1:9 msgid "B I" msgstr "" #. type: Plain text #: ../scripts/archpath.1:12 msgid "B IB<-->I" msgstr "" #. type: Plain text #: ../scripts/archpath.1:15 msgid "B is intended to be run in an arch (tla or Bazaar) working copy." msgstr "" #. type: Plain text #: ../scripts/archpath.1:20 msgid "" "In its simplest usage, B with no parameters outputs the package " "name (archive/category--branch--version) associated with the working copy." msgstr "" #. type: Plain text #: ../scripts/archpath.1:28 msgid "" "If a parameter is given, it may either be a branch--version, in which case " "B will output a corresponding package name in the current archive " "and category, or a plain branch name (without \\(oq--\"), in which case " "B will output a corresponding package name in the current archive " "and category and with the same version as the current working copy." msgstr "" #. type: Plain text #: ../scripts/archpath.1:32 msgid "" "This is useful for branching. For example, if you're using Bazaar and you " "want to create a branch for a new feature, you might use a command like " "this:" msgstr "" #. type: Plain text #: ../scripts/archpath.1:37 #, no-wrap msgid "CW\n" msgstr "" #. type: Plain text #: ../scripts/archpath.1:43 msgid "" "Or if you want to tag your current code onto a \\(oqreleases\\(cq branch as " "version 1.0, you might use a command like this:" msgstr "" #. type: Plain text #: ../scripts/archpath.1:48 #, no-wrap msgid "CW\n" msgstr "" #. type: Plain text #: ../scripts/archpath.1:54 msgid "" "That's much easier than using \\(oqbaz tree-version\\(cq to look up the " "package name and manually modifying the result." msgstr "" #. type: Plain text #: ../scripts/archpath.1:57 msgid "B was written by" msgstr "" #. type: Plain text #: ../scripts/archpath.1:59 msgid "Colin Watson Ecjwatson@debian.orgE." msgstr "" #. type: Plain text #: ../scripts/archpath.1:63 msgid "" "Like B, this manual page is released under the GNU General Public " "License, version 2 or later." msgstr "" #. type: textblock #: ../scripts/bts.pl:41 msgid "bts - command-line interface for Debian's Bug Tracking System (BTS)" msgstr "" #. type: =head2 #: ../scripts/bts.pl:213 msgid "Send Bug Change Request" msgstr "" #. type: textblock #: ../scripts/bts.pl:215 msgid "" "B [I] I [B<#>I] [B<,> I " "[B<#>I]] ..." msgstr "" #. type: =item #: ../scripts/bts.pl:219 msgid "" "* Bug State Is: B|B, B, B, " "B." msgstr "" #. type: =item #: ../scripts/bts.pl:222 msgid "" "* Bug Organisation Is: B, B, B, " "B, B." msgstr "" #. type: =item #: ../scripts/bts.pl:225 msgid "" "* Metadata Is: B, B, B, B, " "B, B, B, B." msgstr "" #. type: =item #: ../scripts/bts.pl:231 msgid "* Bug Linking Is: B." msgstr "" #. type: =item #: ../scripts/bts.pl:234 msgid "" "* Version Tracking Is: B, B, B, " "B." msgstr "" #. type: =item #: ../scripts/bts.pl:237 msgid "* Tagging Is: B, B, B." msgstr "" #. type: =item #: ../scripts/bts.pl:240 msgid "" "* Coordination Is: B, B|B, B, " "B." msgstr "" #. type: =item #: ../scripts/bts.pl:243 msgid "* Blast radius control Is: B, B." msgstr "" #. type: =head2 #: ../scripts/bts.pl:249 msgid "Compose Quoted Reply With In-Line Bug Changes" msgstr "" #. type: textblock #: ../scripts/bts.pl:251 msgid "" "B I[B<#>I] , I [B<#>I] " "[I [B<#>I]]..." msgstr "" #. type: =head2 #: ../scripts/bts.pl:253 msgid "Set Implicit Bug from MUA Message Context" msgstr "" #. type: textblock #: ../scripts/bts.pl:255 msgid "B < bug-message.eml" msgstr "" #. type: =head2 #: ../scripts/bts.pl:257 msgid "Read Bugs (Web or E-Mail)" msgstr "" #. type: textblock #: ../scripts/bts.pl:259 msgid "B|B I..." msgstr "" #. type: =head2 #: ../scripts/bts.pl:262 msgid "Prepare to Work Offline" msgstr "" #. type: textblock #: ../scripts/bts.pl:264 msgid "B|B I..." msgstr "" #. type: =head2 #: ../scripts/bts.pl:267 msgid "Manage $EMAIL Subscription" msgstr "" #. type: textblock #: ../scripts/bts.pl:269 msgid "B|B I" msgstr "" #. type: =head2 #: ../scripts/bts.pl:272 msgid "Contribute to Spam Fighting" msgstr "" #. type: textblock #: ../scripts/bts.pl:274 msgid "B|B I..." msgstr "" #. type: =head2 #: ../scripts/bts.pl:276 msgid "Scripting" msgstr "" #. type: =item #: ../scripts/bts.pl:280 msgid "* List matching bug numbers: B I..." msgstr "" #. type: =item #: ../scripts/bts.pl:283 msgid "* Fetch Live Bug Status: B I" msgstr "" #. type: =item #: ../scripts/bts.pl:286 msgid "* List bugs in local cache (for shell completion): B" msgstr "" #. type: =head2 #: ../scripts/bts.pl:292 msgid "About bts(1)" msgstr "" #. type: textblock #: ../scripts/bts.pl:294 msgid "B B|B" msgstr "" #. type: =head2 #: ../scripts/bts.pl:300 msgid "Change bugs" msgstr "" #. type: verbatim #: ../scripts/bts.pl:302 #, no-wrap msgid "" " $ bts severity 69042 normal\n" " $ bts merge 69042 43233\n" " $ bts retitle 69042 This is a better bug description\n" "\n" msgstr "" #. type: =head2 #: ../scripts/bts.pl:307 msgid "Many canges at once (new implicit bug syntax)" msgstr "" #. type: verbatim #: ../scripts/bts.pl:309 #, no-wrap msgid "" " $ bts severity 69042 normal , merge with 43233 , retitle Another title\n" "\n" msgstr "" #. type: =head2 #: ../scripts/bts.pl:312 msgid "Many canges at once (classic syntax)" msgstr "" #. type: verbatim #: ../scripts/bts.pl:314 #, no-wrap msgid "" " $ bts severity 69042 normal , merge it 43233 , retitle it Another title\n" " $ bts severity 69042 normal , merge -1 43233 , retitle -1 Another title\n" "\n" msgstr "" #. type: =head2 #: ../scripts/bts.pl:318 msgid "Read complete bug report discussion" msgstr "" #. type: verbatim #: ../scripts/bts.pl:320 #, no-wrap msgid "" " $ bts show 69042 # in a browser\n" " $ bts show --mbox 69042 # in a mailreader - all messages\n" "\n" msgstr "" #. type: =head2 #: ../scripts/bts.pl:324 msgid "List bugs" msgstr "" #. type: verbatim #: ../scripts/bts.pl:326 #, no-wrap msgid "" " $ bts show wget # all bugs in a package\n" " $ bts show from:$EMAIL # reported by you\n" "\n" msgstr "" #. type: =head2 #: ../scripts/bts.pl:330 msgid "Read all mails for several bugs" msgstr "" #. type: verbatim #: ../scripts/bts.pl:332 #, no-wrap msgid "" " $ bts show --mbox # in packages maintained by you\n" " $ bts show --mbox deb@e.mail # .. or someone else's\n" "\n" msgstr "" #. type: verbatim #: ../scripts/bts.pl:335 #, no-wrap msgid "" " $ bts show --mbox src:wget # in a source package\n" "\n" msgstr "" #. type: =head2 #: ../scripts/bts.pl:338 msgid "Reply to bug" msgstr "" #. type: verbatim #: ../scripts/bts.pl:340 #, no-wrap msgid "" " $ bts reply 43233 # reply to bug no. 43233\n" " $ bts reply 43233 , done # .. and add pseudoheader to close\n" " $ bts done 43233 , reply # .. other way around also works\n" "\n" msgstr "" #. type: verbatim #: ../scripts/bts.pl:344 #, no-wrap msgid "" " # Quote a message\n" " $ bts reply 43233#15 # reply to bug no. 43233 quoting message 15\n" " $ bts reply 43233#15 , done # .. and add Control: pseudoheader to close\n" "\n" msgstr "" #. type: =head2 #: ../scripts/bts.pl:349 msgid "Reply to bug on stdin, i.e. from command-line mailreader (MUA)" msgstr "" #. type: verbatim #: ../scripts/bts.pl:351 #, no-wrap msgid "" " $ bts reply - # reply and quote piped bug message\n" " $ bts reply - , close #.. and close bug\n" " $ bts severity normal , close #.. 'reply -' is implied inside supported " "MUA\n" "\n" msgstr "" #. type: textblock #: ../scripts/bts.pl:355 msgid "Hint: Run from (neo)mutt > command (\"B<|>\" key)." msgstr "" #. type: =head2 #: ../scripts/bts.pl:358 msgid "Change bug from command-line mailreader" msgstr "" #. type: verbatim #: ../scripts/bts.pl:360 #, no-wrap msgid "" " $ bts context , retitle 'flub: Does not nub!' , reassign flub\n" "\n" msgstr "" #. type: =head2 #: ../scripts/bts.pl:363 msgid "Subscribe $EMAIL to a bug:" msgstr "" #. type: verbatim #: ../scripts/bts.pl:365 #, no-wrap msgid "" " $ bts subscribe 69042\n" "\n" msgstr "" #. type: =head2 #: ../scripts/bts.pl:368 msgid "List selected bugs - for scripting:" msgstr "" #. type: verbatim #: ../scripts/bts.pl:370 #, no-wrap msgid "" " $ bugs=$(bts select src:libc6)\n" " $ for bug in $bugs; do echo $bug needs fixing; done\n" "\n" msgstr "" #. type: textblock #: ../scripts/bts.pl:378 msgid "" "B is the command-line interface for Debian's Bug Tracking System " "(BTS). It is intended for use by Debian contributors and if you're reading " "this that means I<*you*>." msgstr "" #. type: textblock #: ../scripts/bts.pl:382 msgid "" "B helps make the many common tasks involving bugs in Debian more " "convenien and enhances your workflow with offline capabilities through local " "caching." msgstr "" #. type: =head2 #: ../scripts/bts.pl:387 msgid "Contributing to Bugs" msgstr "" #. type: textblock #: ../scripts/bts.pl:389 msgid "" "Debian invites I to contribute by reporting, analyzing, replying " "to and triaging bugs -- without the need for permission or so much as an " "account." msgstr "" #. type: textblock #: ../scripts/bts.pl:393 msgid "" "A standard e-mail address (see I<$EMAIL>) and a willingness to learn and " "collaborate is all that's needed to participate." msgstr "" #. type: textblock #: ../scripts/bts.pl:396 msgid "" "That being said we ask you to use B and the BTS in general " "responsibly. Start by subscribing to packages (pts-subscribe(1)) or " "particular bugs of interest to you (\"bts subscribe 69042\"). Try to observe " "other Debian contributors' working conventions. The Debian Mentors community " " is happy to help if you have " "questions." msgstr "" #. type: textblock #: ../scripts/bts.pl:403 msgid "" "You can find more on how we work at and " "." msgstr "" #. type: textblock #: ../scripts/bts.pl:406 msgid "" "Mistakes happen, but consider that other busy volunteers may have to use " "time they could otherwise spend fixing bugs to help you clean them up." msgstr "" #. type: textblock #: ../scripts/bts.pl:409 msgid "" "To learn from other people in an in-person setting you may find a Bug " "Squashing Party or more general Debian Event to attend near you: " ", ." msgstr "" #. type: =head2 #: ../scripts/bts.pl:415 msgid "Workflows" msgstr "" #. type: textblock #: ../scripts/bts.pl:417 msgid "" "B supports reading bugs in a web- or e-mail-based worflow, but to make " "changes B will always send e-mail to a BTS I e-mail address " "(IB<@bugs.debian.org>)." msgstr "" #. type: textblock #: ../scripts/bts.pl:421 msgid "" "The web-based workflow supports both graphical and command-line " "browsers. While graphical browsers such as firefox or chromium may be " "familiar, you should consider traditional command-line browsers such as " "w3m(1) or lynx(1) for allowing a more focused workflow without context " "switches out of your terminal." msgstr "" #. type: textblock #: ../scripts/bts.pl:427 msgid "" "The software running the Debian BTS, \"Debbugs\", has first-class support " "for these browsers being from the same era of computing." msgstr "" #. type: textblock #: ../scripts/bts.pl:430 msgid "" "To make reading and changing bugs enjoyable a highly configurable " "command-line e-mail client (MUA) such as mutt(1), neomutt(1) or aerc(1) is " "recommended. By using B and B together with your " "MUA's pipe command you can make full use of B without so much as " "leaving your MUA. WARNING: Terminal mailing can be *highly* addictive." msgstr "" #. type: =head2 #: ../scripts/bts.pl:437 msgid "E-Mail Processing" msgstr "" #. type: textblock #: ../scripts/bts.pl:439 msgid "" "Being E-Mail BTS change requests are asynchrounous and may take considerable " "time to get through anti-spam measures. You should expect up to half an hour " "of delay when making your first change." msgstr "" #. type: textblock #: ../scripts/bts.pl:443 msgid "" "You will receive an acknowledgment mail from the BTS when the changes are " "accepted. You can file ACK messages into a folder for mail delivery " "troubleshooting purposes (check the B header for " "automated filtering) or suppress them using B<--no-ack> or " "B=yes." msgstr "" #. type: =head2 #: ../scripts/bts.pl:449 msgid "Sending E-Mail" msgstr "" #. type: textblock #: ../scripts/bts.pl:451 msgid "" "To get started with B right now use B<--smtp-reportbug> to send emails " "exclusively to BTS addressess without having to worry about configuration " "until you need more." msgstr "" #. type: textblock #: ../scripts/bts.pl:455 msgid "" "Once you want to send mail directly to wider internet destinations outside " "BTS mail addresses (for CC'ing people) B supports the following:" msgstr "" #. type: =item #: ../scripts/bts.pl:460 msgid "" "* interactive command-line E-Mail clients (MUAs): B, B and " "B using B<--mutt>," msgstr "" #. type: =item #: ../scripts/bts.pl:462 msgid "* connecting directly to an SMTP server using B<--smtp-host>," msgstr "" #. type: =item #: ../scripts/bts.pl:464 msgid "* system mailer (B compatible) (see B<--sendmail>)" msgstr "" #. type: =for #: ../scripts/bts.pl:466 msgid "" "comment TIL history: mail is oldest, then came sendmail, then mailx. See " "https://heirloom.sourceforge.net/mailx_history.html" msgstr "" #. type: =head2 #: ../scripts/bts.pl:471 msgid "Control Commands" msgstr "" #. type: textblock #: ../scripts/bts.pl:473 msgid "" "The commands used by B mirror Debbugs control commands but with support " "for abbreviations, more relaxed syntax and helpful local validation and " "cross-checking of the current bug state on the BTS server." msgstr "" #. type: textblock #: ../scripts/bts.pl:477 msgid "Debbugs control reference: " msgstr "" #. type: textblock #: ../scripts/bts.pl:479 msgid "" "B is also less strict about what constitutes a valid bug number. For " "example the following are understood:" msgstr "" #. type: verbatim #: ../scripts/bts.pl:482 #, no-wrap msgid "" " $ bts severity Bug#85942 normal\n" " $ bts severity \\#85942 normal\n" "\n" msgstr "" #. type: textblock #: ../scripts/bts.pl:485 msgid "" "In the latter command a POSIX shell will interpret the hash (\"#\") as " "starting a a comment since it's not in the middle of a shellword, so you " "need to quote or escape it it as we've done here." msgstr "" #. type: textblock #: ../scripts/bts.pl:489 msgid "" "B allows you to abbreviate commands to the shortest unique " "substring. It understands \"bts cl 85942\" as an alias for the \"close\" " "command." msgstr "" #. type: =head2 #: ../scripts/bts.pl:494 msgid "Control Command Comments" msgstr "" #. type: textblock #: ../scripts/bts.pl:496 msgid "" "It is possible to add comments to BTS control commands to explain why the " "changes were made:" msgstr "" #. type: verbatim #: ../scripts/bts.pl:499 #, no-wrap msgid "" " $ bts severity 30321 normal \\#Not as severe as claimed\n" "\n" msgstr "" #. type: textblock #: ../scripts/bts.pl:501 msgid "" "Note that POSIX shells will remove these comments unless the hash \"#\" " "comment character is escaped with a backslash as we've done above or quoted " "with single '' or double quotes \"\" as below." msgstr "" #. type: verbatim #: ../scripts/bts.pl:505 #, no-wrap msgid "" " $ bts severity 30321 normal '# Still not all that severe'\n" "\n" msgstr "" #. type: textblock #: ../scripts/bts.pl:507 msgid "" "Generally speaking it's preferred to use the B command to include " "C pseudoheaders in your response to the bug report instead. However " "including comments can still be useful in that context to document what you " "want to achive to other contributors in complex cases." msgstr "" #. type: =head2 #: ../scripts/bts.pl:513 msgid "Multiple Commands" msgstr "" #. type: textblock #: ../scripts/bts.pl:515 msgid "" "You can send multiple commands in a single e-mail by separating them with a " "period or comma, like so:" msgstr "" #. type: verbatim #: ../scripts/bts.pl:518 #, no-wrap msgid "" " $ bts severity 95672 normal , done 96642 0.38-7 \\#Fixed by fix-it.patch\n" "\n" msgstr "" #. type: textblock #: ../scripts/bts.pl:520 msgid "" "It is important the commas are surrounded by whitespace so your shell passes " "them to B as distinct arguments." msgstr "" #. type: verbatim #: ../scripts/bts.pl:523 #, no-wrap msgid "" " $ bts severity 95672 normal , merge 95672 95673 \\#they are the same!\n" "\n" msgstr "" #. type: =head2 #: ../scripts/bts.pl:526 msgid "Consistency Checks" msgstr "" #. type: textblock #: ../scripts/bts.pl:528 msgid "Many commands support internal and online consistency checks. For example:" msgstr "" #. type: =item #: ../scripts/bts.pl:532 msgid "" "* B, B: complain when the record that's being made already " "exists in the BTS," msgstr "" #. type: =item #: ../scripts/bts.pl:535 msgid "" "* B, B: complain when the record being removed doesn't " "exist," msgstr "" #. type: =item #: ../scripts/bts.pl:537 msgid "* B: checks whether the bug is alread marked 'done'," msgstr "" #. type: =item #: ../scripts/bts.pl:539 msgid "" "* B, B: check whether the bug is already/not yet " "archived." msgstr "" #. type: textblock #: ../scripts/bts.pl:543 msgid "" "When multiple commands all checks must succeed before any email is sent so " "you may fearlessly iterate on B commands." msgstr "" #. type: textblock #: ../scripts/bts.pl:546 msgid "" "Many of the checks involve fetching online information from the BTS. Use " "B<--offline> to disable these. Purely B internal consistency checks " "such as marking the same bug as B twice cannot be bypassed this way." msgstr "" #. type: =head2 #: ../scripts/bts.pl:551 msgid "The Implicit Bug" msgstr "" #. type: textblock #: ../scripts/bts.pl:553 msgid "" "To refer to the last mentioned bug number minus one \"-1\" may be used. The " "deprecated alias \"it\" is also allowed. For example you could write:" msgstr "" #. type: verbatim #: ../scripts/bts.pl:556 #, no-wrap msgid "" " $ bts severity 95672 wishlist , retitle -1 bts: please add a foo option\n" "\n" msgstr "" #. type: textblock #: ../scripts/bts.pl:558 msgid "" "Alternatively you can also omit the bug number entirely as long as the " "resulting usage is unambigous, i.e. the argument(s) don't look like " "bug-numbers." msgstr "" #. type: verbatim #: ../scripts/bts.pl:562 #, no-wrap msgid "" " $ bts done 95672 , fixed 0.1-3\n" "\n" msgstr "" #. type: textblock #: ../scripts/bts.pl:564 msgid "" "Every command allows at least one keyword of " "B/B/B/B/B/B/B<+>/B<->/B<=> (see " "B) to disambiguate the meaning." msgstr "" #. type: textblock #: ../scripts/bts.pl:568 msgid "" "Commands that take multiple bug numbers (B/B/B) " "require the use of a keyword to omit the implicit bug argument, but it is " "optional for other commands." msgstr "" #. type: verbatim #: ../scripts/bts.pl:572 #, no-wrap msgid "" " $ bts reopen 95672 , merge with 123456 # is equivalent to:\n" " $ bts reopen 95672 , merge -1 123456\n" "\n" msgstr "" #. type: verbatim #: ../scripts/bts.pl:575 #, no-wrap msgid "" " $ bts reopen 95672 , blocked by 123456 # is equivalent to:\n" " $ bts reopen 95672 , blocked -1 123456\n" "\n" msgstr "" #. type: textblock #: ../scripts/bts.pl:578 msgid "" "When the B command is involved the meaning of -1 can become " "confusing. Below we allocate -1 as a \"new ID\" instead of using it to refer " "to the previously mentioned bug number 95672. Consequently:" msgstr "" #. type: verbatim #: ../scripts/bts.pl:582 #, no-wrap msgid "" " $ bts done 95672 , clone to -1 -2 # is equivalent to:\n" " $ bts done 95672 , clone 95672 to -1 -2\n" "\n" msgstr "" #. type: textblock #: ../scripts/bts.pl:585 msgid "and similarly" msgstr "" #. type: verbatim #: ../scripts/bts.pl:587 #, no-wrap msgid "" " $ bts done 95672 , clone -1 -1 -2 # expands to:\n" " $ bts done 95672 , clone 95672 -1 -2\n" "\n" msgstr "" #. type: textblock #: ../scripts/bts.pl:590 msgid "" "Further, after the B command 'B<-1>' no longer refers to the " "implicit bug number, but rather the number newly allocated by the BTS " "server. You can use 'B' or the keyword syntax to disambiguate." msgstr "" #. type: verbatim #: ../scripts/bts.pl:594 #, no-wrap msgid "" " $ bts clone 95672 to -1 -2 , done # expands to:\n" " $ bts clone 95672 to -1 -2 , done 95672\n" "\n" msgstr "" #. type: textblock #: ../scripts/bts.pl:597 msgid "whereas" msgstr "" #. type: verbatim #: ../scripts/bts.pl:599 #, no-wrap msgid "" " $ bts clone 95672 to -1 -2 , done -1 # is already fully expanded.\n" "\n" msgstr "" #. type: textblock #: ../scripts/bts.pl:604 msgid "" "B examines the B configuration files as described below. " "Command-line options override the configuration file settings as you'd " "expect." msgstr "" #. type: =item #: ../scripts/bts.pl:610 msgid "Workflow Mode Options" msgstr "" #. type: textblock #: ../scripts/bts.pl:612 msgid "See also \"Workflows\" in B." msgstr "" #. type: =item #: ../scripts/bts.pl:616 msgid "B<-o>, B<--offline>" msgstr "" #. type: textblock #: ../scripts/bts.pl:618 msgid "" "Make B use cached bugs for the B and B commands, if a cache " "is available for the requested data. See the B command, below for " "information on setting up a cache." msgstr "" #. type: =item #: ../scripts/bts.pl:622 msgid "B<--online>, B<--no-offline>" msgstr "" #. type: textblock #: ../scripts/bts.pl:624 msgid "" "Opposite of B<--offline>; overrides any configuration file directive to work " "offline." msgstr "" #. type: =item #: ../scripts/bts.pl:627 msgid "B<-m>|B<--mail>|B<--mbox>" msgstr "" #. type: textblock #: ../scripts/bts.pl:629 msgid "" "Use command-line e-mail workflow for reading bugs and sending change request " "emails. When asked to display bugs invoke a mail reader (B<--mailreader>, " "B). When sending emails default to composing in a " "command-line email client (B<--mutt>, B)." msgstr "" #. type: =item #: ../scripts/bts.pl:634 msgid "B<-w>|B<--web>" msgstr "" #. type: textblock #: ../scripts/bts.pl:636 msgid "" "Use web workflow for reading bugs. Opposite of B<--mail>. When asked to " "display bugs use a web-browser (I<$BROWSER> or sensible-browser(1))." msgstr "" #. type: =item #: ../scripts/bts.pl:641 msgid "B<-n>, B<--no-action>" msgstr "" #. type: textblock #: ../scripts/bts.pl:643 msgid "Do not send emails but print them to standard output." msgstr "" #. type: =item #: ../scripts/bts.pl:645 msgid "B<--cache>, B<--no-cache>" msgstr "" #. type: textblock #: ../scripts/bts.pl:647 msgid "" "Should we attempt to cache new versions of BTS pages when performing " "B/B commands? Default is to cache." msgstr "" #. type: =item #: ../scripts/bts.pl:650 msgid "B<--cache-mode=>{B|B|B}" msgstr "" #. type: textblock #: ../scripts/bts.pl:652 msgid "" "When running a B command, should we only mirror the basic bug " "(B), or should we also mirror the mbox version (B), or should we " "mirror the whole thing, including the mbox and the boring attachments to the " "BTS bug pages and the acknowledgement emails (B)? Default is B." msgstr "" #. type: =item #: ../scripts/bts.pl:658 msgid "B<--cache-delay=>I" msgstr "" #. type: textblock #: ../scripts/bts.pl:660 msgid "" "Time in seconds to delay between each download, to avoid hammering the BTS " "web server. Default is 0 seconds." msgstr "" #. type: =item #: ../scripts/bts.pl:663 msgid "B<--mailreader=>I" msgstr "" #. type: textblock #: ../scripts/bts.pl:665 msgid "A (shell) command invoked to read a bug mailbox." msgstr "" #. type: textblock #: ../scripts/bts.pl:667 msgid "" "The I must contain the replacement marker \"B<%s>\" which is " "expanded to path to an mbox file." msgstr "" #. type: textblock #: ../scripts/bts.pl:670 msgid "" "Default depends on mailreaders avalable on the system. See " "B config option." msgstr "" #. type: =item #: ../scripts/bts.pl:673 msgid "B<--cc-addr=>I" msgstr "" #. type: textblock #: ../scripts/bts.pl:675 msgid "" "Send carbon copies to a list of users. I should be a " "comma-separated list of email addresses. Multiple options add more CCs." msgstr "" #. type: =item #: ../scripts/bts.pl:678 msgid "B<--use-default-cc>" msgstr "" #. type: textblock #: ../scripts/bts.pl:680 msgid "" "Add the addresses specified in the configuration file option " "B to the list specified using B<--cc-addr>. This is the " "default." msgstr "" #. type: =item #: ../scripts/bts.pl:684 msgid "B<--no-use-default-cc>" msgstr "" #. type: textblock #: ../scripts/bts.pl:686 msgid "Do not add addresses specified in B to the carbon copy list." msgstr "" #. type: =item #: ../scripts/bts.pl:689 ../scripts/mass-bug.pl:116 msgid "B<--sendmail=>I" msgstr "" #. type: textblock #: ../scripts/bts.pl:691 msgid "" "Specify the system mailer (B compatible) command to use for " "sending email." msgstr "" #. type: textblock #: ../scripts/bts.pl:694 msgid "" "The command will be split on white space and will not be passed to a shell. " "Default is F. The B<-t> option will be automatically " "added if the command is F or F. For " "other mailers, if they require a B<-t> option, this must be included in the " "I, for example: B<--sendmail=\"/usr/sbin/mymailer -t\">." msgstr "" #. type: textblock #: ../scripts/bts.pl:700 msgid "" "Conflicts with explicit B<--mutt>, B<--smtp-hots> and " "B<--smtp-reportbug>. Overrides implicit B<--mutt> and B." msgstr "" #. type: TP #: ../scripts/bts.pl:703 ../scripts/nmudiff.1:34 #, no-wrap msgid "B<--mutt>" msgstr "" #. type: textblock #: ../scripts/bts.pl:705 msgid "" "Use interactive command line mail client (B) for sending " "of mails instead of SMTP (B<--smtp-host>) or system mailer (B<--sendmail>)." msgstr "" #. type: textblock #: ../scripts/bts.pl:708 msgid "" "Note that one of B<$DEBEMAIL> or B<$EMAIL> must be set in the environment in " "order to use B to send emails." msgstr "" #. type: textblock #: ../scripts/bts.pl:711 msgid "" "If B<--mutt> is given B<--interactive> and B<--force-interactive> are " "ineffective." msgstr "" #. type: textblock #: ../scripts/bts.pl:714 msgid "" "B<--mutt> is implied when B is invoked from inside a command-line mail " "client as determined by $_ (see B for detailed logic) and " "e-mail workflow is active (B<--mail>, B)." msgstr "" #. type: TP #: ../scripts/bts.pl:718 ../scripts/nmudiff.1:39 #, no-wrap msgid "B<--no-mutt>" msgstr "" #. type: textblock #: ../scripts/bts.pl:720 msgid "" "Cancel implicit or explicit B<--mutt> reverting to sending with SMTP or " "system mailer instead." msgstr "" #. type: =item #: ../scripts/bts.pl:723 msgid "B<--soap-timeout=>I" msgstr "" #. type: textblock #: ../scripts/bts.pl:725 msgid "" "Timeout when fetching bug status information from the BTS in B<--online> " "mode." msgstr "" #. type: textblock #: ../scripts/bts.pl:728 msgid "" "Defaults to 5 seconds when B<--interactive> or B<--mutt> are active; 30 " "seconds otherwise (B<--no-interactive>)." msgstr "" #. type: =item #: ../scripts/bts.pl:731 msgid "B<--smtp-host=>I" msgstr "" #. type: textblock #: ../scripts/bts.pl:733 msgid "" "Specify an SMTP host. If given, B will send mail by talking directly " "to this SMTP host rather than by invoking a B command." msgstr "" #. type: textblock #: ../scripts/bts.pl:736 msgid "" "The host name may be followed by a colon (\":\") and a port number in order " "to use a port other than the default. It may also begin with \"ssmtp://\" " "or \"smtps://\" to indicate that SMTPS should be used." msgstr "" #. type: textblock #: ../scripts/bts.pl:740 msgid "" "If SMTPS not specified, B will still try to use STARTTLS if it's " "advertised by the SMTP host." msgstr "" #. type: textblock #: ../scripts/bts.pl:743 msgid "" "Note that one of B<$DEBEMAIL> or B<$EMAIL> must be set in the environment in " "order to use direct SMTP connections to send emails." msgstr "" #. type: textblock #: ../scripts/bts.pl:746 msgid "" "Conflicts with B<--mutt> and B<--sendmail>. Overidden by " "B<--smtp-reportbug>." msgstr "" #. type: =item #: ../scripts/bts.pl:748 msgid "B<--smtp-reportbug>" msgstr "" #. type: textblock #: ../scripts/bts.pl:750 msgid "" "Use the the reportbug.debian.org SMTP server to send bug reports and change " "requests (no account registration or authentication needed)." msgstr "" #. type: textblock #: ../scripts/bts.pl:753 msgid "Equivalent to B<--smtp-host=reportbug.debian.org:587 --interactive>." msgstr "" #. type: textblock #: ../scripts/bts.pl:755 msgid "" "Note that reportbug.debian.org is rate limited to a small number of mails " "per hour and only email destined for bugs.debian.org is " "accepted. Consequently using B<--cc-addr>, B, B or " "B commands will likeley cause mails to be rejected while sending." msgstr "" #. type: =item #: ../scripts/bts.pl:761 msgid "B<--smtp-username=>I, B<--smtp-password=>I" msgstr "" #. type: textblock #: ../scripts/bts.pl:763 msgid "" "Specify the credentials to use when connecting to the SMTP server specified " "by B<--smtp-host>. If the server does not require authentication then these " "options should not be used." msgstr "" #. type: textblock #: ../scripts/bts.pl:767 msgid "" "If a username is specified but not a password, B will prompt for the " "password before sending the mail." msgstr "" #. type: =item #: ../scripts/bts.pl:770 msgid "B<--smtp-helo=>I" msgstr "" #. type: textblock #: ../scripts/bts.pl:772 msgid "" "Specify the name to use in the I command when connecting to the SMTP " "server; defaults to the contents of the file F, if it exists." msgstr "" #. type: textblock #: ../scripts/bts.pl:776 msgid "" "Note that some SMTP servers may reject the use of a I which either " "does not resolve or does not appear to belong to the host using it." msgstr "" #. type: =item #: ../scripts/bts.pl:779 msgid "B<--bts-server>" msgstr "" #. type: textblock #: ../scripts/bts.pl:781 msgid "Use a debbugs server other than the default https://bugs.debian.org." msgstr "" #. type: =item #: ../scripts/bts.pl:783 msgid "B<-f>, B<--force-refresh>" msgstr "" #. type: textblock #: ../scripts/bts.pl:785 msgid "" "Download a bug report again, even if it does not appear to have changed " "since the last B command. Useful if a B<--cache-mode=full> is " "requested for the first time (otherwise unchanged bug reports will not be " "downloaded again, even if the boring bits have not been downloaded)." msgstr "" #. type: =item #: ../scripts/bts.pl:791 msgid "B<--no-force-refresh>" msgstr "" #. type: textblock #: ../scripts/bts.pl:793 msgid "Suppress any configuration file B<--force-refresh> option." msgstr "" #. type: =item #: ../scripts/bts.pl:795 msgid "B<--only-new>" msgstr "" #. type: textblock #: ../scripts/bts.pl:797 msgid "" "Download only new bugs when caching. Do not check for updates in bugs we " "already have." msgstr "" #. type: =item #: ../scripts/bts.pl:800 msgid "B<--include-resolved>" msgstr "" #. type: textblock #: ../scripts/bts.pl:802 msgid "" "When caching bug reports, include those that are marked as resolved. This " "is the default behaviour." msgstr "" #. type: =item #: ../scripts/bts.pl:805 msgid "B<--no-include-resolved>" msgstr "" #. type: textblock #: ../scripts/bts.pl:807 msgid "" "Reverse the behaviour of the previous option. That is, do not cache bugs " "that are marked as resolved." msgstr "" #. type: =item #: ../scripts/bts.pl:810 msgid "B<--no-ack>" msgstr "" #. type: textblock #: ../scripts/bts.pl:812 msgid "" "Suppress acknowledgment mails from the BTS. Note that this will only affect " "the copies of messages CCed to bugs, not those sent to the control bot." msgstr "" #. type: =item #: ../scripts/bts.pl:816 msgid "B<--ack>" msgstr "" #. type: textblock #: ../scripts/bts.pl:818 msgid "Do not suppress acknowledgement mails. This is the default behaviour." msgstr "" #. type: =item #: ../scripts/bts.pl:820 ../scripts/tagpending.pl:136 msgid "B<-i>, B<--interactive>" msgstr "" #. type: textblock #: ../scripts/bts.pl:822 msgid "" "Before sending an e-mail, display the content and allow it to be edited, or " "the sending cancelled." msgstr "" #. type: =item #: ../scripts/bts.pl:825 msgid "B<--force-interactive>" msgstr "" #. type: textblock #: ../scripts/bts.pl:827 msgid "" "Force interactive editing immediately. Similar to B<--interactive>, except " "editor is spawned before the send/cancel/edit prompt." msgstr "" #. type: =item #: ../scripts/bts.pl:830 msgid "B<--no-interactive>" msgstr "" #. type: textblock #: ../scripts/bts.pl:832 msgid "Immediately send bug change request e-mails without confirmation." msgstr "" #. type: textblock #: ../scripts/bts.pl:834 msgid "" "This is the default behaviour except if B<--mutt> is implicitly active and " "for some commands which require composing a written reply (B, " "B)." msgstr "" #. type: =item #: ../scripts/bts.pl:837 ../scripts/build-rdeps.pl:116 ../scripts/dget.pl:646 msgid "B<-q>, B<--quiet>" msgstr "" #. type: textblock #: ../scripts/bts.pl:839 msgid "" "When running B, only display information about newly cached " "pages, not messages saying already cached. If this option is specified " "twice, only output error messages (to stderr)." msgstr "" #. type: TP #: ../scripts/bts.pl:843 ../scripts/debc.1:95 ../scripts/debchange.1:390 #: ../scripts/debclean.1:80 ../scripts/debdiff.1:177 ../scripts/debi.1:101 #: ../scripts/debrelease.1:95 ../scripts/debsign.1:95 ../scripts/debuild.1:258 #: ../scripts/dpkg-depcheck.1:92 ../scripts/dscverify.1:25 #: ../scripts/grep-excuses.1:15 ../scripts/mass-bug.pl:125 #: ../scripts/nmudiff.1:78 ../scripts/rmadison.pl:348 ../scripts/uscan.pl:294 #: ../scripts/uupdate.1:56 ../scripts/who-uploads.1:41 #, no-wrap msgid "B<--no-conf>, B<--noconf>" msgstr "" #. type: Plain text #: ../scripts/bts.pl:845 ../scripts/debc.1:99 ../scripts/debchange.1:394 #: ../scripts/debclean.1:84 ../scripts/debdiff.1:181 ../scripts/debi.1:105 #: ../scripts/debrelease.1:99 ../scripts/debsign.1:99 ../scripts/debuild.1:262 #: ../scripts/dpkg-depcheck.1:96 ../scripts/dscverify.1:29 #: ../scripts/grep-excuses.1:19 ../scripts/mass-bug.pl:127 #: ../scripts/nmudiff.1:82 ../scripts/uupdate.1:60 ../scripts/who-uploads.1:45 msgid "" "Do not read any configuration files. This can only be used as the first " "option given on the command-line." msgstr "" #. type: =head1 #: ../scripts/bts.pl:1318 ../scripts/chdist.pl:62 ../scripts/salsa.pl:60 msgid "COMMANDS" msgstr "" #. type: textblock #: ../scripts/bts.pl:1320 msgid "" "For full details about the commands, see the BTS documentation. " "L" msgstr "" #. type: =item #: ../scripts/bts.pl:1325 msgid "" "B [I] [I | I | I | B<:> ] " "[IB<=>I ...]" msgstr "" #. type: =item #: ../scripts/bts.pl:1327 msgid "" "B [I] [I | I | I | B<:> ] " "[IB<=>I ...]" msgstr "" #. type: =item #: ../scripts/bts.pl:1329 msgid "" "B [I] [BI | BI] " "[IB<=>I ...]" msgstr "" #. type: =item #: ../scripts/bts.pl:1331 msgid "" "B [I] [BI | BI] " "[IB<=>I ...]" msgstr "" #. type: =item #: ../scripts/bts.pl:1333 msgid "" "B [I] [BI | BI ] [IB<=>I " "...]" msgstr "" #. type: =item #: ../scripts/bts.pl:1335 msgid "" "B [I] [BI | BI ] [IB<=>I " "...]" msgstr "" #. type: =item #: ../scripts/bts.pl:1337 msgid "B [B | B... | B]" msgstr "" #. type: =item #: ../scripts/bts.pl:1339 msgid "B [B | B... | B]" msgstr "" #. type: textblock #: ../scripts/bts.pl:1341 msgid "" "Display selected bugs in a web browser (default or B<--web>) or in a mail " "reader when B<--mbox> is given." msgstr "" #. type: textblock #: ../scripts/bts.pl:1344 msgid "" "Options that may be specified after the B sub-command in addition to " "or instead of options at the start of the command-line are: " "B<-o>/B<--offline>/B<--online>, B<-m>/B<--mbox>, B<--mailreader> and " "B<-->[B]B. These are described earlier in this manpage. If " "either the B<-o> or B<--offline> option is used, or there is already an " "up-to-date copy in the local cache, the cached version will be used." msgstr "" #. type: textblock #: ../scripts/bts.pl:1351 msgid "" "When using B<--mbox> reading more than one bug report's mails at once using " "the argument syntax described below is possible." msgstr "" #. type: textblock #: ../scripts/bts.pl:1354 msgid "The meanings of the possible arguments are as follows:" msgstr "" #. type: =item #: ../scripts/bts.pl:1358 msgid "(none)" msgstr "" #. type: textblock #: ../scripts/bts.pl:1360 msgid "" "If nothing is specified, B will display your bugs, assuming that " "either B or B (examined in that order) is set to the " "appropriate email address." msgstr "" #. type: =item #: ../scripts/bts.pl:1364 msgid "I" msgstr "" #. type: textblock #: ../scripts/bts.pl:1366 msgid "Display bug number I." msgstr "" #. type: =item #: ../scripts/bts.pl:1368 msgid "I" msgstr "" #. type: textblock #: ../scripts/bts.pl:1370 msgid "Display the bugs for the package I." msgstr "" #. type: =item #: ../scripts/bts.pl:1372 msgid "BI" msgstr "" #. type: textblock #: ../scripts/bts.pl:1374 msgid "Display the bugs for the source package I." msgstr "" #. type: =item #: ../scripts/bts.pl:1376 msgid "I" msgstr "" #. type: textblock #: ../scripts/bts.pl:1378 msgid "Display the bugs for the maintainer email address I." msgstr "" #. type: =item #: ../scripts/bts.pl:1380 msgid "BI" msgstr "" #. type: textblock #: ../scripts/bts.pl:1382 msgid "Display the bugs for the submitter email address I." msgstr "" #. type: =item #: ../scripts/bts.pl:1384 msgid "BI" msgstr "" #. type: textblock #: ../scripts/bts.pl:1386 msgid "Display the bugs which are tagged with I." msgstr "" #. type: =item #: ../scripts/bts.pl:1388 msgid "BI" msgstr "" #. type: textblock #: ../scripts/bts.pl:1390 msgid "" "Display the bugs which are tagged with usertag I. See the BTS " "documentation for more information on usertags. This will require the use " "of a BI option." msgstr "" #. type: =item #: ../scripts/bts.pl:1394 msgid "B<:>" msgstr "" #. type: textblock #: ../scripts/bts.pl:1396 msgid "" "Details of the bug tracking system itself, along with a bug-request page " "with more options than this script, can be found on " "https://bugs.debian.org/. This page itself will be opened if the command " "'bts bugs :' is used." msgstr "" #. type: =item #: ../scripts/bts.pl:1401 msgid "B, B" msgstr "" #. type: textblock #: ../scripts/bts.pl:1403 msgid "" "Display the front page of the release-critical pages on the BTS. This is a " "synonym for https://bugs.debian.org/release-critical/index.html. It is also " "possible to say release-critical/debian/main.html and the like. RC is a " "synonym for release-critical/other/all.html." msgstr "" #. type: textblock #: ../scripts/bts.pl:1410 msgid "" "After the argument specifying what to display, you can optionally specify " "options to use to format the page or change what it displayed. These are " "passed to the BTS in the URL downloaded. For example, pass dist=stable to " "see bugs affecting the stable version of a package, version=1.0 to see bugs " "affecting that version of a package, or reverse=yes to display newest " "messages first in a bug log." msgstr "" #. type: textblock #: ../scripts/bts.pl:1417 msgid "" "If caching has been enabled (that is, B<--no-cache> has not been used, and " "B has not been set to B), then any page requested by B will automatically be cached, and be available offline thereafter. " "Pages which are automatically cached in this way will be deleted on " "subsequent \"B|B|B\" invocations if they have not " "been accessed in 30 days. Warning: on a filesystem mounted with the " "\"noatime\" option, running \"B|B\" does not update the " "cache files' access times; a cached bug will then be subject to " "auto-cleaning 30 days after its initial download, even if it has been " "accessed in the meantime." msgstr "" #. type: =for #: ../scripts/bts.pl:1428 msgid "comment =head2 Execution of Subsequent Commands" msgstr "" #. type: =for #: ../scripts/bts.pl:1430 msgid "" "comment TODO: " "https://salsa.debian.org/debian/sensible-utils/-/merge_requests/14" msgstr "" #. type: textblock #: ../scripts/bts.pl:1432 msgid "" "Other B commands following on the command-line will be executed after " "sensible-browser has quit. With most post modern graphical browsers " "(firefox, chromium) will exit immediately, but when using a terminal browser " "B wait for you to quit it before continuing command execution." msgstr "" #. type: textblock #: ../scripts/bts.pl:1437 msgid "" "The desired browser can be specified and configured by setting the " "B environment variable. See L." msgstr "" #. type: textblock #: ../scripts/bts.pl:1440 msgid "" "The value of B may consist of a colon-separated series of browser " "command parts. These should be tried in order until one succeeds. Each " "command part may optionally contain the string B<%s>; if it does, the URL to " "be viewed is substituted there. If a command part does not contain B<%s>, " "the browser is to be launched as if the URL had been supplied as its first " "argument. The string B<%%> must be substituted as a single %." msgstr "" #. type: textblock #: ../scripts/bts.pl:1448 msgid "" "Rationale: We need to be able to specify multiple browser commands so " "programs obeying this convention can do the right thing in either X or " "console environments, trying X first. Specifying multiple commands may also " "be useful for people who share files like F<.profile> across multiple " "systems. We need B<%s> because some popular browsers have remote-invocation " "syntax that requires it. Unless B<%%> reduces to %, it won't be possible to " "have a literal B<%s> in the string." msgstr "" #. type: =item #: ../scripts/bts.pl:1521 msgid "B