1 # SOME DESCRIPTIVE TITLE
2 # Copyright (C) YEAR Free Software Foundation, Inc.
3 # This file is distributed under the same license as the PACKAGE package.
4 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
9 "Project-Id-Version: PACKAGE VERSION\n"
10 "POT-Creation-Date: 2010-09-28 22:34+0000\n"
11 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
12 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
13 "Language-Team: LANGUAGE <LL@li.org>\n"
16 "Content-Type: text/plain; charset=UTF-8\n"
17 "Content-Transfer-Encoding: 8bit\n"
20 #: ../scripts/annotate-output.1:1
22 msgid "ANNOTATE-OUTPUT"
26 #: ../scripts/annotate-output.1:1 ../scripts/archpath.1:1 ../scripts/checkbashisms.1:1 ../scripts/cvs-debc.1:1 ../scripts/cvs-debi.1:1 ../scripts/cvs-debrelease.1:1 ../scripts/cvs-debuild.1:1 ../scripts/dcmd.1:1 ../scripts/debc.1:1 ../scripts/debchange.1:1 ../scripts/debclean.1:1 ../scripts/debdiff.1:1 ../scripts/debi.1:1 ../scripts/debpkg.1:1 ../scripts/debrelease.1:1 ../scripts/debrsign.1:1 ../scripts/debsign.1:1 ../scripts/debuild.1:1 ../scripts/devscripts.1:1 ../scripts/dpkg-genbuilddeps.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 ../scripts/uscan.1:1 ../scripts/uupdate.1:1 ../scripts/whodepends.1:1 ../scripts/who-uploads.1:1 ../scripts/wnpp-alert.1:1 ../scripts/wnpp-check.1:1 ../scripts/devscripts.conf.5:1
28 msgid "Debian Utilities"
32 #: ../scripts/annotate-output.1:1 ../scripts/archpath.1:1 ../scripts/checkbashisms.1:1 ../scripts/cvs-debc.1:1 ../scripts/cvs-debi.1:1 ../scripts/cvs-debrelease.1:1 ../scripts/cvs-debuild.1:1 ../scripts/dcmd.1:1 ../scripts/debc.1:1 ../scripts/debchange.1:1 ../scripts/debclean.1:1 ../scripts/debdiff.1:1 ../scripts/debi.1:1 ../scripts/debpkg.1:1 ../scripts/debrelease.1:1 ../scripts/debrsign.1:1 ../scripts/debsign.1:1 ../scripts/debuild.1:1 ../scripts/devscripts.1:1 ../scripts/dpkg-depcheck.1:1 ../scripts/dpkg-genbuilddeps.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 ../scripts/uscan.1:1 ../scripts/uupdate.1:1 ../scripts/whodepends.1:1 ../scripts/who-uploads.1:1 ../scripts/wnpp-alert.1:1 ../scripts/wnpp-check.1:1 ../scripts/devscripts.conf.5:1
38 #: ../scripts/annotate-output.1:2 ../scripts/archpath.1:2 ../scripts/bts.pl:27 ../scripts/build-rdeps.pl:18 ../scripts/chdist.pl:19 ../scripts/checkbashisms.1:2 ../scripts/cowpoke.1:18 ../scripts/cvs-debc.1:2 ../scripts/cvs-debi.1:2 ../scripts/cvs-debrelease.1:2 ../scripts/cvs-debuild.1:2 ../scripts/dcmd.1:2 ../scripts/dcontrol.pl:199 ../scripts/dd-list.1:19 ../scripts/debc.1:2 ../scripts/debchange.1:2 ../scripts/debcheckout.pl:23 ../scripts/debclean.1:2 ../scripts/debcommit.pl:3 ../scripts/debdiff.1:2 ../scripts/debi.1:2 ../scripts/debpkg.1:2 ../scripts/debrelease.1:2 ../scripts/debrsign.1:2 ../scripts/debsign.1:2 ../scripts/debsnap.1:3 ../scripts/debuild.1:2 ../scripts/desktop2menu.pl:24 ../scripts/devscripts.1:2 ../scripts/dget.pl:479 ../scripts/diff2patches.1:2 ../scripts/dpkg-depcheck.1:2 ../scripts/dpkg-genbuilddeps.1:2 ../scripts/dscverify.1:2 ../scripts/getbuildlog.1:2 ../scripts/grep-excuses.1:2 ../scripts/licensecheck.pl:22 ../scripts/list-unreleased.1:2 ../scripts/manpage-alert.1:2 ../scripts/mass-bug.pl:22 ../scripts/mergechanges.1:2 ../scripts/mk-build-deps.pl:24 ../scripts/namecheck.pl:3 ../scripts/nmudiff.1:2 ../scripts/plotchangelog.1:2 ../scripts/pts-subscribe.1:2 ../scripts/rc-alert.1:2 ../scripts/rmadison.pl:181 ../scripts/svnpath.pl:3 ../scripts/tagpending.pl:80 ../scripts/transition-check.pl:23 ../scripts/uscan.1:2 ../scripts/uupdate.1:2 ../scripts/whodepends.1:2 ../scripts/who-uploads.1:2 ../scripts/wnpp-alert.1:2 ../scripts/wnpp-check.1:2 ../scripts/devscripts.conf.5:2
44 #: ../scripts/annotate-output.1:4
45 msgid "annotate-output - annotate program output with time and stream"
49 #: ../scripts/annotate-output.1:4 ../scripts/archpath.1:4 ../scripts/bts.pl:151 ../scripts/build-rdeps.pl:22 ../scripts/chdist.pl:23 ../scripts/checkbashisms.1:4 ../scripts/cowpoke.1:20 ../scripts/cvs-debc.1:4 ../scripts/cvs-debi.1:4 ../scripts/cvs-debrelease.1:4 ../scripts/cvs-debuild.1:4 ../scripts/dcmd.1:4 ../scripts/dcontrol.pl:203 ../scripts/dd-list.1:22 ../scripts/debc.1:4 ../scripts/debchange.1:4 ../scripts/debcheckout.pl:27 ../scripts/debclean.1:4 ../scripts/debcommit.pl:7 ../scripts/debdiff.1:4 ../scripts/debi.1:4 ../scripts/debpkg.1:4 ../scripts/debrelease.1:4 ../scripts/debrsign.1:4 ../scripts/debsign.1:4 ../scripts/debsnap.1:6 ../scripts/debuild.1:4 ../scripts/desktop2menu.pl:28 ../scripts/dget.pl:483 ../scripts/dpkg-depcheck.1:4 ../scripts/dpkg-genbuilddeps.1:4 ../scripts/dscverify.1:4 ../scripts/getbuildlog.1:4 ../scripts/grep-excuses.1:4 ../scripts/licensecheck.pl:26 ../scripts/list-unreleased.1:4 ../scripts/manpage-alert.1:4 ../scripts/mass-bug.pl:26 ../scripts/mergechanges.1:4 ../scripts/mk-build-deps.pl:28 ../scripts/nmudiff.1:4 ../scripts/plotchangelog.1:4 ../scripts/pts-subscribe.1:4 ../scripts/rc-alert.1:4 ../scripts/rmadison.pl:185 ../scripts/svnpath.pl:7 ../scripts/tagpending.pl:84 ../scripts/transition-check.pl:27 ../scripts/uscan.1:4 ../scripts/uupdate.1:4 ../scripts/whodepends.1:4 ../scripts/who-uploads.1:4 ../scripts/wnpp-alert.1:4 ../scripts/wnpp-check.1:4
55 #: ../scripts/annotate-output.1:6
56 msgid "B<annotate-output> [I<options>] I<program> [I<args> ...]"
60 #: ../scripts/annotate-output.1:6 ../scripts/archpath.1:12 ../scripts/bts.pl:155 ../scripts/build-rdeps.pl:26 ../scripts/chdist.pl:27 ../scripts/checkbashisms.1:8 ../scripts/cowpoke.1:24 ../scripts/cvs-debc.1:6 ../scripts/cvs-debi.1:6 ../scripts/cvs-debrelease.1:7 ../scripts/cvs-debuild.1:7 ../scripts/dcmd.1:7 ../scripts/dcontrol.pl:211 ../scripts/dd-list.1:26 ../scripts/debc.1:6 ../scripts/debchange.1:8 ../scripts/debcheckout.pl:39 ../scripts/debclean.1:6 ../scripts/debcommit.pl:11 ../scripts/debdiff.1:15 ../scripts/debi.1:6 ../scripts/debpkg.1:6 ../scripts/debrelease.1:6 ../scripts/deb-reversion.dbk:82 ../scripts/debrsign.1:7 ../scripts/debsign.1:6 ../scripts/debsnap.1:14 ../scripts/debuild.1:10 ../scripts/desktop2menu.pl:34 ../scripts/devscripts.1:4 ../scripts/dget.pl:493 ../scripts/diff2patches.1:10 ../scripts/dpkg-depcheck.1:6 ../scripts/dpkg-genbuilddeps.1:6 ../scripts/dscverify.1:6 ../scripts/getbuildlog.1:8 ../scripts/grep-excuses.1:6 ../scripts/licensecheck.pl:34 ../scripts/list-unreleased.1:6 ../scripts/manpage-alert.1:8 ../scripts/mass-bug.pl:30 ../scripts/mergechanges.1:6 ../scripts/mk-build-deps.pl:34 ../scripts/nmudiff.1:6 ../scripts/plotchangelog.1:7 ../scripts/pts-subscribe.1:8 ../scripts/rc-alert.1:8 ../scripts/rmadison.pl:193 ../scripts/svnpath.pl:17 ../scripts/tagpending.pl:88 ../scripts/transition-check.pl:33 ../scripts/uscan.1:6 ../scripts/uupdate.1:8 ../scripts/whodepends.1:6 ../scripts/who-uploads.1:6 ../scripts/wnpp-alert.1:8 ../scripts/wnpp-check.1:8 ../scripts/devscripts.conf.5:4
66 #: ../scripts/annotate-output.1:10
68 "B<annotate-output> will execute the specified program, while prepending "
69 "every line with the current time and O for stdout and E for stderr."
73 #: ../scripts/annotate-output.1:11 ../scripts/bts.pl:206 ../scripts/build-rdeps.pl:30 ../scripts/chdist.pl:34 ../scripts/checkbashisms.1:23 ../scripts/cowpoke.1:29 ../scripts/cvs-debc.1:24 ../scripts/cvs-debi.1:28 ../scripts/cvs-debrelease.1:21 ../scripts/cvs-debuild.1:32 ../scripts/dcmd.1:16 ../scripts/dcontrol.pl:245 ../scripts/dd-list.1:58 ../scripts/debc.1:64 ../scripts/debchange.1:146 ../scripts/debcheckout.pl:67 ../scripts/debclean.1:60 ../scripts/debcommit.pl:19 ../scripts/debdiff.1:50 ../scripts/debi.1:65 ../scripts/debrelease.1:56 ../scripts/deb-reversion.dbk:128 ../scripts/debrsign.1:30 ../scripts/debsign.1:39 ../scripts/debsnap.1:26 ../scripts/debuild.1:219 ../scripts/dget.pl:532 ../scripts/diff2patches.1:16 ../scripts/dpkg-depcheck.1:15 ../scripts/dscverify.1:17 ../scripts/getbuildlog.1:24 ../scripts/grep-excuses.1:13 ../scripts/licensecheck.pl:43 ../scripts/list-unreleased.1:12 ../scripts/manpage-alert.1:14 ../scripts/mass-bug.pl:60 ../scripts/mk-build-deps.pl:44 ../scripts/nmudiff.1:21 ../scripts/plotchangelog.1:43 ../scripts/pts-subscribe.1:18 ../scripts/rc-alert.1:17 ../scripts/rmadison.pl:202 ../scripts/tagpending.pl:94 ../scripts/transition-check.pl:42 ../scripts/uscan.1:333 ../scripts/uupdate.1:52 ../scripts/whodepends.1:10 ../scripts/who-uploads.1:15 ../scripts/wnpp-alert.1:17 ../scripts/wnpp-check.1:16
79 #: ../scripts/annotate-output.1:12
85 #: ../scripts/annotate-output.1:16
86 msgid "Controls the timestamp format, as per B<date>(1). Defaults to \"%H:%M:%S\"."
90 #: ../scripts/annotate-output.1:16 ../scripts/dcontrol.pl:257 ../scripts/debcheckout.pl:92 ../scripts/debsnap.1:47 ../scripts/dget.pl:585 ../scripts/dpkg-depcheck.1:96 ../scripts/getbuildlog.1:25 ../scripts/mk-build-deps.pl:79 ../scripts/rmadison.pl:226
92 msgid "B<-h>, B<--help>"
96 #: ../scripts/annotate-output.1:19 ../scripts/debchange.1:359 ../scripts/debclean.1:87 ../scripts/debrelease.1:102 ../scripts/debsign.1:108 ../scripts/dscverify.1:39 ../scripts/nmudiff.1:76 ../scripts/pts-subscribe.1:31 ../scripts/uupdate.1:85 ../scripts/who-uploads.1:47
97 msgid "Display a help message and exit successfully."
101 #: ../scripts/annotate-output.1:20 ../scripts/uscan.1:318
107 #: ../scripts/annotate-output.1:30
110 "$ annotate-output make\n"
111 "21:41:21 I: Started make\n"
112 "21:41:21 O: gcc -Wall program.c\n"
113 "21:43:18 E: program.c: Couldn't compile, and took me ages to find out\n"
114 "21:43:19 E: collect2: ld returned 1 exit status\n"
115 "21:43:19 E: make: *** [all] Error 1\n"
116 "21:43:19 I: Finished with exitcode 2\n"
120 #: ../scripts/annotate-output.1:32 ../scripts/debsnap.1:109 ../scripts/rc-alert.1:119 ../scripts/whodepends.1:17
126 #: ../scripts/annotate-output.1:36
128 "Since stdout and stderr are processed in parallel, it can happen that some "
129 "lines received on stdout will show up before later-printed stderr lines (and "
134 #: ../scripts/annotate-output.1:41
136 "This is unfortunately very hard to fix with the current annotation "
137 "strategy. A fix would involve switching to PTRACE'ing the process. Giving "
138 "nice a (much) higher priority over the executed program could however cause "
139 "this behaviour to show up less frequently."
143 #: ../scripts/annotate-output.1:46
145 "The program does not work as well when the output is not linewise. In "
146 "particular, when an interactive program asks for input, the question might "
147 "not be shown until after you have answered it. This will give the "
148 "impression that the annotated program has hung, while it has not."
152 #: ../scripts/annotate-output.1:47 ../scripts/bts.pl:4070 ../scripts/checkbashisms.1:60 ../scripts/cowpoke.1:241 ../scripts/cvs-debc.1:58 ../scripts/cvs-debi.1:62 ../scripts/cvs-debrelease.1:64 ../scripts/cvs-debuild.1:53 ../scripts/dcmd.1:98 ../scripts/dcontrol.pl:290 ../scripts/debc.1:115 ../scripts/debchange.1:435 ../scripts/debcheckout.pl:181 ../scripts/debclean.1:107 ../scripts/debcommit.pl:845 ../scripts/debdiff.1:215 ../scripts/debi.1:122 ../scripts/debrelease.1:132 ../scripts/deb-reversion.dbk:247 ../scripts/debrsign.1:66 ../scripts/debsign.1:140 ../scripts/debsnap.1:91 ../scripts/debuild.1:410 ../scripts/dget.pl:639 ../scripts/diff2patches.1:45 ../scripts/dpkg-depcheck.1:118 ../scripts/dpkg-genbuilddeps.1:30 ../scripts/dscverify.1:73 ../scripts/grep-excuses.1:38 ../scripts/list-unreleased.1:19 ../scripts/nmudiff.1:108 ../scripts/plotchangelog.1:124 ../scripts/pts-subscribe.1:51 ../scripts/rc-alert.1:121 ../scripts/rmadison.pl:302 ../scripts/tagpending.pl:149 ../scripts/uscan.1:535 ../scripts/uupdate.1:170 ../scripts/wnpp-alert.1:29 ../scripts/wnpp-check.1:23 ../scripts/devscripts.conf.5:54
158 #: ../scripts/annotate-output.1:49
163 #: ../scripts/annotate-output.1:50
169 #: ../scripts/annotate-output.1:54
171 "This program is community-supported (meaning: you'll need to fix it "
172 "yourself). Patches are however appreciated, as is any feedback (positive or "
177 #: ../scripts/annotate-output.1:55 ../scripts/archpath.1:54 ../scripts/build-rdeps.pl:347 ../scripts/checkbashisms.1:62 ../scripts/cowpoke.1:247 ../scripts/cvs-debc.1:64 ../scripts/cvs-debi.1:68 ../scripts/cvs-debrelease.1:69 ../scripts/cvs-debuild.1:59 ../scripts/dcmd.1:101 ../scripts/dcontrol.pl:283 ../scripts/dd-list.1:93 ../scripts/debc.1:120 ../scripts/debchange.1:442 ../scripts/debcheckout.pl:186 ../scripts/debclean.1:111 ../scripts/debcommit.pl:841 ../scripts/debdiff.1:222 ../scripts/debi.1:126 ../scripts/debpkg.1:23 ../scripts/debrelease.1:137 ../scripts/deb-reversion.dbk:292 ../scripts/debrsign.1:71 ../scripts/debsign.1:153 ../scripts/debuild.1:423 ../scripts/desktop2menu.pl:52 ../scripts/dget.pl:631 ../scripts/diff2patches.1:48 ../scripts/dpkg-genbuilddeps.1:36 ../scripts/dscverify.1:78 ../scripts/getbuildlog.1:41 ../scripts/grep-excuses.1:40 ../scripts/licensecheck.pl:121 ../scripts/list-unreleased.1:21 ../scripts/manpage-alert.1:20 ../scripts/mass-bug.pl:521 ../scripts/mergechanges.1:18 ../scripts/mk-build-deps.pl:89 ../scripts/namecheck.pl:30 ../scripts/nmudiff.1:113 ../scripts/plotchangelog.1:126 ../scripts/pts-subscribe.1:56 ../scripts/rc-alert.1:125 ../scripts/rmadison.pl:306 ../scripts/svnpath.pl:97 ../scripts/transition-check.pl:81 ../scripts/uscan.1:541 ../scripts/uupdate.1:177 ../scripts/whodepends.1:19 ../scripts/who-uploads.1:71 ../scripts/wnpp-alert.1:31 ../scripts/wnpp-check.1:33 ../scripts/devscripts.conf.5:58
183 #: ../scripts/annotate-output.1:59
185 "B<annotate-output> was written by Jeroen van Wolffelaar "
186 "E<lt>jeroen@wolffelaar.nlE<gt> This manpage comes under the same copyright "
187 "as annotate-output itself, read /usr/bin/annotate-output (or wherever you "
188 "install it) for the details."
192 #: ../scripts/archpath.1:1
198 #: ../scripts/archpath.1:4
199 msgid "archpath - output arch (tla/Bazaar) archive names, with support for branches"
203 #: ../scripts/archpath.1:6
208 #: ../scripts/archpath.1:9
209 msgid "B<archpath> I<branch>"
213 #: ../scripts/archpath.1:12
214 msgid "B<archpath> I<branch>--I<version>"
218 #: ../scripts/archpath.1:15
219 msgid "B<archpath> is intended to be run in an arch (tla or Bazaar) working copy."
223 #: ../scripts/archpath.1:20
225 "In its simplest usage, B<archpath> with no parameters outputs the package "
226 "name (archive/category--branch--version) associated with the working copy."
230 #: ../scripts/archpath.1:28
232 "If a parameter is given, it may either be a branch--version, in which case "
233 "B<archpath> will output a corresponding package name in the current archive "
234 "and category, or a plain branch name (without \\(oq--\"), in which case "
235 "B<archpath> will output a corresponding package name in the current archive "
236 "and category and with the same version as the current working copy."
240 #: ../scripts/archpath.1:32
242 "This is useful for branching. For example, if you're using Bazaar and you "
243 "want to create a branch for a new feature, you might use a command like "
248 #: ../scripts/archpath.1:37
250 msgid "CW<baz branch $(archpath) $(archpath new-feature)>\n"
254 #: ../scripts/archpath.1:43
256 "Or if you want to tag your current code onto a \\(oqreleases\\(cq branch as "
257 "version 1.0, you might use a command like this:"
261 #: ../scripts/archpath.1:48
263 msgid "CW<baz branch $(archpath) $(archpath releases--1.0)>\n"
267 #: ../scripts/archpath.1:54
269 "That's much easier than using \\(oqbaz tree-version\\(cq to look up the "
270 "package name and manually modifying the result."
274 #: ../scripts/archpath.1:57
275 msgid "B<archpath> was written by"
279 #: ../scripts/archpath.1:59
280 msgid "Colin Watson E<lt>cjwatson@debian.orgE<gt>."
284 #: ../scripts/archpath.1:63
286 "Like B<archpath>, this manual page is released under the GNU General Public "
287 "License, version 2 or later."
291 #: ../scripts/bts.pl:29
292 msgid "bts - developers' command line interface to the BTS"
296 #: ../scripts/bts.pl:153
298 "B<bts> [options] command [args] [#comment] [.|, command [args] [#comment]] "
303 #: ../scripts/bts.pl:157
305 "This is a command line interface to the Debian Bug Tracking System (BTS), "
306 "intended mainly for use by developers. It lets the BTS be manipulated using "
307 "simple commands that can be run at the prompt or in a script, does various "
308 "sanity checks on the input, and constructs and sends a mail to the BTS "
309 "control address for you. A local cache of web pages and e-mails from the BTS "
310 "may also be created and updated."
314 #: ../scripts/bts.pl:165
316 "In general, the command line interface is the same as what you would write "
317 "in a mail to control@bugs.debian.org, just prefixed with \"bts\". For "
322 #: ../scripts/bts.pl:169
325 " % bts severity 69042 normal\n"
326 " % bts merge 69042 43233\n"
327 " % bts retitle 69042 blah blah\n"
332 #: ../scripts/bts.pl:173
334 "A few additional commands have been added for your convenience, and this "
335 "program is less strict about what constitutes a valid bug number. For "
336 "example, \"severity Bug#85942 normal\" is understood, as is \"severity "
337 "#85942 normal\". (Of course, your shell may regard \"#\" as a comment "
338 "character though, so you may need to quote it!)"
342 #: ../scripts/bts.pl:179
344 "Also, for your convenience, this program allows you to abbreviate commands "
345 "to the shortest unique substring (similar to how cvs lets you abbreviate "
346 "commands). So it understands things like \"bts cl 85942\"."
350 #: ../scripts/bts.pl:183
352 "It is also possible to include a comment in the mail sent to the BTS. If "
353 "your shell does not strip out the comment in a command like \"bts severity "
354 "30321 normal #inflated severity\", then this program is smart enough to "
355 "figure out where the comment is, and include it in the email. Note that "
356 "most shells do strip out such comments before they get to the program, "
357 "unless the comment is quoted. (Something like \"bts severity #85942 "
358 "normal\" will not be treated as a comment!)"
362 #: ../scripts/bts.pl:191
364 "You can specify multiple commands by separating them with a single dot, "
365 "rather like B<update-rc.d>; a single comma may also be used; all the "
366 "commands will then be sent in a single mail. For example (quoting where "
367 "necessary so that B<bts> sees the comment):"
371 #: ../scripts/bts.pl:196
374 " % bts severity 95672 normal , merge 95672 95673 \\#they are the same!\n"
379 #: ../scripts/bts.pl:198
381 "The abbreviation \"it\" may be used to refer to the last mentioned bug "
382 "number, so you could write:"
386 #: ../scripts/bts.pl:201
389 " % bts severity 95672 wishlist , retitle it \"bts: please add a --foo "
395 #: ../scripts/bts.pl:203
397 "Please use this program responsibly, and do take our users into "
402 #: ../scripts/bts.pl:208
404 "B<bts> examines the B<devscripts> configuration files as described below. "
405 "Command line options override the configuration file settings, though."
409 #: ../scripts/bts.pl:214
410 msgid "-o, --offline"
414 #: ../scripts/bts.pl:216
416 "Make bts use cached bugs for the 'show' and 'bugs' commands, if a cache is "
417 "available for the requested data. See the cache command, below for "
418 "information on setting up a cache."
422 #: ../scripts/bts.pl:220
423 msgid "--online, --no-offline"
427 #: ../scripts/bts.pl:222
429 "Opposite of --offline; overrides any configuration file directive to work "
434 #: ../scripts/bts.pl:225
435 msgid "-n, --no-action"
439 #: ../scripts/bts.pl:227
440 msgid "Do not send emails but print them to standard output."
444 #: ../scripts/bts.pl:229
445 msgid "--cache, --no-cache"
449 #: ../scripts/bts.pl:231
451 "Should we attempt to cache new versions of BTS pages when performing "
452 "show/bugs commands? Default is to cache."
456 #: ../scripts/bts.pl:234
457 msgid "--cache-mode={min|mbox|full}"
461 #: ../scripts/bts.pl:236
463 "When running a B<bts cache> command, should we only mirror the basic bug "
464 "(min), or should we also mirror the mbox version (mbox), or should we mirror "
465 "the whole thing, including the mbox and the boring attachments to the BTS "
466 "bug pages and the acknowledgement emails (full)? Default is min."
470 #: ../scripts/bts.pl:242
471 msgid "--cache-delay=seconds"
475 #: ../scripts/bts.pl:244
477 "Time in seconds to delay between each download, to avoid hammering the BTS "
478 "web server. Default is 5 seconds."
482 #: ../scripts/bts.pl:247
487 #: ../scripts/bts.pl:249
489 "Open a mail reader to read the mbox corresponding to a given bug number for "
490 "show and bugs commands."
494 #: ../scripts/bts.pl:252
495 msgid "--mailreader=READER"
499 #: ../scripts/bts.pl:254
501 "Specify the command to read the mbox. Must contain a \"%s\" string "
502 "(unquoted!), which will be replaced by the name of the mbox file. The "
503 "command will be split on white space and will not be passed to a shell. "
504 "Default is 'mutt -f %s'. (Also, %% will be substituted by a single % if "
509 #: ../scripts/bts.pl:260
510 msgid "--cc-addr=CC_EMAIL_ADDRESS"
514 #: ../scripts/bts.pl:262
516 "Send carbon copies to a list of users. CC_EMAIL_ADDRESS should be a "
517 "comma-separated list of emails."
521 #: ../scripts/bts.pl:265
522 msgid "--use-default-cc"
526 #: ../scripts/bts.pl:267
528 "Add the addresses specified in the configuation file option BTS_DEFAULT_CC "
529 "to the list specified using --cc-addr. This is the default."
533 #: ../scripts/bts.pl:271
534 msgid "--no-use-default-cc"
538 #: ../scripts/bts.pl:273
539 msgid "Do not add addresses specified in BTS_DEFAULT_CC to the carbon copy list."
543 #: ../scripts/bts.pl:276 ../scripts/mass-bug.pl:104
544 msgid "--sendmail=SENDMAILCMD"
548 #: ../scripts/bts.pl:278
550 "Specify the sendmail command. The command will be split on white space and "
551 "will not be passed to a shell. Default is '/usr/sbin/sendmail'. The -t "
552 "option will be automatically added if the command is /usr/sbin/sendmail or "
553 "/usr/sbin/exim*. For other mailers, if they require a -t option, this must "
554 "be included in the SENDMAILCMD, for example: --sendmail=\"/usr/sbin/mymailer "
559 #: ../scripts/bts.pl:285
564 #: ../scripts/bts.pl:287
566 "Use mutt for sending of mails. Default is not to use mutt, except for some "
571 #: ../scripts/bts.pl:290
573 "Note that one of $DEBEMAIL or $EMAIL must be set in the environment in order "
574 "to use mutt to send emails."
578 #: ../scripts/bts.pl:293
583 #: ../scripts/bts.pl:295
584 msgid "Don't use mutt for sending of mails."
588 #: ../scripts/bts.pl:297
589 msgid "--smtp-host=SMTPHOST"
593 #: ../scripts/bts.pl:299
595 "Specify an SMTP host. If given, B<bts> will send mail by talking directly "
596 "to this SMTP host rather than by invoking a sendmail command."
600 #: ../scripts/bts.pl:302
602 "The host name may be followed by a colon (\":\") and a port number in order "
603 "to use a port other than the default. It may also begin with \"ssmtp://\" "
604 "or \"smtps://\" to indicate that SMTPS should be used."
608 #: ../scripts/bts.pl:306
610 "Note that one of $DEBEMAIL or $EMAIL must be set in the environment in order "
611 "to use direct SMTP connections to send emails."
615 #: ../scripts/bts.pl:309
617 "Note that when sending directly via an SMTP host, specifying addresses in "
618 "--cc-addr or BTS_DEFAULT_CC that the SMTP host will not relay will cause the "
619 "SMTP host to reject the entire mail."
623 #: ../scripts/bts.pl:313
625 "Note also that the use of the reassign command may, when either interactive "
626 "or force-interactive mode is enabled, lead to the automatic addition of a Cc "
627 "to $newpackage@packages.debian.org. In these cases, the note above "
628 "regarding relaying applies. The submission interface (port 587) on "
629 "reportbug.debian.org does not support relaying and, as such, should not be "
630 "used as an SMTP server for B<bts> under the circumstances described in this "
635 #: ../scripts/bts.pl:320
636 msgid "--smtp-username=USERNAME, --smtp-password=PASSWORD"
640 #: ../scripts/bts.pl:322
642 "Specify the credentials to use when connecting to the SMTP server specified "
643 "by --smtp-host. If the server does not require authentication then these "
644 "options should not be used."
648 #: ../scripts/bts.pl:326
650 "If a username is specified but not a password, B<bts> will prompt for the "
651 "password before sending the mail."
655 #: ../scripts/bts.pl:329
656 msgid "--smtp-helo=HELO"
660 #: ../scripts/bts.pl:331
662 "Specify the name to use in the HELO command when connecting to the SMTP "
663 "server; defaults to the contents of the file F</etc/mailname>, if it exists."
667 #: ../scripts/bts.pl:335
669 "Note that some SMTP servers may reject the use of a HELO which either does "
670 "not resolve or does not appear to belong to the host using it."
674 #: ../scripts/bts.pl:338
679 #: ../scripts/bts.pl:340
680 msgid "Use a debbugs server other than bugs.debian.org."
684 #: ../scripts/bts.pl:342
685 msgid "-f, --force-refresh"
689 #: ../scripts/bts.pl:344
691 "Download a bug report again, even if it does not appear to have changed "
692 "since the last cache command. Useful if a --cache-mode=full is requested "
693 "for the first time (otherwise unchanged bug reports will not be downloaded "
694 "again, even if the boring bits have not been downloaded)."
698 #: ../scripts/bts.pl:350
699 msgid "--no-force-refresh"
703 #: ../scripts/bts.pl:352
704 msgid "Suppress any configuration file --force-refresh option."
708 #: ../scripts/bts.pl:354
713 #: ../scripts/bts.pl:356
715 "Download only new bugs when caching. Do not check for updates in bugs we "
720 #: ../scripts/bts.pl:359
721 msgid "--include-resolved"
725 #: ../scripts/bts.pl:361
727 "When caching bug reports, include those that are marked as resolved. This "
728 "is the default behaviour."
732 #: ../scripts/bts.pl:364
733 msgid "--no-include-resolved"
737 #: ../scripts/bts.pl:366
739 "Reverse the behaviour of the previous option. That is, do not cache bugs "
740 "that are marked as resolved."
744 #: ../scripts/bts.pl:369
749 #: ../scripts/bts.pl:371
751 "Suppress acknowledgment mails from the BTS. Note that this will only affect "
752 "the copies of messages CCed to bugs, not those sent to the control bot."
756 #: ../scripts/bts.pl:375
761 #: ../scripts/bts.pl:377
762 msgid "Do not suppress acknowledgement mails. This is the default behaviour."
766 #: ../scripts/bts.pl:379 ../scripts/tagpending.pl:136
767 msgid "-i, --interactive"
771 #: ../scripts/bts.pl:381
773 "Before sending an e-mail to the control bot, display the content and allow "
774 "it to be edited, or the sending cancelled."
778 #: ../scripts/bts.pl:384
779 msgid "--force-interactive"
783 #: ../scripts/bts.pl:386
785 "Similar to --interactive, with the exception that an editor is spawned "
786 "before prompting for confirmation of the message to be sent."
790 #: ../scripts/bts.pl:389
791 msgid "--no-interactive"
795 #: ../scripts/bts.pl:391
796 msgid "Send control e-mails without confirmation. This is the default behaviour."
800 #: ../scripts/bts.pl:393
805 #: ../scripts/bts.pl:395
807 "When running bts cache, only display information about newly cached pages, "
808 "not messages saying already cached. If this option is specified twice, only "
809 "output error messages (to stderr)."
813 #: ../scripts/bts.pl:399 ../scripts/mass-bug.pl:113
814 msgid "--no-conf, --noconf"
818 #: ../scripts/bts.pl:401 ../scripts/cvs-debrelease.1:61 ../scripts/debc.1:89 ../scripts/debchange.1:351 ../scripts/debclean.1:81 ../scripts/debdiff.1:155 ../scripts/debi.1:96 ../scripts/debrelease.1:99 ../scripts/debsign.1:105 ../scripts/debuild.1:225 ../scripts/dpkg-depcheck.1:96 ../scripts/dscverify.1:28 ../scripts/grep-excuses.1:18 ../scripts/mass-bug.pl:115 ../scripts/nmudiff.1:73 ../scripts/uscan.1:442 ../scripts/uupdate.1:82 ../scripts/who-uploads.1:44
820 "Do not read any configuration files. This can only be used as the first "
821 "option given on the command-line."
825 #: ../scripts/bts.pl:755 ../scripts/chdist.pl:56
830 #: ../scripts/bts.pl:757
832 "For full details about the commands, see the BTS documentation. "
833 "L<http://www.debian.org/Bugs/server-control>"
837 #: ../scripts/bts.pl:762
838 msgid "show [options] [<bug number> | <package> | <maintainer> | : ] [opt=val ...]"
842 #: ../scripts/bts.pl:764
843 msgid "show [options] [src:<package> | from:<submitter>] [opt=val ...]"
847 #: ../scripts/bts.pl:766
848 msgid "show [options] [tag:<tag> | usertag:<tag> ] [opt=val ...]"
852 #: ../scripts/bts.pl:768
853 msgid "show [release-critical | release-critical/... | RC]"
857 #: ../scripts/bts.pl:770
858 msgid "This is a synonym for bts bugs."
862 #: ../scripts/bts.pl:778
863 msgid "bugs [options] [<bug number> | <package> | <maintainer> | : ] [opt=val ..]"
867 #: ../scripts/bts.pl:780
868 msgid "bugs [options] [src:<package> | from:<submitter>] [opt=val ..]"
872 #: ../scripts/bts.pl:782
873 msgid "bugs [options] [tag:<tag> | usertag:<tag> ] [opt=val ..]"
877 #: ../scripts/bts.pl:784
878 msgid "bugs [release-critical | release-critical/... | RC]"
882 #: ../scripts/bts.pl:786
884 "Display the page listing the requested bugs in a web browser using "
885 "sensible-browser(1)."
889 #: ../scripts/bts.pl:789
891 "Options may be specified after the \"bugs\" command in addition to or "
892 "instead of options at the start of the command line: recognised options at "
893 "this point are: -o/--offline/--online, --mbox, --mailreader and "
894 "--[no-]cache. These are described earlier in this manpage. If either the "
895 "-o or --offline option is used, or there is already an up-to-date copy in "
896 "the local cache, the cached version will be used."
900 #: ../scripts/bts.pl:796
901 msgid "The meanings of the possible arguments are as follows:"
905 #: ../scripts/bts.pl:800
910 #: ../scripts/bts.pl:802
912 "If nothing is specified, bts bugs will display your bugs, assuming that "
913 "either DEBEMAIL or EMAIL (examined in that order) is set to the appropriate "
918 #: ../scripts/bts.pl:806
923 #: ../scripts/bts.pl:808
924 msgid "Display bug number <bug number>."
928 #: ../scripts/bts.pl:810
933 #: ../scripts/bts.pl:812
934 msgid "Display the bugs for the package <package>."
938 #: ../scripts/bts.pl:814
939 msgid "src:<package>"
943 #: ../scripts/bts.pl:816
944 msgid "Display the bugs for the source package <package>."
948 #: ../scripts/bts.pl:818
953 #: ../scripts/bts.pl:820
954 msgid "Display the bugs for the maintainer email address <maintainer>."
958 #: ../scripts/bts.pl:822
959 msgid "from:<submitter>"
963 #: ../scripts/bts.pl:824
964 msgid "Display the bugs for the submitter email address <submitter>."
968 #: ../scripts/bts.pl:826
973 #: ../scripts/bts.pl:828
974 msgid "Display the bugs which are tagged with <tag>."
978 #: ../scripts/bts.pl:830
979 msgid "usertag:<tag>"
983 #: ../scripts/bts.pl:832
985 "Display the bugs which are tagged with usertag <tag>. See the BTS "
986 "documentation for more information on usertags. This will require the use "
987 "of a users=<email> option."
991 #: ../scripts/bts.pl:836
996 #: ../scripts/bts.pl:838
998 "Details of the bug tracking system itself, along with a bug-request page "
999 "with more options than this script, can be found on "
1000 "http://bugs.debian.org/. This page itself will be opened if the command "
1001 "'bts bugs :' is used."
1005 #: ../scripts/bts.pl:843
1006 msgid "release-critical, RC"
1010 #: ../scripts/bts.pl:845
1012 "Display the front page of the release-critical pages on the BTS. This is a "
1013 "synonym for http://bugs.debian.org/release-critical/index.html. It is also "
1014 "possible to say release-critical/debian/main.html and the like. RC is a "
1015 "synonym for release-critical/other/all.html."
1019 #: ../scripts/bts.pl:852
1021 "After the argument specifying what to display, you can optionally specify "
1022 "options to use to format the page or change what it displayed. These are "
1023 "passed to the BTS in the URL downloaded. For example, pass dist=stable to "
1024 "see bugs affecting the stable version of a package, version=1.0 to see bugs "
1025 "affecting that version of a package, or reverse=yes to display newest "
1026 "messages first in a bug log."
1030 #: ../scripts/bts.pl:859
1032 "If caching has been enabled (that is, --no-cache has not been used, and "
1033 "BTS_CACHE has not been set to \"no\"), then any page requested by \"bts "
1034 "show\" will automatically be cached, and be available offline thereafter. "
1035 "Pages which are automatically cached in this way will be deleted on "
1036 "subsequent \"bts show|bugs|cache\" invocations if they have not been "
1037 "accessed in 30 days. Warning: on a filesystem mounted with the \"noatime\" "
1038 "option, running \"bts show|bugs\" does not update the cache files' access "
1039 "times; a cached bug will then be subject to auto-cleaning 30 days after its "
1040 "initial download, even if it has been accessed in the meantime."
1044 #: ../scripts/bts.pl:870
1046 "Any other B<bts> commands following this on the command line will be "
1047 "executed after the browser has been exited."
1051 #: ../scripts/bts.pl:873
1053 "The desired browser can be specified and configured by setting the BROWSER "
1054 "environment variable. The conventions follow those defined by Eric Raymond "
1055 "at http://www.catb.org/~esr/BROWSER/; we here reproduce the relevant part."
1059 #: ../scripts/bts.pl:878
1061 "The value of BROWSER may consist of a colon-separated series of browser "
1062 "command parts. These should be tried in order until one succeeds. Each "
1063 "command part may optionally contain the string \"%s\"; if it does, the URL "
1064 "to be viewed is substituted there. If a command part does not contain %s, "
1065 "the browser is to be launched as if the URL had been supplied as its first "
1066 "argument. The string %% must be substituted as a single %."
1070 #: ../scripts/bts.pl:886
1072 "Rationale: We need to be able to specify multiple browser commands so "
1073 "programs obeying this convention can do the right thing in either X or "
1074 "console environments, trying X first. Specifying multiple commands may also "
1075 "be useful for people who share files like .profile across multiple "
1076 "systems. We need %s because some popular browsers have remote-invocation "
1077 "syntax that requires it. Unless %% reduces to %, it won't be possible to "
1078 "have a literal %s in the string."
1082 #: ../scripts/bts.pl:894
1083 msgid "For example, on most Linux systems a good thing to do would be:"
1087 #: ../scripts/bts.pl:896
1088 msgid "BROWSER='mozilla -raise -remote \"openURL(%s,new-window)\":links'"
1092 #: ../scripts/bts.pl:971
1093 msgid "select [key:value ...]"
1097 #: ../scripts/bts.pl:973
1099 "Uses the SOAP interface to output a list of bugs which match the given "
1100 "selection requirements."
1104 #: ../scripts/bts.pl:976
1105 msgid "The following keys are allowed, and may be given multiple times."
1109 #: ../scripts/bts.pl:980 ../scripts/bts.pl:1839
1114 #: ../scripts/bts.pl:982 ../scripts/bts.pl:1841
1115 msgid "Binary package name."
1119 #: ../scripts/bts.pl:984 ../scripts/bts.pl:1843
1124 #: ../scripts/bts.pl:986 ../scripts/bts.pl:1845
1125 msgid "Source package name."
1129 #: ../scripts/bts.pl:988
1134 #: ../scripts/bts.pl:990
1135 msgid "E-mail address of the maintainer."
1139 #: ../scripts/bts.pl:992 ../scripts/bts.pl:1823
1144 #: ../scripts/bts.pl:994 ../scripts/bts.pl:1825
1145 msgid "E-mail address of the submitter."
1149 #: ../scripts/bts.pl:996 ../scripts/bts.pl:1851
1154 #: ../scripts/bts.pl:998 ../scripts/bts.pl:1853
1155 msgid "Bug severity."
1159 #: ../scripts/bts.pl:1000
1164 #: ../scripts/bts.pl:1002
1165 msgid "Status of the bug. One of \"open\", \"done\", or \"forwarded\"."
1169 #: ../scripts/bts.pl:1004 ../scripts/bts.pl:1847
1174 #: ../scripts/bts.pl:1006
1176 "Tags applied to the bug. If I<users> is specified, may include usertags in "
1177 "addition to the standard tags."
1181 #: ../scripts/bts.pl:1009 ../scripts/bts.pl:1855
1186 #: ../scripts/bts.pl:1011 ../scripts/bts.pl:1857
1187 msgid "Bug's owner."
1191 #: ../scripts/bts.pl:1013
1192 msgid "correspondent"
1196 #: ../scripts/bts.pl:1015
1197 msgid "Address of someone who sent mail to the log."
1201 #: ../scripts/bts.pl:1017 ../scripts/bts.pl:1859
1206 #: ../scripts/bts.pl:1019
1207 msgid "Bugs which affect this package."
1211 #: ../scripts/bts.pl:1021
1216 #: ../scripts/bts.pl:1023
1217 msgid "List of bugs to search within."
1221 #: ../scripts/bts.pl:1025
1226 #: ../scripts/bts.pl:1027
1227 msgid "Users to use when looking up usertags."
1231 #: ../scripts/bts.pl:1029 ../scripts/bts.pl:1863
1236 #: ../scripts/bts.pl:1031 ../scripts/bts.pl:1865
1238 "Whether to search archived bugs or normal bugs; defaults to 0 (i.e. only "
1239 "search normal bugs). As a special case, if archive is 'both', both archived "
1240 "and unarchived bugs are returned."
1244 #: ../scripts/bts.pl:1037
1246 "For example, to select the set of bugs submitted by "
1247 "jrandomdeveloper@example.com and tagged wontfix, one would use"
1251 #: ../scripts/bts.pl:1040
1252 msgid "bts select submitter:jrandomdeveloper@example.com tag:wontfix"
1256 #: ../scripts/bts.pl:1042 ../scripts/bts.pl:1877
1258 "If a key is used multiple times then the set of bugs selected includes those "
1259 "matching any of the supplied values; for example"
1263 #: ../scripts/bts.pl:1045
1264 msgid "bts select package:foo severity:wishlist severity:minor"
1268 #: ../scripts/bts.pl:1047
1269 msgid "returns all bugs of package foo with either wishlist or minor severity."
1273 #: ../scripts/bts.pl:1060
1274 msgid "status [<bug> | file:<file> | fields:<field,field,...> | verbose] ..."
1278 #: ../scripts/bts.pl:1062
1280 "Uses the SOAP interface to output status information for the given bugs (or "
1281 "as read from the listed files -- use '-' to indicate STDIN)."
1285 #: ../scripts/bts.pl:1065
1286 msgid "By default, all populated fields for a bug are displayed."
1290 #: ../scripts/bts.pl:1067
1291 msgid "If B<verbose> is given, empty fields will also be displayed."
1295 #: ../scripts/bts.pl:1069
1297 "If B<fields> is given, only those fields will be displayed. No validity "
1298 "checking is performed on any specified fields."
1302 #: ../scripts/bts.pl:1146
1303 msgid "clone <bug> <new ID> [<new ID> ...]"
1307 #: ../scripts/bts.pl:1148
1309 "The clone control command allows you to duplicate a bug report. It is useful "
1310 "in the case where a single report actually indicates that multiple distinct "
1311 "bugs have occurred. \"New IDs\" are negative numbers, separated by spaces, "
1312 "which may be used in subsequent control commands to refer to the newly "
1313 "duplicated bugs. A new report is generated for each new ID."
1317 #: ../scripts/bts.pl:1198
1318 msgid "done <bug> <version>"
1322 #: ../scripts/bts.pl:1200
1324 "Mark a bug as Done. This forces interactive mode since done messages should "
1325 "include an explanation why the bug is being closed. You should specify "
1326 "which version of the package closed the bug, if possible."
1330 #: ../scripts/bts.pl:1218
1331 msgid "reopen <bug> [<submitter>]"
1335 #: ../scripts/bts.pl:1220
1336 msgid "Reopen a bug, with optional submitter."
1340 #: ../scripts/bts.pl:1231
1341 msgid "archive <bug>"
1345 #: ../scripts/bts.pl:1233
1347 "Archive a bug that has previously been archived but is currently not. The "
1348 "bug must fulfil all of the requirements for archiving with the exception of "
1349 "those that are time-based."
1353 #: ../scripts/bts.pl:1245
1354 msgid "unarchive <bug>"
1358 #: ../scripts/bts.pl:1247
1359 msgid "Unarchive a bug that is currently archived."
1363 #: ../scripts/bts.pl:1257
1364 msgid "retitle <bug> <title>"
1368 #: ../scripts/bts.pl:1259
1369 msgid "Change the title of the bug."
1373 #: ../scripts/bts.pl:1272
1374 msgid "summary <bug> <messagenum>"
1378 #: ../scripts/bts.pl:1274
1379 msgid "Select a message number that should be used as the summary of a bug."
1383 #: ../scripts/bts.pl:1288
1384 msgid "submitter <bug> [<bug> ...] <submitter-email>"
1388 #: ../scripts/bts.pl:1290
1390 "Change the submitter address of a bug or a number of bugs, with `!' meaning "
1391 "`use the address on the current email as the new submitter address'."
1395 #: ../scripts/bts.pl:1307
1396 msgid "reassign <bug> [<bug> ...] <package> [<version>]"
1400 #: ../scripts/bts.pl:1309
1402 "Reassign a bug or a number of bugs to a different package. The version "
1403 "field is optional; see the explanation at "
1404 "L<http://www.debian.org/Bugs/server-control>."
1408 #: ../scripts/bts.pl:1339
1409 msgid "found <bug> [<version>]"
1413 #: ../scripts/bts.pl:1341
1414 msgid "Indicate that a bug was found to exist in a particular package version."
1418 #: ../scripts/bts.pl:1356
1419 msgid "notfound <bug> <version>"
1423 #: ../scripts/bts.pl:1358
1425 "Remove the record that bug was encountered in the given version of the "
1426 "package to which it is assigned."
1430 #: ../scripts/bts.pl:1370
1431 msgid "fixed <bug> <version>"
1435 #: ../scripts/bts.pl:1372
1437 "Indicate that a bug was fixed in a particular package version, without "
1438 "affecting the bug's open/closed status."
1442 #: ../scripts/bts.pl:1384
1443 msgid "notfixed <bug> <version>"
1447 #: ../scripts/bts.pl:1386
1449 "Remove the record that a bug was fixed in the given version of the package "
1450 "to which it is assigned."
1454 #: ../scripts/bts.pl:1389
1456 "This is equivalent to the sequence of commands \"found <bug> <version>\", "
1457 "\"notfound <bug> <version>\"."
1461 #: ../scripts/bts.pl:1401
1462 msgid "block <bug> by|with <bug> [<bug> ...]"
1466 #: ../scripts/bts.pl:1403
1467 msgid "Note that a bug is blocked from being fixed by a set of other bugs."
1471 #: ../scripts/bts.pl:1422
1472 msgid "unblock <bug> by|with <bug> [<bug> ...]"
1476 #: ../scripts/bts.pl:1424
1478 "Note that a bug is no longer blocked from being fixed by a set of other "
1483 #: ../scripts/bts.pl:1443
1484 msgid "merge <bug> <bug> [<bug> ...]"
1488 #: ../scripts/bts.pl:1445
1489 msgid "Merge a set of bugs together."
1493 #: ../scripts/bts.pl:1460
1494 msgid "forcemerge <bug> <bug> [<bug> ...]"
1498 #: ../scripts/bts.pl:1462
1500 "Forcibly merge a set of bugs together. The first bug listed is the master "
1501 "bug, and its settings (those which must be equal in a normal merge) are "
1502 "assigned to the bugs listed next."
1506 #: ../scripts/bts.pl:1480
1507 msgid "unmerge <bug>"
1511 #: ../scripts/bts.pl:1482
1512 msgid "Unmerge a bug."
1516 #: ../scripts/bts.pl:1492
1517 msgid "tag <bug> [+|-|=] tag [tag ..]"
1521 #: ../scripts/bts.pl:1494
1522 msgid "tags <bug> [+|-|=] tag [tag ..]"
1526 #: ../scripts/bts.pl:1496
1528 "Set or unset a tag on a bug. The tag may either be the exact tag name or it "
1529 "may be abbreviated to any unique tag substring. (So using \"fixed\" will set "
1530 "the tag \"fixed\", not \"fixed-upstream\", for example, but \"fix\" would "
1531 "not be acceptable.) Multiple tags may be specified as well. The two commands "
1532 "(tag and tags) are identical. At least one tag must be specified, unless the "
1533 "'=' flag is used, where the command"
1537 #: ../scripts/bts.pl:1503
1540 " bts tags <bug> =\n"
1545 #: ../scripts/bts.pl:1505
1546 msgid "will remove all tags from the specified bug."
1550 #: ../scripts/bts.pl:1507
1552 "As a special case, the unofficial \"gift\" tag name is supported in addition "
1553 "to official tag names. \"gift\" is used as a shorthand for the gift usertag; "
1554 "see L<http://wiki.debian.org/qa.debian.org/GiftTag>. Adding/removing the "
1555 "gift tag will add/remove the gift usertag, belonging to the "
1556 "\"debian-qa@lists.debian.org\" user."
1560 #: ../scripts/bts.pl:1583
1561 msgid "affects <bug> [+|-|=] <package> [<package> ..]"
1565 #: ../scripts/bts.pl:1585
1567 "Indicates that a bug affects a package other than that against which it is "
1568 "filed, causing the bug to be listed by default in the package list of the "
1569 "other package. This should generally be used where the bug is severe enough "
1570 "to cause multiple reports from users to be assigned to the wrong package."
1574 #: ../scripts/bts.pl:1621
1575 msgid "user <email>"
1579 #: ../scripts/bts.pl:1623
1580 msgid "Specify a user email address before using the usertags command."
1584 #: ../scripts/bts.pl:1639
1585 msgid "usertag <bug> [+|-|=] tag [tag ..]"
1589 #: ../scripts/bts.pl:1641
1590 msgid "usertags <bug> [+|-|=] tag [tag ..]"
1594 #: ../scripts/bts.pl:1643
1596 "Set or unset a user tag on a bug. The tag must be the exact tag name wanted; "
1597 "there are no defaults or checking of tag names. Multiple tags may be "
1598 "specified as well. The two commands (usertag and usertags) are identical. "
1599 "At least one tag must be specified, unless the '=' flag is used, where the "
1604 #: ../scripts/bts.pl:1649
1607 " bts usertags <bug> =\n"
1612 #: ../scripts/bts.pl:1651
1613 msgid "will remove all user tags from the specified bug."
1617 #: ../scripts/bts.pl:1706
1618 msgid "claim <bug> [<claim>]"
1622 #: ../scripts/bts.pl:1708
1624 "Record that you have claimed a bug (e.g. for a bug squashing party). "
1625 "<claim> should be a unique token allowing the bugs you have claimed to be "
1626 "identified; an e-mail address is often used."
1630 #: ../scripts/bts.pl:1712 ../scripts/bts.pl:1732
1632 "If no claim is specified, the environment variable DEBEMAIL or EMAIL "
1633 "(checked in that order) is used."
1637 #: ../scripts/bts.pl:1728
1638 msgid "unclaim <bug> [<claim>]"
1642 #: ../scripts/bts.pl:1730
1643 msgid "Remove the record that you have claimed a bug."
1647 #: ../scripts/bts.pl:1748
1648 msgid "severity <bug> <severity>"
1652 #: ../scripts/bts.pl:1750
1654 "Change the severity of a bug. Available severities are: wishlist, minor, "
1655 "normal, important, serious, grave, critical. The severity may be abbreviated "
1656 "to any unique substring."
1660 #: ../scripts/bts.pl:1767
1661 msgid "forwarded <bug> <address>"
1665 #: ../scripts/bts.pl:1769
1667 "Mark the bug as forwarded to the given address (usually an email address or "
1668 "a URL for an upstream bug tracker)."
1672 #: ../scripts/bts.pl:1786
1673 msgid "notforwarded <bug>"
1677 #: ../scripts/bts.pl:1788
1678 msgid "Mark a bug as not forwarded."
1682 #: ../scripts/bts.pl:1798
1683 msgid "package [<package> ...]"
1687 #: ../scripts/bts.pl:1800
1689 "The following commands will only apply to bugs against the listed packages; "
1690 "this acts as a safety mechanism for the BTS. If no packages are listed, "
1691 "this check is turned off again."
1695 #: ../scripts/bts.pl:1814
1696 msgid "limit [<key>[:<value>] ...]"
1700 #: ../scripts/bts.pl:1816
1702 "The following commands will only apply to bugs which meet the specified "
1703 "criterion; this acts as a safety mechanism for the BTS. If no C<value>s are "
1704 "listed, the limits for that C<key> are turned off again. If no C<key>s are "
1705 "specified, all limits are reset."
1709 #: ../scripts/bts.pl:1827
1714 #: ../scripts/bts.pl:1829
1715 msgid "Date the bug was submitted."
1719 #: ../scripts/bts.pl:1831
1724 #: ../scripts/bts.pl:1833
1725 msgid "Subject of the bug."
1729 #: ../scripts/bts.pl:1835
1734 #: ../scripts/bts.pl:1837
1735 msgid "Message-id of the initial bug report."
1739 #: ../scripts/bts.pl:1849
1740 msgid "Tags applied to the bug."
1744 #: ../scripts/bts.pl:1861
1745 msgid "Bugs affecting this package."
1749 #: ../scripts/bts.pl:1871
1751 "For example, to limit the set of bugs affected by the subsequent control "
1752 "commands to those submitted by jrandomdeveloper@example.com and tagged "
1753 "wontfix, one would use"
1757 #: ../scripts/bts.pl:1875
1758 msgid "bts limit submitter:jrandomdeveloper@example.com tag:wontfix"
1762 #: ../scripts/bts.pl:1880
1763 msgid "bts limit package:foo severity:wishlist severity:minor"
1767 #: ../scripts/bts.pl:1882
1769 "only applies the subsequent control commands to bugs of package foo with "
1770 "either wishlist or minor severity."
1774 #: ../scripts/bts.pl:1957
1775 msgid "owner <bug> <owner-email>"
1779 #: ../scripts/bts.pl:1959
1781 "Change the \"owner\" address of a bug, with `!' meaning `use the address on "
1782 "the current email as the new owner address'."
1786 #: ../scripts/bts.pl:1962
1788 "The owner of a bug accepts responsibility for dealing with it. Note that the "
1789 "\"owner\" of a bug does not automatically receive all of the email "
1790 "corresponding to it; use \"subscribe\" to achieve that."
1794 #: ../scripts/bts.pl:1975
1795 msgid "noowner <bug>"
1799 #: ../scripts/bts.pl:1977
1800 msgid "Mark a bug as having no \"owner\"."
1804 #: ../scripts/bts.pl:1987
1805 msgid "subscribe <bug> <email>"
1809 #: ../scripts/bts.pl:1989
1811 "Subscribe the given email address to the specified bug report. If no email "
1812 "address is specified, the environment variable DEBEMAIL or EMAIL (in that "
1813 "order) is used. If those are not set, or `!' is given as email address, "
1814 "your default address will be used."
1818 #: ../scripts/bts.pl:1994
1820 "After executing this command, you will be sent a subscription confirmation "
1821 "to which you have to reply. When subscribed to a bug report, you receive "
1822 "all relevant emails and notifications. Use the unsubscribe command to "
1827 #: ../scripts/bts.pl:2014
1828 msgid "unsubscribe <bug> <email>"
1832 #: ../scripts/bts.pl:2016
1834 "Unsubscribe the given email address from the specified bug report. As with "
1835 "subscribe above, if no email address is specified, the environment variables "
1836 "DEBEMAIL or EMAIL (in that order) is used. If those are not set, or `!' is "
1837 "given as email address, your default address will be used."
1841 #: ../scripts/bts.pl:2021
1843 "After executing this command, you will be sent an unsubscription "
1844 "confirmation to which you have to reply. Use the subscribe command to, well, "
1849 #: ../scripts/bts.pl:2040
1850 msgid "reportspam <bug> ..."
1854 #: ../scripts/bts.pl:2042
1856 "The reportspam command allows you to report a bug report as containing "
1857 "spam. It saves one from having to go to the bug web page to do so."
1861 #: ../scripts/bts.pl:2078
1862 msgid "spamreport <bug> ..."
1866 #: ../scripts/bts.pl:2080
1867 msgid "spamreport is a synonym for reportspam."
1871 #: ../scripts/bts.pl:2088
1872 msgid "cache [options] [<maint email> | <pkg> | src:<pkg> | from:<submitter>]"
1876 #: ../scripts/bts.pl:2090
1877 msgid "cache [options] [release-critical | release-critical/... | RC]"
1881 #: ../scripts/bts.pl:2092
1883 "Generate or update a cache of bug reports for the given email address or "
1884 "package. By default it downloads all bugs belonging to the email address in "
1885 "the DEBEMAIL environment variable (or the EMAIL environment variable if "
1886 "DEBEMAIL is unset). This command may be repeated to cache bugs belonging to "
1887 "several people or packages. If multiple packages or addresses are supplied, "
1888 "bugs belonging to any of the arguments will be cached; those belonging to "
1889 "more than one of the arguments will only be downloaded once. The cached bugs "
1890 "are stored in ~/.devscripts_cache/bts/"
1894 #: ../scripts/bts.pl:2101
1895 msgid "You can use the cached bugs with the -o switch. For example:"
1899 #: ../scripts/bts.pl:2103
1903 " bts -o show 12345\n"
1908 #: ../scripts/bts.pl:2106
1910 "Also, bts will update the files in it in a piecemeal fashion as it downloads "
1911 "information from the BTS using the 'show' command. You might thus set up the "
1912 "cache, and update the whole thing once a week, while letting the automatic "
1913 "cache updates update the bugs you frequently refer to during the week."
1917 #: ../scripts/bts.pl:2112
1919 "Some options affect the behaviour of the cache command. The first is the "
1920 "setting of --cache-mode, which controls how much B<bts> downloads of the "
1921 "referenced links from the bug page, including boring bits such as the "
1922 "acknowledgement emails, emails to the control bot, and the mbox version of "
1923 "the bug report. It can take three values: min (the minimum), mbox (download "
1924 "the minimum plus the mbox version of the bug report) or full (the whole "
1925 "works). The second is --force-refresh or -f, which forces the download, "
1926 "even if the cached bug report is up-to-date. The --include-resolved option "
1927 "indicates whether bug reports marked as resolved should be downloaded during "
1932 #: ../scripts/bts.pl:2123
1934 "Each of these is configurable from the configuration file, as described "
1935 "below. They may also be specified after the \"cache\" command as well as at "
1936 "the start of the command line."
1940 #: ../scripts/bts.pl:2127
1942 "Finally, -q or --quiet will suppress messages about caches being up-to-date, "
1943 "and giving the option twice will suppress all cache messages (except for "
1948 #: ../scripts/bts.pl:2131
1950 "Beware of caching RC, though: it will take a LONG time! (With 1000+ RC bugs "
1951 "and a delay of 5 seconds between bugs, you're looking at a minimum of 1.5 "
1952 "hours, and probably significantly more than that.)"
1956 #: ../scripts/bts.pl:2260
1957 msgid "cleancache <package> | src:<package> | <maintainer>"
1961 #: ../scripts/bts.pl:2262
1962 msgid "cleancache from:<submitter> | tag:<tag> | usertag:<tag> | <number> | ALL"
1966 #: ../scripts/bts.pl:2264
1968 "Clean the cache for the specified package, maintainer, etc., as described "
1969 "above for the \"bugs\" command, or clean the entire cache if \"ALL\" is "
1970 "specified. This is useful if you are going to have permanent network access "
1971 "or if the database has become corrupted for some reason. Note that for "
1972 "safety, this command does not default to the value of DEBEMAIL or EMAIL."
1976 #: ../scripts/bts.pl:2313
1981 #: ../scripts/bts.pl:2315
1982 msgid "Display version and copyright information."
1986 #: ../scripts/bts.pl:2330
1991 #: ../scripts/bts.pl:2332
1993 "Display a short summary of commands, suspiciously similar to parts of this "
1998 #: ../scripts/bts.pl:3944 ../scripts/debuild.1:86 ../scripts/diff2patches.1:40 ../scripts/pts-subscribe.1:34
2000 msgid "ENVIRONMENT VARIABLES"
2004 #: ../scripts/bts.pl:3948 ../scripts/devscripts.1:22
2010 #: ../scripts/bts.pl:3950
2012 "If this is set, the From: line in the email will be set to use this email "
2013 "address instead of your normal email address (as would be determined by "
2018 #: ../scripts/bts.pl:3954 ../scripts/devscripts.1:25
2024 #: ../scripts/bts.pl:3956
2026 "If DEBEMAIL is set, DEBFULLNAME is examined to determine the full name to "
2027 "use; if this is not set, B<bts> attempts to determine a name from your "
2032 #: ../scripts/bts.pl:3960
2037 #: ../scripts/bts.pl:3962
2039 "If set, it specifies the browser to use for the 'show' and 'bugs' options. "
2040 "See the description above."
2044 #: ../scripts/bts.pl:3967 ../scripts/dcontrol.pl:267 ../scripts/debc.1:92 ../scripts/debchange.1:362 ../scripts/debcheckout.pl:142 ../scripts/debclean.1:90 ../scripts/debcommit.pl:97 ../scripts/debdiff.1:167 ../scripts/debi.1:99 ../scripts/debrelease.1:105 ../scripts/debrsign.1:57 ../scripts/debsign.1:111 ../scripts/debuild.1:290 ../scripts/dget.pl:595 ../scripts/dpkg-depcheck.1:102 ../scripts/dscverify.1:42 ../scripts/grep-excuses.1:28 ../scripts/licensecheck.pl:88 ../scripts/mass-bug.pl:133 ../scripts/nmudiff.1:79 ../scripts/plotchangelog.1:106 ../scripts/pts-subscribe.1:42 ../scripts/rmadison.pl:266 ../scripts/uscan.1:448 ../scripts/uupdate.1:88 ../scripts/who-uploads.1:50
2046 msgid "CONFIGURATION VARIABLES"
2050 #: ../scripts/bts.pl:3969 ../scripts/debcommit.pl:99 ../scripts/licensecheck.pl:90 ../scripts/mass-bug.pl:135
2052 "The two configuration files F</etc/devscripts.conf> and F<~/.devscripts> are "
2053 "sourced by a shell in that order to set configuration variables. Command "
2054 "line options can be used to override configuration file settings. "
2055 "Environment variable settings are ignored for this purpose. The currently "
2056 "recognised variables are:"
2060 #: ../scripts/bts.pl:3977
2065 #: ../scripts/bts.pl:3979
2067 "If this is set to I<yes>, then it is the same as the --offline command line "
2068 "parameter being used. Only has an effect on the show and bugs commands. "
2069 "The default is I<no>. See the description of the show command above for "
2074 #: ../scripts/bts.pl:3984
2079 #: ../scripts/bts.pl:3986
2081 "If this is set to I<no>, then it is the same as the --no-cache command line "
2082 "parameter being used. Only has an effect on the show and bug commands. The "
2083 "default is I<yes>. Again, see the show command above for more information."
2087 #: ../scripts/bts.pl:3991
2088 msgid "BTS_CACHE_MODE={min,mbox,full}"
2092 #: ../scripts/bts.pl:3993
2094 "How much of the BTS should we mirror when we are asked to cache something? "
2095 "Just the minimum, or also the mbox or the whole thing? The default is "
2096 "I<min>, and it has the same meaning as the --cache-mode command line "
2097 "parameter. Only has an effect on the cache. See the cache command for more "
2102 #: ../scripts/bts.pl:3999
2103 msgid "BTS_FORCE_REFRESH"
2107 #: ../scripts/bts.pl:4001
2109 "If this is set to I<yes>, then it is the same as the --force-refresh command "
2110 "line parameter being used. Only has an effect on the cache command. The "
2111 "default is I<no>. See the cache command for more information."
2115 #: ../scripts/bts.pl:4006
2116 msgid "BTS_MAIL_READER"
2120 #: ../scripts/bts.pl:4008
2122 "If this is set, specifies a mail reader to use instead of mutt. Same as the "
2123 "--mailreader command line option."
2127 #: ../scripts/bts.pl:4011 ../scripts/mass-bug.pl:143
2128 msgid "BTS_SENDMAIL_COMMAND"
2132 #: ../scripts/bts.pl:4013 ../scripts/mass-bug.pl:145 ../scripts/nmudiff.1:108
2134 "If this is set, specifies a sendmail command to use instead of "
2135 "/usr/sbin/sendmail. Same as the --sendmail command line option."
2139 #: ../scripts/bts.pl:4016
2140 msgid "BTS_ONLY_NEW"
2144 #: ../scripts/bts.pl:4018
2146 "Download only new bugs when caching. Do not check for updates in bugs we "
2147 "already have. The default is I<no>. Same as the --only-new command line "
2152 #: ../scripts/bts.pl:4022
2153 msgid "BTS_SMTP_HOST"
2157 #: ../scripts/bts.pl:4024
2159 "If this is set, specifies an SMTP host to use for sending mail rather than "
2160 "using the sendmail command. Same as the --smtp-host command line option."
2164 #: ../scripts/bts.pl:4028
2166 "Note that this option takes priority over BTS_SENDMAIL_COMMAND if both are "
2167 "set, unless the --sendmail option is used."
2171 #: ../scripts/bts.pl:4031
2172 msgid "BTS_SMTP_AUTH_USERNAME, BTS_SMTP_AUTH_PASSWORD"
2176 #: ../scripts/bts.pl:4033
2178 "If these options are set, then it is the same as the --smtp-username and "
2179 "--smtp-password options being used."
2183 #: ../scripts/bts.pl:4036
2184 msgid "BTS_SMTP_HELO"
2188 #: ../scripts/bts.pl:4038
2189 msgid "Same as the --smtp-helo command line option."
2193 #: ../scripts/bts.pl:4040
2194 msgid "BTS_INCLUDE_RESOLVED"
2198 #: ../scripts/bts.pl:4042
2200 "If this is set to I<no>, then it is the same as the --no-include-resolved "
2201 "command line parameter being used. Only has an effect on the cache "
2202 "command. The default is I<yes>. See the cache command for more "
2207 #: ../scripts/bts.pl:4047
2208 msgid "BTS_SUPPRESS_ACKS"
2212 #: ../scripts/bts.pl:4049
2214 "If this is set to I<yes>, then it is the same as the --no-ack command line "
2215 "parameter being used. The default is I<no>."
2219 #: ../scripts/bts.pl:4052
2220 msgid "BTS_INTERACTIVE"
2224 #: ../scripts/bts.pl:4054
2226 "If this is set to I<yes> or I<force>, then it is the same as the "
2227 "--interactive or --force-interactive command line parameter being used. The "
2232 #: ../scripts/bts.pl:4058
2233 msgid "BTS_DEFAULT_CC"
2237 #: ../scripts/bts.pl:4060
2239 "Specify a list of e-mail addresses to which a carbon copy of the generated "
2240 "e-mail to the control bot should automatically be sent."
2244 #: ../scripts/bts.pl:4063
2249 #: ../scripts/bts.pl:4065
2251 "Specify the name of a debbugs server which should be used instead of "
2256 #: ../scripts/bts.pl:4072
2258 "Please see L<http://www.debian.org/Bugs/server-control> for more details on "
2259 "how to control the BTS using emails and L<http://www.debian.org/Bugs/> for "
2260 "more information about the BTS."
2264 #: ../scripts/bts.pl:4076
2265 msgid "reportbug(1), querybts(1)"
2269 #: ../scripts/bts.pl:4078 ../scripts/chdist.pl:92 ../scripts/debsnap.1:99 ../scripts/mass-bug.pl:514 ../scripts/tagpending.pl:431
2275 #: ../scripts/bts.pl:4080
2277 "This program is Copyright (C) 2001-2003 by Joey Hess <joeyh@debian.org>. "
2278 "Many modifications have been made, Copyright (C) 2002-2005 Julian Gilbey "
2279 "<jdg@debian.org> and Copyright (C) 2007 Josh Triplett "
2280 "<josh@freedesktop.org>."
2284 #: ../scripts/bts.pl:4085 ../scripts/chdist.pl:97 ../scripts/mass-bug.pl:518
2286 "It is licensed under the terms of the GPL, either version 2 of the License, "
2287 "or (at your option) any later version."
2291 #: ../scripts/build-rdeps.pl:20
2293 "build-rdeps - find packages that depend on a specific package to build "
2294 "(reverse build depends)"
2298 #: ../scripts/build-rdeps.pl:24
2299 msgid "B<build-rdeps> I<package>"
2303 #: ../scripts/build-rdeps.pl:28
2305 "B<build-rdeps> searches for all packages that build-depend on the specified "
2310 #: ../scripts/build-rdeps.pl:34
2311 msgid "B<-u> B<--update>"
2315 #: ../scripts/build-rdeps.pl:36
2316 msgid "Run apt-get update before searching for build-depends."
2320 #: ../scripts/build-rdeps.pl:38
2321 msgid "B<-s> B<--sudo>"
2325 #: ../scripts/build-rdeps.pl:40
2326 msgid "Use sudo when running apt-get update. Has no effect if -u is omitted."
2330 #: ../scripts/build-rdeps.pl:42
2331 msgid "B<--distribution>"
2335 #: ../scripts/build-rdeps.pl:44
2336 msgid "Select another distribution, which is searched for build-depends."
2340 #: ../scripts/build-rdeps.pl:46
2341 msgid "B<--only-main>"
2345 #: ../scripts/build-rdeps.pl:48
2346 msgid "Ignore contrib and non-free"
2350 #: ../scripts/build-rdeps.pl:50
2351 msgid "B<--exclude-component>"
2355 #: ../scripts/build-rdeps.pl:52
2356 msgid "Ignore the given component (e.g. main, contrib, non-free)."
2360 #: ../scripts/build-rdeps.pl:54
2365 #: ../scripts/build-rdeps.pl:56
2366 msgid "Restrict the search to only the specified origin (such as \"Debian\")."
2370 #: ../scripts/build-rdeps.pl:58
2371 msgid "B<-m> B<--print-maintainer>"
2375 #: ../scripts/build-rdeps.pl:60
2376 msgid "Print the value of the maintainer field for each package."
2380 #: ../scripts/build-rdeps.pl:62
2381 msgid "B<-d> B<--debug>"
2385 #: ../scripts/build-rdeps.pl:64
2386 msgid "Run the debug mode"
2390 #: ../scripts/build-rdeps.pl:66 ../scripts/cowpoke.1:68 ../scripts/debclean.1:84 ../scripts/grep-excuses.1:22 ../scripts/nmudiff.1:73 ../scripts/plotchangelog.1:92 ../scripts/uscan.1:442
2396 #: ../scripts/build-rdeps.pl:68
2397 msgid "Show the usage information."
2401 #: ../scripts/build-rdeps.pl:70 ../scripts/cowpoke.1:72 ../scripts/debchange.1:359 ../scripts/debclean.1:87 ../scripts/debrelease.1:102 ../scripts/debsign.1:108 ../scripts/debsnap.1:51 ../scripts/diff2patches.1:25 ../scripts/dscverify.1:39 ../scripts/grep-excuses.1:25 ../scripts/nmudiff.1:76 ../scripts/plotchangelog.1:95 ../scripts/pts-subscribe.1:31 ../scripts/rmadison.pl:253 ../scripts/uscan.1:445 ../scripts/uupdate.1:85 ../scripts/who-uploads.1:47
2403 msgid "B<--version>"
2407 #: ../scripts/build-rdeps.pl:72
2408 msgid "Show the version information."
2412 #: ../scripts/build-rdeps.pl:76 ../scripts/debpkg.1:12
2414 msgid "REQUIREMENTS"
2418 #: ../scripts/build-rdeps.pl:78
2420 "The tool requires apt Sources files to be around for the checked "
2421 "components. In the default case this means that in /var/lib/apt/lists files "
2422 "need to be around for main, contrib and non-free."
2426 #: ../scripts/build-rdeps.pl:82
2428 "In practice this means one needs to add one deb-src line for each component, "
2433 #: ../scripts/build-rdeps.pl:85
2434 msgid "deb-src http://<mirror>/debian <dist> main contrib non-free"
2438 #: ../scripts/build-rdeps.pl:87
2439 msgid "and run apt-get update afterwards or use the update option of this tool."
2443 #: ../scripts/build-rdeps.pl:339 ../scripts/desktop2menu.pl:43 ../scripts/licensecheck.pl:112 ../scripts/namecheck.pl:36 ../scripts/svnpath.pl:93 ../scripts/transition-check.pl:72
2448 #: ../scripts/build-rdeps.pl:341
2450 "This code is copyright by Patrick Schoenfeld <schoenfeld@debian.org>, all "
2451 "rights reserved. This program comes with ABSOLUTELEY NO WARRANTY. You are "
2452 "free to redistribute this code under the terms of the GNU General Public "
2453 "License, version 2 or later."
2457 #: ../scripts/build-rdeps.pl:349
2458 msgid "Patrick Schoenfeld <schoenfeld@debian.org>"
2462 #: ../scripts/chdist.pl:21
2463 msgid "chdist - script to easily play with several distributions"
2467 #: ../scripts/chdist.pl:25
2468 msgid "B<chdist> [options] [command] [command parameters]"
2472 #: ../scripts/chdist.pl:29
2474 "B<chdist> is a rewrite of what used to be known as 'MultiDistroTools' (or "
2475 "mdt). Its use is to create 'APT trees' for several distributions, making it "
2476 "easy to query the status of packages in other distribution without using "
2477 "chroots, for instance."
2481 #: ../scripts/chdist.pl:38
2486 #: ../scripts/chdist.pl:40 ../scripts/mass-bug.pl:120
2487 msgid "Provide a usage message."
2491 #: ../scripts/chdist.pl:42
2492 msgid "-d, --data-dir DIR"
2496 #: ../scripts/chdist.pl:44
2497 msgid "Choose data directory (default: $HOME/.chdist/)."
2501 #: ../scripts/chdist.pl:46
2502 msgid "-a, --arch ARCH"
2506 #: ../scripts/chdist.pl:48
2507 msgid "Choose architecture (default: `dpkg --print-architecture`)"
2511 #: ../scripts/chdist.pl:50 ../scripts/mass-bug.pl:122
2516 #: ../scripts/chdist.pl:52 ../scripts/deb-reversion.dbk:239 ../scripts/mass-bug.pl:124 ../scripts/uscan.1:448
2517 msgid "Display version information."
2521 #: ../scripts/chdist.pl:60
2522 msgid "create DIST : prepare a new tree named DIST"
2526 #: ../scripts/chdist.pl:62
2527 msgid "apt-get DIST (update|source|...) : run apt-get inside DIST"
2531 #: ../scripts/chdist.pl:64
2532 msgid "apt-cache DIST (show|showsrc|...) : run apt-cache inside DIST"
2536 #: ../scripts/chdist.pl:66
2537 msgid "apt-rdepends DIST [...] : run apt-rdepends inside DIST"
2541 #: ../scripts/chdist.pl:68
2542 msgid "src2bin DIST PKG : get binary packages for a source package in DIST"
2546 #: ../scripts/chdist.pl:70
2547 msgid "bin2src DIST PKG : get source package for a binary package in DIST"
2551 #: ../scripts/chdist.pl:72
2553 "compare-packages DIST1 DIST2 [DIST3, ...] : list versions of packages in "
2554 "several DISTributions"
2558 #: ../scripts/chdist.pl:74
2559 msgid "compare-bin-packages DIST1 DIST2 [DIST3, ...]"
2563 #: ../scripts/chdist.pl:76
2565 "compare-versions DIST1 DIST2 : same as compare-packages, but also run dpkg "
2566 "--compare-versions and display where the package is newer."
2570 #: ../scripts/chdist.pl:78
2571 msgid "compare-bin-versions DIST1 DIST2"
2575 #: ../scripts/chdist.pl:80
2576 msgid "compare-src-bin-packages DIST : compare sources and binaries for DIST"
2580 #: ../scripts/chdist.pl:82
2582 "compare-src-bin-versions DIST : same as compare-src-bin-versions, but also "
2583 "run dpkg --compare-versions and display where the package is newer"
2587 #: ../scripts/chdist.pl:84
2588 msgid "grep-dctrl-packages DIST [...] : run grep-dctrl on *_Packages inside DIST"
2592 #: ../scripts/chdist.pl:86
2593 msgid "grep-dctrl-sources DIST [...] : run grep-dctrl on *_Sources inside DIST"
2597 #: ../scripts/chdist.pl:88
2598 msgid "list : list available DISTs"
2602 #: ../scripts/chdist.pl:94
2604 "This program is copyright 2007 by Lucas Nussbaum and Luk Claes. This program "
2605 "comes with ABSOLUTELY NO WARRANTY."
2609 #: ../scripts/checkbashisms.1:1
2611 msgid "CHECKBASHISMS"
2615 #: ../scripts/checkbashisms.1:4
2616 msgid "checkbashisms - check for bashisms in /bin/sh scripts"
2620 #: ../scripts/checkbashisms.1:6
2621 msgid "B<checkbashisms> I<script> ..."
2625 #: ../scripts/checkbashisms.1:8
2626 msgid "B<checkbashisms --help|--version>"
2630 #: ../scripts/checkbashisms.1:14
2632 "B<checkbashisms>, based on one of the checks from the B<lintian> system, "
2633 "performs basic checks on I</bin/sh> shell scripts for the possible presence "
2634 "of bashisms. It takes the names of the shell scripts on the command line, "
2635 "and outputs warnings if possible bashisms are detected."
2639 #: ../scripts/checkbashisms.1:19
2641 "Note that the definition of a bashism in this context roughly equates to \"a "
2642 "shell feature that is not required to be supported by POSIX\"; this means "
2643 "that some issues flagged may be permitted under optional sections of POSIX, "
2644 "such as XSI or User Portability."
2648 #: ../scripts/checkbashisms.1:23
2650 "In cases where POSIX and Debian Policy disagree, B<checkbashisms> by default "
2651 "allows extensions permitted by Policy but may also provide options for "
2652 "stricter checking."
2656 #: ../scripts/checkbashisms.1:24 ../scripts/debchange.1:356 ../scripts/debdiff.1:155 ../scripts/debrelease.1:99 ../scripts/debsign.1:105 ../scripts/dscverify.1:36 ../scripts/pts-subscribe.1:28 ../scripts/rc-alert.1:21 ../scripts/uupdate.1:82 ../scripts/who-uploads.1:44 ../scripts/wnpp-alert.1:23 ../scripts/wnpp-check.1:17
2658 msgid "B<--help>, B<-h>"
2662 #: ../scripts/checkbashisms.1:27 ../scripts/debdiff.1:158 ../scripts/mk-build-deps.pl:81 ../scripts/rc-alert.1:24 ../scripts/wnpp-alert.1:26 ../scripts/wnpp-check.1:20
2663 msgid "Show a summary of options."
2667 #: ../scripts/checkbashisms.1:27
2669 msgid "B<--newline>, B<-n>"
2673 #: ../scripts/checkbashisms.1:30
2674 msgid "Check for \"echo -n\" usage (non POSIX but required by Debian Policy 10.4.)"
2678 #: ../scripts/checkbashisms.1:30
2680 msgid "B<--posix>, B<-p>"
2684 #: ../scripts/checkbashisms.1:34
2686 "Check for issues which are non POSIX but required to be supported by Debian "
2687 "Policy 10.4 (implies -n)."
2691 #: ../scripts/checkbashisms.1:34
2693 msgid "B<--force>, B<-f>"
2697 #: ../scripts/checkbashisms.1:39
2699 "Force each script to be checked, even if it would normally not be (for "
2700 "instance, it has a bash or non POSIX shell shebang or appears to be a shell "
2705 #: ../scripts/checkbashisms.1:39
2707 msgid "B<--extra>, B<-x>"
2711 #: ../scripts/checkbashisms.1:46
2713 "Highlight lines which, whilst they do not contain bashisms, may be useful in "
2714 "determining whether a particular issue is a false positive which may be "
2715 "ignored. For example, the use of \"$BASH_ENV\" may be preceded by checking "
2716 "whether \"$BASH\" is set."
2720 #: ../scripts/checkbashisms.1:46 ../scripts/debdiff.1:158 ../scripts/manpage-alert.1:17 ../scripts/rc-alert.1:24 ../scripts/wnpp-alert.1:26 ../scripts/wnpp-check.1:20
2722 msgid "B<--version>, B<-v>"
2726 #: ../scripts/checkbashisms.1:49 ../scripts/debdiff.1:161 ../scripts/getbuildlog.1:31 ../scripts/grep-excuses.1:28 ../scripts/manpage-alert.1:20 ../scripts/mk-build-deps.pl:85 ../scripts/rc-alert.1:27 ../scripts/whodepends.1:17 ../scripts/wnpp-alert.1:29 ../scripts/wnpp-check.1:23
2727 msgid "Show version and copyright information."
2731 #: ../scripts/checkbashisms.1:49 ../scripts/debdiff.1:211
2737 #: ../scripts/checkbashisms.1:53
2739 "The exit value will be 0 if no possible bashisms or other problems were "
2740 "detected. Otherwise it will be the sum of the following error values:"
2744 #: ../scripts/checkbashisms.1:53 ../scripts/transition-check.pl:66 ../scripts/uscan.1:506 ../scripts/wnpp-check.1:29
2750 #: ../scripts/checkbashisms.1:56
2751 msgid "A possible bashism was detected."
2755 #: ../scripts/checkbashisms.1:56
2761 #: ../scripts/checkbashisms.1:60
2763 "A file was skipped for some reason, for example, because it was unreadable "
2764 "or not found. The warning message will give details."
2768 #: ../scripts/checkbashisms.1:62
2769 msgid "B<lintian>(1)."
2773 #: ../scripts/checkbashisms.1:65
2775 "B<checkbashisms> was originally written as a shell script by Yann Dirson "
2776 "E<lt>dirson@debian.orgE<gt> and rewritten in Perl with many more features by "
2777 "Julian Gilbey E<lt>jdg@debian.orgE<gt>."
2781 #: ../scripts/cowpoke.1:5
2787 #: ../scripts/cowpoke.1:5
2789 msgid "April 28, 2008"
2793 #: ../scripts/cowpoke.1:20
2794 msgid "cowpoke - Build a Debian source package in a remote cowbuilder instance"
2798 #: ../scripts/cowpoke.1:23
2799 msgid "B<cowpoke> [I<options>]I< packagename.dsc>"
2803 #: ../scripts/cowpoke.1:27
2805 "Uploads a Debian source package to a cowbuilder host and builds it, "
2806 "optionally also signing and uploading the result to an incoming queue."
2810 #: ../scripts/cowpoke.1:31 ../scripts/debsnap.1:28
2811 msgid "The following options are available:"
2815 #: ../scripts/cowpoke.1:32
2817 msgid "B<--arch=>I<arch>"
2821 #: ../scripts/cowpoke.1:38
2823 "Specify the Debian architecture(s) to build for. A space separated list of "
2824 "architectures may be used to build for all of them in a single pass. Valid "
2825 "arch names are those returned by B<dpkg-architecture>(1) for "
2826 "B<DEB_BUILD_ARCH>."
2830 #: ../scripts/cowpoke.1:39
2832 msgid "B<--dist=>I<dist>"
2836 #: ../scripts/cowpoke.1:47
2838 "Specify the Debian distribution(s) to build for. A space separated list of "
2839 "distributions may be used to build for all of them in a single pass. Either "
2840 "codenames (such as sid, or lenny) or distribution names (such as unstable, "
2841 "or experimental) may be used, but you should usually stick to using one or "
2842 "the other consistently as this name may be used in file paths and to locate "
2843 "old packages for comparison reporting."
2847 #: ../scripts/cowpoke.1:48
2849 msgid "B<--buildd=>I<host>"
2853 #: ../scripts/cowpoke.1:51
2854 msgid "Specify the remote host to build on."
2858 #: ../scripts/cowpoke.1:52
2860 msgid "B<--buildd-user=>I<name>"
2864 #: ../scripts/cowpoke.1:55
2865 msgid "Specify the remote user to build as."
2869 #: ../scripts/cowpoke.1:56 ../scripts/debchange.1:185
2875 #: ../scripts/cowpoke.1:61
2877 "Create the remote cowbuilder root if it does not already exist. If this "
2878 "option is not passed it is an error for the specified B<--dist> or B<--arch> "
2879 "to not have an existing cowbuilder root in the expected location."
2883 #: ../scripts/cowpoke.1:62
2885 msgid "B<--dpkg-opts=>I<'opt1 opt2 ...'>"
2889 #: ../scripts/cowpoke.1:67
2891 "Specify additional options to be passed to B<dpkg-buildpackage>(1). "
2892 "Multiple options are delimited with spaces. This will override any options "
2893 "specified in DEBBUILDOPTS in the build host's pbuilderrc."
2897 #: ../scripts/cowpoke.1:71
2898 msgid "Display a brief summary of the available options and current configuration."
2902 #: ../scripts/cowpoke.1:75
2903 msgid "Display the current version information."
2907 #: ../scripts/cowpoke.1:77 ../scripts/debsnap.1:56
2909 msgid "CONFIGURATION OPTIONS"
2913 #: ../scripts/cowpoke.1:83
2915 "When B<cowpoke> is run the following configuration options are read from "
2916 "global, per-user, and per-project configuration files if present. File "
2917 "paths may be absolute or relative, the latter being relative to the "
2918 "BUILDD_USER's home directory. Since the paths are typically quoted when "
2919 "used, tilde expansion will B<not> be performed on them."
2923 #: ../scripts/cowpoke.1:84
2925 msgid "Global defaults"
2929 #: ../scripts/cowpoke.1:86
2930 msgid "These apply to every arch and dist in a single cowpoke invocation."
2934 #: ../scripts/cowpoke.1:87
2936 msgid "B<BUILDD_HOST>"
2940 #: ../scripts/cowpoke.1:91
2942 "The network address or fqdn of the build machine where cowbuilder is "
2943 "configured. This may be overridden by the B<--buildd> command line option."
2947 #: ../scripts/cowpoke.1:91
2949 msgid "B<BUILDD_USER>"
2953 #: ../scripts/cowpoke.1:97
2955 "The unprivileged user name for operations on the build machine. This "
2956 "defaults to the local name of the user executing B<cowpoke> (or to a "
2957 "username that is specified in your ssh config for BUILDD_HOST), and may be "
2958 "overridden by the B<--buildd-user> command line option."
2962 #: ../scripts/cowpoke.1:97
2964 msgid "B<BUILDD_ARCH>"
2968 #: ../scripts/cowpoke.1:104
2970 "The Debian architecture(s) to build for. This must match the "
2971 "B<DEB_BUILD_ARCH> of the build chroot being used. It defaults to the local "
2972 "machine architecture where B<cowpoke> is executed, and may be overridden by "
2973 "the B<--arch> command line option. A (quoted) space separated list of "
2974 "architectures may be used here to build for all of them in a single pass."
2978 #: ../scripts/cowpoke.1:104
2980 msgid "B<BUILDD_DIST>"
2984 #: ../scripts/cowpoke.1:109
2986 "The Debian distribution(s) to build for. A (quoted) space separated list of "
2987 "distributions may be used to build for all of them in a single pass. This "
2988 "may be overridden by the B<--dist> command line option."
2992 #: ../scripts/cowpoke.1:110
2994 msgid "B<INCOMING_DIR>"
2998 #: ../scripts/cowpoke.1:114
3000 "The directory path on the build machine where the source package will "
3001 "initially be placed. This must be writable by the B<BUILDD_USER>."
3005 #: ../scripts/cowpoke.1:114
3007 msgid "B<PBUILDER_BASE>"
3011 #: ../scripts/cowpoke.1:119
3013 "The filesystem root for all pbuilder COW and result files. Arch and dist "
3014 "specific subdirectories will normally be created under this. The apt cache "
3015 "and temporary build directory will also be located under this path."
3019 #: ../scripts/cowpoke.1:120
3021 msgid "B<SIGN_KEYID>"
3025 #: ../scripts/cowpoke.1:127
3027 "If this option is set, it is expected to contain the gpg key id to pass to "
3028 "B<debsign>(1) if the packages are to be remotely signed. You will be "
3029 "prompted to confirm whether you wish to sign the packages after all builds "
3030 "are complete. If this option is unset or an empty string, no attempt to "
3031 "sign packages will be made."
3035 #: ../scripts/cowpoke.1:127
3037 msgid "B<UPLOAD_QUEUE>"
3041 #: ../scripts/cowpoke.1:134
3043 "If this option is set, it is expected to contain a 'host' specification for "
3044 "B<dput>(1) which will be used to upload them after they are signed. You "
3045 "will be prompted to confirm whether you wish to upload the packages after "
3046 "they are signed. If this option is unset or an empty string, no attempt to "
3047 "upload packages will be made. If B<SIGN_KEYID> is not set, this option will "
3048 "be ignored entirely."
3052 #: ../scripts/cowpoke.1:135
3054 msgid "B<BUILDD_ROOTCMD>"
3058 #: ../scripts/cowpoke.1:143
3060 "The command to use to gain root privileges on the remote build machine. If "
3061 "unset the default is B<sudo>(8). This is only required to invoke cowbuilder "
3062 "and allow it to enter its chroot, so you may restrict this user to only "
3063 "being able to run that command with escalated privileges. Something like "
3064 "this in sudoers will enable invoking cowbuilder without an additional "
3065 "password entry required:"
3069 #: ../scripts/cowpoke.1:147
3070 msgid "youruser ALL = NOPASSWD: /usr/sbin/cowbuilder"
3074 #: ../scripts/cowpoke.1:153
3076 "Alternatively you could use ssh with a forwarded key, or whatever other "
3077 "mechanism suits your local access policy. su -c isn't really suitable here "
3078 "due to its quoting requirements being different from all the rest."
3082 #: ../scripts/cowpoke.1:154
3084 msgid "B<DEBOOTSTRAP>"
3088 #: ../scripts/cowpoke.1:158
3090 "The utility to use when creating a new build root. Alternatives are "
3091 "B<debootstrap> or B<cdebootstrap>."
3095 #: ../scripts/cowpoke.1:160
3097 msgid "Arch and dist specific options"
3101 #: ../scripts/cowpoke.1:163
3103 "These are variables of the form: $arch_$dist_VAR which apply only for a "
3104 "particular target arch/dist build."
3108 #: ../scripts/cowpoke.1:164
3110 msgid "archB<_>distB<_RESULT_DIR>"
3114 #: ../scripts/cowpoke.1:175
3116 "The directory path on the build machine where the resulting packages (source "
3117 "and binary) will be found, and where older versions of the package that were "
3118 "built previously may be found. If any such older packages exist, debdiff "
3119 "will be used to compare the new package with the previous version after the "
3120 "build is complete, and the result will be included in the build log. Files "
3121 "in it must be readable by the B<BUILDD_USER> for sanity checking with "
3122 "B<lintian>(1) and B<debdiff>(1), and for upload with B<dput>(1). If this "
3123 "option is not specified for some arch and dist combination then it will "
3124 "default to I<$PBUILDER_BASE/$arch/$dist/result>"
3128 #: ../scripts/cowpoke.1:176
3130 msgid "archB<_>distB<_BASE_PATH>"
3134 #: ../scripts/cowpoke.1:182
3136 "The directory where the COW master files are to be found (or created if the "
3137 "B<--create> command line option was passed). If this option is not "
3138 "specified for some arch or dist then it will default to "
3139 "I<$PBUILDER_BASE/$arch/$dist/base.cow>"
3143 #: ../scripts/cowpoke.1:184
3145 msgid "CONFIGURATION FILES"
3149 #: ../scripts/cowpoke.1:185
3151 msgid "I</etc/cowpoke.conf>"
3155 #: ../scripts/cowpoke.1:188
3156 msgid "Global configuration options. Will override hardcoded defaults."
3160 #: ../scripts/cowpoke.1:188
3162 msgid "I<~/.cowpoke>"
3166 #: ../scripts/cowpoke.1:191 ../scripts/debsnap.1:90
3167 msgid "Per-user configuration options. Will override any global configuration."
3171 #: ../scripts/cowpoke.1:191
3177 #: ../scripts/cowpoke.1:195
3179 "Per-project configuration options. Will override any per-user or global "
3180 "configuration if B<cowpoke> is called from the directory where they exist."
3184 #: ../scripts/cowpoke.1:199
3186 "If the environment variable B<COWPOKE_CONF> is set, it specifies an "
3187 "addtional configuration file which will override all of those above. "
3188 "Options specified explicitly on the command line override all configuration "
3193 #: ../scripts/cowpoke.1:201
3195 msgid "COWBUILDER CONFIGURATION"
3199 #: ../scripts/cowpoke.1:210
3201 "There is nothing particularly special required to configure a cowbuilder "
3202 "instance for use with B<cowpoke>. Simply create them in the flavour you "
3203 "require with `cowbuilder --create` according to the cowbuilder "
3204 "documentation, then configure B<cowpoke> with the user, arch, and path "
3205 "information required to access it, on the machines you wish to invoke it "
3206 "from (or alternatively configure B<cowpoke> with the path, arch and "
3207 "distribution information and pass the B<--create> option to it on the first "
3208 "invocation). The build host running cowbuilder does not require B<cowpoke> "
3209 "installed locally."
3213 #: ../scripts/cowpoke.1:216
3215 "The build machine should have the lintian and devscripts packages installed "
3216 "for post-build sanity checking. Upon completion, the build log and the "
3217 "results of automated checks will be recorded in the B<INCOMING_DIR>. If you "
3218 "wish to upload signed packages the build machine will also need B<dput>(1) "
3219 "installed and configured to use the 'host' alias specified by "
3224 #: ../scripts/cowpoke.1:222
3226 "The user executing B<cowpoke> must have ssh access to the build machine as "
3227 "the B<BUILDD_USER>. That user must be able to invoke cowbuilder as root by "
3228 "using the B<BUILDD_ROOTCMD>. Signing keys are not required to be installed "
3229 "on the build machine (and will be ignored there if they are). If the "
3230 "package is signed, keys will be expected on the machine that executes "
3235 #: ../scripts/cowpoke.1:229
3237 "When B<cowpoke> is invoked, it will first attempt to update the cowbuilder "
3238 "image if that has not already been done on the same day. This is checked by "
3239 "the presence or absence of a I<cowbuilder-$arch-$dist-update-log-$date> file "
3240 "in the B<INCOMING_DIR>. You may move, remove, or touch this file if you "
3241 "wish the image to be updated more or less often than that. Its contents log "
3242 "the output of cowbuilder during the update (or creation) of the build root."
3246 #: ../scripts/cowpoke.1:231 ../scripts/rmadison.pl:290
3252 #: ../scripts/cowpoke.1:240
3254 "Since cowbuilder creates a chroot, and to do that you need root, B<cowpoke> "
3255 "also requires some degree of root access. So all the horrible things that "
3256 "can go wrong with that may well one day rain down upon you. cowbuilder has "
3257 "been known to accidentally wipe out bind-mounted filesystems outside the "
3258 "chroot, and worse than that can easily happen. So be careful, keep good "
3259 "backups of things you don't want to lose on your build machine, and use "
3260 "B<cowpoke> to keep all that on a machine that isn't your bleeding edge dev "
3261 "box with your last few hours of uncommitted work."
3265 #: ../scripts/cowpoke.1:246
3266 msgid "B<cowbuilder>(1), B<pbuilder>(1), B<ssh-agent>(1), B<sudoers>(5)."
3270 #: ../scripts/cowpoke.1:250
3271 msgid "B<cowpoke> was written by Ron E<lt>ron@debian.orgE<gt>."
3275 #: ../scripts/cvs-debc.1:1 ../scripts/cvs-debrelease.1:1
3281 #: ../scripts/cvs-debc.1:4
3282 msgid "cvs-debc - view contents of a cvs-buildpackage/cvs-debuild generated package"
3286 #: ../scripts/cvs-debc.1:6
3287 msgid "B<cvs-debc> [I<options>] [I<package> ...]"
3291 #: ../scripts/cvs-debc.1:17
3293 "B<cvs-debc> is run from the CVS working directory after B<cvs-buildpackage> "
3294 "or B<cvs-debuild>. It uses the B<cvs-buildpackage> system to locate the "
3295 "I<.changes> file generated in that run. It then displays information about "
3296 "the .deb files which were generated in that run, by running B<dpkg-deb -I> "
3297 "and B<dpkg-deb -c> on every I<.deb> archive listed in the I<.changes> file, "
3298 "assuming that all of the I<.deb> archives live in the same directory as the "
3299 "I<.changes> file. It is useful for ensuring that the expected files have "
3300 "ended up in the Debian package."
3304 #: ../scripts/cvs-debc.1:20
3306 "If a list of packages is given on the command line, then only those debs "
3307 "with names in this list of packages will be processed."
3311 #: ../scripts/cvs-debc.1:24 ../scripts/cvs-debi.1:23 ../scripts/cvs-debrelease.1:21
3313 "Note that unlike B<cvs-buildpackage>, the only way to specify the source "
3314 "package name is with the B<-P> option; you cannot simply have it as the last "
3315 "command-line parameter."
3319 #: ../scripts/cvs-debc.1:28 ../scripts/cvs-debi.1:32
3321 "All current B<cvs-buildpackage> options are silently accepted; however, only "
3322 "the ones listed below have any effect. For more details on all of them, see "
3323 "the B<cvs-buildpackage>(1) manpage."
3327 #: ../scripts/cvs-debc.1:28 ../scripts/cvs-debi.1:32 ../scripts/cvs-debrelease.1:30 ../scripts/debc.1:65 ../scripts/debi.1:66 ../scripts/debrelease.1:67 ../scripts/debrsign.1:35 ../scripts/debsign.1:77
3329 msgid "B<-a>I<debian-architecture>, B<-t>I<GNU-system-type>"
3333 #: ../scripts/cvs-debc.1:34 ../scripts/cvs-debi.1:38 ../scripts/cvs-debrelease.1:36 ../scripts/debc.1:71 ../scripts/debi.1:72 ../scripts/debrsign.1:41 ../scripts/debsign.1:83
3335 "See B<dpkg-architecture>(1) for a description of these options. They affect "
3336 "the search for the I<.changes> file. They are provided to mimic the "
3337 "behaviour of B<dpkg-buildpackage> when determining the name of the "
3342 #: ../scripts/cvs-debc.1:34 ../scripts/cvs-debi.1:38 ../scripts/cvs-debrelease.1:36
3344 msgid "B<-ME<lt>moduleE<gt>>"
3348 #: ../scripts/cvs-debc.1:37 ../scripts/cvs-debi.1:41 ../scripts/cvs-debrelease.1:39
3349 msgid "The name of the CVS module."
3353 #: ../scripts/cvs-debc.1:37 ../scripts/cvs-debi.1:41 ../scripts/cvs-debrelease.1:39
3355 msgid "B<-PE<lt>packageE<gt>>"
3359 #: ../scripts/cvs-debc.1:40 ../scripts/cvs-debi.1:44 ../scripts/cvs-debrelease.1:42
3360 msgid "The name of the package."
3364 #: ../scripts/cvs-debc.1:40 ../scripts/cvs-debi.1:44 ../scripts/cvs-debrelease.1:42
3366 msgid "B<-VE<lt>versionE<gt>>"
3370 #: ../scripts/cvs-debc.1:43 ../scripts/cvs-debi.1:47 ../scripts/cvs-debrelease.1:45
3371 msgid "The version number of the package."
3375 #: ../scripts/cvs-debc.1:43 ../scripts/cvs-debi.1:47 ../scripts/cvs-debrelease.1:45
3377 msgid "B<-TE<lt>tagE<gt>>"
3381 #: ../scripts/cvs-debc.1:46 ../scripts/cvs-debi.1:50 ../scripts/cvs-debrelease.1:48
3382 msgid "The CVS tag to use for exporting sources."
3386 #: ../scripts/cvs-debc.1:46 ../scripts/cvs-debi.1:50 ../scripts/cvs-debrelease.1:48
3388 msgid "B<-RE<lt>root\\ directoryE<gt>>"
3392 #: ../scripts/cvs-debc.1:49 ../scripts/cvs-debi.1:53 ../scripts/cvs-debrelease.1:51
3393 msgid "Root of the original sources archive."
3397 #: ../scripts/cvs-debc.1:49 ../scripts/cvs-debi.1:53 ../scripts/cvs-debrelease.1:51
3399 msgid "B<-WE<lt>work directoryE<gt>>"
3403 #: ../scripts/cvs-debc.1:52 ../scripts/cvs-debi.1:56 ../scripts/cvs-debrelease.1:54
3404 msgid "The full path name for the cvs-buildpackage working directory."
3408 #: ../scripts/cvs-debc.1:52 ../scripts/cvs-debi.1:56 ../scripts/cvs-debrelease.1:54
3410 msgid "B<-xE<lt>prefixE<gt>>"
3414 #: ../scripts/cvs-debc.1:55 ../scripts/cvs-debi.1:59 ../scripts/cvs-debrelease.1:57
3415 msgid "This option provides the CVS default module prefix."
3419 #: ../scripts/cvs-debc.1:55 ../scripts/cvs-debi.1:59 ../scripts/cvs-debrelease.1:61 ../scripts/debc.1:89 ../scripts/debi.1:96 ../scripts/debrsign.1:50
3421 msgid "B<--help>, B<--version>"
3425 #: ../scripts/cvs-debc.1:58 ../scripts/cvs-debi.1:62 ../scripts/cvs-debrelease.1:64 ../scripts/debc.1:92 ../scripts/debi.1:99 ../scripts/debrsign.1:53
3426 msgid "Show help message and version information respectively."
3430 #: ../scripts/cvs-debc.1:64
3431 msgid "B<cvs-buildpackage>(1), B<cvs-debi>(1), B<cvs-debuild>(1) and B<debc>(1)."
3435 #: ../scripts/cvs-debc.1:68 ../scripts/cvs-debi.1:72
3437 "B<cvs-buildpackage> was written by Manoj Srivastava, and the current version "
3438 "of B<debi> was written by Julian Gilbey E<lt>jdg@debian.orgE<gt>. They have "
3439 "been combined into this program by Julian Gilbey."
3443 #: ../scripts/cvs-debi.1:1
3449 #: ../scripts/cvs-debi.1:4
3450 msgid "cvs-debi - install cvs-buildpackage/cvs-debuild generated package"
3454 #: ../scripts/cvs-debi.1:6
3455 msgid "B<cvs-debi> [I<options>] [I<package> ...]"
3459 #: ../scripts/cvs-debi.1:16
3461 "B<cvs-debi> is run from the CVS working directory after B<cvs-buildpackage> "
3462 "or B<cvs-debuild>. It uses the B<cvs-buildpackage> system to locate the "
3463 "I<.changes> file generated in that run. It then runs B<debpkg -i> on every "
3464 "I<.deb> archive listed in the I<.changes> file to install them, assuming "
3465 "that all of the I<.deb> archives live in the same directory as the "
3466 "I<.changes> file. Note that you probably don't want to run this program on "
3467 "a I<.changes> file relating to a different architecture after "
3468 "cross-compiling the package!"
3472 #: ../scripts/cvs-debi.1:19 ../scripts/debi.1:24
3474 "If a list of packages is given on the command line, then only those debs "
3475 "with names in this list of packages will be installed."
3479 #: ../scripts/cvs-debi.1:28 ../scripts/debi.1:29
3481 "Since installing a package requires root privileges, B<debi> calls B<debpkg> "
3482 "rather than B<dpkg> directly. Thus B<debi> will only be useful if it is "
3483 "either being run as root or B<debpkg> can be run as root. See B<debpkg>(1) "
3488 #: ../scripts/cvs-debi.1:68
3489 msgid "B<cvs-buildpackage>(1), B<cvs-debc>(1) B<cvs-debuild>(1) and B<debi>(1)."
3493 #: ../scripts/cvs-debrelease.1:4
3494 msgid "cvs-debrelease - upload a cvs-buildpackage/cvs-debuild generated package"
3498 #: ../scripts/cvs-debrelease.1:7
3500 "B<cvs-debrelease> [I<cvs-debrelease options>] [B<--dopts> [I<dupload/dput "
3505 #: ../scripts/cvs-debrelease.1:17
3507 "B<cvs-debrelease> is run from the CVS working directory after "
3508 "B<cvs-buildpackage> or B<cvs-debuild>. It uses the B<cvs-buildpackage> "
3509 "system to locate the I<.changes> file generated in that run. It then "
3510 "uploads the package using B<debrelease>(1), which in turn calls either "
3511 "B<dupload> or B<dput>. Note that the B<--dopts> option must be specified to "
3512 "distinguish the B<cvs-debrelease> options from the B<dupload> or B<dput> "
3513 "options. Also, the B<devscripts> configuration files will be read, as "
3514 "described in the B<debrelease>(1) manpage."
3518 #: ../scripts/cvs-debrelease.1:26
3520 "All current B<cvs-buildpackage> options are silently accepted; however, only "
3521 "the ones listed below have any effect. For more details on all of them, see "
3522 "the B<cvs-buildpackage>(1) manpage. All B<debrelease> options (as listed "
3523 "below) are also accepted."
3527 #: ../scripts/cvs-debrelease.1:26 ../scripts/debrelease.1:57
3529 msgid "B<--dupload>, B<--dput>"
3533 #: ../scripts/cvs-debrelease.1:30 ../scripts/debrelease.1:61
3534 msgid "This specifies which uploader program to use; the default is B<dupload>."
3538 #: ../scripts/cvs-debrelease.1:57 ../scripts/debc.1:85 ../scripts/debchange.1:347 ../scripts/debclean.1:77 ../scripts/debdiff.1:151 ../scripts/debi.1:92 ../scripts/debrelease.1:95 ../scripts/debsign.1:101 ../scripts/dpkg-depcheck.1:92 ../scripts/dscverify.1:24 ../scripts/grep-excuses.1:14 ../scripts/nmudiff.1:69 ../scripts/rmadison.pl:257 ../scripts/uscan.1:438 ../scripts/uupdate.1:78 ../scripts/who-uploads.1:40
3540 msgid "B<--no-conf>, B<--noconf>"
3544 #: ../scripts/cvs-debrelease.1:69
3545 msgid "B<cvs-buildpackage>(1), B<debrelease>(1) and B<cvs-debuild>(1)."
3549 #: ../scripts/cvs-debrelease.1:73
3551 "B<cvs-buildpackage> was written by Manoj Srivastava, and the current version "
3552 "of B<debrelease> was written by Julian Gilbey E<lt>jdg@debian.orgE<gt>. "
3553 "They have been combined into this program by Julian Gilbey."
3557 #: ../scripts/cvs-debuild.1:1
3563 #: ../scripts/cvs-debuild.1:4
3564 msgid "cvs-debuild - build a Debian package using cvs-buildpackage and debuild"
3568 #: ../scripts/cvs-debuild.1:7
3570 "B<cvs-debuild> [I<debuild options>] [I<cvs-buildpackage options>] "
3571 "[B<--lintian-opts> I<lintian options>]"
3575 #: ../scripts/cvs-debuild.1:13
3577 "B<cvs-debuild> is a wrapper around B<cvs-buildpackage> to run it with "
3578 "B<debuild> as the package-building program. (This cannot simply be "
3579 "accomplished using the B<-C> option of B<cvs-buildpackage>, as it does not "
3580 "know how to handle all of the special B<debuild> options.)"
3584 #: ../scripts/cvs-debuild.1:22
3586 "The program simply stashes the B<debuild> and B<lintian> options, and passes "
3587 "them to B<debuild> when it is called by B<cvs-buildpackage>. All of the "
3588 "standard B<debuild> options may be used (as listed below), but note that the "
3589 "root command specified by any B<--rootcmd> or B<-r> command-line option will "
3590 "be passed as an option to B<cvs-buildpackage>. The first non-B<debuild> "
3591 "option detected will signal the start of the B<cvs-buildpackage> options."
3595 #: ../scripts/cvs-debuild.1:29
3597 "The selection of the root command is slightly subtle: if there are any "
3598 "command-line options, these will be used. If not, then if "
3599 "B<cvs-buildpackage> is set up to use a default root command, that will be "
3600 "used. Finally, if neither of these are the case, then B<debuild> will use "
3601 "its procedures to determine an appropriate command, as described in its "
3606 #: ../scripts/cvs-debuild.1:32
3608 "See the manpages for B<debuild>(1) and B<cvs-buildpackage> for more "
3609 "information about the behaviour of each."
3613 #: ../scripts/cvs-debuild.1:38
3615 "The following are the B<debuild> options recognised by B<cvs-debuild>. All "
3616 "B<cvs-buildpackage> and B<lintian> options are simply passed to the "
3617 "appropriate program. For explanations of the meanings of these variables, "
3618 "see B<debuild>(1)."
3622 #: ../scripts/cvs-debuild.1:38 ../scripts/debuild.1:221
3624 msgid "B<--no-conf, --noconf>"
3628 #: ../scripts/cvs-debuild.1:40 ../scripts/debuild.1:225
3630 msgid "B<--rootcmd=>I<gain-root-command, >B<-r>I<gain-root-command>"
3634 #: ../scripts/cvs-debuild.1:42 ../scripts/debuild.1:228
3636 msgid "B<--preserve-env>"
3640 #: ../scripts/cvs-debuild.1:44 ../scripts/debuild.1:231
3642 msgid "B<--preserve-envvar=>I<var, >B<-e>I<var>"
3646 #: ../scripts/cvs-debuild.1:46 ../scripts/debuild.1:238
3648 msgid "B<--set-envvar=>I<var>B<=>I<value, >B<-e>I<var>B<=>I<value>"
3652 #: ../scripts/cvs-debuild.1:48
3654 msgid "B<--lintian, --no-lintian>"
3658 #: ../scripts/cvs-debuild.1:50
3660 msgid "B<--ignore-dirname>, B<--check-dirname>"
3664 #: ../scripts/cvs-debuild.1:53
3665 msgid "These should not be needed, but it is provided nevertheless."
3669 #: ../scripts/cvs-debuild.1:59
3671 "B<cvs-buildpackage>(1), B<debuild>(1), B<dpkg-buildpackage>(1) and "
3676 #: ../scripts/cvs-debuild.1:60
3677 msgid "This program was written by Julian Gilbey E<lt>jdg@debian.orgE<gt>."
3681 #: ../scripts/dcmd.1:1
3687 #: ../scripts/dcmd.1:4
3688 msgid "dcmd - expand file lists of .dsc/.changes files in the command line"
3692 #: ../scripts/dcmd.1:7
3693 msgid "B<dcmd> [I<options>] [I<command>] [I<changes-file>|I<dsc-file>] [I<...>]"
3697 #: ../scripts/dcmd.1:12
3699 "B<dcmd> replaces any reference to a .dsc or .changes file in the command "
3700 "line with the list of files in its 'Files' section, plus the file itself. "
3701 "It allows easy manipulation of all the files involved in an upload (for "
3702 "changes files) or a source package (for dsc files)."
3706 #: ../scripts/dcmd.1:16
3708 "If I<command> is omitted (that is the first argument is an existing .dsc or "
3709 ".changes file), the expanded list of files is printed to stdout, one file by "
3710 "line. Useful for usage in backticks."
3714 #: ../scripts/dcmd.1:20
3716 "There are a number of options which may be used in order to select only a "
3717 "subset of the files listed in the .dsc or .changes file. If a requested file "
3718 "is not found, an error message will be printed."
3722 #: ../scripts/dcmd.1:20
3728 #: ../scripts/dcmd.1:23
3729 msgid "Select the .dsc file."
3733 #: ../scripts/dcmd.1:23
3735 msgid "B<--schanges>"
3739 #: ../scripts/dcmd.1:26
3740 msgid "Select .changes files for the 'source' architecture."
3744 #: ../scripts/dcmd.1:26
3746 msgid "B<--bchanges>"
3750 #: ../scripts/dcmd.1:29
3751 msgid "Select .changes files for binary architectures."
3755 #: ../scripts/dcmd.1:29
3757 msgid "B<--changes>"
3761 #: ../scripts/dcmd.1:32
3762 msgid "Select .changes files. Implies --schanges and --bchanges."
3766 #: ../scripts/dcmd.1:32
3768 msgid "B<--archdeb>"
3772 #: ../scripts/dcmd.1:35
3773 msgid "Select architecture-dependent binary packages (.deb files)."
3777 #: ../scripts/dcmd.1:35
3779 msgid "B<--indepdeb>"
3783 #: ../scripts/dcmd.1:38
3784 msgid "Select architecture-independent binary packages (.deb files)."
3788 #: ../scripts/dcmd.1:38
3794 #: ../scripts/dcmd.1:41
3795 msgid "Select binary packages (.deb files). Implies --archdeb and --indepdeb."
3799 #: ../scripts/dcmd.1:41
3801 msgid "B<--archudeb>"
3805 #: ../scripts/dcmd.1:44
3806 msgid "Select architecture-dependent udeb binary packages."
3810 #: ../scripts/dcmd.1:44
3812 msgid "B<--indepudeb>"
3816 #: ../scripts/dcmd.1:47
3817 msgid "Select architecture-independent udeb binary packages."
3821 #: ../scripts/dcmd.1:47
3827 #: ../scripts/dcmd.1:50
3828 msgid "Select udeb binary packages. Implies --archudeb and --indepudeb."
3832 #: ../scripts/dcmd.1:50
3834 msgid "B<--tar, --orig>"
3838 #: ../scripts/dcmd.1:53
3839 msgid "Select the tar file."
3843 #: ../scripts/dcmd.1:53
3849 #: ../scripts/dcmd.1:56
3850 msgid "Select the Debian diff file."
3854 #: ../scripts/dcmd.1:59
3856 "Each option may be prefixed by B<--no> to indicate that all files I<not> "
3857 "matching the specification should be selected."
3861 #: ../scripts/dcmd.1:63
3863 "It is not possible to combine positive filtering options (e.g. --dsc) and "
3864 "negative filtering options (e.g. --no-changes) in the same B<dcmd> "
3869 #: ../scripts/dcmd.1:63
3871 msgid "B<--no-fail-on-missing, -r>"
3875 #: ../scripts/dcmd.1:66
3876 msgid "If any of the requested files were not found, do not output an error."
3880 #: ../scripts/dcmd.1:66 ../scripts/debuild.1:367 ../scripts/getbuildlog.1:31 ../scripts/rc-alert.1:96
3886 #: ../scripts/dcmd.1:68
3887 msgid "Copy the result of a build to another machine:"
3891 #: ../scripts/dcmd.1:76
3894 "$ dcmd scp rcs_5.7-23_amd64.changes elegiac:/tmp\n"
3895 "rcs_5.7-23.dsc 100% 490 0.5KB/s 00:00\n"
3896 "rcs_5.7-23.diff.gz 100% 12KB 11.7KB/s 00:00\n"
3897 "rcs_5.7-23_amd64.deb 100% 363KB 362.7KB/s 00:00\n"
3898 "rcs_5.7-23_amd64.changes 100% 1095 1.1KB/s 00:00\n"
3903 #: ../scripts/dcmd.1:81
3906 "$ dcmd --diff --deb scp rcs_5.7-23_amd64.changes elegiac:/tmp\n"
3907 "rcs_5.7-23.diff.gz 100% 12KB 11.7KB/s 00:00\n"
3908 "rcs_5.7-23_amd64.deb 100% 363KB 362.7KB/s 00:00\n"
3913 #: ../scripts/dcmd.1:84
3914 msgid "Check the contents of a source package:"
3918 #: ../scripts/dcmd.1:91
3921 "$ dcmd md5sum rcs_5.7-23.dsc \n"
3922 "8fd09ea9654cda128f8d5c337d3b8de7 rcs_5.7.orig.tar.gz\n"
3923 "f0ceeae96603e823eacba6721a30b5c7 rcs_5.7-23.diff.gz\n"
3924 "5241db1e231b1f43ae5514b63d2523f8 rcs_5.7-23.dsc\n"
3929 #: ../scripts/dcmd.1:96
3932 "$ dcmd --no-diff md5sum rcs_5.7-23.dsc \n"
3933 "8fd09ea9654cda128f8d5c337d3b8de7 rcs_5.7.orig.tar.gz\n"
3934 "5241db1e231b1f43ae5514b63d2523f8 rcs_5.7-23.dsc\n"
3939 #: ../scripts/dcmd.1:101
3940 msgid "B<dpkg-source>(1), B<dpkg-genchanges>(1)."
3944 #: ../scripts/dcmd.1:103
3946 "This program was written by Romain Francoise E<lt>rfrancoise@debian.orgE<gt> "
3947 "and is released under the GPL, version 2 or later."
3951 #: ../scripts/dcontrol.pl:201
3953 "dcontrol -- Query package and source control files for all Debian "
3958 #: ../scripts/dcontrol.pl:207
3959 msgid "B<dcontrol> [I<options>] I<package>[I<modifiers>] [I<...>]"
3963 #: ../scripts/dcontrol.pl:213
3965 "B<dcontrol> queries a remote database of Debian binary and source package "
3966 "control files. It can be thought of as an B<apt-cache> webservice that also "
3967 "operates for distributions and architectures different from the local "
3972 #: ../scripts/dcontrol.pl:217
3977 #: ../scripts/dcontrol.pl:219
3978 msgid "Like B<apt-cache>, packages can be suffixed by modifiers:"
3982 #: ../scripts/dcontrol.pl:223
3983 msgid "B<=>I<version>"
3987 #: ../scripts/dcontrol.pl:225
3988 msgid "Exact version match"
3992 #: ../scripts/dcontrol.pl:227
3993 msgid "B<@>I<architecture>"
3997 #: ../scripts/dcontrol.pl:229
3999 "Query this only architecture. Use B<@source> for source packages, B<@binary> "
4000 "excludes source packages."
4004 #: ../scripts/dcontrol.pl:232
4005 msgid "B</>[I<archive>B<:>][I<suite>][B</>I<component>]"
4009 #: ../scripts/dcontrol.pl:234
4011 "Restrict to I<archive> (debian, debian-backports, debian-security, "
4012 "debian-volatile), I<suite> (always codenames, with the exception of "
4013 "experimental), and/or I<component> (main, updates/main, ...). Use two "
4014 "slashes (B<//>) to separate suite and component if the suite name contains "
4015 "slashes. (Component can be left empty.)"
4019 #: ../scripts/dcontrol.pl:242
4021 "By default, all versions, suites, and architectures are queried. Refer to "
4022 "B<http://qa.debian.org/cgi-bin/dcontrol> for currently supported values."
4026 #: ../scripts/dcontrol.pl:249
4027 msgid "B<-s>, B<--show-suites>"
4031 #: ../scripts/dcontrol.pl:251
4032 msgid "Add headers showing which distribution the control file is from."
4036 #: ../scripts/dcontrol.pl:253
4037 msgid "B<-d>, B<--debug>"
4041 #: ../scripts/dcontrol.pl:255
4042 msgid "Print URL queried."
4046 #: ../scripts/dcontrol.pl:259 ../scripts/dget.pl:587
4047 msgid "Show a help message."
4051 #: ../scripts/dcontrol.pl:261 ../scripts/dget.pl:589 ../scripts/getbuildlog.1:28
4053 msgid "B<-V>, B<--version>"
4057 #: ../scripts/dcontrol.pl:263 ../scripts/dget.pl:591
4058 msgid "Show version information."
4062 #: ../scripts/dcontrol.pl:269 ../scripts/dget.pl:597
4064 "The two configuration files F</etc/devscripts.conf> and F<~/.devscripts> are "
4065 "sourced by a shell in that order to set configuration variables. Command "
4066 "line options can be used to override configuration file settings. "
4067 "Environment variable settings are ignored for this purpose. The currently "
4068 "recognised variable is:"
4072 #: ../scripts/dcontrol.pl:277
4073 msgid "DCONTROL_URL"
4077 #: ../scripts/dcontrol.pl:279
4078 msgid "URL to query. Default is B<http://qa.debian.org/cgi-bin/dcontrol>."
4082 #: ../scripts/dcontrol.pl:285
4083 msgid "This program is Copyright (C) 2009 by Christoph Berg <myon@debian.org>."
4087 #: ../scripts/dcontrol.pl:287 ../scripts/dget.pl:636 ../scripts/tagpending.pl:440
4089 "This program is licensed under the terms of the GPL, either version 2 of the "
4090 "License, or (at your option) any later version."
4094 #: ../scripts/dcontrol.pl:292
4095 msgid "B<apt-cache>(1)."
4099 #: ../scripts/dd-list.1:17
4105 #: ../scripts/dd-list.1:17
4111 #: ../scripts/dd-list.1:17
4116 #. --------------------------------------------------------------------
4118 #: ../scripts/dd-list.1:22
4119 msgid "dd-list - nicely list .deb packages and their maintainers"
4122 #. --------------------------------------------------------------------
4124 #: ../scripts/dd-list.1:26
4126 "B<dd-list> [B<-hiuV>] [B<--help>] [B<--stdin>] [B<--dctrl>] [B<--version>] "
4127 "[B<--uploaders>] [B<package>...]"
4131 #: ../scripts/dd-list.1:30
4133 "B<dd-list> produces nicely formatted lists of Debian (.deb) packages and "
4134 "their maintainers."
4138 #: ../scripts/dd-list.1:37
4140 "Input is a list of source or binary package names on the command line (or "
4141 "the standard input if B<--stdin> is given). Output is a list of the "
4142 "following format, where package names are source packages by default:"
4146 #: ../scripts/dd-list.1:41
4148 msgid "J. Random Developer E<lt>jrandom@debian.orgE<gt>\n"
4152 #: ../scripts/dd-list.1:44
4155 "j-random-package\n"
4160 #: ../scripts/dd-list.1:47
4162 msgid "Diana Hacker E<lt>diana@example.orgE<gt>\n"
4166 #: ../scripts/dd-list.1:50
4170 "more-fun-package\n"
4173 #. --------------------------------------------------------------------
4175 #: ../scripts/dd-list.1:58
4177 "This is useful when you want, for example, to produce a list of packages "
4178 "that need to attention from their maintainers, e.g., to be rebuilt when a "
4179 "library version transition happens."
4183 #: ../scripts/dd-list.1:59
4185 msgid "B<-h>,B<--help>"
4189 #: ../scripts/dd-list.1:62
4190 msgid "Print brief help message."
4194 #: ../scripts/dd-list.1:62
4196 msgid "B<-i>,B<--stdin>"
4200 #: ../scripts/dd-list.1:66
4202 "Read package names from the standard input, instead of taking them from the "
4203 "command line. Package names are whitespace delimited."
4207 #: ../scripts/dd-list.1:66
4209 msgid "B<-d>,B<--dctrl>"
4213 #: ../scripts/dd-list.1:73
4215 "Read package list from standard input in the format of a Debian package "
4216 "control file. This includes the status file, or output of apt-cache. This is "
4217 "the fastest way to use dd-list, as it uses the maintainer information from "
4218 "the input instead of looking up the maintainer of each listed package."
4222 #: ../scripts/dd-list.1:76
4224 "If no I<Source:> line is given, the I<Package:> name is used for output, "
4225 "which might be a binary package name."
4229 #: ../scripts/dd-list.1:76
4231 msgid "B<-u>,B<--uploaders>"
4235 #: ../scripts/dd-list.1:81
4237 "Also list developers who are named as uploaders of packages, not only the "
4238 "maintainers; this is the default behaviour, use --nouploaders to prevent "
4239 "it. Uploaders are indicated with \"(U)\" appended to the package name."
4243 #: ../scripts/dd-list.1:81
4245 msgid "B<-nou>,B<--nouploaders>"
4249 #: ../scripts/dd-list.1:84
4250 msgid "Only list package Maintainers, do not list Uploaders."
4254 #: ../scripts/dd-list.1:84
4256 msgid "B<-b>,B<--print-binary>"
4260 #: ../scripts/dd-list.1:89
4262 "Use binary package names in the output instead of source package names (has "
4263 "no effect with B<--dctrl> if the I<Package:> line contains source package "
4268 #: ../scripts/dd-list.1:89
4270 msgid "B<-V>,B<--version>"
4273 #. --------------------------------------------------------------------
4275 #: ../scripts/dd-list.1:93
4276 msgid "Print the version."
4280 #: ../scripts/dd-list.1:95
4281 msgid "Lars Wirzenius E<lt>liw@iki.fiE<gt>"
4285 #: ../scripts/dd-list.1:96
4286 msgid "Joey Hess E<lt>joeyh@debian.orgE<gt>"
4290 #: ../scripts/debc.1:1
4296 #: ../scripts/debc.1:4
4297 msgid "debc - view contents of a generated Debian package"
4301 #: ../scripts/debc.1:6
4302 msgid "B<debc> [I<options>] [I<changes file>] [I<package> ...]"
4306 #: ../scripts/debc.1:25
4308 "B<debc> figures out the current version of a package and displays "
4309 "information about the .deb and .udeb files which have been generated in the "
4310 "current build process. If a I<.changes> file is specified on the command "
4311 "line, the filename must end with I<.changes>, as this is how the program "
4312 "distinguishes it from package names. If not, then B<debc> has to be called "
4313 "from within the source code directory tree. In this case, it will look for "
4314 "the I<.changes> file corresponding to the current package version (by "
4315 "determining the name and version number from the changelog, and the "
4316 "architecture in the same way as B<dpkg-buildpackage>(1) does). It then runs "
4317 "B<dpkg-deb -I> and B<dpkg-deb -c> on every I<.deb> and I<.udeb> archive "
4318 "listed in the I<.changes> file to display information about the contents of "
4319 "the I<.deb> / I<.udeb> files. It precedes every I<.deb> or I<.udeb> file "
4320 "with the name of the file. It assumes that all of the I<.deb> / I<.udeb> "
4321 "archives live in the same directory as the I<.changes> file. It is useful "
4322 "for ensuring that the expected files have ended up in the Debian package."
4326 #: ../scripts/debc.1:28
4328 "If a list of packages is given on the command line, then only those debs or "
4329 "udebs with names in this list of packages will be processed."
4333 #: ../scripts/debc.1:28 ../scripts/debchange.1:106 ../scripts/debclean.1:24 ../scripts/debi.1:29 ../scripts/debrelease.1:20 ../scripts/debuild.1:49 ../scripts/uscan.1:276
4335 msgid "Directory name checking"
4339 #: ../scripts/debc.1:39
4341 "In common with several other scripts in the B<devscripts> package, B<debc> "
4342 "will climb the directory tree until it finds a I<debian/changelog> file. As "
4343 "a safeguard against stray files causing potential problems, it will examine "
4344 "the name of the parent directory once it finds the I<debian/changelog> file, "
4345 "and check that the directory name corresponds to the package name. "
4346 "Precisely how it does this is controlled by two configuration file variables "
4347 "DEVSCRIPTS_CHECK_DIRNAME_LEVEL and DEVSCRIPTS_CHECK_DIRNAME_REGEX, and their "
4348 "corresponding command-line options B<--check-dirname-level> and "
4349 "B<--check-dirname-regex>."
4353 #: ../scripts/debc.1:41 ../scripts/debchange.1:119 ../scripts/debclean.1:37 ../scripts/debi.1:42 ../scripts/debrelease.1:33 ../scripts/debuild.1:63 ../scripts/uscan.1:293
4354 msgid "DEVSCRIPTS_CHECK_DIRNAME_LEVEL can take the following values:"
4358 #: ../scripts/debc.1:41 ../scripts/debchange.1:119 ../scripts/debclean.1:37 ../scripts/debi.1:42 ../scripts/debrelease.1:33 ../scripts/debuild.1:63 ../scripts/uscan.1:293
4364 #: ../scripts/debc.1:44 ../scripts/debchange.1:122 ../scripts/debclean.1:40 ../scripts/debi.1:45 ../scripts/debrelease.1:36 ../scripts/debuild.1:66 ../scripts/uscan.1:296
4365 msgid "Never check the directory name."
4369 #: ../scripts/debc.1:44 ../scripts/debchange.1:122 ../scripts/debclean.1:40 ../scripts/debi.1:45 ../scripts/debrelease.1:36 ../scripts/debuild.1:66 ../scripts/uscan.1:296
4375 #: ../scripts/debc.1:48 ../scripts/debchange.1:126 ../scripts/debclean.1:44 ../scripts/debi.1:49 ../scripts/debrelease.1:40 ../scripts/debuild.1:70
4377 "Only check the directory name if we have had to change directory in our "
4378 "search for I<debian/changelog>. This is the default behaviour."
4382 #: ../scripts/debc.1:48 ../scripts/debchange.1:126 ../scripts/debclean.1:44 ../scripts/debi.1:49 ../scripts/debrelease.1:40 ../scripts/debuild.1:70 ../scripts/uscan.1:302
4388 #: ../scripts/debc.1:51 ../scripts/debchange.1:129 ../scripts/debclean.1:47 ../scripts/debi.1:52 ../scripts/debrelease.1:43 ../scripts/debuild.1:73 ../scripts/uscan.1:305
4389 msgid "Always check the directory name."
4393 #: ../scripts/debc.1:64 ../scripts/debchange.1:142 ../scripts/debclean.1:60 ../scripts/debi.1:65 ../scripts/debrelease.1:56 ../scripts/debuild.1:86 ../scripts/uscan.1:318
4395 "The directory name is checked by testing whether the current directory name "
4396 "(as determined by B<pwd>(1)) matches the regex given by the configuration "
4397 "file option DEVSCRIPTS_CHECK_DIRNAME_REGEX or by the command line option "
4398 "B<--check-dirname-regex> I<regex>. Here I<regex> is a Perl regex (see "
4399 "B<perlre>(3perl)), which will be anchored at the beginning and the end. If "
4400 "I<regex> contains a '/', then it must match the full directory path. If "
4401 "not, then it must match the full directory name. If I<regex> contains the "
4402 "string \\'PACKAGE', this will be replaced by the source package name, as "
4403 "determined from the changelog. The default value for the regex is: "
4404 "\\'PACKAGE(-.+)?', thus matching directory names such as PACKAGE and "
4409 #: ../scripts/debc.1:71 ../scripts/debi.1:72 ../scripts/debrelease.1:81 ../scripts/debsign.1:95
4411 msgid "B<--debs-dir> I<DIR>"
4415 #: ../scripts/debc.1:77
4417 "Look for the I<.changes>, I<.deb> and I<.udeb> files in directory I<DIR> "
4418 "instead of the parent of the source directory. This should either be an "
4419 "absolute path or relative to the top of the source directory."
4423 #: ../scripts/debc.1:77 ../scripts/debchange.1:339 ../scripts/debclean.1:69 ../scripts/debi.1:84 ../scripts/debrelease.1:87 ../scripts/debuild.1:276 ../scripts/uscan.1:427
4425 msgid "B<--check-dirname-level> I<N>"
4429 #: ../scripts/debc.1:81 ../scripts/debc.1:85 ../scripts/debchange.1:343 ../scripts/debchange.1:347 ../scripts/debclean.1:73 ../scripts/debclean.1:77 ../scripts/debi.1:88 ../scripts/debi.1:92 ../scripts/debrelease.1:91 ../scripts/debrelease.1:95 ../scripts/debuild.1:280 ../scripts/debuild.1:284 ../scripts/uscan.1:431 ../scripts/uscan.1:435
4431 "See the above section \"Directory name checking\" for an explanation of this "
4436 #: ../scripts/debc.1:81 ../scripts/debchange.1:343 ../scripts/debclean.1:73 ../scripts/debi.1:88 ../scripts/debrelease.1:91 ../scripts/debuild.1:280 ../scripts/uscan.1:431
4438 msgid "B<--check-dirname-regex> I<regex>"
4442 #: ../scripts/debc.1:98 ../scripts/debchange.1:368 ../scripts/debclean.1:96 ../scripts/debi.1:105 ../scripts/debrelease.1:111 ../scripts/debrsign.1:63 ../scripts/debsign.1:117 ../scripts/nmudiff.1:85 ../scripts/pts-subscribe.1:48 ../scripts/uupdate.1:94 ../scripts/who-uploads.1:56
4444 "The two configuration files I</etc/devscripts.conf> and I<~/.devscripts> are "
4445 "sourced in that order to set configuration variables. Command line options "
4446 "can be used to override configuration file settings. Environment variable "
4447 "settings are ignored for this purpose. The currently recognised variables "
4452 #: ../scripts/debc.1:98 ../scripts/debi.1:105 ../scripts/debrelease.1:116 ../scripts/debsign.1:130
4454 msgid "B<DEBRELEASE_DEBS_DIR>"
4458 #: ../scripts/debc.1:108
4460 "This specifies the directory in which to look for the I<.changes>, I<.deb> "
4461 "and I<.udeb> files, and is either an absolute path or relative to the top of "
4462 "the source tree. This corresponds to the B<--debs-dir> command line "
4463 "option. This directive could be used, for example, if you always use "
4464 "B<pbuilder> or B<svn-buildpackage> to build your packages. Note that it "
4465 "also affects B<debrelease>(1) in the same way, hence the strange name of the "
4470 #: ../scripts/debc.1:108 ../scripts/debchange.1:376 ../scripts/debclean.1:100 ../scripts/debi.1:115 ../scripts/debrelease.1:125 ../scripts/debuild.1:360 ../scripts/devscripts.conf.5:42
4472 msgid "B<DEVSCRIPTS_CHECK_DIRNAME_LEVEL>, B<DEVSCRIPTS_CHECK_DIRNAME_REGEX>"
4476 #: ../scripts/debc.1:115 ../scripts/debchange.1:383 ../scripts/debclean.1:107 ../scripts/debi.1:122 ../scripts/debrelease.1:132 ../scripts/debuild.1:367
4478 "See the above section \"Directory name checking\" for an explanation of "
4479 "these variables. Note that these are package-wide configuration variables, "
4480 "and will therefore affect all B<devscripts> scripts which check their value, "
4481 "as described in their respective manpages and in B<devscripts.conf>(5)."
4485 #: ../scripts/debc.1:120
4486 msgid "B<dpkg-deb>(1), B<debdiff>(1) and B<devscripts.conf>(5)."
4490 #: ../scripts/debc.1:122
4492 "Julian Gilbey E<lt>jdg@debian.orgE<gt>, based on an original script by "
4493 "Christoph Lameter E<lt>clameter@debian.orgE<gt>."
4497 #: ../scripts/debchange.1:1
4503 #: ../scripts/debchange.1:4
4505 "debchange - Tool for maintenance of the debian/changelog file in a source "
4510 #: ../scripts/debchange.1:6
4511 msgid "B<debchange> [I<options>] [I<text> ...]"
4515 #: ../scripts/debchange.1:8
4516 msgid "B<dch> [I<options>] [I<text> ...]"
4520 #: ../scripts/debchange.1:29
4522 "B<debchange> or its alias B<dch> will add a new comment line to the Debian "
4523 "changelog in the current source tree. This command must be run from within "
4524 "that tree. If the text of the change is given on the command line, "
4525 "B<debchange> will run in batch mode and simply add the text, with line "
4526 "breaks as necessary, at the appropriate place in I<debian/changelog> (or the "
4527 "changelog specified by options, as described below). If no text is "
4528 "specified then B<debchange> will run the editor as determined by "
4529 "B<sensible-editor> for you to edit the file. (The environment variables "
4530 "B<VISUAL> and B<EDITOR> are used in this order to determine which editor to "
4531 "use.) Editors which understand the I<+n> option for starting the editing on "
4532 "a specified line will use this to move to the correct line of the file for "
4533 "editing. If the editor is quit without modifying the temporary file, "
4534 "B<debchange> will exit without touching the existing changelog. B<Note that "
4535 "the changelog is assumed to be encoded with the UTF-8 encoding. If it is "
4536 "not, problems may occur.> Please see the B<iconv>(1) manpage to find out how "
4537 "to convert changelogs from legacy encodings. Finally, a changelog or NEWS "
4538 "file can be created from scratch using the B<--create> option described "
4543 #: ../scripts/debchange.1:42
4545 "B<debchange> also supports automatically producing bug-closing changelog "
4546 "entries, using the B<--closes> option. This will usually query the BTS, the "
4547 "Debian Bug Tracking System (see http://bugs.debian.org/) to determine the "
4548 "title of the bug and the package in which it occurs. This behaviour can be "
4549 "stopped by giving a B<--noquery> option or by setting the configuration "
4550 "variable B<DEBCHANGE_QUERY_BTS> to I<no>, as described below. In either "
4551 "case, the editor (as described above) will always be invoked to give an "
4552 "opportunity to modify the entries, and the changelog will be accepted "
4553 "whether or not modifications are made. An extra changelog entry can be "
4554 "given on the command line in addition to the closes entries."
4558 #: ../scripts/debchange.1:49
4560 "At most one of B<--append>, B<--increment>, B<--edit>, B<--release>, and "
4561 "B<--newversion> may be specified as listed below. If no options are "
4562 "specified, B<debchange> will use heuristics to guess whether or not the "
4563 "package has been successfully released, and behave as if B<--increment> had "
4564 "been specified if the package has been released, or otherwise as if "
4565 "B<--append> has been specified."
4569 #: ../scripts/debchange.1:65
4571 "Two different sets of heuristics can be used, as controlled by the "
4572 "B<--release-heuristic> option or the B<DEBCHANGE_RELEASE_HEURISTIC> "
4573 "configuration variable. The default I<log> heuristic determines if a package "
4574 "has been released by looking for an appropriate B<dupload>(1) or B<dput>(1) "
4575 "log file in the parent directory. A warning will be issued if the log file "
4576 "is found but a successful upload is not recorded. This may be because the "
4577 "previous upload was performed with a version of B<dupload> prior to 2.1 or "
4578 "because the upload failed. The alternate I<changelog> heuristic assumes the "
4579 "package has been released unless its changelog contains I<UNRELEASED> in the "
4580 "distribution field. If this heuristic is enabled then the distribution will "
4581 "default to I<UNRELEASED> in new changelog entries, and the B<--mainttrailer> "
4582 "option described below will be automatically enabled. This can be useful if "
4583 "a package can be released by different maintainers, or if you do not keep "
4588 #: ../scripts/debchange.1:83
4590 "If either B<--increment> or B<--newversion> is used, the name and email for "
4591 "the new version will be determined as follows. If the environment variable "
4592 "B<DEBFULLNAME> is set, this will be used for the maintainer full name; if "
4593 "not, then B<NAME> will be checked. If the environment variable B<DEBEMAIL> "
4594 "is set, this will be used for the email address. If this variable has the "
4595 "form \"name E<lt>emailE<gt>\", then the maintainer name will also be taken "
4596 "from here if neither B<DEBFULLNAME> nor B<NAME> is set. If this variable is "
4597 "not set, the same test is performed on the environment variable B<EMAIL>. "
4598 "Next, if the full name has still not been determined, then use "
4599 "B<getpwuid>(3) to determine the name from the password file. If this fails, "
4600 "use the previous changelog entry. For the email address, if it has not been "
4601 "set from B<DEBEMAIL> or B<EMAIL>, then look in I</etc/mailname>, then "
4602 "attempt to build it from the username and FQDN, otherwise use the email "
4603 "address in the previous changelog entry. In other words, it's a good idea "
4604 "to set B<DEBEMAIL> and B<DEBFULLNAME> when using this script."
4608 #: ../scripts/debchange.1:96
4610 "Support is included for changelogs that record changes by multiple "
4611 "co-maintainers of a package. If an entry is appended to the current "
4612 "version's entries, and the maintainer is different from the maintainer who "
4613 "is listed as having done the previous entries, then lines will be added to "
4614 "the changelog to tell which maintainers made which changes. Currently only "
4615 "one of the several such styles of recording this information is supported, "
4616 "in which the name of the maintainer who made a set of changes appears on a "
4617 "line before the changes, inside square brackets. This can be switched on and "
4618 "off using the B<--[no]multimaint> option or the B<DEBCHANGE_MULTIMAINT> "
4619 "configuration file option; the default is to enable it. Note that if an "
4620 "entry has already been marked in this way, then this option will be silently "
4625 #: ../scripts/debchange.1:102
4627 "If the directory name of the source tree has the form I<package>-I<version>, "
4628 "then B<debchange> will also attempt to rename it if the (upstream) version "
4629 "number changes. This can be prevented by using the B<--preserve> command "
4630 "line or configuration file option as described below."
4634 #: ../scripts/debchange.1:106
4636 "If B<--force-bad-version> or B<--allow-lower-version> is used, B<debchange> "
4637 "will not stop if the new version is less than the current one. This is "
4638 "especially useful while doing backports."
4642 #: ../scripts/debchange.1:117
4644 "In common with several other scripts in the B<devscripts> package, "
4645 "B<debchange> will climb the directory tree until it finds a "
4646 "I<debian/changelog> file. As a safeguard against stray files causing "
4647 "potential problems, it will examine the name of the parent directory once it "
4648 "finds the I<debian/changelog> file, and check that the directory name "
4649 "corresponds to the package name. Precisely how it does this is controlled "
4650 "by two configuration file variables DEVSCRIPTS_CHECK_DIRNAME_LEVEL and "
4651 "DEVSCRIPTS_CHECK_DIRNAME_REGEX, and their corresponding command-line options "
4652 "B<--check-dirname-level> and B<--check-dirname-regex>."
4656 #: ../scripts/debchange.1:146
4658 "The default changelog to be edited is I<debian/changelog>; however, this can "
4659 "be changed using the B<--changelog> or B<--news> options or the CHANGELOG "
4660 "environment variable, as described below."
4664 #: ../scripts/debchange.1:147
4666 msgid "B<--append>, B<-a>"
4670 #: ../scripts/debchange.1:150
4671 msgid "Add a new changelog entry at the end of the current version's entries."
4675 #: ../scripts/debchange.1:150
4677 msgid "B<--increment>, B<-i>"
4681 #: ../scripts/debchange.1:157
4683 "Increment either the final component of the Debian release number or, if "
4684 "this is a native Debian package, the version number. This creates a new "
4685 "section at the beginning of the changelog with appropriate headers and "
4686 "footers. Also, if this is a new version of a native Debian package, the "
4687 "directory name is changed to reflect this."
4691 #: ../scripts/debchange.1:157
4693 msgid "B<--newversion >I<version>, B<-v >I<version>"
4697 #: ../scripts/debchange.1:163
4699 "This specifies the version number (including the Debian release part) "
4700 "explicitly and behaves as the B<--increment> option in other respects. It "
4701 "will also change the directory name if the upstream version number has "
4706 #: ../scripts/debchange.1:163
4708 msgid "B<--edit>, B<-e>"
4712 #: ../scripts/debchange.1:166
4713 msgid "Edit the changelog in an editor."
4717 #: ../scripts/debchange.1:166
4719 msgid "B<--release>, B<-r>"
4723 #: ../scripts/debchange.1:174
4725 "Finalize the changelog for a release. Update the changelog timestamp. If "
4726 "the distribution is set to I<UNRELEASED>, change it to the distribution from "
4727 "the previous changelog entry (or another distribution as specified by "
4728 "B<--distribution>). If there are no previous changelog entries and an "
4729 "explicit distribution has not been specified, I<unstable> will be used."
4733 #: ../scripts/debchange.1:174
4735 msgid "B<--force-save-on-release>"
4739 #: ../scripts/debchange.1:179
4741 "When --release is used and an editor opened to allow inspection of the "
4742 "changelog, require the user to save the changelog their editor opened. "
4743 "Otherwise, the original changelog will not be modified. (default)"
4747 #: ../scripts/debchange.1:179
4749 msgid "B<--no-force-save-on-release>"
4753 #: ../scripts/debchange.1:185
4755 "Do not do so. Note that a dummy changelog entry made be supplied in order to "
4756 "achieve the same effect - e.g. B<debchange --release \"\">. The entry will "
4757 "not be added to the changelog but its presence will suppress the editor."
4761 #: ../scripts/debchange.1:197
4763 "This will create a new I<debian/changelog> file (or I<NEWS> if the B<--news> "
4764 "option is used). You must be in the top-level directory to use this; no "
4765 "directory name checking will be performed. The package name and version can "
4766 "either be specified using the B<--package> and B<--newversion> options, "
4767 "determined from the directory name using the B<--fromdirname> option or "
4768 "entered manually into the generated changelog file. The maintainer name is "
4769 "determined from the environment if this is possible, and the distribution is "
4770 "specified either using the B<--distribution> option or in the generated "
4775 #: ../scripts/debchange.1:197
4781 #: ../scripts/debchange.1:204
4783 "When used in combination with B<--create>, suppress the automatic addition "
4784 "of an \"initial release\" changelog entry (so that the next invocation of "
4785 "B<debchange> adds the first entry). Note that this will cause a "
4786 "B<dpkg-parsechangelog> warning on the next invocation due to the lack of "
4791 #: ../scripts/debchange.1:204 ../scripts/uscan.1:390
4793 msgid "B<--package> I<package>"
4797 #: ../scripts/debchange.1:209
4799 "This specifies the package name to be used in the new changelog; this may "
4800 "only be used in conjunction with the B<--create>, B<--increment> and "
4801 "B<--newversion> options."
4805 #: ../scripts/debchange.1:209
4807 msgid "B<--nmu>, B<-n>"
4811 #: ../scripts/debchange.1:218
4813 "Increment the Debian release number for a non-maintainer upload by either "
4814 "appending a \".1\" to a non-NMU version number (unless the package is Debian "
4815 "native, in which case \"+nmu1\" is appended) or by incrementing an NMU "
4816 "version number, and add an NMU changelog comment. This happens "
4817 "automatically if the packager is neither in the Maintainer nor the Uploaders "
4818 "field in I<debian/control>, unless B<DEBCHANGE_AUTO_NMU> is set to I<no> or "
4819 "the B<--no-auto-nmu> option is used."
4823 #: ../scripts/debchange.1:218
4825 msgid "B<--bin-nmu>"
4829 #: ../scripts/debchange.1:223
4831 "Increment the Debian release number for a binary non-maintainer upload by "
4832 "either appending a \"+b1\" to a non-binNMU version number or by incrementing "
4833 "a binNMU version number, and add a binNMU changelog comment."
4837 #: ../scripts/debchange.1:223
4839 msgid "B<--qa>, B<-q>"
4843 #: ../scripts/debchange.1:227
4845 "Increment the Debian release number for a Debian QA Team upload, and add a "
4846 "QA upload changelog comment."
4850 #: ../scripts/debchange.1:227
4852 msgid "B<--security>, B<-s>"
4856 #: ../scripts/debchange.1:231
4858 "Increment the Debian release number for a Debian Security Team "
4859 "non-maintainer upload, and add a Security Team upload changelog comment."
4863 #: ../scripts/debchange.1:231
4869 #: ../scripts/debchange.1:235
4871 "Increment the Debian release number for a team upload, and add a team upload "
4872 "changelog comment."
4876 #: ../scripts/debchange.1:235
4882 #: ../scripts/debchange.1:239
4884 "Increment the Debian release number for an upload to lenny-backports, and "
4885 "add a backport upload changelog comment."
4889 #: ../scripts/debchange.1:239
4891 msgid "B<--local>, B<-l>I<suffix>"
4895 #: ../scripts/debchange.1:242
4897 msgid " Add a suffix to the Debian version number for a local build.\n"
4901 #: ../scripts/debchange.1:242
4903 msgid "B<--force-bad-version>, B<-b>"
4907 #: ../scripts/debchange.1:246
4909 "Force a version number to be less than the current one (e.g., when "
4914 #: ../scripts/debchange.1:246
4916 msgid "B<--allow-lower-version>"
4920 #: ../scripts/debchange.1:250
4922 "Allow a version number to be less than the current one if the new version "
4923 "matches the specified pattern."
4927 #: ../scripts/debchange.1:250
4929 msgid "B<--force-distribution>"
4933 #: ../scripts/debchange.1:254
4935 "Force the provided distribution to be used, even if it doesn't match the "
4936 "list of known distributions (e.g. for unofficial distributions)."
4940 #: ../scripts/debchange.1:254
4942 msgid "B<--auto-nmu>"
4946 #: ../scripts/debchange.1:258
4948 "Attempt to automatically determine whether a change to the changelog "
4949 "represents a Non Maintainer Upload. This is the default."
4953 #: ../scripts/debchange.1:258
4955 msgid "B<--no-auto-nmu>"
4959 #: ../scripts/debchange.1:262
4961 "Disable automatic NMU detection. Equivalent to setting "
4962 "B<DEBCHANGE_AUTO_NMU> to I<no>."
4966 #: ../scripts/debchange.1:262
4968 msgid "B<--fromdirname>, B<-d>"
4972 #: ../scripts/debchange.1:272
4974 "This will take the upstream version number from the directory name, which "
4975 "should be of the form I<package>-I<version>. If the upstream version number "
4976 "has increased from the most recent changelog entry, then a new entry will be "
4977 "made with version number I<version>-1 (or I<version> if the package is "
4978 "Debian native), with the same epoch as the previous package version. If the "
4979 "upstream version number is the same, this option will behave in the same way "
4984 #: ../scripts/debchange.1:272
4986 msgid "B<--closes>I< nnnnn,[nnnnn,...]>"
4990 #: ../scripts/debchange.1:278
4992 "Add changelog entries to close the specified bug numbers. Also invoke the "
4993 "editor after adding these entries. Will generate warnings if the BTS cannot "
4994 "be contacted (and B<--noquery> has not been specified), or if there are "
4995 "problems with the bug report located."
4999 #: ../scripts/debchange.1:278
5001 msgid "B<--[no]query>"
5005 #: ../scripts/debchange.1:281
5006 msgid "Should we attempt to query the BTS when generating closes entries?"
5010 #: ../scripts/debchange.1:281
5012 msgid "B<--preserve>, B<-p>"
5016 #: ../scripts/debchange.1:286
5018 "Preserve the source tree directory name if the upstream version number (or "
5019 "the version number of a Debian native package) changes. See also the "
5020 "configuration variables section below."
5024 #: ../scripts/debchange.1:286
5026 msgid " B<--no-preserve>, B<--nopreserve>"
5030 #: ../scripts/debchange.1:289
5031 msgid "Do not preserve the source tree directory name (default)."
5035 #: ../scripts/debchange.1:289
5037 msgid "B<--distribution >I<dist>, B<-D >I<dist>"
5041 #: ../scripts/debchange.1:294
5043 "Use the specified distribution in the changelog entry being edited, instead "
5044 "of using the previous changelog entry's distribution for new entries or the "
5045 "existing value for existing entries."
5049 #: ../scripts/debchange.1:294
5051 msgid "B<--urgency >I<urgency>, B<-u >I<urgency>"
5055 #: ../scripts/debchange.1:299
5057 "Use the specified urgency in the changelog entry being edited, instead of "
5058 "using the default \"low\" for new entries or the existing value for existing "
5063 #: ../scripts/debchange.1:299
5065 msgid "B<--changelog >I<file>, B<-c >I<file>"
5069 #: ../scripts/debchange.1:305
5071 "This will edit the changelog I<file> instead of the standard "
5072 "I<debian/changelog>. This option overrides any CHANGELOG environment "
5073 "variable setting. Also, no directory traversing or checking will be "
5074 "performed when this option is used."
5078 #: ../scripts/debchange.1:305
5080 msgid "B<--news> [I<newsfile>]"
5084 #: ../scripts/debchange.1:311
5086 "This will edit I<newsfile> (by default, I<debian/NEWS>) instead of the "
5087 "regular changelog. Directory searching will be performed. The changelog "
5088 "will be examined in order to determine the current package version."
5092 #: ../scripts/debchange.1:311
5094 msgid "B<--[no]multimaint>"
5098 #: ../scripts/debchange.1:316
5100 "Should we indicate that parts of a changelog entry have been made by "
5101 "different maintainers? Default is yes; see the discussion above and also the "
5102 "B<DEBCHANGE_MULTIMAINT> configuration file option below."
5106 #: ../scripts/debchange.1:316
5108 msgid "B<--[no]multimaint-merge>"
5112 #: ../scripts/debchange.1:321
5114 "Should all changes made by the same author be merged into the same changelog "
5115 "section? Default is no; see the discussion above and also the "
5116 "B<DEBCHANGE_MULTIMAINT_MERGE> configuration file option below."
5120 #: ../scripts/debchange.1:321
5122 msgid "B<--maintmaint>, B<-m>"
5126 #: ../scripts/debchange.1:329
5128 "Do not modify the maintainer details previously listed in the changelog. "
5129 "This is useful particularly for sponsors wanting to automatically add a "
5130 "sponsorship message without disrupting the other changelog details. Note "
5131 "that there may be some interesting interactions if multi-maintainer mode is "
5132 "in use; you will probably wish to check the changelog manually before "
5133 "uploading it in such cases."
5137 #: ../scripts/debchange.1:329
5139 msgid "B<--[no]mainttrailer>, B<-t>"
5143 #: ../scripts/debchange.1:339
5145 "If mainttrailer is set, it will avoid modifying the existing changelog "
5146 "trailer line (i.e. the maintainer and date-stamp details), unless used with "
5147 "options that require the trailer to be modified (e.g. B<--create>, "
5148 "B<--release>, B<-i>, B<--qa>, etc.) This option differs from "
5149 "B<--maintmaint> in that it will use multi-maintainer mode if appropriate, "
5150 "with the exception of editing the trailer. See also the "
5151 "B<DEBCHANGE_MAINTTRAILER> configuration file option below."
5155 #: ../scripts/debchange.1:351
5157 msgid "B<--release-heuristic> I<log|changelog>"
5161 #: ../scripts/debchange.1:356
5163 "Controls how B<debchange> determines if a package has been released, when "
5164 "deciding whether to create a new changelog entry or append to an existing "
5169 #: ../scripts/debchange.1:362 ../scripts/debclean.1:90 ../scripts/debrelease.1:105 ../scripts/debsign.1:111 ../scripts/dscverify.1:42 ../scripts/nmudiff.1:79 ../scripts/pts-subscribe.1:34 ../scripts/uupdate.1:88 ../scripts/who-uploads.1:50
5170 msgid "Display version and copyright information and exit successfully."
5174 #: ../scripts/debchange.1:368
5176 msgid "B<DEBCHANGE_PRESERVE>"
5180 #: ../scripts/debchange.1:372
5182 "If this is set to I<yes>, then it is the same as the B<--preserve> command "
5183 "line parameter being used."
5187 #: ../scripts/debchange.1:372
5189 msgid "B<DEBCHANGE_QUERY_BTS>"
5193 #: ../scripts/debchange.1:376
5195 "If this is set to I<no>, then it is the same as the B<--noquery> command "
5196 "line parameter being used."
5200 #: ../scripts/debchange.1:383
5202 msgid "B<DEBCHANGE_RELEASE_HEURISTIC>"
5206 #: ../scripts/debchange.1:388
5208 "Controls how B<debchange> determines if a package has been released, when "
5209 "deciding whether to create a new changelog entry or append to an existing "
5210 "changelog entry. Can be either I<log> or I<changelog>."
5214 #: ../scripts/debchange.1:388
5216 msgid "B<DEBCHANGE_MULTIMAINT>"
5220 #: ../scripts/debchange.1:393
5222 "If set to I<no>, B<debchange> will not introduce multiple-maintainer "
5223 "distinctions when a different maintainer appends an entry to an existing "
5224 "changelog. See the discussion above. Default is I<yes>."
5228 #: ../scripts/debchange.1:393
5230 msgid "B<DEBCHANGE_MULTIMAINT_MERGE>"
5234 #: ../scripts/debchange.1:399
5236 "If set to I<yes>, when adding changes in multiple-maintainer mode "
5237 "B<debchange> will check whether previous changes by the current maintainer "
5238 "exist and add the new changes to the existing block rather than creating a "
5239 "new block. Default is I<no>."
5243 #: ../scripts/debchange.1:399
5245 msgid "B<DEBCHANGE_MAINTTRAILER>"
5249 #: ../scripts/debchange.1:403
5251 "If this is set to I<no>, then it is the same as the B<--nomainttrailer> "
5252 "command line parameter being used."
5256 #: ../scripts/debchange.1:403
5258 msgid "B<DEBCHANGE_TZ>"
5262 #: ../scripts/debchange.1:407
5264 "Use this timezone for changelog entries. Default is the user/system "
5265 "timezone as shown by `date -R` and affected by the environment variable TZ."
5269 #: ../scripts/debchange.1:407
5271 msgid "B<DEBCHANGE_LOWER_VERSION_PATTERN>"
5275 #: ../scripts/debchange.1:411
5277 "If this is set, then it is the same as the B<--allow-lower-version> command "
5278 "line parameter being used."
5282 #: ../scripts/debchange.1:411
5284 msgid "B<DEBCHANGE_AUTO_NMU>"
5288 #: ../scripts/debchange.1:417
5290 "If this is set to I<no> then B<debchange> will not attempt to automatically "
5291 "determine whether the current changelog stanza represents an NMU. The "
5292 "default is I<yes>. See the discussion of the B<--nmu> option above."
5296 #: ../scripts/debchange.1:417
5298 msgid "B<DEBCHANGE_FORCE_SAVE_ON_RELEASE>"
5302 #: ../scripts/debchange.1:421
5304 "If this is set to I<no>, then it is the same as the "
5305 "B<--no-force-save-on-release> command line parameter being used."
5309 #: ../scripts/debchange.1:421 ../scripts/devscripts.1:16 ../scripts/devscripts.1:20 ../scripts/mass-bug.pl:128
5315 #: ../scripts/debchange.1:422
5317 msgid "B<DEBEMAIL>, B<EMAIL>, B<DEBFULLNAME>, B<NAME>"
5321 #: ../scripts/debchange.1:425
5322 msgid "See the above description of the use of these environment variables."
5326 #: ../scripts/debchange.1:425
5328 msgid "B<CHANGELOG>"
5332 #: ../scripts/debchange.1:431
5334 "This variable specifies the changelog to edit in place of "
5335 "I<debian/changelog>. No directory traversal or checking is performed when "
5336 "this variable is set. This variable is overridden by the B<--changelog> "
5337 "command-line setting."
5341 #: ../scripts/debchange.1:431
5343 msgid "B<VISUAL>, B<EDITOR>"
5347 #: ../scripts/debchange.1:435
5349 "These environment variables (in this order) determine the editor used by "
5350 "B<sensible-editor>."
5354 #: ../scripts/debchange.1:442
5356 "B<debclean>(1), B<dupload>(1), B<dput>(1), B<debc>(1) and "
5357 "B<devscripts.conf>(5)."
5361 #: ../scripts/debchange.1:445
5363 "The original author was Christoph Lameter E<lt>clameter@debian.orgE<gt>. "
5364 "Many substantial changes and improvements were made by Julian Gilbey "
5365 "E<lt>jdg@debian.orgE<gt>."
5369 #: ../scripts/debcheckout.pl:25
5370 msgid "debcheckout - checkout the development repository of a Debian package"
5374 #: ../scripts/debcheckout.pl:31
5375 msgid "B<debcheckout> [I<OPTIONS>] I<PACKAGE> [I<DESTDIR>]"
5379 #: ../scripts/debcheckout.pl:33
5380 msgid "B<debcheckout> [I<OPTIONS>] I<REPOSITORY_URL> [I<DESTDIR>]"
5384 #: ../scripts/debcheckout.pl:35
5385 msgid "B<debcheckout> B<--help>"
5389 #: ../scripts/debcheckout.pl:41
5391 "B<debcheckout> retrieves the information about the Version Control System "
5392 "used to maintain a given Debian package (the I<PACKAGE> argument), and then "
5393 "checks out the latest (potentially unreleased) version of the package from "
5394 "its repository. By default the repository is checked out to the I<PACKAGE> "
5395 "directory; this can be overridden by providing the I<DESTDIR> argument."
5399 #: ../scripts/debcheckout.pl:47
5401 "The information about where the repository is available is expected to be "
5402 "found in B<Vcs-*> fields available in the source package record. For "
5403 "example, the vim package exposes such information with a field like "
5404 "S<Vcs-Git: git://git.debian.org/git/pkg-vim/vim.git>, you can see it by "
5405 "grepping through C<apt-cache showsrc vim>."
5409 #: ../scripts/debcheckout.pl:53
5411 "If more than one source package record containing B<Vcs-*> fields is "
5412 "available, B<debcheckout> will select the record with the highest version "
5413 "number. Alternatively, a particular version may be selected from those "
5414 "available by specifying the package name as I<PACKAGE>=I<VERSION>."
5418 #: ../scripts/debcheckout.pl:58
5420 "If you already know the URL of a given repository you can invoke debcheckout "
5421 "directly on it, but you will probably need to pass the appropriate B<-t> "
5422 "flag. That is, some heuristics are in use to guess the repository type from "
5423 "the URL; if they fail, you might want to override the guessed type using "
5428 #: ../scripts/debcheckout.pl:64
5430 "The currently supported version control systems are: arch, bzr, cvs, darcs, "
5435 #: ../scripts/debcheckout.pl:69
5436 msgid "B<GENERAL OPTIONS>"
5440 #: ../scripts/debcheckout.pl:73
5441 msgid "B<-a>, B<--auth>"
5445 #: ../scripts/debcheckout.pl:75
5447 "Work in authenticated mode; this means that for known repositories (mainly "
5448 "those hosted on S<http://alioth.debian.org>) URL rewriting is attempted "
5449 "before checking out, to ensure that the repository can be committed to. For "
5450 "example, for subversion repositories hosted on alioth this means that "
5451 "S<svn+ssh://svn.debian.org/...> will be used instead of "
5452 "S<svn://svn.debian.org/...>."
5456 #: ../scripts/debcheckout.pl:82
5457 msgid "B<-d>, B<--details>"
5461 #: ../scripts/debcheckout.pl:84
5463 "Only print a list of detailed information about the package repository, "
5464 "without checking it out; the output format is a list of fields, each field "
5465 "being a pair of TAB-separated field name and field value. The actual fields "
5466 "depend on the repository type. This action might require a network "
5467 "connection to the remote repository."
5471 #: ../scripts/debcheckout.pl:90
5472 msgid "Also see B<-p>. This option and B<-p> are mutually exclusive."
5476 #: ../scripts/debcheckout.pl:94
5477 msgid "Print a detailed help message and exit."
5481 #: ../scripts/debcheckout.pl:96
5482 msgid "B<-p>, B<--print>"
5486 #: ../scripts/debcheckout.pl:98
5488 "Only print a summary about package repository information, without checking "
5489 "it out; the output format is TAB-separated with two fields: repository type, "
5490 "repository URL. This action works offline, it only uses \"static\" "
5491 "information as known by APT's cache."
5495 #: ../scripts/debcheckout.pl:103
5496 msgid "Also see B<-d>. This option and B<-d> are mutually exclusive."
5500 #: ../scripts/debcheckout.pl:105
5501 msgid "B<-t> I<TYPE>, B<--type> I<TYPE>"
5505 #: ../scripts/debcheckout.pl:107
5507 "Override the repository type (which defaults to some heuristics based on the "
5508 "URL or, in case of heuristic failure, the fallback \"svn\"); should be one "
5509 "of the currently supported repository types."
5513 #: ../scripts/debcheckout.pl:111
5514 msgid "B<-u> I<USERNAME>, B<--user> I<USERNAME>"
5518 #: ../scripts/debcheckout.pl:113
5520 "Specify the login name to be used in authenticated mode (see B<-a>). This "
5521 "option implies B<-a>: you don't need to specify both."
5525 #: ../scripts/debcheckout.pl:116
5526 msgid "B<-f>, B<--file>"
5530 #: ../scripts/debcheckout.pl:118
5532 "Specify that the named file should be extracted from the repository and "
5533 "placed in the destination directory. May be used more than once to extract "
5538 #: ../scripts/debcheckout.pl:124
5539 msgid "B<VCS-SPECIFIC OPTIONS>"
5543 #: ../scripts/debcheckout.pl:126
5544 msgid "I<GIT-SPECIFIC OPTIONS>"
5548 #: ../scripts/debcheckout.pl:130
5549 msgid "B<--git-track> I<BRANCHES>"
5553 #: ../scripts/debcheckout.pl:132
5555 "Specify a list of remote branches which will be set up for tracking (as in "
5556 "S<git branch --track>, see git-branch(1)) after the remote GIT repository "
5557 "has been cloned. The list should be given as a space-separated list of "
5562 #: ../scripts/debcheckout.pl:137
5564 "As a shorthand, the string \"*\" can be given to require tracking of all "
5569 #: ../scripts/debcheckout.pl:144 ../scripts/rmadison.pl:268
5571 "The two configuration files F</etc/devscripts.conf> and F<~/.devscripts> are "
5572 "sourced by a shell in that order to set configuration variables. Command "
5573 "line options can be used to override configuration file "
5574 "settings. Environment variable settings are ignored for this purpose. The "
5575 "currently recognised variables are:"
5579 #: ../scripts/debcheckout.pl:152
5580 msgid "B<DEBCHECKOUT_AUTH_URLS>"
5584 #: ../scripts/debcheckout.pl:154
5586 "This variable should be a space separated list of Perl regular expressions "
5587 "and replacement texts, which must come in pairs: REGEXP TEXT REGEXP TEXT "
5588 "... and so on. Each pair denotes a substitution which is applied to "
5589 "repository URLs if other built-in means of building URLs for authenticated "
5590 "mode (see B<-a>) have failed."
5594 #: ../scripts/debcheckout.pl:160
5596 "References to matching substrings in the replacement texts are allowed as "
5597 "usual in Perl by the means of $1, $2, ... and so on."
5601 #: ../scripts/debcheckout.pl:163
5603 "This setting can be used to enable authenticated mode for most repositories "
5604 "out there. Note that the Debian repositories on S<alioth.debian.org> "
5605 "(S<$vcs.debian.org>) are implicitly defined."
5609 #: ../scripts/debcheckout.pl:167
5610 msgid "Here is a sample snippet suitable for the configuration files:"
5614 #: ../scripts/debcheckout.pl:169
5617 " DEBCHECKOUT_AUTH_URLS='\n"
5618 " ^\\w+://(svn\\.example\\.com)/(.*) svn+ssh://$1/srv/svn/$2\n"
5619 " ^\\w+://(git\\.example\\.com)/(.*) git+ssh://$1/home/git/$2\n"
5625 #: ../scripts/debcheckout.pl:174
5627 "Note that whitespace is not allowed in either regexps or replacement "
5628 "texts. Also, given that configuration files are sourced by a shell, you "
5629 "probably want to use single quotes around the value of this variable."
5633 #: ../scripts/debcheckout.pl:183
5635 "apt-cache(8), Section 6.2.5 of the Debian Developer's Reference (for more "
5636 "information about Vcs-* fields): "
5637 "S<http://www.debian.org/doc/developers-reference/best-pkging-practices.html#bpp-vcs>"
5641 #: ../scripts/debcheckout.pl:188
5643 "debcheckout and this manpage have been written by Stefano Zacchiroli "
5648 #: ../scripts/debclean.1:1
5654 #: ../scripts/debclean.1:4
5655 msgid "debclean - clean up a sourcecode tree"
5659 #: ../scripts/debclean.1:6
5660 msgid "B<debclean> [I<options>]"
5664 #: ../scripts/debclean.1:13
5666 "B<debclean> walks through the directory tree starting at the directory tree "
5667 "in which it was invoked, and executes I<debian/rules clean> for each Debian "
5668 "source directory encountered. These directories are recognised by "
5669 "containing a debian/changelog file for a package whose name matches that of "
5670 "the directory. Name matching is described below."
5674 #: ../scripts/debclean.1:22
5676 "Also, if the B<--cleandebs> option is given, then in every directory "
5677 "containing a Debian source tree, all files named *.deb, *.changes and "
5678 "*.build are removed. The .dsc, .diff.gz and the (.orig).tar.gz files are "
5679 "not touched so that the release can be reconstructed if necessary, and the "
5680 ".upload files are left so that B<debchange> functions correctly. The "
5681 "B<--nocleandebs> option prevents this extra cleaning behaviour and the "
5682 "B<--cleandebs> option forces it. The default is not to clean these files."
5686 #: ../scripts/debclean.1:24
5687 msgid "B<debclean> uses B<debuild>(1) to clean the source tree."
5691 #: ../scripts/debclean.1:35
5693 "In common with several other scripts in the B<devscripts> package, "
5694 "B<debclean> will walk through the directory tree searching for "
5695 "I<debian/changelog> files. As a safeguard against stray files causing "
5696 "potential problems, it will examine the name of the parent directory once it "
5697 "finds a I<debian/changelog> file, and check that the directory name "
5698 "corresponds to the package name. Precisely how it does this is controlled "
5699 "by two configuration file variables DEVSCRIPTS_CHECK_DIRNAME_LEVEL and "
5700 "DEVSCRIPTS_CHECK_DIRNAME_REGEX, and their corresponding command-line options "
5701 "B<--check-dirname-level> and B<--check-dirname-regex>."
5705 #: ../scripts/debclean.1:61
5707 msgid "B<--cleandebs>"
5711 #: ../scripts/debclean.1:65
5712 msgid "Also remove all .deb, .changes and .build files from the parent directory."
5716 #: ../scripts/debclean.1:65
5718 msgid "B<--nocleandebs>"
5722 #: ../scripts/debclean.1:69
5724 "Do not remove the .deb, .changes and .build files from the parent directory; "
5725 "this is the default behaviour."
5729 #: ../scripts/debclean.1:81 ../scripts/debuild.1:284
5735 #: ../scripts/debclean.1:84
5736 msgid "Do not run dpkg-checkbuilddeps to check build dependencies."
5740 #: ../scripts/debclean.1:96
5742 msgid "B<DEBCLEAN_CLEANDEBS>"
5746 #: ../scripts/debclean.1:100
5748 "If this is set to I<yes>, then it is the same as the B<--cleandebs> command "
5749 "line parameter being used."
5753 #: ../scripts/debclean.1:111
5754 msgid "B<debuild>(1) and B<devscripts.conf>(5)."
5758 #: ../scripts/debclean.1:113
5760 "Christoph Lameter E<lt>clameter@debian.orgE<gt>; modifications by Julian "
5761 "Gilbey E<lt>jdg@debian.orgE<gt>."
5765 #: ../scripts/debcommit.pl:5
5766 msgid "debcommit - commit changes to a package"
5770 #: ../scripts/debcommit.pl:9
5772 "B<debcommit> [B<--release>] [B<--release-use-changelog>] "
5773 "[B<--message=>I<text>] [B<--noact>] [B<--diff>] [B<--confirm>] [B<--edit>] "
5774 "[B<--changelog=>I<path>] [B<--all> | I<files to commit>]"
5778 #: ../scripts/debcommit.pl:13
5780 "B<debcommit> generates a commit message based on new text in "
5781 "B<debian/changelog>, and commits the change to a package's repository. It "
5782 "must be run in a working copy for the package. Supported version control "
5783 "systems are: B<cvs>, B<git>, B<hg> (mercurial), B<svk>, B<svn> (subversion), "
5784 "B<baz>, B<bzr>, B<tla> (arch), B<darcs>."
5788 #: ../scripts/debcommit.pl:23
5789 msgid "B<-c> B<--changelog> I<path>"
5793 #: ../scripts/debcommit.pl:25
5795 "Specify an alternate location for the changelog. By default debian/changelog "
5800 #: ../scripts/debcommit.pl:28
5801 msgid "B<-r> B<--release>"
5805 #: ../scripts/debcommit.pl:30
5807 "Commit a release of the package. The version number is determined from "
5808 "debian/changelog, and is used to tag the package in the repository."
5812 #: ../scripts/debcommit.pl:33
5814 "Note that svn/svk tagging conventions vary, so debcommit uses svnpath(1) to "
5815 "determine where the tag should be placed in the repository."
5819 #: ../scripts/debcommit.pl:37
5820 msgid "B<-R> B<--release-use-changelog>"
5824 #: ../scripts/debcommit.pl:39
5826 "When used in conjunction with --release, if there are uncommited changes to "
5827 "the changelog then derive the commit message from those changes rather than "
5828 "using the default message."
5832 #: ../scripts/debcommit.pl:43
5833 msgid "B<-m> I<text> B<--message> I<text>"
5837 #: ../scripts/debcommit.pl:45
5839 "Specify a commit message to use. Useful if the program cannot determine a "
5840 "commit message on its own based on debian/changelog, or if you want to "
5841 "override the default message."
5845 #: ../scripts/debcommit.pl:49
5846 msgid "B<-n> B<--noact>"
5850 #: ../scripts/debcommit.pl:51
5851 msgid "Do not actually do anything, but do print the commands that would be run."
5855 #: ../scripts/debcommit.pl:53
5856 msgid "B<-d> B<--diff>"
5860 #: ../scripts/debcommit.pl:55
5862 "Instead of committing, do print the diff of what would have been committed "
5863 "if this option were not given. A typical usage scenario of this option is "
5864 "the generation of patches against the current working copy (e.g. when you "
5865 "don't have commit access right)."
5869 #: ../scripts/debcommit.pl:60
5870 msgid "B<-C> B<--confirm>"
5874 #: ../scripts/debcommit.pl:62
5876 "Display the generated commit message and ask for confirmation before "
5877 "committing it. It is also possible to edit the message at this stage; in "
5878 "this case, the confirmation prompt will be re-displayed after the editing "
5879 "has been performed."
5883 #: ../scripts/debcommit.pl:66
5884 msgid "B<-e> B<--edit>"
5888 #: ../scripts/debcommit.pl:68
5890 "Edit the generated commit message in your favorite editor before committing "
5895 #: ../scripts/debcommit.pl:71
5896 msgid "B<-a> B<--all>"
5900 #: ../scripts/debcommit.pl:73
5902 "Commit all files. This is the default operation when using a VCS other than "
5907 #: ../scripts/debcommit.pl:76
5908 msgid "I<files to commit>"
5912 #: ../scripts/debcommit.pl:78
5914 "Specify which files to commit (debian/changelog is added to the list "
5919 #: ../scripts/debcommit.pl:81
5920 msgid "B<-s> B<--strip-message>, B<--no-strip-message>"
5924 #: ../scripts/debcommit.pl:83
5926 "If this option is set and the commit message has been derived from the "
5927 "changelog, the characters \"* \" will be stripped from the beginning of the "
5932 #: ../scripts/debcommit.pl:87
5934 "This option is set by default and ignored if more than one line of the "
5935 "message begins with \"[*+-] \"."
5939 #: ../scripts/debcommit.pl:90
5940 msgid "B<--sign-tags>, B<--no-sign-tags>"
5944 #: ../scripts/debcommit.pl:92
5946 "If this option is set, then tags that debcommit creates will be signed using "
5947 "gnupg. Currently this is only supported by git."
5951 #: ../scripts/debcommit.pl:107
5952 msgid "B<DEBCOMMIT_STRIP_MESSAGE>"
5956 #: ../scripts/debcommit.pl:109
5958 "If this is set to I<no>, then it is the same as the --no-strip-message "
5959 "command line parameter being used. The default is I<yes>."
5963 #: ../scripts/debcommit.pl:112
5964 msgid "B<DEBCOMMIT_SIGN_TAGS>"
5968 #: ../scripts/debcommit.pl:114
5970 "If this is set to I<yes>, then it is the same as the --sign-tags command "
5971 "line parameter being used. The default is I<no>."
5975 #: ../scripts/debcommit.pl:117
5976 msgid "B<DEBCOMMIT_RELEASE_USE_CHANGELOG>"
5980 #: ../scripts/debcommit.pl:119
5982 "If this is set to I<yes>, then it is the same as the --release-use-changelog "
5983 "command line parameter being used. The default is I<no>."
5987 #: ../scripts/debcommit.pl:122 ../scripts/debsign.1:127
5989 msgid "B<DEBSIGN_KEYID>"
5993 #: ../scripts/debcommit.pl:124
5995 "This is the key id used for signing tags. If not set, a default will be "
5996 "chosen by the revision control system."
6000 #: ../scripts/debcommit.pl:129
6001 msgid "VCS SPECIFIC FEATURES"
6005 #: ../scripts/debcommit.pl:133
6006 msgid "B<tla> / B<baz>"
6010 #: ../scripts/debcommit.pl:135
6012 "If the commit message contains more than 72 characters, a summary will be "
6013 "created containing as many full words from the message as will fit within 72 "
6014 "characters, followed by an ellipsis."
6018 #: ../scripts/debcommit.pl:141
6020 "Each of the features described below is applicable only if the commit "
6021 "message has been automatically determined from the changelog."
6025 #: ../scripts/debcommit.pl:146
6030 #: ../scripts/debcommit.pl:148
6032 "If only a single change is detected in the changelog, B<debcommit> will "
6033 "unfold it to a single line and behave as if --strip-message was used."
6037 #: ../scripts/debcommit.pl:151
6039 "Otherwise, the first change will be unfolded and stripped to form a summary "
6040 "line and a commit message formed using the summary line followed by a blank "
6041 "line and the changes as extracted from the changelog. B<debcommit> will then "
6042 "spawn an editor so that the message may be fine-tuned before committing."
6046 #: ../scripts/debcommit.pl:156
6047 msgid "B<hg> / B<darcs>"
6051 #: ../scripts/debcommit.pl:158
6053 "The first change detected in the changelog will be unfolded to form a single "
6054 "line summary. If multiple changes were detected then an editor will be "
6055 "spawned to allow the message to be fine-tuned."
6059 #: ../scripts/debcommit.pl:162
6064 #: ../scripts/debcommit.pl:164
6066 "If the changelog entry used for the commit message closes any bugs then "
6067 "--fixes options to \"bzr commit\" will be generated to associate the "
6068 "revision and the bugs."
6072 #: ../scripts/debcommit.pl:843 ../scripts/mass-bug.pl:523
6073 msgid "Joey Hess <joeyh@debian.org>"
6077 #: ../scripts/debcommit.pl:847
6082 #: ../scripts/debdiff.1:1
6088 #: ../scripts/debdiff.1:4
6089 msgid "debdiff - compare file lists in two Debian packages"
6093 #: ../scripts/debdiff.1:6
6094 msgid "B<debdiff> [I<options>]"
6098 #: ../scripts/debdiff.1:8
6099 msgid "B<debdiff> [I<options>] ... I<deb1 deb2>"
6103 #: ../scripts/debdiff.1:10
6104 msgid "B<debdiff> [I<options>] ... I<changes1 changes2>"
6108 #: ../scripts/debdiff.1:13
6110 "B<debdiff> [I<options>] ... B<--from >I<deb1a deb1b ... >B<--to >I<deb2a "
6115 #: ../scripts/debdiff.1:15
6116 msgid "B<debdiff> [I<options>] ... I<dsc1 dsc2>"
6120 #: ../scripts/debdiff.1:24
6122 "B<debdiff> takes the names of two Debian package files (I<.deb>s or "
6123 "I<.udeb>s) on the command line and compares their contents (considering only "
6124 "the files in the main package, not the maintenance scripts). It shows which "
6125 "files have been introduced and which removed between the two package files, "
6126 "and is therefore useful for spotting files which may have been inadvertently "
6127 "lost between revisions of the package. It also checks the file owners and "
6128 "permissions, and compares the control files of the two packages using the "
6133 #: ../scripts/debdiff.1:27
6135 "If no arguments are given, B<debdiff> tries to compare the content of the "
6136 "current source directory with the last version of the package."
6140 #: ../scripts/debdiff.1:38
6142 "B<debdiff> can also handle changes between groups of I<.deb> files in two "
6143 "ways. The first is to specify two I<.changes> files. In this case, the "
6144 "I<.deb> files listed in the I<.changes> file will be compared, by taking the "
6145 "contents of all of the listed I<.deb> files together. (The I<.deb> files "
6146 "listed are assumed to be in the same directory as the I<.changes> file.) "
6147 "The second way is to list the I<.deb> files of interest specifically using "
6148 "the B<--from> ... B<--to> syntax. These both help if a package is broken up "
6149 "into smaller packages and one wishes to ensure that nothing is lost in the "
6154 #: ../scripts/debdiff.1:42
6156 "B<debdiff> examines the B<devscripts> configuration files as described "
6157 "below. Command line options override the configuration file settings, "
6162 #: ../scripts/debdiff.1:50
6164 "If B<debdiff> is passed two source packages (I<.dsc> files) it will compare "
6165 "the contents of the source packages. If the source packages differ only in "
6166 "Debian revision number (that is, the I<.orig.tar.gz> files are the same in "
6167 "the two I<.dsc> files), then B<interdiff>(1) will be used to compare the two "
6168 "patch files if this program is available on the system, otherwise a B<diff> "
6169 "will be performed between the two source trees."
6173 #: ../scripts/debdiff.1:51
6175 msgid "B<--dirs>, B<-d>"
6179 #: ../scripts/debdiff.1:56
6181 "The default mode of operation is to ignore directory names which appear in "
6182 "the file list, but they, too, will be considered if this option is given."
6186 #: ../scripts/debdiff.1:56
6192 #: ../scripts/debdiff.1:60
6194 "Ignore directory names which appear in the file list. This is the default "
6195 "and it can be used to override a configuration file setting."
6199 #: ../scripts/debdiff.1:60
6201 msgid "B<--move>I< FROM TO>,B< -m>I< FROM TO>"
6205 #: ../scripts/debdiff.1:70
6207 "It sometimes occurs that various files or directories are moved around "
6208 "between revisions. This can be handled using this option. There are two "
6209 "arguments, the first giving the location of the directory or file in the "
6210 "first package, and the second in the second. Any files in the first listing "
6211 "whose names begin with the first argument are treated as having that "
6212 "substituted for the second argument when the file lists are compared. Any "
6213 "number of B<--move> arguments may be given; they are processed in the order "
6214 "in which they appear."
6218 #: ../scripts/debdiff.1:70
6220 msgid "B<--move-regex>I< FROM TO>"
6224 #: ../scripts/debdiff.1:76
6226 "This is the same as B<--move>, except that I<FROM> is treated as a regular "
6227 "expression and the B<perl> substitution command I<s/^FROM/TO/> is applied to "
6228 "the files. In particular, TO can make use of backreferences such as $1."
6232 #: ../scripts/debdiff.1:76
6234 msgid "B<--nocontrol>"
6238 #: ../scripts/debdiff.1:81
6240 "B<debdiff> will usually compare the respective control files of the packages "
6241 "using B<wdiff>(1). This option suppresses this part of the processing."
6245 #: ../scripts/debdiff.1:81
6247 msgid "B<--control>"
6251 #: ../scripts/debdiff.1:85
6253 "Compare the respective control files; this is the default, and it can be "
6254 "used to override a configuration file setting."
6258 #: ../scripts/debdiff.1:85
6260 msgid "B<--controlfiles>I< FILE,FILE,...>"
6264 #: ../scripts/debdiff.1:93
6266 "Specify which control files to compare; by default this is just I<control>, "
6267 "but could include I<postinst>, I<config> and so on. Files will only be "
6268 "compared if they are present in both I<.debs> being compared. The special "
6269 "value I<ALL> compares all control files present in both packages, except for "
6270 "md5sums. This option can be used to override a configuration file setting."
6274 #: ../scripts/debdiff.1:93
6276 msgid "B<--wdiff-source-control>"
6280 #: ../scripts/debdiff.1:97
6282 "When processing source packages, compare control files using B<wdiff>. "
6283 "Equivalent to the B<--control> option for binary packages."
6287 #: ../scripts/debdiff.1:97
6289 msgid "B<--no-wdiff-source-control>"
6293 #: ../scripts/debdiff.1:101
6295 "Do not compare control files in source packages using B<wdfiff>. This is "
6300 #: ../scripts/debdiff.1:101
6302 msgid "B<--wp>, B<--wl>, B<--wt>"
6306 #: ../scripts/debdiff.1:106
6308 "Pass a B<-p>, B<-l> or B<-t> option to B<wdiff> respectively. (This yields "
6309 "the whole B<wdiff> output rather than just the lines with any changes.)"
6313 #: ../scripts/debdiff.1:106
6315 msgid "B<--show-moved>"
6319 #: ../scripts/debdiff.1:113
6321 "If multiple I<.deb> files are specified on the command line, either using "
6322 "I<.changes> files or the B<--from>/B<--to> syntax, then this option will "
6323 "also show which files (if any) have moved between packages. (The package "
6324 "names are simply determined from the names of the I<.deb> files.)"
6328 #: ../scripts/debdiff.1:113
6330 msgid "B<--noshow-moved>"
6334 #: ../scripts/debdiff.1:117 ../scripts/debdiff.1:134
6335 msgid "The default behaviour; can be used to override a configuration file setting."
6339 #: ../scripts/debdiff.1:117
6341 msgid "B<--renamed>I< FROM TO>"
6345 #: ../scripts/debdiff.1:123
6347 "If B<--show-moved> is being used and a package has been renamed in the "
6348 "process, this command instructs B<debdiff> to treat the package in the first "
6349 "list called I<FROM> as if it were called I<TO>. Multiple uses of this "
6350 "option are permitted."
6354 #: ../scripts/debdiff.1:123
6356 msgid "B<--exclude>I< PATTERN>"
6360 #: ../scripts/debdiff.1:127
6362 "Exclude files that match I<PATTERN>. Multiple uses of this option are "
6367 #: ../scripts/debdiff.1:127
6369 msgid "B<--diffstat>"
6373 #: ../scripts/debdiff.1:130
6374 msgid "Include the result of B<diffstat> before the generated diff."
6378 #: ../scripts/debdiff.1:130
6380 msgid "B<--no-diffstat>"
6384 #: ../scripts/debdiff.1:134
6386 msgid "B<--auto-ver-sort>"
6390 #: ../scripts/debdiff.1:137
6391 msgid "When comparing source packages, do so in version order."
6395 #: ../scripts/debdiff.1:137
6397 msgid "B<--no-auto-ver-sort>"
6401 #: ../scripts/debdiff.1:143
6403 "Compare source packages in the order they were passed on the command-line, "
6404 "even if that means comparing a package with a higher version against one "
6405 "with a lower version. This is the default behaviour."
6409 #: ../scripts/debdiff.1:143
6411 msgid "B<--unpack-tarballs>"
6415 #: ../scripts/debdiff.1:148
6417 "When comparing source packages, also unpack tarballs found in the top level "
6418 "source directory to compare their contents along with the other files. This "
6419 "is the default behaviour."
6423 #: ../scripts/debdiff.1:148
6425 msgid "B<--no-unpack-tarballs>"
6429 #: ../scripts/debdiff.1:151
6430 msgid "Do not unpack tarballs inside source packages."
6434 #: ../scripts/debdiff.1:161
6436 msgid "B<--quiet>, B<-q>"
6440 #: ../scripts/debdiff.1:164
6441 msgid "Be quiet if no differences were found."
6445 #: ../scripts/debdiff.1:164
6447 msgid "B<--ignore-space>, B<-w>"
6451 #: ../scripts/debdiff.1:167
6452 msgid "Ignore whitespace in diffs."
6456 #: ../scripts/debdiff.1:173
6458 "The two configuration files I</etc/devscripts.conf> and I<~/.devscripts> are "
6459 "sourced by a shell in that order to set configuration variables. Command "
6460 "line options can be used to override configuration file settings. "
6461 "Environment variable settings are ignored for this purpose. The currently "
6462 "recognised variables are:"
6466 #: ../scripts/debdiff.1:173
6468 msgid "B<DEBDIFF_DIRS>"
6472 #: ../scripts/debdiff.1:177
6474 "If this is set to I<yes>, then it is the same as the B<--dirs> command line "
6475 "parameter being used."
6479 #: ../scripts/debdiff.1:177
6481 msgid "B<DEBDIFF_CONTROL>"
6485 #: ../scripts/debdiff.1:182
6487 "If this is set to I<no>, then it is the same as the B<--nocontrol> command "
6488 "line parameter being used. The default is I<yes>."
6492 #: ../scripts/debdiff.1:182
6494 msgid "B<DEBDIFF_CONTROLFILES>"
6498 #: ../scripts/debdiff.1:187
6500 "Which control files to compare, corresponding to the B<--controlfiles> "
6501 "command line option. The default is I<control>."
6505 #: ../scripts/debdiff.1:187
6507 msgid "B<DEBDIFF_SHOW_MOVED>"
6511 #: ../scripts/debdiff.1:191
6513 "If this is set to I<yes>, then it is the same as the B<--show-moved> command "
6514 "line parameter being used."
6518 #: ../scripts/debdiff.1:191
6520 msgid "B<DEBDIFF_WDIFF_OPT>"
6524 #: ../scripts/debdiff.1:195
6526 "This option will be passed to B<wdiff>; it should be one of B<-p>, B<-l> or "
6531 #: ../scripts/debdiff.1:195
6533 msgid "B<DEBDIFF_SHOW_DIFFSTAT>"
6537 #: ../scripts/debdiff.1:199
6539 "If this is set to I<yes>, then it is the same as the B<--diffstat> command "
6540 "line parameter being used."
6544 #: ../scripts/debdiff.1:199
6546 msgid "B<DEBDIFF_WDIFF_SOURCE_CONTROL>"
6550 #: ../scripts/debdiff.1:203
6552 "If this is set to I<yes>, then it is the same as the "
6553 "B<--wdiff-source-control> command line parameter being used."
6557 #: ../scripts/debdiff.1:203
6559 msgid "B<DEBDIFF_AUTO_VER_SORT>"
6563 #: ../scripts/debdiff.1:207
6565 "If this is set to I<yes>, then it is the same as the B<--auto-ver-sort> "
6566 "command line parameter being used."
6570 #: ../scripts/debdiff.1:207
6572 msgid "B<DEBDIFF_UNPACK_TARBALLS>"
6576 #: ../scripts/debdiff.1:211
6578 "If this is set to I<no>, then it is the same as the B<--no-unpack-tarballs> "
6579 "command line parameter being used."
6583 #: ../scripts/debdiff.1:215
6585 "Normally the exit value will be 0 if no differences are reported and 1 if "
6586 "any are reported. If there is some fatal error, the exit code will be 255."
6590 #: ../scripts/debdiff.1:222
6592 "B<dpkg-deb>(1), B<wdiff>(1), B<interdiff>(1), B<diffstat>(1) and "
6593 "B<devscripts.conf>(5)."
6597 #: ../scripts/debdiff.1:227
6599 "B<debdiff> was originally written as a shell script by Yann Dirson "
6600 "E<lt>dirson@debian.orgE<gt> and rewritten in Perl with many more features by "
6601 "Julian Gilbey E<lt>jdg@debian.orgE<gt>. The software may be freely "
6602 "redistributed under the terms and conditions of the GNU General Public "
6603 "License, version 2."
6607 #: ../scripts/debi.1:1
6613 #: ../scripts/debi.1:4
6614 msgid "debi - install current version of generated Debian package"
6618 #: ../scripts/debi.1:6
6619 msgid "B<debi> [I<options>] [I<changes file>] [I<package> ...]"
6623 #: ../scripts/debi.1:21
6625 "B<debi> figures out the current version of a package and installs it. If a "
6626 "I<.changes> file is specified on the command line, the filename must end "
6627 "with I<.changes>, as this is how the program distinguishes it from package "
6628 "names. If not, then B<debi> has to be called from within the source code "
6629 "directory tree. In this case, it will look for the I<.changes> file "
6630 "corresponding to the current package version (by determining the name and "
6631 "version number from the changelog, and the architecture in the same way as "
6632 "B<dpkg-buildpackage>(1) does). It then runs B<debpkg -i> on every I<.deb> "
6633 "archive listed in the I<.changes> file to install them, assuming that all of "
6634 "the I<.deb> archives live in the same directory as the I<.changes> file. "
6635 "Note that you probably don't want to run this program on a I<.changes> file "
6636 "relating to a different architecture after cross-compiling the package!"
6640 #: ../scripts/debi.1:40
6642 "In common with several other scripts in the B<devscripts> package, B<debi> "
6643 "will climb the directory tree until it finds a I<debian/changelog> file. As "
6644 "a safeguard against stray files causing potential problems, it will examine "
6645 "the name of the parent directory once it finds the I<debian/changelog> file, "
6646 "and check that the directory name corresponds to the package name. "
6647 "Precisely how it does this is controlled by two configuration file variables "
6648 "DEVSCRIPTS_CHECK_DIRNAME_LEVEL and DEVSCRIPTS_CHECK_DIRNAME_REGEX, and their "
6649 "corresponding command-line options B<--check-dirname-level> and "
6650 "B<--check-dirname-regex>."
6654 #: ../scripts/debi.1:78 ../scripts/debrelease.1:87
6656 "Look for the I<.changes> and I<.deb> files in directory I<DIR> instead of "
6657 "the parent of the source directory. This should either be an absolute path "
6658 "or relative to the top of the source directory."
6662 #: ../scripts/debi.1:78
6664 msgid "B<--upgrade>"
6668 #: ../scripts/debi.1:84
6670 "Only upgrade packages already installed on the system, rather than "
6671 "installing all packages listed in the I<.changes> file. Useful for "
6672 "multi-binary packages when you don't want to have all the binaries installed "
6677 #: ../scripts/debi.1:115
6679 "This specifies the directory in which to look for the I<.changes> and "
6680 "I<.deb> files, and is either an absolute path or relative to the top of the "
6681 "source tree. This corresponds to the B<--debs-dir> command line option. "
6682 "This directive could be used, for example, if you always use B<pbuilder> or "
6683 "B<svn-buildpackage> to build your packages. Note that it also affects "
6684 "B<debrelease>(1) in the same way, hence the strange name of the option."
6688 #: ../scripts/debi.1:126
6689 msgid "B<debpkg>(1) and B<devscripts.conf>(5)."
6693 #: ../scripts/debi.1:131
6695 "B<debi> was originally written by Christoph Lameter "
6696 "E<lt>clameter@debian.orgE<gt>. The now-defunct script B<debit> was "
6697 "originally written by James R. Van Zandt E<lt>jrv@vanzandt.mv.comE<gt>. "
6698 "They have been moulded into one script together with B<debc>(1) and parts "
6699 "extensively modified by Julian Gilbey E<lt>jdg@debian.orgE<gt>."
6703 #: ../scripts/debpkg.1:1
6709 #: ../scripts/debpkg.1:4
6710 msgid "debpkg - wrapper for dpkg"
6714 #: ../scripts/debpkg.1:6
6715 msgid "B<debpkg> I<dpkg-options>"
6719 #: ../scripts/debpkg.1:12
6721 "B<debpkg> simply invokes B<dpkg>(1) but first becomes superuser so that "
6722 "B<dpkg> is able to install and remove packages. It also cleans the "
6723 "environment and resets PATH to a sane default: "
6724 "\"/usr/sbin:/usr/bin:/sbin:/bin:/usr/bin/X11\" so that local versions of "
6725 "programs are not run by accident."
6729 #: ../scripts/debpkg.1:17
6731 "B<debpkg> must be given superuser privileges in some way to function "
6732 "properly. B<Access to debpkg with those privileges is the same as having "
6733 "superuser access to your machine.> B<debpkg> will abort if it finds that it "
6734 "neither being run by root nor setuid root."
6738 #: ../scripts/debpkg.1:23
6740 "The B<devscripts> package has been designed to allow B<debpkg> to be made "
6741 "setuid root. This works by using a compiled wrapper script, which means "
6742 "that B<suidperl> is not required. See B<dpkg-statoverride>(8) if you wish "
6743 "to make this program setuid root. B<sudo> or B<super> could also "
6744 "conceivably be used."
6748 #: ../scripts/debpkg.1:25
6750 "Christoph Lameter E<lt>clameter@debian.orgE<gt>; minor modifications made by "
6751 "Julian Gilbey E<lt>jdg@debian.orgE<gt>."
6755 #: ../scripts/debrelease.1:1
6761 #: ../scripts/debrelease.1:4
6762 msgid "debrelease - a wrapper around dupload or dput"
6766 #: ../scripts/debrelease.1:6
6767 msgid "B<debrelease> [I<debrelease options>] [I<dupload/dput options>]"
6771 #: ../scripts/debrelease.1:15
6773 "B<debrelease> is a simple wrapper around B<dupload> or B<dput>. It is "
6774 "called from within the source code tree of a package, and figures out the "
6775 "current version of a package. It then looks for the corresponding "
6776 "I<.changes> file (which lists the files needed to upload in order to release "
6777 "the package) in the parent directory of the source code tree and calls "
6778 "B<dupload> or B<dput> with the I<.changes> file as parameter in order to "
6779 "perform the actual uploading."
6783 #: ../scripts/debrelease.1:20
6785 "Options may be given to B<debrelease>; except for the ones listed below, "
6786 "they are passed on unchanged to B<dupload> or B<dput>. The B<devscripts> "
6787 "configuration files are also read by B<debrelease> as described below."
6791 #: ../scripts/debrelease.1:31
6793 "In common with several other scripts in the B<devscripts> package, "
6794 "B<debrelease> will climb the directory tree until it finds a "
6795 "I<debian/changelog> file. As a safeguard against stray files causing "
6796 "potential problems, it will examine the name of the parent directory once it "
6797 "finds the I<debian/changelog> file, and check that the directory name "
6798 "corresponds to the package name. Precisely how it does this is controlled "
6799 "by two configuration file variables DEVSCRIPTS_CHECK_DIRNAME_LEVEL and "
6800 "DEVSCRIPTS_CHECK_DIRNAME_REGEX, and their corresponding command-line options "
6801 "B<--check-dirname-level> and B<--check-dirname-regex>."
6805 #: ../scripts/debrelease.1:61 ../scripts/debrsign.1:31 ../scripts/debsign.1:73
6811 #: ../scripts/debrelease.1:67
6813 "If this option is used, or the default I<.changes> file is not found but a "
6814 "source-only I<.changes> file is present, then this source-only I<.changes> "
6815 "file will be uploaded instead of an arch-specific one."
6819 #: ../scripts/debrelease.1:75
6821 "See B<dpkg-architecture>(1) for a description of these options. They affect "
6822 "the search for the I<.changes> file. They are provided to mimic the "
6823 "behaviour of B<dpkg-buildpackage> when determining the name of the "
6824 "I<.changes> file. If a plain B<-t> is given, it is taken to be the "
6825 "B<dupload> host-specifying option, and therefore signifies the end of the "
6826 "B<debrelease>-specific options."
6830 #: ../scripts/debrelease.1:75 ../scripts/debrsign.1:41 ../scripts/debsign.1:83
6836 #: ../scripts/debrelease.1:81
6838 "Multiarch changes mode: This signifies that B<debrelease> should use the "
6839 "most recent file with the name pattern I<package_version_*+*.changes> as the "
6840 "changes file, allowing for the changes files produced by B<dpkg-cross>."
6844 #: ../scripts/debrelease.1:111
6846 msgid "B<DEBRELEASE_UPLOADER>"
6850 #: ../scripts/debrelease.1:116
6852 "The currently recognised values are I<dupload> and I<dput>, and it specifies "
6853 "which uploader program should be used. It corresponds to the B<--dupload> "
6854 "and B<--dput> command line options."
6858 #: ../scripts/debrelease.1:125
6860 "This specifies the directory in which to look for the I<.changes> and "
6861 "I<.deb> files, and is either an absolute path or relative to the top of the "
6862 "source tree. This corresponds to the B<--debs-dir> command line option. "
6863 "This directive could be used, for example, if you always use B<pbuilder> or "
6864 "B<svn-buildpackage> to build your packages. Note that it also affects "
6865 "B<debc>(1) and B<debi>(1)."
6869 #: ../scripts/debrelease.1:137
6870 msgid "B<dupload>(1), B<dput>(1) and B<devscripts.conf>(5)."
6874 #: ../scripts/debrelease.1:139
6876 "Julian Gilbey E<lt>jdg@debian.orgE<gt>, based on the original B<release> "
6877 "script by Christoph Lameter E<lt>clameter@debian.orgE<gt>."
6880 #. type: Content of the dhfirstname entity
6881 #: ../scripts/deb-reversion.dbk:30
6882 msgid "<firstname>martin f.</firstname>"
6885 #. type: Content of the dhsurname entity
6886 #: ../scripts/deb-reversion.dbk:31
6887 msgid "<surname>krafft</surname>"
6890 #. type: Content of the dhmaintfirstname entity
6891 #: ../scripts/deb-reversion.dbk:32
6892 msgid "<firstname>Julian</firstname>"
6895 #. type: Content of the dhmaintsurname entity
6896 #: ../scripts/deb-reversion.dbk:33
6897 msgid "<surname>Gilbey</surname>"
6900 #. type: Content of the dhdate entity
6901 #: ../scripts/deb-reversion.dbk:35
6902 msgid "<date>Feb 13, 2006</date>"
6905 #. type: Content of the dhsection entity
6906 #: ../scripts/deb-reversion.dbk:38
6907 msgid "<manvolnum>1</manvolnum>"
6910 #. type: Content of the dhemail entity
6911 #: ../scripts/deb-reversion.dbk:39
6912 msgid "<email>madduck@debian.org</email>"
6915 #. type: Content of the dhmaintemail entity
6916 #: ../scripts/deb-reversion.dbk:40
6917 msgid "<email>jdg@debian.org</email>"
6920 #. type: Content of the dhusername entity
6921 #: ../scripts/deb-reversion.dbk:41
6922 msgid "martin f. krafft"
6925 #. type: Content of the dhmaintusername entity
6926 #: ../scripts/deb-reversion.dbk:42
6927 msgid "Julian Gilbey"
6930 #. type: Content of the dhucpackage entity
6931 #: ../scripts/deb-reversion.dbk:43
6932 msgid "<refentrytitle>deb-reversion</refentrytitle>"
6935 #. type: Content of the dhcommand entity
6936 #: ../scripts/deb-reversion.dbk:44 ../scripts/deb-reversion.dbk:45
6937 msgid "deb-reversion"
6940 #. type: Content of the debian entity
6941 #: ../scripts/deb-reversion.dbk:47
6942 msgid "<productname>Debian</productname>"
6945 #. type: Content of the gnu entity
6946 #: ../scripts/deb-reversion.dbk:48
6947 msgid "<acronym>GNU</acronym>"
6950 #. type: Content of the gpl entity
6951 #: ../scripts/deb-reversion.dbk:49
6952 msgid "&gnu; <acronym>GPL</acronym>"
6955 #. type: Content of: <refentry><refentryinfo><address>
6956 #: ../scripts/deb-reversion.dbk:55
6963 #. type: Content of: <refentry><refentryinfo>
6964 #: ../scripts/deb-reversion.dbk:54
6965 msgid "<placeholder type=\"address\" id=\"0\"/> &dhdate;"
6968 #. type: Content of: <refentry><refnamediv><refname>
6969 #: ../scripts/deb-reversion.dbk:65
6973 #. type: Content of: <refentry><refnamediv><refpurpose>
6974 #: ../scripts/deb-reversion.dbk:67
6975 msgid "simple script to change the version of a .deb file."
6978 #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
6979 #: ../scripts/deb-reversion.dbk:72
6981 "<command>&dhcommand;</command> <arg choice=\"opt\"> "
6982 "<replaceable>options</replaceable> </arg> <replaceable> "
6983 ".deb-file</replaceable> <arg choice=\"opt\" rep=\"repeat\">log message</arg>"
6986 #. type: Content of: <refentry><refsect1><para>
6987 #: ../scripts/deb-reversion.dbk:85
6989 "&dhcommand; unpacks the specified .deb file, changes the version number in "
6990 "the relevant locations, appends a Debian <filename>changelog</filename> "
6991 "entry with the specified contents, and creates a new .deb file with the "
6995 #. type: Content of: <refentry><refsect1><para>
6996 #: ../scripts/deb-reversion.dbk:92
6998 "By default, the tool creates a new version number suitable for local "
6999 "changes, such that the new package will be greater than the current one, but "
7000 "lesser than any future, official Debian packages. With <option>-v "
7001 "<replaceable class=\"parameter\">version</replaceable></option>, the version "
7002 "number can be specified directly. On the other hand, the "
7003 "<option>-c</option> simply calculates the new version number but does not "
7004 "generate a new package."
7007 #. type: Content of: <refentry><refsect1><para>
7008 #: ../scripts/deb-reversion.dbk:103
7010 "When building a .deb file, root privileges are required in order to have the "
7011 "correct permissions and ownerships in the resulting .deb file. This can be "
7012 "achieved either by running <command>&dhcommand;</command> as root or running "
7013 "under <citerefentry><refentrytitle>fakeroot</refentrytitle> "
7014 "<manvolnum>1</manvolnum></citerefentry>, as 'fakeroot &dhcommand; foo.deb'."
7017 #. type: Content of: <refentry><refsect1><para>
7018 #: ../scripts/deb-reversion.dbk:113
7020 "With <option>-k <replaceable "
7021 "class=\"parameter\">hook</replaceable></option>, a hook script may be "
7022 "specified, which is run on the unpacked binary packages just before it is "
7023 "repacked. If you want to write changelog entries from within the hook, use "
7024 "'<command>dch -a -- <replaceable class=\"parameter\">your "
7025 "message</replaceable></command>'. (Alternatively, do not give a changelog "
7026 "entry on the <command>&dhcommand;</command> command line and "
7027 "<command>dch</command> will be called automatically.) The hook command must "
7028 "be placed in quotes if it has more than one word; it is called via "
7029 "<command>sh -c</command>."
7032 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
7033 #: ../scripts/deb-reversion.dbk:131
7035 "<option>-v</option> <replaceable "
7036 "class=\"parameter\">new-version</replaceable>"
7039 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
7040 #: ../scripts/deb-reversion.dbk:132
7042 "<option>--new-version</option> <replaceable "
7043 "class=\"parameter\">new-version</replaceable>"
7046 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
7047 #: ../scripts/deb-reversion.dbk:135
7049 "Specifies the version number to be used for the new version. Passed to "
7050 "<citerefentry> <refentrytitle>dch</refentrytitle> <manvolnum>1</manvolnum> "
7054 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
7055 #: ../scripts/deb-reversion.dbk:145
7057 "<option>-o</option> <replaceable "
7058 "class=\"parameter\">old-version</replaceable>"
7061 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
7062 #: ../scripts/deb-reversion.dbk:146
7064 "<option>--old-version</option> <replaceable "
7065 "class=\"parameter\">old-version</replaceable>"
7068 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
7069 #: ../scripts/deb-reversion.dbk:149
7071 "Specifies the version number to be used as the old version instead of the "
7072 "version stored in the .deb's control file."
7075 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
7076 #: ../scripts/deb-reversion.dbk:157
7077 msgid "<option>-c</option>"
7080 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
7081 #: ../scripts/deb-reversion.dbk:158
7082 msgid "<option>--calculate-only</option>"
7085 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
7086 #: ../scripts/deb-reversion.dbk:161
7088 "Only calculate and display the new version number which would be used; do "
7089 "not build a new .deb file. Cannot be used in conjunction with "
7090 "<option>-v</option>."
7093 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
7094 #: ../scripts/deb-reversion.dbk:169
7095 msgid "<option>-s</option> <replaceable class=\"parameter\">string</replaceable>"
7098 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
7099 #: ../scripts/deb-reversion.dbk:170
7101 "<option>--string</option> <replaceable "
7102 "class=\"parameter\">string</replaceable>"
7105 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
7106 #: ../scripts/deb-reversion.dbk:173
7108 "Instead of using 'LOCAL.' as the version string to append to the old version "
7109 "number, use <replaceable class=\"parameter\">string</replaceable> instead."
7112 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
7113 #: ../scripts/deb-reversion.dbk:181
7115 "<option>-k</option> <replaceable "
7116 "class=\"parameter\">hook-command</replaceable>"
7119 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
7120 #: ../scripts/deb-reversion.dbk:182
7122 "<option>--hook</option> <replaceable "
7123 "class=\"parameter\">hook-command</replaceable>"
7126 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
7127 #: ../scripts/deb-reversion.dbk:185
7129 "A hook command to run after unpacking the old .deb file and modifying the "
7130 "changelog, and before packing up the new .deb file. Must be in quotes if it "
7131 "is more than one (shell) word. Only one hook command may be specified; if "
7132 "you want to perform more than this, you could specify 'bash' as the hook "
7133 "command, and you will then be given a shell to work in."
7136 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
7137 #: ../scripts/deb-reversion.dbk:197
7138 msgid "<option>-D</option>"
7141 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
7142 #: ../scripts/deb-reversion.dbk:198
7143 msgid "<option>--debug</option>"
7146 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
7147 #: ../scripts/deb-reversion.dbk:201
7149 "Pass <option>--debug</option> to <citerefentry> "
7150 "<refentrytitle>dpkg-deb</refentrytitle> <manvolnum>1</manvolnum> "
7154 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
7155 #: ../scripts/deb-reversion.dbk:211
7156 msgid "<option>-b</option>"
7159 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
7160 #: ../scripts/deb-reversion.dbk:212
7161 msgid "<option>--force-bad-version</option>"
7164 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
7165 #: ../scripts/deb-reversion.dbk:215
7167 "Pass <option>--force-bad-version</option> to <citerefentry> "
7168 "<refentrytitle>dch</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>"
7171 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
7172 #: ../scripts/deb-reversion.dbk:225
7173 msgid "<option>-h</option>"
7176 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
7177 #: ../scripts/deb-reversion.dbk:226
7178 msgid "<option>--help</option>"
7181 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
7182 #: ../scripts/deb-reversion.dbk:229
7183 msgid "Display usage information."
7186 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
7187 #: ../scripts/deb-reversion.dbk:235
7188 msgid "<option>-V</option>"
7191 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
7192 #: ../scripts/deb-reversion.dbk:236
7193 msgid "<option>--version</option>"
7196 #. type: Content of: <refentry><refsect1><para>
7197 #: ../scripts/deb-reversion.dbk:249
7199 "<citerefentry> <refentrytitle>dch</refentrytitle> <manvolnum>1</manvolnum> "
7200 "</citerefentry>, <citerefentry> <refentrytitle>fakeroot</refentrytitle> "
7201 "<manvolnum>1</manvolnum> </citerefentry>, <citerefentry> "
7202 "<refentrytitle>dpkg-deb</refentrytitle> <manvolnum>1</manvolnum> "
7206 #. type: Content of: <refentry><refsect1><title>
7207 #: ../scripts/deb-reversion.dbk:265
7211 #. type: Content of: <refentry><refsect1><para>
7212 #: ../scripts/deb-reversion.dbk:267
7214 "&dhpackage; is a tool intended to help porters (e.g. amd64) with modifying "
7215 "packages for other architectures, and to augment deb-repack, which creates "
7216 "modified packages with identical version numbers as the official "
7217 "packages. Chaos will ensue! With &dhpackage;, a proper version number can be "
7218 "selected, which does not obstruct the next official release but can be "
7219 "specifically pinned with APT or held with dpkg."
7222 #. type: Content of: <refentry><refsect1><para>
7223 #: ../scripts/deb-reversion.dbk:276
7225 "Please take note that &dhpackage; does not come without problems. While it "
7226 "works fine in most cases, it may just not in yours. Especially, please "
7227 "consider that it changes binary packages (only!) and hence can break strict "
7228 "versioned dependencies between binary packages generated from the same "
7232 #. type: Content of: <refentry><refsect1><para>
7233 #: ../scripts/deb-reversion.dbk:283
7235 "You are using this tool at your own risk and I shall not shed a tear if your "
7236 "gerbil goes up in flames, your microwave attacks the stereo, or the angry "
7237 "slamming of your fist spills your coffee into the keyboard, which sets off a "
7238 "chain reaction resulting in a vast amount of money transfered from your "
7242 #. type: Content of: <refentry><refsect1><para>
7243 #: ../scripts/deb-reversion.dbk:295
7245 "&dhpackage; is Copyright 2004-5 by &dhusername; &dhemail; and modifications "
7246 "are Copyright 2006 by &dhmaintusername; &dhmaintemail;."
7249 #. type: Content of: <refentry><refsect1><para>
7250 #: ../scripts/deb-reversion.dbk:300
7252 "Permission is granted to copy, distribute and/or modify this document under "
7253 "the terms of the Artistic License: "
7254 "<ulink>http://www.opensource.org/licenses/artistic-license.php</ulink> On "
7255 "Debian systems, the complete text of the Artistic License can be found in "
7256 "<filename>/usr/share/common-licenses/Artistic</filename>."
7259 #. type: Content of: <refentry><refsect1><para>
7260 #: ../scripts/deb-reversion.dbk:309
7262 "This manual page was written by &dhusername; &dhemail; and modified by "
7263 "&dhmaintusername; &dhmaintemail;."
7267 #: ../scripts/debrsign.1:1
7273 #: ../scripts/debrsign.1:4
7274 msgid "debrsign - remotely sign a Debian changes and dsc file pair using SSH"
7278 #: ../scripts/debrsign.1:7
7279 msgid "B<debrsign> [options] [I<user@>]I<remotehost> [I<changes-file>|I<dsc-file>]"
7283 #: ../scripts/debrsign.1:15
7285 "B<debrsign> takes either an unsigned I<.dsc> file or an unsigned I<.changes> "
7286 "file and the associated unsigned I<.dsc> file (found by replacing the "
7287 "architecture name and I<.changes> by I<.dsc>) if it appears in the "
7288 "I<.changes> file and signs them by copying them to the remote machine using "
7289 "B<ssh>(1) and remotely running B<debsign>(1) on that machine. All options "
7290 "not listed below are passed to the B<debsign> program on the remote machine."
7294 #: ../scripts/debrsign.1:19
7296 "If a I<.changes> or I<.dsc> file is specified, it is signed, otherwise, "
7297 "I<debian/changelog> is parsed to determine the name of the I<.changes> file "
7298 "to look for in the parent directory."
7302 #: ../scripts/debrsign.1:25
7304 "This utility is useful if a developer must build a package on one machine "
7305 "where it is unsafe to sign it; they need then only transfer the small "
7306 "I<.dsc> and I<.changes> files to a safe machine and then use the B<debsign> "
7307 "program to sign them before transferring them back. This program automates "
7312 #: ../scripts/debrsign.1:30
7314 "To do it the other way round, that is to connect to an unsafe machine to "
7315 "download the I<.dsc> and I<.changes> files, to sign them locally and then to "
7316 "transfer them back, see the B<debsign>(1) program, which can do this task."
7320 #: ../scripts/debrsign.1:35 ../scripts/debsign.1:77
7322 "Look for a source-only I<.changes> file instead of a binary-build changes "
7327 #: ../scripts/debrsign.1:47
7329 "Multiarch changes mode: This signifies that B<debrsign> should use the most "
7330 "recent file with the name pattern I<package_version_*+*.changes> as the "
7331 "changes file, allowing for the changes files produced by B<dpkg-cross>."
7335 #: ../scripts/debrsign.1:47
7337 msgid "B<--path >I<remote-path>"
7341 #: ../scripts/debrsign.1:50
7342 msgid "Specify a path to the GPG or PGP binary on the remote host."
7346 #: ../scripts/debrsign.1:53
7348 msgid "B<Other options>"
7352 #: ../scripts/debrsign.1:57
7353 msgid "All other options are passed on to B<debsign> on the remote machine."
7357 #: ../scripts/debrsign.1:63
7359 msgid "B<DEBRSIGN_PGP_PATH>"
7363 #: ../scripts/debrsign.1:66
7364 msgid "Equivalent to passing B<--path> on the command line (see above.)"
7368 #: ../scripts/debrsign.1:71
7369 msgid "B<debsign>(1), B<dpkg-architecture>(1) and B<ssh>(1)."
7373 #: ../scripts/debrsign.1:73 ../scripts/debsign.1:155
7375 "This program was written by Julian Gilbey E<lt>jdg@debian.orgE<gt> and is "
7376 "copyright under the GPL, version 2 or later."
7380 #: ../scripts/debsign.1:1
7386 #: ../scripts/debsign.1:4
7387 msgid "debsign - sign a Debian changes and dsc file pair using GPG/PGP"
7391 #: ../scripts/debsign.1:6
7392 msgid "B<debsign> [options] [I<changes-file>|I<dsc-file>|I<commands-file> ...]"
7396 #: ../scripts/debsign.1:16
7398 "B<debsign> mimics the signing aspects (and bugs) of "
7399 "B<dpkg-buildpackage>(1). It takes either an unsigned I<.dsc> file or an "
7400 "unsigned I<.changes> file (along with the associated unsigned I<.dsc> file "
7401 "found by replacing the architecture name and I<.changes> by I<.dsc> if it "
7402 "appears in the I<.changes> file), and signs them using the GNU Privacy Guard "
7403 "or PGP. It is careful to calculate the size and checksums of the newly "
7404 "signed I<.dsc> file and replace the original values in the I<.changes> file."
7408 #: ../scripts/debsign.1:21
7410 "If a I<.changes>, I<.dsc> or I<.commands> file is specified, it is signed, "
7411 "otherwise, I<debian/changelog> is parsed to determine the name of the "
7412 "I<.changes> file to look for in the parent directory."
7416 #: ../scripts/debsign.1:25
7418 "If a I<.commands> file is specified it is first validated (see the details "
7419 "at I<ftp://ftp.upload.debian.org/pub/UploadQueue/README>), and the name "
7420 "specified in the Uploader field is used for signing."
7424 #: ../scripts/debsign.1:36
7426 "This utility is useful if a developer must build a package on one machine "
7427 "where it is unsafe to sign it; they need then only transfer the small "
7428 "I<.dsc> and I<.changes> files to a safe machine and then use the B<debsign> "
7429 "program to sign them before transferring them back. This process can be "
7430 "automated in two ways. If the files to be signed live on the B<remote> "
7431 "machine, the B<-r> option may be used to copy them to the local machine and "
7432 "back again after signing. If the files live on the B<local> machine, then "
7433 "they may be transferred to the remote machine for signing using "
7438 #: ../scripts/debsign.1:39
7440 "This program can take default settings from the B<devscripts> configuration "
7441 "files, as described below."
7445 #: ../scripts/debsign.1:40
7447 msgid "B<-r >[I<username>B<@>]I<remotehost>"
7451 #: ../scripts/debsign.1:48
7453 "The I<.changes> and I<.dsc> files live on the specified remote host. In "
7454 "this case, a I<.changes> file must be explicitly named, with an absolute "
7455 "directory or one relative to the remote home directory. B<scp> will be used "
7456 "for the copying. The [I<username>B<@>]I<remotehost>B<:>I<changes> syntax is "
7457 "permitted as an alternative. Wildcards (B<*> etc.) are allowed."
7461 #: ../scripts/debsign.1:48
7463 msgid "B<-p>I<progname>"
7467 #: ../scripts/debsign.1:53
7469 "I<progname> is one of B<pgp> or B<gpg>, and specifies which signing program "
7470 "is to be called. The default is B<gpg> if I<~/.gnupg/secring.gpg> exists "
7471 "and B<pgp> otherwise."
7475 #: ../scripts/debsign.1:53
7477 msgid "B<-m>I<maintainer>"
7481 #: ../scripts/debsign.1:62
7483 "Specify the maintainer name to be used for signing. (See "
7484 "B<dpkg-buildpackage>(1) for more information about the differences between "
7485 "B<-m>, B<-e> and B<-k> when building packages; B<debsign> makes no use of "
7486 "these distinctions except with respect to the precedence of the various "
7487 "options. These multiple options are provided so that the program will "
7488 "behave as expected when called by B<debuild>(1).)"
7492 #: ../scripts/debsign.1:62
7494 msgid "B<-e>I<maintainer>"
7498 #: ../scripts/debsign.1:65
7499 msgid "Same as B<-m> but takes precedence over it."
7503 #: ../scripts/debsign.1:65
7505 msgid "B<-k>I<keyid>"
7509 #: ../scripts/debsign.1:69
7511 "Specify the key ID to be used for signing; overrides any B<-m> and B<-e> "
7516 #: ../scripts/debsign.1:69
7518 msgid "B<-spgp>, B<-sgpg>"
7522 #: ../scripts/debsign.1:73
7524 "Whether the signing program is to be called with command line arguments like "
7525 "those of B<pgp> or B<gpg>."
7529 #: ../scripts/debsign.1:89
7531 "Multiarch changes mode: This signifies that B<debsign> should use the most "
7532 "recent file with the name pattern I<package_version_*+*.changes> as the "
7533 "changes file, allowing for the changes files produced by B<dpkg-cross>."
7537 #: ../scripts/debsign.1:89
7539 msgid "B<--re-sign>, B<--no-re-sign>"
7543 #: ../scripts/debsign.1:95
7545 "Recreate signature, respectively use the existing signature, if the file has "
7546 "been signed already. If neither option is given and an already signed file "
7547 "is found the user is asked if he or she likes to use the current signature."
7551 #: ../scripts/debsign.1:101
7553 "Look for the I<.changes> and I<.dsc> files in directory I<DIR> instead of "
7554 "the parent of the source directory. This should either be an absolute path "
7555 "or relative to the top of the source directory."
7559 #: ../scripts/debsign.1:117
7561 msgid "B<DEBSIGN_PROGRAM>"
7565 #: ../scripts/debsign.1:120
7566 msgid "Setting this is equivalent to giving a B<-p> option."
7570 #: ../scripts/debsign.1:120
7572 msgid "B<DEBSIGN_SIGNLIKE>"
7576 #: ../scripts/debsign.1:124
7578 "This must be I<gpg> or I<pgp> and is equivalent to using either B<-sgpg> or "
7579 "B<-spgp> respectively."
7583 #: ../scripts/debsign.1:124
7585 msgid "B<DEBSIGN_MAINT>"
7589 #: ../scripts/debsign.1:127
7590 msgid "This is the B<-m> option."
7594 #: ../scripts/debsign.1:130
7595 msgid "And this is the B<-k> option."
7599 #: ../scripts/debsign.1:140
7601 "This specifies the directory in which to look for the I<.changes> and "
7602 "I<.dsc> files, and is either an absolute path or relative to the top of the "
7603 "source tree. This corresponds to the B<--debs-dir> command line option. "
7604 "This directive could be used, for example, if you always use B<pbuilder> or "
7605 "B<svn-buildpackage> to build your packages. Note that it also affects "
7606 "B<debrelease>(1) in the same way, hence the strange name of the option."
7610 #: ../scripts/debsign.1:153
7612 "B<debrsign>(1), B<dpkg-buildpackage>(1), B<dpkg-architecture>(1), "
7613 "B<debuild>(1), B<md5sum>(1), B<sha1sum>(1), B<sha256sum>(1), B<gpg>(1), "
7614 "B<pgp>(1), B<scp>(1) and B<devscripts.conf>(5)."
7618 #: ../scripts/debsnap.1:2
7624 #: ../scripts/debsnap.1:2
7626 msgid "July 3, 2010"
7630 #: ../scripts/debsnap.1:2
7632 msgid "Debian devscripts"
7636 #: ../scripts/debsnap.1:2
7638 msgid "DebSnap User Manual"
7642 #: ../scripts/debsnap.1:5
7643 msgid "debsnap - retrieve old snapshots of Debian packages"
7647 #: ../scripts/debsnap.1:9
7648 msgid "B<debsnap> [I<options>]I< package >[I<version>]"
7652 #: ../scripts/debsnap.1:12
7653 msgid "B<debsnap> [B<-h> | B<--help>]B< >[B<--version>]"
7657 #: ../scripts/debsnap.1:17
7659 "B<debsnap> is a tool to help with retrieving snapshots of old packages from "
7660 "a daily archive repository."
7664 #: ../scripts/debsnap.1:20
7666 "The only publicly available snapshot archive is currently located at "
7667 "I<http://snapshot.debian.org>"
7671 #: ../scripts/debsnap.1:24
7673 "By default, debsnap will download all the available versions for I<package> "
7674 "that are found in the snapshot archive. If a I<version> is specified, only "
7675 "that particular version will be downloaded, if available."
7679 #: ../scripts/debsnap.1:29
7681 msgid "B<-d>I< destination>,I< >B<--destdir>I< destination>"
7685 #: ../scripts/debsnap.1:32
7686 msgid "Directory to place retrieved packages."
7690 #: ../scripts/debsnap.1:33
7692 msgid "B<-f>, B<--force>"
7696 #: ../scripts/debsnap.1:41
7698 "Force writing into an existing I<destination>. By default B<debsnap> will "
7699 "insist the destination directory does not exist yet unless it is explicitly "
7700 "specified to be '.' (the current working directory). This is to avoid files "
7701 "being accidentally overwritten by what is fetched from the archive and to "
7702 "provide a guarantee for other scripts that only the files fetched will be "
7703 "present there upon completion."
7707 #: ../scripts/debsnap.1:42
7709 msgid "B<-v>, B<--verbose>"
7713 #: ../scripts/debsnap.1:46
7715 "Report on the B<debsnap> configuration being used and progress during the "
7716 "download operation. Please always use this option when reporting bugs."
7720 #: ../scripts/debsnap.1:50
7721 msgid "Show a summary of these options."
7725 #: ../scripts/debsnap.1:54
7726 msgid "Show the version of B<debsnap>."
7730 #: ../scripts/debsnap.1:59
7732 "B<debsnap> may also be configured through the use of the following options "
7733 "in the devscripts configuration files:"
7737 #: ../scripts/debsnap.1:60
7739 msgid "B<DEBSNAP_VERBOSE>"
7743 #: ../scripts/debsnap.1:63
7744 msgid "Same as the command line option B<--verbose>. Set to \"yes\" to enable."
7748 #: ../scripts/debsnap.1:64
7750 msgid "B<DEBSNAP_DESTDIR>"
7754 #: ../scripts/debsnap.1:69
7756 "Set a default path for the destination directory. If unset "
7757 "I<./source-E<lt>package_nameE<gt>> will be used. The command line option "
7758 "B<--destdir> will override this."
7762 #: ../scripts/debsnap.1:70
7764 msgid "B<DEBSNAP_BASE_URL>"
7768 #: ../scripts/debsnap.1:73
7769 msgid "The base url for the snapshots archive."
7773 #: ../scripts/debsnap.1:75
7774 msgid "If unset this defaults to I<http://snapshot.debian.org>"
7778 #: ../scripts/debsnap.1:76 ../scripts/transition-check.pl:54 ../scripts/uscan.1:498 ../scripts/wnpp-check.1:25
7784 #: ../scripts/debsnap.1:82
7786 "B<debsnap> will return an exit status of 0 if all operations succeeded, 1 if "
7787 "a fatal error occurred, and 2 if some packages failed to be downloaded but "
7788 "operations otherwise succeeded as expected. In some cases packages may fail "
7789 "to be downloaded because they are no longer available on the snapshot "
7790 "mirror, so any caller should expect this may occur in normal use."
7794 #: ../scripts/debsnap.1:83 ../scripts/diff2patches.1:28
7800 #: ../scripts/debsnap.1:84
7802 msgid "I</etc/devscripts.conf>"
7806 #: ../scripts/debsnap.1:87
7807 msgid "Global devscripts configuration options. Will override hardcoded defaults."
7811 #: ../scripts/debsnap.1:87
7813 msgid "I<~/.devscripts>"
7817 #: ../scripts/debsnap.1:95
7818 msgid "B<devscripts>(1), B<devscripts.conf>(5), B<git-debimport>(1)"
7822 #: ../scripts/debsnap.1:96
7828 #: ../scripts/debsnap.1:98
7829 msgid "David Paleino E<lt>dapal@debian.orgE<gt>"
7833 #: ../scripts/debsnap.1:101
7834 msgid "Copyright \\(co 2010 David Paleino"
7838 #: ../scripts/debsnap.1:105
7840 "Permission is granted to copy, distribute and/or modify this document under "
7841 "the terms of the GNU General Public License, Version 3 or (at your option) "
7842 "any later version published by the Free Software Foundation."
7846 #: ../scripts/debsnap.1:108
7848 "On Debian systems, the complete text of the GNU General Public License can "
7849 "be found in I</usr/share/common-licenses/GPL>."
7853 #: ../scripts/debsnap.1:110
7855 msgid "Reporting bugs"
7859 #: ../scripts/debsnap.1:113
7861 "The program is part of the devscripts package. Please report bugs using "
7862 "`B<reportbug devscripts>`"
7866 #: ../scripts/debuild.1:1
7872 #: ../scripts/debuild.1:4
7873 msgid "debuild - build a Debian package"
7877 #: ../scripts/debuild.1:7
7879 "B<debuild> [I<debuild options>] [I<dpkg-buildpackage options>] "
7880 "[B<--lintian-opts> I<lintian options>]"
7884 #: ../scripts/debuild.1:10
7886 "B<debuild> [I<debuild options>] "
7887 "B<binary>|B<binary-arch>|B<binary-indep>|B<clean> ..."
7891 #: ../scripts/debuild.1:29
7893 "B<debuild> creates all the files necessary for uploading a Debian package. "
7894 "It first runs B<dpkg-buildpackage>, then runs B<lintian> on the I<.changes> "
7895 "file created (assuming that B<lintian> is installed), and finally signs the "
7896 "I<.changes> and/or I<.dsc> files as appropriate (using B<debsign>(1) to do "
7897 "this instead of B<dpkg-buildpackage>(1) itself; all relevant key-signing "
7898 "options are passed on). Parameters can be passed to B<dpkg-buildpackage> "
7899 "and B<lintian>, where the parameters to the latter are indicated with the "
7900 "B<--lintian-opts> option. The allowable options in this case are "
7901 "B<--lintian> and B<--no-lintian> to force or skip the B<lintian> step, "
7902 "respectively. The default is to run B<lintian>. There are also various "
7903 "options available for setting and preserving environment variables, as "
7904 "described below in the Environment Variables section. In this method of "
7905 "running B<debuild>, we also save a build log to the file "
7906 "I<../E<lt>packageE<gt>_E<lt>versionE<gt>_E<lt>archE<gt>.build>."
7910 #: ../scripts/debuild.1:46
7912 "An alternative way of using B<debuild> is to use one or more of the "
7913 "parameters B<binary>, B<binary-arch>, B<binary-indep> and B<clean>, in which "
7914 "case B<debuild> will attempt to gain root privileges and then run "
7915 "I<debian/rules> with the given parameters. A "
7916 "B<--rootcmd=>I<gain-root-command> or B<-r>I<gain-root-command> option may be "
7917 "used to specify a method of gaining root privileges. The "
7918 "I<gain-root-command> is likely to be one of I<fakeroot>, I<sudo> or "
7919 "I<super>. See below for further discussion of this point. Again, the "
7920 "environment preservation options may be used. In this case, B<debuild> will "
7921 "also attempt to run B<dpkg-checkbuilddeps> first; this can be explicitly "
7922 "requested or switched off using the options B<-D> and B<-d> respectively. "
7923 "Note also that if either of these or a B<-r> option is specified in the "
7924 "configuration file option DEBUILD_DPKG_BUILDPACKAGE_OPTS, then it will be "
7925 "recognised even in this method of invocation of B<debuild>."
7929 #: ../scripts/debuild.1:49
7931 "B<debuild> also reads the B<devscripts> configuration files as described "
7932 "below. This allows default options to be given."
7936 #: ../scripts/debuild.1:61
7938 "In common with several other scripts in the B<devscripts> package, "
7939 "B<debuild> will climb the directory tree until it finds a "
7940 "I<debian/changelog> file before attempting to build the package. As a "
7941 "safeguard against stray files causing potential problems, it will examine "
7942 "the name of the parent directory once it finds the I<debian/changelog> file, "
7943 "and check that the directory name corresponds to the package name. "
7944 "Precisely how it does this is controlled by two configuration file variables "
7945 "DEVSCRIPTS_CHECK_DIRNAME_LEVEL and DEVSCRIPTS_CHECK_DIRNAME_REGEX, and their "
7946 "corresponding command-line options B<--check-dirname-level> and "
7947 "B<--check-dirname-regex>."
7951 #: ../scripts/debuild.1:94
7953 "As environment variables can affect the building of a package, often "
7954 "unintentionally, B<debuild> sanitises the environment by removing all "
7955 "environment variables except for TERM, HOME, LOGNAME, GNUPGHOME, PGPPATH, "
7956 "GPG_AGENT_INFO, FAKEROOTKEY, DEB_*, the (C, CPP, CXX, LD and F)FLAGS "
7957 "variables and their _APPEND counterparts and the locale variables LANG and "
7958 "LC_*. TERM is set to `dumb' if it is unset, and PATH is set to "
7959 "\"/usr/sbin:/usr/bin:/sbin:/bin:/usr/bin/X11\"."
7963 #: ../scripts/debuild.1:105
7965 "If a particular environment variable is required to be passed through "
7966 "untouched to the build process, this may be specified by using a "
7967 "B<--preserve-envvar> I<envvar> (which can also be written as B<-e> I<envvar> "
7968 "option). The environment may be left untouched by using the "
7969 "B<--preserve-env> option. However, even in this case, the PATH will be set "
7970 "to the sane value described above. The B<only> way to prevent PATH from "
7971 "being reset is to specify a B<--preserve-envvar PATH> option. But you are "
7972 "warned that using programs from non-standard locations can easily result in "
7973 "the package being broken, as it will not be able to be built on standard "
7978 #: ../scripts/debuild.1:109
7980 "Note that one may add directories to the beginning of the sanitised PATH, "
7981 "using the B<--prepend-path> option. This is useful when one wishes to use "
7982 "tools such as ccache or distcc for building."
7986 #: ../scripts/debuild.1:114
7988 "It is also possible to avoid having to type something like I<FOO>B<=>I<bar "
7989 ">B<debuild -e >I<FOO> by writing B<debuild -e >I<FOO>B<=>I<bar> or the long "
7990 "form B<debuild --set-envvar >I<FOO>B<=>I<bar>."
7994 #: ../scripts/debuild.1:114
7996 msgid "SUPERUSER REQUIREMENTS"
8000 #: ../scripts/debuild.1:124
8002 "B<debuild> needs to be run as superuser to function properly. There are "
8003 "three fundamentally different ways to do this. The first, and preferable, "
8004 "method is to use some root-gaining command. The best one to use is probably "
8005 "B<fakeroot>(1), since it does not involve granting any genuine privileges. "
8006 "B<super>(1) and B<sudo>(1) are also possibilities. If no B<-r> (or "
8007 "B<--rootcmd>) option is given (and recall that B<dpkg-buildpackage> also "
8008 "accepts a B<-r> option) and neither of the following methods is used, then "
8009 "B<-rfakeroot> will silently be assumed."
8013 #: ../scripts/debuild.1:130
8015 "The second method is to use some command such as B<su>(1) to become root, "
8016 "and then to do everything as root. Note, though, that B<lintian> will abort "
8017 "if it is run as root or setuid root; this can be overcome using the "
8018 "B<--allow-root> option of B<lintian> if you know what you are doing."
8022 #: ../scripts/debuild.1:146
8024 "The third possible method is to have B<debuild> installed as setuid root. "
8025 "This is not the default method, and will have to be installed as such by the "
8026 "system administrator. It must also be realised that anyone who can run "
8027 "B<debuild> as root or setuid root has B<full access to the whole machine>. "
8028 "This method is therefore not recommended, but will work. B<debuild> could "
8029 "be installed with mode 4754, so that only members of the owning group could "
8030 "run it. A disadvantage of this method would be that other users would then "
8031 "not be able to use the program. There are many other variants of this "
8032 "option involving multiple copies of B<debuild>, or the use of programs such "
8033 "as B<sudo> or B<super> to grant root privileges to users selectively. If "
8034 "the sysadmin wishes to do this, she should use the B<dpkg-statoverride> "
8035 "program to change the permissions of I</usr/bin/debuild>. This will ensure "
8036 "that these permissions are preserved across upgrades."
8040 #: ../scripts/debuild.1:146
8046 #: ../scripts/debuild.1:153
8048 "B<debuild> supports a number of hooks when running B<dpkg-buildpackage>. "
8049 "Note that if any of the hooks from clean-hook to final-clean (inclusive) are "
8050 "used, B<debuild> will emulate some sections of the B<dpkg-buildpackage> "
8051 "process rather than running them directly, as B<dpkg-buildpackage> does not "
8052 "support hooks. The available hooks are as follows:"
8056 #: ../scripts/debuild.1:153
8058 msgid "dpkg-buildpackage-hook"
8062 #: ../scripts/debuild.1:156
8063 msgid "Run before dpkg-buildpackage begins by calling dpkg-checkbuilddeps."
8067 #: ../scripts/debuild.1:156
8073 #: ../scripts/debuild.1:161
8075 "Run before dpkg-buildpackage runs debian/rules clean to clean the source "
8076 "tree. (Run even if the tree is not being cleaned because -nc is used.)"
8080 #: ../scripts/debuild.1:161
8082 msgid "dpkg-source-hook"
8086 #: ../scripts/debuild.1:165
8088 "Run after cleaning the tree and before running dpkg-source. (Run even if "
8089 "dpkg-source is not being called because -b or -B is used.)"
8093 #: ../scripts/debuild.1:165
8095 msgid "dpkg-build-hook"
8099 #: ../scripts/debuild.1:170
8101 "Run after dpkg-source and before calling debian/rules build. (Run even if "
8102 "this is a source-only build, so debian/rules build is not being called.)"
8106 #: ../scripts/debuild.1:170
8108 msgid "dpkg-binary-hook"
8112 #: ../scripts/debuild.1:174
8114 "Run between debian/rules build and debian/rules binary(-arch). Run ONLY if "
8115 "a binary package is being built."
8119 #: ../scripts/debuild.1:174
8121 msgid "dpkg-genchanges-hook"
8125 #: ../scripts/debuild.1:178
8126 msgid "Run after the binary package is built and before calling dpkg-genchanges."
8130 #: ../scripts/debuild.1:178
8132 msgid "final-clean-hook"
8136 #: ../scripts/debuild.1:183
8138 "Run after dpkg-genchanges and before the final debian/rules clean. (Run "
8139 "even if we are not cleaning the tree post-build, which is the default.)"
8143 #: ../scripts/debuild.1:183
8145 msgid "lintian-hook"
8149 #: ../scripts/debuild.1:187
8151 "Run (once) before calling lintian. (Run even if we are not calling "
8156 #: ../scripts/debuild.1:187
8158 msgid "signing-hook"
8162 #: ../scripts/debuild.1:191
8164 "Run after calling lintian before any signing takes place. (Run even if we "
8165 "are not signing anything.)"
8169 #: ../scripts/debuild.1:191
8171 msgid "post-dpkg-buildpackage-hook"
8175 #: ../scripts/debuild.1:194
8176 msgid "Run after everything has finished."
8180 #: ../scripts/debuild.1:209
8182 "A hook command can be specified either in the configuration file as, for "
8183 "example, DEBUILD_SIGNING_HOOK='foo' (note the hyphens change into "
8184 "underscores!) or as a command line option B<--signing-hook-foo>. The "
8185 "command will have certain percent substitutions made on it: %% will be "
8186 "replaced by a single % sign, %p will be replaced by the package name, %v by "
8187 "the package version number, %s by the source version number, %u by the "
8188 "upstream version number. Neither %s nor %u will contain an epoch. %a will "
8189 "be 1 if the immediately following action is to be performed and 0 if not "
8190 "(for example, in the dpkg-source hook, %a will become 1 if dpkg-source is to "
8191 "be run and 0 if not). Then it will be handed to the shell to deal with, so "
8192 "it can include redirections and stuff. For example, to only run the "
8193 "dpkg-source hook if dpkg-source is to be run, the hook could be something "
8194 "like: \"if [ %a -eq 1 ]; then ...; fi\"."
8198 #: ../scripts/debuild.1:213
8200 "B<Please take care with hooks>, as misuse of them can lead to packages which "
8201 "FTBFS (fail to build from source). They can be useful for taking snapshots "
8202 "of things or the like."
8206 #: ../scripts/debuild.1:219
8208 "Finally, only dpkg-buildpackage-hook and the hooks from lintian-hook onwards "
8209 "can be used if B<dpkg-cross> is installed. (This is because internally, "
8210 "B<debuild> reimplements B<dpkg-buildpackage>, but it does not attempt to "
8211 "reimplement the B<dpkg-cross> replacement of this script.)"
8215 #: ../scripts/debuild.1:221
8216 msgid "For details, see above."
8220 #: ../scripts/debuild.1:228
8221 msgid "Command to gain root (or fake root) privileges."
8225 #: ../scripts/debuild.1:231
8226 msgid "Do not clean the environment, except for PATH."
8230 #: ../scripts/debuild.1:234
8231 msgid "Do not clean the I<var> variable from the environment."
8235 #: ../scripts/debuild.1:238
8237 "If I<var> ends in an asterisk (\"*\") then all variables with names that "
8238 "match the portion of I<var> before the asterisk will be preserved."
8242 #: ../scripts/debuild.1:242
8244 "Set the environment variable I<var> to I<value> and do not remove it from "
8249 #: ../scripts/debuild.1:242
8251 msgid "B<--prepend-path=>I<value >"
8255 #: ../scripts/debuild.1:246
8256 msgid "Once the normalized PATH has been set, prepend I<value> to it."
8260 #: ../scripts/debuild.1:246
8262 msgid "B<--lintian>"
8266 #: ../scripts/debuild.1:251
8268 "Run B<lintian> after B<dpkg-buildpackage>. This is the default behaviour, "
8269 "and it overrides any configuration file directive to the contrary."
8273 #: ../scripts/debuild.1:251
8275 msgid "B<--no-lintian>"
8279 #: ../scripts/debuild.1:254
8280 msgid "Do not run B<lintian> after B<dpkg-buildpackage>."
8284 #: ../scripts/debuild.1:254
8286 msgid "B<--no-tgz-check>"
8290 #: ../scripts/debuild.1:259
8292 "Even if we're running B<dpkg-buildpackage> and the version number has a "
8293 "Debian revision, do not check that the .orig.tar.gz file or .orig directory "
8294 "exists before starting the build."
8298 #: ../scripts/debuild.1:259
8300 msgid "B<--tgz-check>"
8304 #: ../scripts/debuild.1:264
8306 "If we're running B<dpkg-buildpackage> and the version number has a Debian "
8307 "revision, check that the .orig.tar.gz file or .orig directory exists before "
8308 "starting the build. This is the default behaviour."
8312 #: ../scripts/debuild.1:264
8314 msgid "B<--username> I<username>"
8318 #: ../scripts/debuild.1:268
8320 "When signing, use B<debrsign> instead of B<debsign>. I<username> specifies "
8321 "the credentials to be used."
8325 #: ../scripts/debuild.1:268
8327 msgid "B<-->I<foo>B<-hook>=I<hook>"
8331 #: ../scripts/debuild.1:272
8332 msgid "Set a hook as described above. If I<hook> is blank, this unsets the hook."
8336 #: ../scripts/debuild.1:272
8338 msgid "B<--clear-hooks>"
8342 #: ../scripts/debuild.1:276
8343 msgid "Clears all hooks. They may be reinstated by later command line options."
8347 #: ../scripts/debuild.1:287
8348 msgid "Do not run B<dpkg-checkbuilddeps> to check build dependencies."
8352 #: ../scripts/debuild.1:287
8358 #: ../scripts/debuild.1:290
8359 msgid "Run B<dpkg-checkbuilddeps> to check build dependencies."
8363 #: ../scripts/debuild.1:298
8365 "The two configuration files I</etc/devscripts.conf> and I<~/.devscripts> are "
8366 "sourced by a shell in that order to set configuration variables. Command "
8367 "line options can be used to override some of these configuration file "
8368 "settings, otherwise the B<--no-conf> option can be used to prevent reading "
8369 "these files. Environment variable settings are ignored when these "
8370 "configuration files are read. The currently recognised variables are:"
8374 #: ../scripts/debuild.1:298
8376 msgid "B<DEBUILD_PRESERVE_ENV>"
8380 #: ../scripts/debuild.1:302
8382 "If this is set to I<yes>, then it is the same as the B<--preserve-env> "
8383 "command line parameter being used."
8387 #: ../scripts/debuild.1:302
8389 msgid "B<DEBUILD_PRESERVE_ENVVARS>"
8393 #: ../scripts/debuild.1:307
8395 "Which environment variables to preserve. This should be a comma-separated "
8396 "list of variables. This corresponds to using possibly multiple "
8397 "B<--preserve-envvar> or B<-e> options."
8401 #: ../scripts/debuild.1:307
8403 msgid "B<DEBUILD_SET_ENVVAR_>I<var>B<=>I<value>"
8407 #: ../scripts/debuild.1:310
8408 msgid "This corresponds to B<--set-envvar=>I<var>B<=>I<value>."
8412 #: ../scripts/debuild.1:310
8414 msgid "B<DEBUILD_PREPEND_PATH>"
8418 #: ../scripts/debuild.1:313
8419 msgid "This corresponds to B<--prepend-path>."
8423 #: ../scripts/debuild.1:313
8425 msgid "B<DEBUILD_ROOTCMD>"
8429 #: ../scripts/debuild.1:317
8430 msgid "Setting this variable to I<prog> is the equivalent of B<-r>I<prog>."
8434 #: ../scripts/debuild.1:317
8436 msgid "B<DEBUILD_TGZ_CHECK>"
8440 #: ../scripts/debuild.1:321
8442 "Setting this variable to I<no> is the same as the B<--no-tgz-check> command "
8447 #: ../scripts/debuild.1:321
8449 msgid "B<DEBUILD_SIGNING_USERNAME>"
8453 #: ../scripts/debuild.1:325
8455 "Setting this variable is the same as using the --username command line "
8460 #: ../scripts/debuild.1:325
8462 msgid "B<DEBUILD_DPKG_BUILDPACKAGE_OPTS>"
8466 #: ../scripts/debuild.1:333
8468 "These are options which should be passed to the invocation of "
8469 "B<dpkg-buildpackage>. They are given before any command-line options. Due "
8470 "to issues of shell quoting, if a word containing spaces is required as a "
8471 "single option, extra quotes will be required. For example, to ensure that "
8472 "your own GPG key is always used, even for sponsored uploads, the config file "
8473 "might contain the line:"
8477 #: ../scripts/debuild.1:336
8480 "DEBUILD_DPKG_BUILDPACKAGE_OPTS=\"-k'Julian Gilbey E<lt>jdg@debian.orgE<gt>' "
8485 #: ../scripts/debuild.1:341
8487 "which gives precisely two options. Without the extra single quotes, "
8488 "B<dpkg-buildpackage> would reasonably complain that I<Gilbey> is an "
8489 "unrecognised option (it doesn't start with a `-' sign)."
8493 #: ../scripts/debuild.1:346
8495 "Also, if this option contains any B<-r>, B<-d> or B<-D> options, these will "
8496 "always be taken account of by B<debuild>. Note that a B<-r> option in this "
8497 "variable will override the setting in DEBUILD_ROOTCMD."
8501 #: ../scripts/debuild.1:346
8503 msgid "B<DEBUILD_>I<FOO>B<_HOOK>"
8507 #: ../scripts/debuild.1:350
8509 "The hook variable for the I<foo> hook. See the section on hooks above for "
8510 "more details. By default, this is empty."
8514 #: ../scripts/debuild.1:350
8516 msgid "B<DEBUILD_LINTIAN>"
8520 #: ../scripts/debuild.1:354
8522 "Should we run B<lintian>? If this is set to I<no>, then B<lintian> will not "
8527 #: ../scripts/debuild.1:354
8529 msgid "B<DEBUILD_LINTIAN_OPTS>"
8533 #: ../scripts/debuild.1:360
8535 "These are options which should be passed to the invocation of B<lintian>. "
8536 "They are given before any command-line options, and the usage of this "
8537 "variable is as described for the B<DEBUILD_DPKG_BUILDPACKAGE_OPTS> variable."
8541 #: ../scripts/debuild.1:371
8543 "To build your own package, simply run B<debuild> from inside the source "
8544 "tree. B<dpkg-buildpackage>(1) options may be given on the command line."
8548 #: ../scripts/debuild.1:374
8550 "The typical command line options to build only the binary package(s) "
8551 "without signing the .changes file (or the non-existent .dsc file):"
8555 #: ../scripts/debuild.1:377
8557 msgid "debuild -i -us -uc -b\n"
8561 #: ../scripts/debuild.1:380
8562 msgid "Change the \"-b\" to \"-S\" to build only a source package."
8566 #: ../scripts/debuild.1:383
8568 "An example using B<lintian> to check the resulting packages and passing "
8573 #: ../scripts/debuild.1:386
8575 msgid "debuild --lintian-opts -i\n"
8579 #: ../scripts/debuild.1:394
8581 "Note the order of options here: the B<debuild> options come first, then the "
8582 "B<dpkg-buildpackage> ones, then finally the checker options. (And "
8583 "B<lintian> is called by default.) If you find yourself using the same "
8584 "B<dpkg-buildpackage> options repeatedly, consider using the "
8585 "DEBUILD_DPKG_BUILDPACKAGE_OPTS configuration file option as described above."
8589 #: ../scripts/debuild.1:398
8591 "To build a package for a sponsored upload, given I<foobar_1.0-1.dsc> and the "
8592 "respective source files, run something like the following commands:"
8596 #: ../scripts/debuild.1:403
8599 "dpkg-source -x foobar_1.0-1.dsc\n"
8601 "debuild -k0x12345678\n"
8605 #: ../scripts/debuild.1:410
8607 "where 0x12345678 is replaced by your GPG key ID or other key identifier such "
8608 "as your email address. Again, you could also use the "
8609 "DEBUILD_DPKG_BUILDPACKAGE_OPTS configuration file option as described above "
8610 "to avoid having to type the B<-k> option each time you do a sponsored "
8615 #: ../scripts/debuild.1:423
8617 "B<dpkg-buildpackage>(1), B<dpkg-checkbuilddeps>(1), B<debsign>(1), "
8618 "B<fakeroot>(1), B<lintian>(1), B<chmod>(1), B<dpkg-statoverride>(8), "
8619 "B<su>(1), B<sudo>(1), B<super>(1) and B<devscripts.conf>(5)."
8623 #: ../scripts/debuild.1:426
8625 "The original B<debuild> program was written by Christoph Lameter "
8626 "E<lt>clameter@debian.orgE<gt>. The current version has been written by "
8627 "Julian Gilbey E<lt>jdg@debian.orgE<gt>."
8631 #: ../scripts/desktop2menu.pl:26
8632 msgid "desktop2menu - create a menu file skeleton from a desktop file"
8636 #: ../scripts/desktop2menu.pl:30
8637 msgid "B<desktop2menu> B<--help|--version>"
8641 #: ../scripts/desktop2menu.pl:32
8642 msgid "B<desktop2menu> I<desktop file> [I<package name>]"
8646 #: ../scripts/desktop2menu.pl:36
8648 "B<desktop2menu> generates a skeleton menu file from the supplied "
8649 "freedesktop.org desktop file."
8653 #: ../scripts/desktop2menu.pl:39
8655 "The package name to be used in the menu file may be passed as an additional "
8656 "argument. If it is not supplied then B<desktop2menu> will attempt to derive "
8657 "the package name from the data in the desktop file."
8661 #: ../scripts/desktop2menu.pl:45
8663 "This program is Copyright (C) 2007 by Sune Vuorela <debian@pusling.com>. It "
8664 "was modified by Adam D. Barratt <adam@adam-barratt.org.uk> for the "
8665 "devscripts package. This program comes with ABSOLUTELY NO WARRANTY. You "
8666 "are free to redistribute this code under the terms of the GNU General Public "
8667 "License, version 2 or later."
8671 #: ../scripts/desktop2menu.pl:54
8673 "Sune Vuorela <debian@pusling.com> with modifications by Adam D. Barratt "
8674 "<adam@adam-barratt.org.uk>"
8678 #: ../scripts/devscripts.1:1
8684 #: ../scripts/devscripts.1:4
8685 msgid "devscripts - scripts to ease the lives of Debian developers"
8689 #: ../scripts/devscripts.1:12
8691 "The B<devscripts> package provides a collection of scripts which may be of "
8692 "use to Debian developers and others wishing to build Debian packages. For a "
8693 "summary of the available scripts, please see the file "
8694 "I</usr/share/doc/devscripts/README.gz>, and for full details, please see the "
8695 "individual manpages. They are contributed by multiple developers; for "
8696 "details of the authors, please see the code or manpages."
8700 #: ../scripts/devscripts.1:16
8702 "Also, the directory I</usr/share/doc/devscripts/examples> contains examples "
8703 "of B<procmail> and B<exim> scripts for sorting mail arriving to Debian "
8708 #: ../scripts/devscripts.1:20
8710 "Several scripts of the devscripts suite use the following environment "
8711 "variables. Check the man page of individual scripts for more details on how "
8712 "the variables are used."
8716 #: ../scripts/devscripts.1:20
8722 #: ../scripts/devscripts.1:21
8724 msgid "\\s-1DEBEMAIL\\s0"
8728 #: ../scripts/devscripts.1:22 ../scripts/devscripts.1:25
8734 #: ../scripts/devscripts.1:24
8735 msgid "Email of the person acting on a given Debian package via devscripts."
8739 #: ../scripts/devscripts.1:24
8741 msgid "\\s-1DEBFULLNAME\\s0"
8745 #: ../scripts/devscripts.1:28
8747 "Full name (first + family) of the person acting on a given Debian package "
8752 #: ../scripts/devscripts.1:28
8758 #: ../scripts/devscripts.1:31
8760 "Here is the complete list of available devscripts. See their man pages for "
8761 "additional documentation."
8765 #: ../scripts/devscripts.1:31
8767 msgid "I<annotate-output>(1)"
8771 #: ../scripts/devscripts.1:33
8773 "run a command and prepend time and stream (O for stdout, E for stderr) for "
8774 "every line of output"
8778 #: ../scripts/devscripts.1:33
8780 msgid "I<archpath>(1)"
8784 #: ../scripts/devscripts.1:35
8785 msgid "print tla/Bazaar package names [tla | bazaar]"
8789 #: ../scripts/devscripts.1:35
8795 #: ../scripts/devscripts.1:37
8797 "a command-line tool for manipulating the BTS [www-browser, "
8798 "libauthen-sasl-perl, libnet-smtp-ssl-perl, libsoap-lite-perl, libwww-perl, "
8799 "bsd-mailx | mailx]"
8803 #: ../scripts/devscripts.1:37
8805 msgid "I<build-rdeps>(1)"
8809 #: ../scripts/devscripts.1:39
8810 msgid "Searches for all packages that build-depend on a given package [dctrl-tools]"
8814 #: ../scripts/devscripts.1:39
8816 msgid "I<chdist>(1)"
8820 #: ../scripts/devscripts.1:41
8821 msgid "tool to easily play with several distributions [dctrl-tools]"
8825 #: ../scripts/devscripts.1:41
8827 msgid "I<checkbashisms>(1)"
8831 #: ../scripts/devscripts.1:43
8832 msgid "check whether a /bin/sh script contains any common bash-specific contructs"
8836 #: ../scripts/devscripts.1:43
8838 msgid "I<cowpoke>(1)"
8842 #: ../scripts/devscripts.1:45
8844 "upload a Debian source package to a cowbuilder host and build it, optionally "
8845 "also signing and uploading the result to an incoming queue [ssh-client]"
8849 #: ../scripts/devscripts.1:45
8851 msgid "I<cvs-debi, cvs-debc>(1)"
8855 #: ../scripts/devscripts.1:47
8857 "wrappers around debi and debc respectively (see below) which allow them to "
8858 "be called from the CVS working directory. [cvs-buildpackage]"
8862 #: ../scripts/devscripts.1:47
8864 msgid "I<cvs-debrelease>(1)"
8868 #: ../scripts/devscripts.1:49
8870 "wrapper around debrelease which allows it to be called from the CVS working "
8871 "directory. [cvs-buildpackage, dupload | dput, ssh-client]"
8875 #: ../scripts/devscripts.1:49
8877 msgid "I<cvs-debuild>(1)"
8881 #: ../scripts/devscripts.1:51
8883 "A wrapper for cvs-buildpackage to use debuild as its package building "
8884 "program. [cvs-buildpackage, fakeroot, lintian, gnupg]"
8888 #: ../scripts/devscripts.1:51
8894 #: ../scripts/devscripts.1:53
8896 "run a given command replacing the name of a .changes or .dsc file with each "
8897 "of the files referenced therein"
8901 #: ../scripts/devscripts.1:53
8903 msgid "I<dcontrol>(1)"
8907 #: ../scripts/devscripts.1:55
8909 "remotely query package and source control files for all Debian "
8910 "distributions. [liburl-perl, libwww-perl]"
8914 #: ../scripts/devscripts.1:55
8916 msgid "I<dd-list>(1)"
8920 #: ../scripts/devscripts.1:57
8921 msgid "given a list of packages, pretty-print it ordered by maintainer"
8925 #: ../scripts/devscripts.1:57
8931 #: ../scripts/devscripts.1:59
8932 msgid "display the contents of just-built .debs"
8936 #: ../scripts/devscripts.1:59
8938 msgid "I<debchange/dch>(1)"
8942 #: ../scripts/devscripts.1:61
8944 "automagically add entries to debian/changelog files "
8945 "[libparse-debcontrol-perl, libsoap-lite-perl, lsb-release]"
8949 #: ../scripts/devscripts.1:61
8951 msgid "I<debcheckout>(1)"
8955 #: ../scripts/devscripts.1:63
8956 msgid "checkout the development repository of a Debian package"
8960 #: ../scripts/devscripts.1:63
8962 msgid "I<debclean>(1)"
8966 #: ../scripts/devscripts.1:65
8967 msgid "purge a Debian source tree [fakeroot]"
8971 #: ../scripts/devscripts.1:65
8973 msgid "I<debcommit>(1)"
8977 #: ../scripts/devscripts.1:67
8979 "commit changes to cvs, darcs, svn, svk, tla, bzr, git, or hg, basing commit "
8980 "message on changelog [cvs | darcs | subversion | svk | tla | bzr | git-core "
8985 #: ../scripts/devscripts.1:67
8987 msgid "I<debdiff>(1)"
8991 #: ../scripts/devscripts.1:69
8993 "compare two versions of a Debian package to check for added and removed "
8994 "files [wdiff, patchutils]"
8998 #: ../scripts/devscripts.1:69
9004 #: ../scripts/devscripts.1:71
9005 msgid "install a just-built package"
9009 #: ../scripts/devscripts.1:71
9011 msgid "I<debpkg>(1)"
9015 #: ../scripts/devscripts.1:73
9016 msgid "dpkg wrapper to be able to manage/test packages without su"
9020 #: ../scripts/devscripts.1:73
9022 msgid "I<debrelease>(1)"
9026 #: ../scripts/devscripts.1:75
9027 msgid "wrapper around dupload or dput [dupload | dput, ssh-client]"
9031 #: ../scripts/devscripts.1:75
9033 msgid "I<debsign, debrsign>(1)"
9037 #: ../scripts/devscripts.1:77
9039 "sign a .changes/.dsc pair without needing any of the rest of the package to "
9040 "be present; can sign the pair remotely or fetch the pair from a remote "
9041 "machine for signing [gnupg, debian-keyring, ssh-client]"
9045 #: ../scripts/devscripts.1:77
9047 msgid "I<debsnap>(1)"
9051 #: ../scripts/devscripts.1:79
9052 msgid "grab packages from http://snapshot.debian.org [libwww-perl, libjson-perl]"
9056 #: ../scripts/devscripts.1:79
9058 msgid "I<debuild>(1)"
9062 #: ../scripts/devscripts.1:81
9064 "wrapper to build a package without having to su or worry about how to invoke "
9065 "dpkg to build using fakeroot. Also deals with common environment problems, "
9066 "umask etc. [fakeroot, lintian, gnupg]"
9070 #: ../scripts/devscripts.1:81
9072 msgid "I<deb-reversion>(1)"
9076 #: ../scripts/devscripts.1:83
9077 msgid "increases a binary package version number and repacks the archive"
9081 #: ../scripts/devscripts.1:83
9083 msgid "I<desktop2menu>(1)"
9087 #: ../scripts/devscripts.1:85
9089 "produce a skeleton menu file from a freedesktop.org desktop file "
9090 "[libfile-desktopentry-perl]"
9094 #: ../scripts/devscripts.1:85
9100 #: ../scripts/devscripts.1:87
9101 msgid "downloads Debian source and binary packages [wget | curl]"
9105 #: ../scripts/devscripts.1:87
9107 msgid "I<dpkg-depcheck, dpkg-genbuilddeps>(1)"
9111 #: ../scripts/devscripts.1:89
9113 "determine the packages used during the build of a Debian package; useful for "
9114 "determining the Build-Depends control field needed [build-essential, strace]"
9118 #: ../scripts/devscripts.1:89
9120 msgid "I<diff2patches>(1)"
9124 #: ../scripts/devscripts.1:91
9126 "extract patches from a .diff.gz file placing them under debian/ or, if "
9127 "present, debian/patches [patchutils]"
9131 #: ../scripts/devscripts.1:91
9133 msgid "I<dscverify>(1)"
9137 #: ../scripts/devscripts.1:93
9139 "verify the integrity of a Debian package from the .changes or .dsc files "
9140 "[gnupg, debian-keyring, libdigest-md5-perl]"
9144 #: ../scripts/devscripts.1:93
9146 msgid "I<getbuildlog>(1)"
9150 #: ../scripts/devscripts.1:95
9151 msgid "download package build logs from Debian auto-builders [wget]"
9155 #: ../scripts/devscripts.1:95
9157 msgid "I<grep-excuses>(1)"
9161 #: ../scripts/devscripts.1:97
9163 "grep the update_excuses.html file for your packages [libterm-size-perl, "
9168 #: ../scripts/devscripts.1:97
9170 msgid "I<licensecheck>(1)"
9174 #: ../scripts/devscripts.1:99
9175 msgid "attempt to determine the license of source files"
9179 #: ../scripts/devscripts.1:99
9181 msgid "I<list-unreleased>(1)"
9185 #: ../scripts/devscripts.1:101
9186 msgid "searches for unreleased packages"
9190 #: ../scripts/devscripts.1:101
9192 msgid "I<manpage-alert>(1)"
9196 #: ../scripts/devscripts.1:103
9197 msgid "locate binaries without corresponding manpages [man-db]"
9201 #: ../scripts/devscripts.1:103
9203 msgid "I<mass-bug>(1)"
9207 #: ../scripts/devscripts.1:105
9208 msgid "mass-file bug reports [bsd-mailx | mailx]"
9212 #: ../scripts/devscripts.1:105
9214 msgid "I<mergechanges>(1)"
9218 #: ../scripts/devscripts.1:107
9219 msgid "merge .changes files from a package built on different architectures"
9223 #: ../scripts/devscripts.1:107
9225 msgid "I<mk-build-deps>(1)"
9229 #: ../scripts/devscripts.1:109
9231 "Given a package name and/or control file, generate a binary package which "
9232 "may be installed to satisfy the build-dependencies of the given "
9233 "packages. [equivs]"
9237 #: ../scripts/devscripts.1:109
9239 msgid "I<namecheck>(1)"
9243 #: ../scripts/devscripts.1:111
9244 msgid "Check project names are not already taken."
9248 #: ../scripts/devscripts.1:111
9250 msgid "I<nmudiff>(1)"
9254 #: ../scripts/devscripts.1:113
9256 "mail a diff of the current package against the previous version to the BTS "
9257 "to assist in tracking NMUs [patchutils, mutt]"
9261 #: ../scripts/devscripts.1:113
9263 msgid "I<plotchangelog>(1)"
9267 #: ../scripts/devscripts.1:115
9268 msgid "view a nice plot of the data in a changelog file [libtimedate-perl, gnuplot]"
9272 #: ../scripts/devscripts.1:115
9274 msgid "I<pts-subscribe>(1)"
9278 #: ../scripts/devscripts.1:117
9279 msgid "subscribe to the PTS for a limited period of time [bsd-mailx | mailx, at]"
9283 #: ../scripts/devscripts.1:117
9285 msgid "I<rc-alert>(1)"
9289 #: ../scripts/devscripts.1:119
9290 msgid "list installed packages which have release-critical bugs [wget]"
9294 #: ../scripts/devscripts.1:119
9296 msgid "I<rmadison>(1)"
9300 #: ../scripts/devscripts.1:121
9302 "remotely query the Debian archive database about packages [wget | curl, "
9307 #: ../scripts/devscripts.1:121
9309 msgid "I<svnpath>(1)"
9313 #: ../scripts/devscripts.1:123
9314 msgid "print svn repository paths [subversion]"
9318 #: ../scripts/devscripts.1:123
9320 msgid "I<tagpending>(1)"
9324 #: ../scripts/devscripts.1:125
9326 "runs from a Debian source tree and tags bugs that are to be closed in the "
9327 "latest changelog as pending. [libsoap-lite-perl]"
9331 #: ../scripts/devscripts.1:125
9333 msgid "I<transition-check>(1)"
9337 #: ../scripts/devscripts.1:127
9339 "Check a list of source packages for involvement in transitions for which "
9340 "uploads to unstable are currently blocked [libwww-perl, libyaml-syck-perl]"
9344 #: ../scripts/devscripts.1:127
9350 #: ../scripts/devscripts.1:129
9352 "scan upstream sites for new releases of packages [libcrypt-ssleay-perl, "
9353 "libwww-perl, unzip, lzma, xz-utils]"
9357 #: ../scripts/devscripts.1:129
9359 msgid "I<uupdate>(1)"
9363 #: ../scripts/devscripts.1:131
9364 msgid "integrate upstream changes into a source package [patch]"
9368 #: ../scripts/devscripts.1:131
9370 msgid "I<whodepends>(1)"
9374 #: ../scripts/devscripts.1:133
9375 msgid "check which maintainers' packages depend on a package"
9379 #: ../scripts/devscripts.1:133
9381 msgid "I<who-uploads>(1)"
9385 #: ../scripts/devscripts.1:135
9387 "determine the most recent uploaders of a package to the Debian archive "
9388 "[gnupg, debian-keyring, debian-maintainers, wget]"
9392 #: ../scripts/devscripts.1:135
9394 msgid "I<wnpp-alert>(1)"
9398 #: ../scripts/devscripts.1:136
9399 msgid "list installed packages which are orphaned or up for adoption [wget]"
9403 #: ../scripts/dget.pl:481
9404 msgid "dget -- Download Debian source and binary packages"
9408 #: ../scripts/dget.pl:487
9409 msgid "B<dget> [I<options>] I<URL> ..."
9413 #: ../scripts/dget.pl:489
9414 msgid "B<dget> [I<options>] I<package>[=I<version>]"
9418 #: ../scripts/dget.pl:495
9420 "B<dget> downloads Debian packages. In the first form, B<dget> fetches the "
9421 "requested URLs. If this is a .dsc or .changes file, then B<dget> acts as a "
9422 "source-package aware form of B<wget>: it also fetches any files referenced "
9423 "in the .dsc/.changes file. The downloaded source is then checked with "
9424 "B<dscverify> and, if successful, unpacked by B<dpkg-source>."
9428 #: ../scripts/dget.pl:502
9430 "In the second form, B<dget> downloads a I<binary> package (i.e., a I<.deb> "
9431 "file) from the Debian mirror configured in /etc/apt/sources.list(.d). "
9432 "Unlike B<apt-get install -d>, it does not require root privileges, writes to "
9433 "the current directory, and does not download dependencies. If a version "
9434 "number is specified, this version of the package is requested."
9438 #: ../scripts/dget.pl:509
9440 "In both cases dget is capable of getting several packages and/or URLs at "
9445 #: ../scripts/dget.pl:512
9447 "(Note that I<.udeb> packages used by debian-installer are located in "
9448 "separate packages files from I<.deb> packages. In order to use I<.udebs> "
9449 "with B<dget>, you will need to have configured B<apt> to use a packages file "
9450 "for I<component>/I<debian-installer>)."
9454 #: ../scripts/dget.pl:517
9456 "Before downloading files listed in .dsc and .changes files, and before "
9457 "downloading binary packages, B<dget> checks to see whether any of these "
9458 "files already exist. If they do, then their md5sums are compared to avoid "
9459 "downloading them again unnecessarily. B<dget> also looks for matching files "
9460 "in I</var/cache/apt/archives> and directories given by the B<--path> option "
9461 "or specified in the configuration files (see below). Finally, if "
9462 "downloading (.orig).tar.gz or .diff.gz files fails, dget consults B<apt-get "
9463 "source --print-uris>. Download backends used are B<curl> and B<wget>, "
9464 "looked for in that order."
9468 #: ../scripts/dget.pl:527
9470 "B<dget> was written to make it easier to retrieve source packages from the "
9471 "web for sponsor uploads. For checking the package with B<debdiff>, the last "
9472 "binary version is available via B<dget> I<package>, the last source version "
9473 "via B<apt-get source> I<package>."
9477 #: ../scripts/dget.pl:536
9478 msgid "B<-b>, B<--backup>"
9482 #: ../scripts/dget.pl:538
9483 msgid "Move files that would be overwritten to I<./backup>."
9487 #: ../scripts/dget.pl:540
9488 msgid "B<-q>, B<--quiet>"
9492 #: ../scripts/dget.pl:542
9493 msgid "Suppress B<wget>/B<curl> non-error output."
9497 #: ../scripts/dget.pl:544
9498 msgid "B<-d>, B<--download-only>"
9502 #: ../scripts/dget.pl:546
9504 "Do not run B<dpkg-source -x> on the downloaded source package. This can "
9505 "only be used with the first method of calling B<dget>."
9509 #: ../scripts/dget.pl:549
9510 msgid "B<-x>, B<--extract>"
9514 #: ../scripts/dget.pl:551
9516 "Run B<dpkg-source -x> on the downloaded source package to unpack it. This "
9517 "option is the default and can only be used with the first method of calling "
9522 #: ../scripts/dget.pl:555
9523 msgid "B<-u>, B<--allow-unauthenticated>"
9527 #: ../scripts/dget.pl:557
9529 "Do not attempt to verify the integrity of downloaded source packages using "
9534 #: ../scripts/dget.pl:560
9539 #: ../scripts/dget.pl:562
9540 msgid "Run B<dpkg-buildpackage -b -uc> on the downloaded source package."
9544 #: ../scripts/dget.pl:564
9545 msgid "B<--path> DIR[:DIR...]"
9549 #: ../scripts/dget.pl:566
9551 "In addition to I</var/cache/apt/archives>, B<dget> uses the colon-separated "
9552 "list given as argument to B<--path> to find files with a matching md5sum. "
9553 "For example: \"--path /srv/pbuilder/result:/home/cb/UploadQueue\". If DIR "
9554 "is empty (i.e., \"--path ''\" is specified), then any previously listed "
9555 "directories or directories specified in the configuration files will be "
9556 "ignored. This option may be specified multiple times, and all of the "
9557 "directories listed will be searched; hence, the above example could have "
9558 "been written as: \"--path /srv/pbuilder/result --path "
9559 "/home/cb/UploadQueue\"."
9563 #: ../scripts/dget.pl:577
9564 msgid "B<--insecure>"
9568 #: ../scripts/dget.pl:579
9569 msgid "Allow SSL connections to untrusted hosts."
9573 #: ../scripts/dget.pl:581
9574 msgid "B<--no-cache>"
9578 #: ../scripts/dget.pl:583
9579 msgid "Bypass server-side HTTP caches by sending a B<Pragma: no-cache> header."
9583 #: ../scripts/dget.pl:605
9588 #: ../scripts/dget.pl:607
9590 "This can be set to a colon-separated list of directories in which to search "
9591 "for files in addition to the default I</var/cache/apt/archives>. It has the "
9592 "same effect as the B<--path> command line option. It is not set by default."
9596 #: ../scripts/dget.pl:612
9601 #: ../scripts/dget.pl:614
9603 "Set to 'no' to disable extracting downloaded source packages. Default is "
9608 #: ../scripts/dget.pl:617
9613 #: ../scripts/dget.pl:619
9615 "Set to 'no' to disable checking signatures of downloaded source packages. "
9620 #: ../scripts/dget.pl:624
9621 msgid "BUGS AND COMPATIBILITY"
9625 #: ../scripts/dget.pl:626
9626 msgid "B<dget> I<package> should be implemented in B<apt-get install -d>."
9630 #: ../scripts/dget.pl:628
9632 "Before devscripts version 2.10.17, the default was not to extract the "
9633 "downloaded source. Set DGET_UNPACK=no to revert to the old behaviour."
9637 #: ../scripts/dget.pl:633
9639 "This program is Copyright (C) 2005-08 by Christoph Berg <myon@debian.org>. "
9640 "Modifications are Copyright (C) 2005-06 by Julian Gilbey <jdg@debian.org>."
9644 #: ../scripts/dget.pl:641
9645 msgid "B<apt-get>(1), B<debdiff>(1), B<dpkg-source>(1), B<curl>(1), B<wget>(1)."
9649 #: ../scripts/diff2patches.1:1
9651 msgid "diff2patches"
9655 #: ../scripts/diff2patches.1:1 ../scripts/diff2patches.1:50
9657 msgid "Raphael Geissert E<lt>atomo64@gmail.comE<gt>"
9661 #: ../scripts/diff2patches.1:5
9662 msgid "diff2patches - Extract non-debian/ patches from .diff.gz files"
9666 #: ../scripts/diff2patches.1:5
9672 #: ../scripts/diff2patches.1:8
9673 msgid "diff2patches I<E<lt>filenameE<gt>>"
9677 #: ../scripts/diff2patches.1:10
9678 msgid "diff2patches I<--help>|I<--version>"
9682 #: ../scripts/diff2patches.1:16
9684 "Extracts patches from .diff.gz which apply to files outside the ``debian/'' "
9685 "directory scope. A patch is created for each modified file. Each patch is "
9686 "named according to the path of the modified file, with ``/'' replaced by "
9687 "``___'', and an extension of ``.patch''."
9691 #: ../scripts/diff2patches.1:18
9697 #: ../scripts/diff2patches.1:22
9699 "Extract patches from I<filename> which apply outside the ``debian/'' "
9704 #: ../scripts/diff2patches.1:22
9710 #: ../scripts/diff2patches.1:25
9711 msgid "Output help information and exit."
9715 #: ../scripts/diff2patches.1:28
9716 msgid "Output version information and exit."
9720 #: ../scripts/diff2patches.1:29
9722 msgid "I<debian/control> "
9726 #: ../scripts/diff2patches.1:32
9727 msgid "Existence of this file is tested before any patch is extracted."
9731 #: ../scripts/diff2patches.1:32
9737 #: ../scripts/diff2patches.1:34
9739 msgid "I<debian/patches/>"
9743 #: ../scripts/diff2patches.1:40
9745 "Patches are extracted to one of these directories. ``debian/patches/'' is "
9746 "preferred, if it exists. If I<DEB_PATCHES> is present in the environment, "
9747 "it will override this behavior (see ``ENVIRONMENT VARIABLES'' section "
9752 #: ../scripts/diff2patches.1:41
9754 msgid "I<DEB_PATCHES>"
9758 #: ../scripts/diff2patches.1:45
9760 "When defined and points to an existing directory, patches are extracted in "
9761 "that directory and not under ``debian/'' nor ``debian/patches/''."
9765 #: ../scripts/diff2patches.1:48
9766 msgid "B<combinediff>(1)"
9770 #: ../scripts/dpkg-depcheck.1:1
9772 msgid "DPKG-DEPCHECK"
9776 #: ../scripts/dpkg-depcheck.1:1
9782 #: ../scripts/dpkg-depcheck.1:1
9784 msgid "dpkg-depcheck"
9788 #: ../scripts/dpkg-depcheck.1:4
9789 msgid "dpkg-depcheck - determine packages used to execute a command"
9793 #: ../scripts/dpkg-depcheck.1:6
9794 msgid "B<dpkg-depcheck> [I<options>] I<command>"
9798 #: ../scripts/dpkg-depcheck.1:15
9800 "This program runs the specified command under B<strace> and then determines "
9801 "and outputs the packages used in the process. The list can be trimmed in "
9802 "various ways as described in the options below. A good example of this "
9803 "program would be the command B<dpkg-depcheck -b debian/rules build>, which "
9804 "would give a good first approximation to the Build-Depends line needed by a "
9805 "Debian package. Note, however, that this does I<not> give any direct "
9806 "information on versions required or architecture-specific packages."
9810 #: ../scripts/dpkg-depcheck.1:16
9812 msgid "B<-a>, B<--all>"
9816 #: ../scripts/dpkg-depcheck.1:22
9818 "Report all packages used to run I<command>. This is the default behaviour. "
9819 "If used in conjunction with B<-b>, B<-d> or B<-m>, gives additional "
9820 "information on those packages skipped by these options."
9824 #: ../scripts/dpkg-depcheck.1:22
9826 msgid "B<-b>, B<--build-depends>"
9830 #: ../scripts/dpkg-depcheck.1:26
9832 "Do not report any build-essential or essential packages used, or any of "
9833 "their (direct or indirect) dependencies."
9837 #: ../scripts/dpkg-depcheck.1:26
9839 msgid "B<-d>, B<--ignore-dev-deps>"
9843 #: ../scripts/dpkg-depcheck.1:30
9845 "Do not show packages used which are direct dependencies of I<-dev> packages "
9846 "used. This implies B<-b>."
9850 #: ../scripts/dpkg-depcheck.1:30
9852 msgid "B<-m>, B<--min-deps>"
9856 #: ../scripts/dpkg-depcheck.1:34
9858 "Output a minimal set of packages needed, taking into account direct "
9859 "dependencies. Using B<-m> implies B<-d> and also B<-b>."
9863 #: ../scripts/dpkg-depcheck.1:34
9865 msgid "B<-C>, B<--C-locale>"
9869 #: ../scripts/dpkg-depcheck.1:37
9870 msgid "Run I<command> with the C locale."
9874 #: ../scripts/dpkg-depcheck.1:37
9876 msgid "B<--no-C-locale>"
9880 #: ../scripts/dpkg-depcheck.1:40
9881 msgid "Don't change locale when running I<command>."
9885 #: ../scripts/dpkg-depcheck.1:40
9887 msgid "B<-l>, B<--list-files>"
9891 #: ../scripts/dpkg-depcheck.1:43
9892 msgid "Also report the list of files used in each package."
9896 #: ../scripts/dpkg-depcheck.1:43
9898 msgid "B<--no-list-files>"
9902 #: ../scripts/dpkg-depcheck.1:47
9903 msgid "Do not report the files used in each package. Cancels a B<-l> option."
9907 #: ../scripts/dpkg-depcheck.1:47
9909 msgid "B<-o>, B<--output=>I<FILE>"
9913 #: ../scripts/dpkg-depcheck.1:50
9914 msgid "Output the package diagnostics to I<FILE> instead of stdout."
9918 #: ../scripts/dpkg-depcheck.1:50
9920 msgid "B<-O>, B<--strace-output=>I<FILE>"
9924 #: ../scripts/dpkg-depcheck.1:54
9926 "Write the B<strace> output to I<FILE> when tracing I<command> instead of "
9927 "using a temporary file."
9931 #: ../scripts/dpkg-depcheck.1:54
9933 msgid "B<-I>, B<--strace-input=>I<FILE>"
9937 #: ../scripts/dpkg-depcheck.1:59
9939 "Get B<strace> output from I<FILE> instead of tracing I<command>; B<strace> "
9940 "must have be run with the B<-f -q> options for this to work."
9944 #: ../scripts/dpkg-depcheck.1:59
9946 msgid "B<-f>, B<--features=>I<LIST>"
9950 #: ../scripts/dpkg-depcheck.1:65
9952 "Enable or disabled features given in the comma-separated I<LIST> as "
9953 "follows. A feature is enabled with I<+feature> or just I<feature> and "
9954 "disabled with I<-feature>. The currently recognised features are:"
9958 #: ../scripts/dpkg-depcheck.1:67
9960 msgid "B<warn-local>"
9964 #: ../scripts/dpkg-depcheck.1:71
9966 "Warn if files in I</usr/local> or I</var/local> are used. Enabled by "
9971 #: ../scripts/dpkg-depcheck.1:71
9973 msgid "B<discard-check-version>"
9977 #: ../scripts/dpkg-depcheck.1:76
9979 "Discards I<execve> when only a I<--version> argument is given to the "
9980 "program; this works around some configure scripts that check for binaries "
9981 "they don't actually use. Enabled by default."
9985 #: ../scripts/dpkg-depcheck.1:76
9987 msgid "B<trace-local>"
9991 #: ../scripts/dpkg-depcheck.1:81
9993 "Also try to identify files which are accessed in I</usr/local> and "
9994 "I</var/local>. Not usually very useful, as Debian does not place files in "
9995 "these directories. Disabled by default."
9999 #: ../scripts/dpkg-depcheck.1:81
10001 msgid "B<catch-alternatives>"
10004 #. type: Plain text
10005 #: ../scripts/dpkg-depcheck.1:85
10007 "Warn about access to files controlled by the Debian I<alternatives> "
10008 "mechanism. Enabled by default."
10012 #: ../scripts/dpkg-depcheck.1:85
10014 msgid "B<discard-sgml-catalogs>"
10017 #. type: Plain text
10018 #: ../scripts/dpkg-depcheck.1:90
10020 "Discards access to SGML catalogs; some SGML tools read all the registered "
10021 "catalogs at startup. Files matching the regexp /usr/share/sgml/.*\\e.cat "
10022 "are recognised as catalogs. Enabled by default."
10025 #. type: Plain text
10026 #: ../scripts/dpkg-depcheck.1:99
10027 msgid "Display usage information and exit."
10031 #: ../scripts/dpkg-depcheck.1:99 ../scripts/mk-build-deps.pl:83
10033 msgid "B<-v>, B<--version>"
10036 #. type: Plain text
10037 #: ../scripts/dpkg-depcheck.1:102
10038 msgid "Display version and copyright information and exit."
10041 #. type: Plain text
10042 #: ../scripts/dpkg-depcheck.1:108 ../scripts/grep-excuses.1:34
10044 "The two configuration files I</etc/devscripts.conf> and I<~/.devscripts> are "
10045 "sourced in that order to set configuration variables. Command line options "
10046 "can be used to override configuration file settings. Environment variable "
10047 "settings are ignored for this purpose. The currently recognised variable "
10052 #: ../scripts/dpkg-depcheck.1:108
10054 msgid "B<DPKG_DEPCHECK_OPTIONS>"
10057 #. type: Plain text
10058 #: ../scripts/dpkg-depcheck.1:112
10060 "These are options which are parsed before the command-line options. For "
10064 #. type: Plain text
10065 #: ../scripts/dpkg-depcheck.1:114
10066 msgid "DPKG_DEPCHECK_OPTIONS=\"-b -f-catch-alternatives\""
10069 #. type: Plain text
10070 #: ../scripts/dpkg-depcheck.1:118
10072 "which passes these options to B<dpkg-depcheck> before any command-line "
10073 "options are processed. You are advised not to try tricky quoting, because "
10074 "of the vagaries of shell quoting!"
10077 #. type: Plain text
10078 #: ../scripts/dpkg-depcheck.1:124
10080 "B<dpkg>(1), B<strace>(1), B<update-alternatives>(8) and "
10081 "B<devscripts.conf>(5)."
10085 #: ../scripts/dpkg-depcheck.1:124
10090 #. type: Plain text
10091 #: ../scripts/dpkg-depcheck.1:131
10093 "Copyright 2001 Bill Allombert E<lt>ballombe@debian.orgE<gt>. Modifications "
10094 "copyright 2002,2003 Julian Gilbey E<lt>jdg@debian.orgE<gt>. "
10095 "B<dpkg-depcheck> is free software, covered by the GNU General Public "
10096 "License, version 2 or (at your option) any later version, and you are "
10097 "welcome to change it and/or distribute copies of it under certain "
10098 "conditions. There is absolutely no warranty for B<dpkg-depcheck>."
10102 #: ../scripts/dpkg-genbuilddeps.1:1
10104 msgid "DPKG-GENBUILDDEPS"
10107 #. type: Plain text
10108 #: ../scripts/dpkg-genbuilddeps.1:4
10109 msgid "dpkg-genbuilddeps - generate a list of packages used to build this package"
10112 #. type: Plain text
10113 #: ../scripts/dpkg-genbuilddeps.1:6
10114 msgid "B<dpkg-genbuilddeps> [I<arg> ...]"
10117 #. type: Plain text
10118 #: ../scripts/dpkg-genbuilddeps.1:19
10120 "This program is a wrapper around B<dpkg-depcheck>(1). It should be run from "
10121 "the top of a Debian build tree. It calls B<dpkg-buildpackage> with any "
10122 "arguments given on the command line, and by tracing the execution of this, "
10123 "it determines which non-essential packages were used during the package "
10124 "building. This can be useful in determining what the I<Build-Depends> "
10125 "control fields should contain. It does not determine which packages were "
10126 "used for the arch independent parts of the build and which for the arch "
10127 "dependent parts, not does it attempt to determine which versions of packages "
10128 "are required. It should be able to run under B<fakeroot> rather than being "
10129 "run as root, as B<fakeroot dpkg-genbuilddeps>, or B<dpkg-genbuilddeps "
10133 #. type: Plain text
10134 #: ../scripts/dpkg-genbuilddeps.1:23
10136 "This program requires the build-essential package to be installed. If it is "
10137 "not, please use B<dpkg-depcheck> directly, with a command such as"
10140 #. type: Plain text
10141 #: ../scripts/dpkg-genbuilddeps.1:25
10143 msgid " dpkg-depcheck --all dpkg-buildpackage -us -uc -b -rfakeroot ...\n"
10146 #. type: Plain text
10147 #: ../scripts/dpkg-genbuilddeps.1:27
10148 msgid "All this program itself does is essentially to run the command:"
10151 #. type: Plain text
10152 #: ../scripts/dpkg-genbuilddeps.1:29
10154 msgid " dpkg-depcheck -b dpkg-buildpackage -us -uc -b -rfakeroot [arg ...]\n"
10157 #. type: Plain text
10158 #: ../scripts/dpkg-genbuilddeps.1:36
10160 "B<The Debian Policy Manual,> sections on Build-Depends etc., "
10161 "B<dpkg-depcheck>(1) and B<fakeroot>(1)."
10164 #. type: Plain text
10165 #: ../scripts/dpkg-genbuilddeps.1:40
10167 "The original B<dpkg-genbuilddeps> was written by Ben Collins "
10168 "E<lt>bcollins@debian.orgE<gt>. The current version is a simple wrapper "
10169 "around B<dpkg-depcheck> written by Bill Allombert "
10170 "E<lt>ballombe@debian.orgE<gt>. This manual page was written by Julian "
10171 "Gilbey E<lt>jdg@debian.orgE<gt>."
10175 #: ../scripts/dscverify.1:1
10180 #. type: Plain text
10181 #: ../scripts/dscverify.1:4
10182 msgid "dscverify - verify the validity of a Debian package"
10185 #. type: Plain text
10186 #: ../scripts/dscverify.1:6
10187 msgid "B<dscverify> [B<--keyring >I<keyring>] ... I<changes_or_dsc_filename> ..."
10190 #. type: Plain text
10191 #: ../scripts/dscverify.1:17
10193 "B<dscverify> checks that the GPG or PGP signatures on the given I<.changes> "
10194 "or I<.dsc> files are good signatures made by keys in the current Debian "
10195 "keyrings, found in the I<debian-keyring> and I<debian-maintainers> "
10196 "packages. (Additional keyrings can be specified using the B<--keyring> "
10197 "option any number of times.) It then checks that the other files listed in "
10198 "the I<.changes> or I<.dsc> files have the correct sizes and checksums (MD5 "
10199 "plus SHA1 and SHA256 if the latter are present). The exit status is 0 if "
10200 "there are no problems and non-zero otherwise."
10204 #: ../scripts/dscverify.1:18
10206 msgid "B<--keyring>I< >I<keyring>"
10209 #. type: Plain text
10210 #: ../scripts/dscverify.1:21
10211 msgid "Add I<keyring> to the list of keyrings to be used."
10215 #: ../scripts/dscverify.1:21 ../scripts/who-uploads.1:25
10217 msgid "B<--no-default-keyrings>"
10220 #. type: Plain text
10221 #: ../scripts/dscverify.1:24
10222 msgid "Do not use the default set of keyrings."
10226 #: ../scripts/dscverify.1:28
10228 msgid "B<--nosigcheck>, B<--no-sig-check>, B<-u>"
10231 #. type: Plain text
10232 #: ../scripts/dscverify.1:32
10234 "Skip the signature verification step. That is, only verify the sizes and "
10235 "checksums of the files listed in the I<.changes> or I<.dsc> files."
10239 #: ../scripts/dscverify.1:32 ../scripts/plotchangelog.1:78 ../scripts/uscan.1:418
10241 msgid "B<--verbose>"
10244 #. type: Plain text
10245 #: ../scripts/dscverify.1:35
10246 msgid "Do not suppress GPG output."
10249 #. type: Plain text
10250 #: ../scripts/dscverify.1:49
10252 "The two configuration files I</etc/devscripts.conf> and I<~/.devscripts> are "
10253 "sourced by a shell in that order to set configuration variables. "
10254 "Environment variable settings are ignored for this purpose. If the first "
10255 "command line option given is B<--noconf> or B<--no-conf>, then these files "
10256 "will not be read. The currently recognised variable is:"
10260 #: ../scripts/dscverify.1:49
10262 msgid "B<DSCVERIFY_KEYRINGS>"
10265 #. type: Plain text
10266 #: ../scripts/dscverify.1:53
10268 "This is a colon-separated list of extra keyrings to use in addition to any "
10269 "specified on the command line."
10273 #: ../scripts/dscverify.1:53
10278 #. type: Plain text
10279 #: ../scripts/dscverify.1:60
10281 "Please note that the keyring provided by the debian-keyring package can be "
10282 "slightly out of date. The latest version can be obtained with rsync, as "
10283 "documented in the README that comes with debian-keyring. If you sync the "
10284 "keyring to a non-standard location (see below), you can use the "
10285 "possibilities to specify extra keyrings, by either using the above mentioned "
10286 "configuration option or the --keyring option."
10289 #. type: Plain text
10290 #: ../scripts/dscverify.1:62
10291 msgid "Below is an example for an alias:"
10294 #. type: Plain text
10295 #: ../scripts/dscverify.1:64
10296 msgid "alias dscverify='dscverify --keyring ~/.gnupg/pubring.gpg'"
10300 #: ../scripts/dscverify.1:64
10302 msgid "STANDARD KEYRING LOCATIONS"
10305 #. type: Plain text
10306 #: ../scripts/dscverify.1:67
10308 "By default dscverify searches for the debian-keyring in the following "
10312 #. type: Plain text
10313 #: ../scripts/dscverify.1:69
10314 msgid "- /org/keyring.debian.org/keyrings/debian-keyring.(gpg|pgp)"
10317 #. type: Plain text
10318 #: ../scripts/dscverify.1:71
10319 msgid "- /usr/share/keyrings/debian-keyring.(pgp|gpg)"
10322 #. type: Plain text
10323 #: ../scripts/dscverify.1:73
10324 msgid "- /usr/share/keyrings/debian-maintainers.gpg"
10327 #. type: Plain text
10328 #: ../scripts/dscverify.1:77
10329 msgid "B<gpg>(1) and B<devscripts.conf>(5)."
10332 #. type: Plain text
10333 #: ../scripts/dscverify.1:81
10335 "B<dscverify> was written by Roderick Schertler E<lt>roderick@argon.orgE<gt> "
10336 "and posted on the debian-devel@lists.debian.org mailing list, with several "
10337 "modifications by Julian Gilbey E<lt>jdg@debian.orgE<gt>."
10341 #: ../scripts/getbuildlog.1:1
10343 msgid "GETBUILDLOG"
10346 #. type: Plain text
10347 #: ../scripts/getbuildlog.1:4
10348 msgid "getbuildlog - download build logs from Debian auto-builders"
10351 #. type: Plain text
10352 #: ../scripts/getbuildlog.1:8
10353 msgid "B<getbuildlog> I<package> [I<version-pattern>] [I<architecture-pattern>]"
10356 #. type: Plain text
10357 #: ../scripts/getbuildlog.1:17
10359 "B<getbuildlog> downloads build logs of I<package> from Debian "
10360 "auto-builders. It downloads build logs of all versions and for all "
10361 "architectures if I<version-pattern> and I<architecture-pattern> are not "
10362 "specified or empty, otherwise only build logs whose versions match "
10363 "I<version-pattern> and build logs whose architectures match "
10364 "I<architecture-pattern> will be downloaded. The version and architecture "
10365 "patterns are interpreted as extended regular expressions as described in "
10369 #. type: Plain text
10370 #: ../scripts/getbuildlog.1:21
10372 "If I<version-pattern> is \"last\" then only the logs for the most recent "
10373 "version of I<package> found on buildd.debian.org will be downloaded."
10376 #. type: Plain text
10377 #: ../scripts/getbuildlog.1:24
10379 "If I<version-pattern> is \"last-all\" then the logs for the most recent "
10380 "version found on each build log index will be downloaded."
10383 #. type: Plain text
10384 #: ../scripts/getbuildlog.1:28
10385 msgid "Show usage information and examples."
10389 #: ../scripts/getbuildlog.1:32
10391 msgid "getbuildlog hello 2\\e.2-1 amd64"
10394 #. type: Plain text
10395 #: ../scripts/getbuildlog.1:35
10396 msgid "Download amd64 build log for hello version 2.2-1."
10400 #: ../scripts/getbuildlog.1:35
10402 msgid "getbuildlog glibc \"\" mips.*"
10405 #. type: Plain text
10406 #: ../scripts/getbuildlog.1:38
10407 msgid "Download mips(el) build logs of all glibc versions."
10411 #: ../scripts/getbuildlog.1:38
10413 msgid "getbuildlog wesnoth .*bpo.*"
10416 #. type: Plain text
10417 #: ../scripts/getbuildlog.1:41
10418 msgid "Download all build logs of backported wesnoth versions."
10421 #. type: Plain text
10422 #: ../scripts/getbuildlog.1:42
10423 msgid "Written by Frank S. Thomas E<lt>fst@debian.orgE<gt>."
10427 #: ../scripts/grep-excuses.1:1
10429 msgid "GREP-EXCUSES"
10432 #. type: Plain text
10433 #: ../scripts/grep-excuses.1:4
10434 msgid "grep-excuses - search the testing excuses files for a specific maintainer"
10437 #. type: Plain text
10438 #: ../scripts/grep-excuses.1:6
10439 msgid "B<grep-excuses> [I<options>] [I<maintainer>|I<package>]"
10442 #. type: Plain text
10443 #: ../scripts/grep-excuses.1:13
10445 "B<grep-excuses> downloads the update_excuses.html file and greps it for the "
10446 "specified maintainer name. The B<libwww-perl> package is required for this "
10447 "script. If no name is given on the command line, first the environment "
10448 "variable B<DEBFULLNAME> is used if it is defined, and failing that, the "
10449 "configuration variable described below is used."
10453 #: ../scripts/grep-excuses.1:18
10455 msgid "B<--wipnity>, B<-w>"
10458 #. type: Plain text
10459 #: ../scripts/grep-excuses.1:22
10461 "Get information from E<lt>http://release.debian.org/migration/E<gt>. A "
10462 "package name must be given when using this option."
10465 #. type: Plain text
10466 #: ../scripts/grep-excuses.1:25 ../scripts/whodepends.1:14
10467 msgid "Show a brief usage message."
10471 #: ../scripts/grep-excuses.1:34
10473 msgid "B<GREP_EXCUSES_MAINTAINER>"
10476 #. type: Plain text
10477 #: ../scripts/grep-excuses.1:38
10479 "The default maintainer, email or package to grep for if none is specified on "
10480 "the command line."
10483 #. type: Plain text
10484 #: ../scripts/grep-excuses.1:40 ../scripts/plotchangelog.1:126
10485 msgid "B<devscripts.conf>(5)."
10488 #. type: Plain text
10489 #: ../scripts/grep-excuses.1:42
10491 "Joey Hess E<lt>joeyh@debian.orgE<gt>; modifications by Julian Gilbey "
10492 "E<lt>jdg@debian.orgE<gt>."
10496 #: ../scripts/licensecheck.pl:24
10497 msgid "licensecheck - simple license checker for source files"
10501 #: ../scripts/licensecheck.pl:28
10502 msgid "B<licensecheck> B<--help|--version>"
10506 #: ../scripts/licensecheck.pl:30
10508 "B<licensecheck> [B<--no-conf>] [B<--verbose>] [B<--copyright>] "
10509 "[B<-l|--lines=N>] [B<-i|--ignore=regex>] [B<-c|--check=regex>] "
10510 "[B<-r|--recursive>] I<list of files and directories to check>"
10514 #: ../scripts/licensecheck.pl:36
10516 "B<licensecheck> attempts to determine the license that applies to each file "
10517 "passed to it, by searching the start of the file for text belonging to "
10518 "various licenses."
10522 #: ../scripts/licensecheck.pl:40
10524 "If any of the arguments passed are directories, B<licensecheck> will add the "
10525 "files contained within to the list of files to process."
10529 #: ../scripts/licensecheck.pl:47
10530 msgid "B<--verbose> B<--no-verbose>"
10534 #: ../scripts/licensecheck.pl:49
10536 "Specify whether to output the text being processed from each file before the "
10537 "corresponding license information."
10541 #: ../scripts/licensecheck.pl:52
10542 msgid "Default is to be quiet."
10546 #: ../scripts/licensecheck.pl:54
10547 msgid "B<-l=N> B<--lines=N>"
10551 #: ../scripts/licensecheck.pl:56
10553 "Specify the number of lines of each file's header which should be parsed for "
10554 "license information. (Default is 60)."
10558 #: ../scripts/licensecheck.pl:59
10559 msgid "B<-i=regex> B<--ignore=regex>"
10563 #: ../scripts/licensecheck.pl:61
10565 "When processing the list of files and directories, the regular expression "
10566 "specified by this option will be used to indicate those which should not be "
10567 "considered (e.g. backup files, VCS metadata)."
10571 #: ../scripts/licensecheck.pl:65
10572 msgid "B<-r> B<--recursive>"
10576 #: ../scripts/licensecheck.pl:67
10577 msgid "Specify that the contents of directories should be added recursively."
10581 #: ../scripts/licensecheck.pl:70
10582 msgid "B<-c=regex> B<--check=regex>"
10586 #: ../scripts/licensecheck.pl:72
10588 "Specify a pattern against which filenames will be matched in order to decide "
10589 "which files to check the license of."
10593 #: ../scripts/licensecheck.pl:75
10594 msgid "The default includes common source files."
10598 #: ../scripts/licensecheck.pl:77
10599 msgid "B<--copyright>"
10603 #: ../scripts/licensecheck.pl:79
10604 msgid "Also display copyright text found within the file"
10608 #: ../scripts/licensecheck.pl:81
10609 msgid "B<--no-conf> B<--noconf>"
10613 #: ../scripts/licensecheck.pl:83
10615 "Do not read any configuration files. This can only be used as the first "
10616 "option given on the command-line."
10620 #: ../scripts/licensecheck.pl:98
10621 msgid "B<LICENSECHECK_VERBOSE>"
10625 #: ../scripts/licensecheck.pl:100
10627 "If this is set to I<yes>, then it is the same as the --verbose command line "
10628 "parameter being used. The default is I<no>."
10632 #: ../scripts/licensecheck.pl:103
10633 msgid "B<LICENSECHECK_PARSELINES>"
10637 #: ../scripts/licensecheck.pl:105
10639 "If this is set to a positive number then the specified number of lines at "
10640 "the start of each file will be read whilst attempting to determine the "
10641 "license(s) in use. This is equivalent to the --lines command line option."
10645 #: ../scripts/licensecheck.pl:114
10647 "This code is copyright by Adam D. Barratt <adam@adam-barratt.org.uk>, all "
10648 "rights reserved; based on a script of the same name from the KDE SDK, which "
10649 "is copyright by <dfaure@kde.org>. This program comes with ABSOLUTELY NO "
10650 "WARRANTY. You are free to redistribute this code under the terms of the GNU "
10651 "General Public License, version 2 or later."
10655 #: ../scripts/licensecheck.pl:123 ../scripts/transition-check.pl:83
10656 msgid "Adam D. Barratt <adam@adam-barratt.org.uk>"
10660 #: ../scripts/list-unreleased.1:1
10662 msgid "LIST-UNRELEASED"
10665 #. type: Plain text
10666 #: ../scripts/list-unreleased.1:4
10667 msgid "list-unreleased - display UNRELEASED packages"
10670 #. type: Plain text
10671 #: ../scripts/list-unreleased.1:6
10672 msgid "B<list-unreleased> [I<arg> ...] [I<path> ...]"
10675 #. type: Plain text
10676 #: ../scripts/list-unreleased.1:9
10678 "Searches for packages whose changelogs indicate there are pending changes "
10679 "(UNRELEASED) and either lists them or displays the relevant changelog entry."
10682 #. type: Plain text
10683 #: ../scripts/list-unreleased.1:12
10685 "By default it searches for packages under the current directory. If a path "
10686 "is specified it will look for packages under that directory instead."
10690 #: ../scripts/list-unreleased.1:13
10695 #. type: Plain text
10696 #: ../scripts/list-unreleased.1:16
10697 msgid "Display pending changes."
10701 #: ../scripts/list-unreleased.1:16
10706 #. type: Plain text
10707 #: ../scripts/list-unreleased.1:19
10708 msgid "Don't recurse into subdirectories looking for packages."
10711 #. type: Plain text
10712 #: ../scripts/list-unreleased.1:21
10713 msgid "B<debchange>(1)"
10716 #. type: Plain text
10717 #: ../scripts/list-unreleased.1:23
10719 "B<list-unreleased> was written by Frans Pop E<lt>elendil@planet.nlE<gt>. "
10720 "This manual page was written by Joey Hess E<lt>joeyh@debian.orgE<gt>."
10724 #: ../scripts/manpage-alert.1:1
10726 msgid "MANPAGE-ALERT"
10729 #. type: Plain text
10730 #: ../scripts/manpage-alert.1:4
10731 msgid "manpage-alert - check for binaries without corresponding manpages"
10734 #. type: Plain text
10735 #: ../scripts/manpage-alert.1:6
10736 msgid "B<manpage-alert> I<[path list]>"
10739 #. type: Plain text
10740 #: ../scripts/manpage-alert.1:8
10741 msgid "B<manpage-alert --help|--version>"
10744 #. type: Plain text
10745 #: ../scripts/manpage-alert.1:11
10747 "B<manpage-alert> searches the given list of paths for binaries without "
10748 "corresponding manpages."
10751 #. type: Plain text
10752 #: ../scripts/manpage-alert.1:14
10754 "If no paths are specified on the command line, the path list I</bin /sbin "
10755 "/usr/bin /usr/sbin /usr/games> will be assumed."
10758 #. type: Plain text
10759 #: ../scripts/manpage-alert.1:17
10760 msgid "B<--help>, B<-h> Show a summary of options."
10763 #. type: Plain text
10764 #: ../scripts/manpage-alert.1:25
10766 "B<manpage-alert> was written by Branden Robinson and modified by Julian "
10767 "Gilbey E<lt>jdg@debian.orgE<gt> and Adam D. Barratt "
10768 "E<lt>debian-bts@adam-barratt.org.ukE<gt> (who also wrote this manpage) for "
10769 "the devscripts package."
10772 #. type: Plain text
10773 #: ../scripts/manpage-alert.1:28
10775 "This manpage and the associated program are licensed under the terms of the "
10776 "GPL, version 2 or later."
10780 #: ../scripts/mass-bug.pl:24
10781 msgid "mass-bug - mass-file a bug report against a list of packages"
10785 #: ../scripts/mass-bug.pl:28
10786 msgid "mass-bug [options] --subject=\"bug subject\" template package-list"
10790 #: ../scripts/mass-bug.pl:32
10792 "mass-bug assists in filing a mass bug report in the Debian BTS on a set of "
10793 "packages. For each package in the package-list file (which should list one "
10794 "package per line together with an optional version number separated from the "
10795 "package name by an underscore), it fills out the template, adds BTS "
10796 "pseudo-headers, and either displays or sends the bug report."
10800 #: ../scripts/mass-bug.pl:38
10802 "Warning: Some care has been taken to avoid unpleasant and common mistakes, "
10803 "but this is still a power tool that can generate massive amounts of bug "
10804 "report mails. Use it with care, and read the documentation in the "
10805 "Developer's Reference about mass filing of bug reports first."
10809 #: ../scripts/mass-bug.pl:43
10814 #: ../scripts/mass-bug.pl:45
10816 "The template file is the body of the message that will be sent for each bug "
10817 "report, excluding the BTS pseudo-headers. In the template, #PACKAGE# is "
10818 "replaced with the name of the package. If a version was specified for the "
10819 "package, #VERSION# will be replaced by that version."
10823 #: ../scripts/mass-bug.pl:50
10825 "The components of the version number may be specified using #EPOCH#, "
10826 "#UPSTREAM_VERSION# and #REVISION#. #EPOCH# includes the trailing colon and "
10827 "#REVISION# the leading dash so that #EPOCH#UPSTREAM_VERSION##REVISION# is "
10828 "always the same as #VERSION#."
10832 #: ../scripts/mass-bug.pl:55
10834 "Note that text in the template will be automatically word-wrapped to 70 "
10835 "columns, up to the start of a signature (indicated by S<'-- '> at the start "
10836 "of a line on its own). This is another reason to avoid including BTS "
10837 "pseudo-headers in your template."
10841 #: ../scripts/mass-bug.pl:62
10843 "B<mass-bug> examines the B<devscripts> configuration files as described "
10844 "below. Command line options override the configuration file settings, "
10849 #: ../scripts/mass-bug.pl:68
10850 msgid "--severity=(wishlist|minor|normal|important|serious|grave|critical)"
10854 #: ../scripts/mass-bug.pl:70
10855 msgid "Specify the severity with which bugs should be filed. Default is 'normal'."
10859 #: ../scripts/mass-bug.pl:73
10864 #: ../scripts/mass-bug.pl:75
10866 "Fill out the templates for each package and display them all for "
10867 "verification. This is the default behavior."
10871 #: ../scripts/mass-bug.pl:78
10876 #: ../scripts/mass-bug.pl:80
10877 msgid "Actually send the bug reports."
10881 #: ../scripts/mass-bug.pl:82
10882 msgid "--subject=\"bug subject\""
10886 #: ../scripts/mass-bug.pl:84
10888 "Specify the subject of the bug report. The subject will be automatically "
10889 "prefixed with the name of the package that the bug is filed against."
10893 #: ../scripts/mass-bug.pl:87
10898 #: ../scripts/mass-bug.pl:89
10899 msgid "Set the BTS pseudo-header for tags."
10903 #: ../scripts/mass-bug.pl:91
10908 #: ../scripts/mass-bug.pl:93
10909 msgid "Set the BTS pseudo-header for a usertags' user."
10913 #: ../scripts/mass-bug.pl:95
10918 #: ../scripts/mass-bug.pl:97
10919 msgid "Set the BTS pseudo-header for usertags."
10923 #: ../scripts/mass-bug.pl:99
10928 #: ../scripts/mass-bug.pl:101
10930 "Specify that package names refer to source packages rather than binary "
10935 #: ../scripts/mass-bug.pl:106
10937 "Specify the sendmail command. The command will be split on white space and "
10938 "will not be passed to a shell. Default is '/usr/sbin/sendmail'."
10942 #: ../scripts/mass-bug.pl:109
10947 #: ../scripts/mass-bug.pl:111
10948 msgid "Do not wrap the template to lines of 70 characters."
10952 #: ../scripts/mass-bug.pl:118
10957 #: ../scripts/mass-bug.pl:130
10959 "DEBEMAIL and EMAIL can be set in the environment to control the email "
10960 "address that the bugs are sent from."
10964 #: ../scripts/mass-bug.pl:516
10965 msgid "This program is Copyright (C) 2006 by Joey Hess <joeyh@debian.org>."
10969 #: ../scripts/mergechanges.1:1
10971 msgid "MERGECHANGES"
10974 #. type: Plain text
10975 #: ../scripts/mergechanges.1:4
10976 msgid "mergechanges - merge multiple changes files"
10979 #. type: Plain text
10980 #: ../scripts/mergechanges.1:6
10981 msgid "B<mergechanges> [B<-f>] I<file1 file2> [I<file>...]"
10984 #. type: Plain text
10985 #: ../scripts/mergechanges.1:13
10987 "B<mergechanges> merges two or more I<.changes> files, merging the "
10988 "Architecture, Description and Files (and Checksums-*, if present) fields of "
10989 "the two. There are checks made to ensure that the changes files are from "
10990 "the same source package and version and use the same changes file Format. "
10991 "The first changes file is used as the basis and the information from the "
10992 "later ones is merged into it."
10995 #. type: Plain text
10996 #: ../scripts/mergechanges.1:18
10998 "The output is normally written to I<stdout>. If the B<-f> option is given, "
10999 "the output is written to I<package>_I<version>_multi.changes instead, in the "
11000 "same directory as the first changes file listed."
11003 #. type: Plain text
11004 #: ../scripts/mergechanges.1:21
11006 "Gergely Nagy E<lt>algernon@debian.orgE<gt>, modifications by Julian Gilbey "
11007 "E<lt>jdg@debian.orgE<gt> and Adam D. Barratt "
11008 "E<lt>adam@adam-barratt.org.ukE<gt>."
11012 #: ../scripts/mk-build-deps.pl:26
11013 msgid "mk-build-deps - build a package satisfying a package's build-dependencies"
11017 #: ../scripts/mk-build-deps.pl:30
11018 msgid "B<mk-build-deps> --help|--version"
11022 #: ../scripts/mk-build-deps.pl:32
11023 msgid "B<mk-build-deps> [options] <control file | package name> [...]"
11027 #: ../scripts/mk-build-deps.pl:36
11029 "Given a package name and/or control file, B<mk-build-deps> will use "
11030 "B<equivs> to generate a binary package which may be installed to satisfy all "
11031 "the build dependencies of the given package."
11035 #: ../scripts/mk-build-deps.pl:40
11037 "If B<--build-dep> and/or B<--build-indep> are given, then the resulting "
11038 "binary package(s) will depend solely on the "
11039 "Build-Depends/Build-Depends-Indep dependencies, respectively."
11043 #: ../scripts/mk-build-deps.pl:48
11044 msgid "B<-i>, B<--install>"
11048 #: ../scripts/mk-build-deps.pl:50
11049 msgid "Install the generated packages and its build-dependencies."
11053 #: ../scripts/mk-build-deps.pl:52
11054 msgid "B<-t>, B<--tool>"
11058 #: ../scripts/mk-build-deps.pl:54
11060 "When installing the generated package use the specified tool. (default: "
11065 #: ../scripts/mk-build-deps.pl:57
11066 msgid "B<-r>, B<--remove>"
11070 #: ../scripts/mk-build-deps.pl:59
11072 "Remove the package file after installing it. Ignored if used without the "
11077 #: ../scripts/mk-build-deps.pl:62
11078 msgid "B<-a> I<foo>, B<--arch> I<foo>"
11082 #: ../scripts/mk-build-deps.pl:64
11084 "If the source package has architecture-specific build dependencies, produce "
11085 "a package for architecture I<foo>, not for the system architecture. (If the "
11086 "source package does not have architecture-specific build dependencies, the "
11087 "package produced is always for the pseudo-architecture B<all>.)"
11091 #: ../scripts/mk-build-deps.pl:69
11092 msgid "B<-B>, B<--build-dep>"
11096 #: ../scripts/mk-build-deps.pl:71
11098 "Generate a package which only depends on the source package's Build-Depends "
11103 #: ../scripts/mk-build-deps.pl:74
11104 msgid "B<-A>, B<--build-indep>"
11108 #: ../scripts/mk-build-deps.pl:76
11110 "Generate a package which only depends on the source package's "
11111 "Build-Depends-Indep dependencies."
11115 #: ../scripts/mk-build-deps.pl:91
11117 "B<mk-build-deps> is copyright by Vincent Fourmond and was modified for the "
11118 "devscripts package by Adam D. Barratt <adam@adam-barratt.org.uk>."
11122 #: ../scripts/mk-build-deps.pl:94 ../scripts/transition-check.pl:77
11124 "This program comes with ABSOLUTELY NO WARRANTY. You are free to "
11125 "redistribute this code under the terms of the GNU General Public License, "
11126 "version 2 or later."
11130 #: ../scripts/namecheck.pl:5
11131 msgid "namecheck - Check project names are not already taken."
11135 #: ../scripts/namecheck.pl:7
11140 #: ../scripts/namecheck.pl:9
11142 "This is a simple tool to automate the testing of project names at the most "
11143 "common Open Source / Free Software hosting environments."
11147 #: ../scripts/namecheck.pl:12
11149 "Each new project requires a name, and those names are ideally unique. To "
11150 "come up with names is hard, and testing to ensure they're not already in use "
11151 "is time-consuming - unless you have a tool such as this one."
11155 #: ../scripts/namecheck.pl:16
11156 msgid "CUSTOMIZATION"
11160 #: ../scripts/namecheck.pl:18
11161 msgid "The script, as-is, contains a list of sites, and patterns, to test against."
11165 #: ../scripts/namecheck.pl:20
11167 "If those patterns aren't sufficient then you may create your own additions "
11168 "and add them to the script. If you wish to have your own version of the "
11169 "patterns you may save them into the file ~/.namecheckrc"
11173 #: ../scripts/namecheck.pl:24
11178 #: ../scripts/namecheck.pl:26
11179 msgid "The most recent version of this script may be found here:"
11183 #: ../scripts/namecheck.pl:28
11184 msgid "http://mybin.repository.steve.org.uk/?raw-file/tip/namecheck"
11188 #: ../scripts/namecheck.pl:32
11189 msgid "Steve -- http://www.steve.org.uk/"
11193 #: ../scripts/namecheck.pl:38
11194 msgid "Copyright (c) 2008 by Steve Kemp. All rights reserved."
11198 #: ../scripts/namecheck.pl:40
11200 "This module is free software; you can redistribute it and/or modify it under "
11201 "the same terms as Perl itself."
11205 #: ../scripts/nmudiff.1:1
11210 #. type: Plain text
11211 #: ../scripts/nmudiff.1:4
11212 msgid "nmudiff - email an NMU diff to the Debian BTS"
11215 #. type: Plain text
11216 #: ../scripts/nmudiff.1:6
11217 msgid "B<nmudiff> [I<options>]"
11220 #. type: Plain text
11221 #: ../scripts/nmudiff.1:16
11223 "B<nmudiff> should be run in the source tree of the package being NMUed, "
11224 "after the NMU is built. It assumes that the source packages (specifically, "
11225 "the .dsc and any corresponding tar and diff files) for both the previous "
11226 "version of the package and the newly built NMU version are in the parent "
11227 "directory. It then uses B<debdiff> to generate a diff between the previous "
11228 "version and the current NMU, and either runs mutt or an editor (using "
11229 "B<sensible-editor>) so that the mail message (including the diff) can be "
11230 "examined and modified; once you exit the editor the diff will be mailed to "
11234 #. type: Plain text
11235 #: ../scripts/nmudiff.1:21
11237 "The default behaviour is that if exactly one bug is closed by this NMU, then "
11238 "that bug will be mailed, otherwise a new bug will be submitted. This "
11239 "behaviour may be changed by command line options and configuration file "
11244 #: ../scripts/nmudiff.1:22
11249 #. type: Plain text
11250 #: ../scripts/nmudiff.1:26
11252 "Instead of mailing the bug reports which are to be closed by this NMU, a new "
11253 "bug report is submitted directly to the BTS."
11257 #: ../scripts/nmudiff.1:26
11262 #. type: Plain text
11263 #: ../scripts/nmudiff.1:31
11265 "Send the bug report to all of the bugs which are being closed by this NMU, "
11266 "rather than opening a new bug report. This option has no effect if no bugs "
11267 "are being closed by this NMU."
11271 #: ../scripts/nmudiff.1:31
11276 #. type: Plain text
11277 #: ../scripts/nmudiff.1:36
11279 "Use B<mutt>(1) for editing and sending the message to the BTS (default "
11280 "behaviour). This can be controlled using a configuration file option (see "
11285 #: ../scripts/nmudiff.1:36
11287 msgid "B<--no-mutt>"
11290 #. type: Plain text
11291 #: ../scripts/nmudiff.1:41
11293 "Use B<sensible-editor>(1) to edit the message and then mail it directly "
11294 "using I</usr/bin/sendmail>. This can be controlled using a configuration "
11295 "file option (see below)."
11299 #: ../scripts/nmudiff.1:41
11301 msgid "B<--sendmail> I<SENDMAILCMD>"
11304 #. type: Plain text
11305 #: ../scripts/nmudiff.1:51
11307 "Specify the sendmail command. The command will be split on white space and "
11308 "will be interpreted by the shell. Default is I</usr/sbin/sendmail>. The "
11309 "I<-t> option will be automatically added if the command is "
11310 "I</usr/sbin/sendmail> or I</usr/sbin/exim*>. For other mailers, if they "
11311 "require a I<-t> option, this must be included in the I<SENDMAILCMD>, for "
11312 "example: --sendmail=\"/usr/sbin/mymailer -t\". This can also be set using "
11313 "the devscripts configuration files; see below."
11317 #: ../scripts/nmudiff.1:51
11319 msgid "B<--from> I<EMAIL>"
11322 #. type: Plain text
11323 #: ../scripts/nmudiff.1:59
11325 "If using the sendmail (B<--no-mutt>) option, then the email to the BTS will "
11326 "be sent using the name and address in the environment variables DEBEMAIL and "
11327 "DEBFULLNAME. If these are not set, then the variables EMAIL and NAME will "
11328 "be used instead. These can be overridden using the B<--from> option. The "
11329 "program will not work in this case if an email address cannot be determined."
11333 #: ../scripts/nmudiff.1:59
11335 msgid "B<--delay> I<DELAY>"
11338 #. type: Plain text
11339 #: ../scripts/nmudiff.1:66
11341 "Indicate in the generated mail that the NMU has been uploaded to the DELAYED "
11342 "queue, with a delay of I<DELAY> days. The default value is I<XX> which adds "
11343 "a placeholder to the e-mail. A value of 0 indicates that the upload has not "
11344 "been delayed. This can also be set using the devscripts configuration "
11345 "files; see below."
11349 #: ../scripts/nmudiff.1:66
11351 msgid "B<--no-delay>, B<--nodelay>"
11354 #. type: Plain text
11355 #: ../scripts/nmudiff.1:69
11356 msgid "Equivalent to B<--delay 0>."
11360 #: ../scripts/nmudiff.1:85
11362 msgid "B<NMUDIFF_DELAY>"
11365 #. type: Plain text
11366 #: ../scripts/nmudiff.1:91
11368 "If this is set to a number, e-mails generated by B<nmudiff> will by default "
11369 "mention an upload to the DELAYED queue, delayed for the specified number of "
11370 "days. The value \"0\" indicates that the DELAYED queue has not been used."
11374 #: ../scripts/nmudiff.1:91
11376 msgid "B<NMUDIFF_MUTT>"
11379 #. type: Plain text
11380 #: ../scripts/nmudiff.1:96
11382 "Can be \"yes\" (default) or \"no\", and specifies whether to use B<mutt> to "
11383 "compose and send the message or not, as described above."
11387 #: ../scripts/nmudiff.1:96
11389 msgid "B<NMUDIFF_NEWREPORT>"
11392 #. type: Plain text
11393 #: ../scripts/nmudiff.1:104
11395 "This option controls whether a new bug report is made, or whether the diff "
11396 "is sent to the bugs closed by this NMU. Can be \"maybe\" (default), which "
11397 "sends to the existing bug reports if exactly one bug is being closed; "
11398 "\"yes\", which always creates a new report, or \"no\", which always sends to "
11399 "the reports of the bugs being closed (unless no bugs are being closed, in "
11400 "which case a new report is always made)."
11404 #: ../scripts/nmudiff.1:104
11406 msgid "B<BTS_SENDMAIL_COMMAND>"
11409 #. type: Plain text
11410 #: ../scripts/nmudiff.1:113
11411 msgid "B<debdiff>(1), B<sensible-editor>(1) and B<devscripts.conf>(5)."
11414 #. type: Plain text
11415 #: ../scripts/nmudiff.1:117
11417 "B<nmudiff> was written and is copyright 2006 by Steinar H. Gunderson and "
11418 "modified by Julian Gilbey E<lt>jdg@debian.orgE<gt>. The software may be "
11419 "freely redistributed under the terms and conditions of the GNU General "
11420 "Public License, version 2."
11424 #: ../scripts/plotchangelog.1:1
11426 msgid "PLOTCHANGELOG"
11429 #. type: Plain text
11430 #: ../scripts/plotchangelog.1:4
11431 msgid "plotchangelog - graph debian changelogs"
11434 #. type: Plain text
11435 #: ../scripts/plotchangelog.1:7
11436 msgid "B<plotchangelog> I<[options] changelog ...>"
11439 #. type: Plain text
11440 #: ../scripts/plotchangelog.1:17
11442 "B<plotchangelog> is a tool to aid in visualizing a Debian changelog. The "
11443 "changelogs are graphed with B<gnuplot>(1) , with the X axis of the graph "
11444 "denoting time of release and the Y axis denoting the debian version number "
11445 "of the package. Each individual release of the package is represented by a "
11446 "point, and the points are color coded to indicate who released that version "
11447 "of the package. The upstream version number of the package can also be "
11448 "labeled on the graph."
11451 #. type: Plain text
11452 #: ../scripts/plotchangelog.1:21
11454 "Alternatively, the Y axis can be configured to display the size of the "
11455 "changelog entry for each new version. Or it can be configured to display "
11456 "approximately how many bugs were fixed for each new version."
11459 #. type: Plain text
11460 #: ../scripts/plotchangelog.1:24
11462 "Note that if the package is a debian-specific package, the entire package "
11463 "version will be used for the Y axis. This does not always work perfectly."
11467 #: ../scripts/plotchangelog.1:25
11469 msgid "READING THE GRAPH"
11472 #. type: Plain text
11473 #: ../scripts/plotchangelog.1:33
11475 "The general outline of a package's graph is typically a series of peaks, "
11476 "starting at 1, going up to n, and then returning abruptly to 1. The higher "
11477 "the peaks, the more releases the maintainer made between new upstream "
11478 "versions of the package. If a package is debian-only, it's graph will just "
11479 "grow upwards without ever falling (although a bug in this program may cause "
11480 "it to fall sometimes, if the version number goes from say, 0.9 to say, 0.10 "
11481 "- this is interpreted wrong..)"
11484 #. type: Plain text
11485 #: ../scripts/plotchangelog.1:40
11487 "If the graph dips below 1, someone made a NMU of the package and upgraded it "
11488 "to a new upstream version, thus setting the debian version to 0. NMU's in "
11489 "general appear as fractional points like 1.1, 2.1, etc. A NMU can also be "
11490 "easily detected by looking at the points that represent which maintainer "
11491 "uploaded the package -- a solitary point of a different type than the points "
11492 "before and after it is typically a NMU."
11495 #. type: Plain text
11496 #: ../scripts/plotchangelog.1:43
11498 "It's also easy to tell by looking at the points when a package changes "
11503 #: ../scripts/plotchangelog.1:44
11505 msgid "B<-l, --linecount>"
11508 #. type: Plain text
11509 #: ../scripts/plotchangelog.1:50
11511 "Instead of using the debian version number as the Y axis, use the number of "
11512 "lines in the changelog entry for each version. Cannot be used together with "
11517 #: ../scripts/plotchangelog.1:50
11519 msgid "B<-b, --bugcount>"
11522 #. type: Plain text
11523 #: ../scripts/plotchangelog.1:57
11525 "Instead of using the debian version number as the Y axis, use the number of "
11526 "bugs that were closed by each changelog entry. Note that this number is "
11527 "obtained by searching for \"#dddd\" in the changelog, and so it may be "
11528 "inaccurate. Cannot be used together with B<--linecount>."
11532 #: ../scripts/plotchangelog.1:57
11534 msgid "B<-c, --cumulative>"
11537 #. type: Plain text
11538 #: ../scripts/plotchangelog.1:65
11540 "When used together with either B<--bugcount> or B<--linecount>, graphs the "
11541 "cumulative count rather than the count in each individual changelog entry."
11545 #: ../scripts/plotchangelog.1:65
11547 msgid "B<-v, --no-version>"
11550 #. type: Plain text
11551 #: ../scripts/plotchangelog.1:68
11552 msgid "Do not show upstream version labels. Useful if the graph gets too crowded."
11556 #: ../scripts/plotchangelog.1:68
11558 msgid "B<-m, --no-maint>"
11561 #. type: Plain text
11562 #: ../scripts/plotchangelog.1:71
11563 msgid "Do not differentiate between different maintainers of the package."
11567 #: ../scripts/plotchangelog.1:71
11569 msgid "B<-s file, --save=file>"
11572 #. type: Plain text
11573 #: ../scripts/plotchangelog.1:75
11575 "Save the graph to \"file\" in postscript format instead of immediately "
11580 #: ../scripts/plotchangelog.1:75
11582 msgid "B<-u, --urgency>"
11585 #. type: Plain text
11586 #: ../scripts/plotchangelog.1:78
11587 msgid "Use larger points when displaying higher-urgency package uploads."
11590 #. type: Plain text
11591 #: ../scripts/plotchangelog.1:81
11592 msgid "Output the gnuplot script that is fed into gnuplot (for debugging purposes)."
11596 #: ../scripts/plotchangelog.1:81
11598 msgid "B<-g>I<commands,>B<--gnuplot=\">I<commands>"
11601 #. type: Plain text
11602 #: ../scripts/plotchangelog.1:92
11604 "This allows you to insert B<gnuplot>(1) commands into the gnuplot script "
11605 "that is used to generate the graph. The commands are placed after all "
11606 "initialization but before the final \"plot\" command. This can be used to "
11607 "override the default look provided by this program in arbitrary ways. You "
11608 "can also use things like \"set terminal png color\" to change the output "
11609 "file type, which is useful in conjunction with the -s option."
11612 #. type: Plain text
11613 #: ../scripts/plotchangelog.1:95
11614 msgid "Show a usage summary."
11617 #. type: Plain text
11618 #: ../scripts/plotchangelog.1:98
11619 msgid "Display version, author and copyright information."
11623 #: ../scripts/plotchangelog.1:98
11625 msgid "B<--noconf, --no-conf>"
11628 #. type: Plain text
11629 #: ../scripts/plotchangelog.1:101
11630 msgid "Do not read any configuration files (see below)."
11634 #: ../scripts/plotchangelog.1:101
11636 msgid "B<changelog ...>"
11639 #. type: Plain text
11640 #: ../scripts/plotchangelog.1:106
11642 "The changelog files to graph. If multiple files are specified they will all "
11643 "be display on the same graph. The files may be compressed with gzip. Any "
11644 "text in them that is not in Debian changelog format will be ignored."
11647 #. type: Plain text
11648 #: ../scripts/plotchangelog.1:113
11650 "The two configuration files I</etc/devscripts.conf> and I<~/.devscripts> are "
11651 "sourced by a shell in that order to set configuration variables. The "
11652 "B<--no-conf> option can be used to prevent reading these files. Environment "
11653 "variable settings are ignored when these configuration files are read. The "
11654 "currently recognised variables are:"
11658 #: ../scripts/plotchangelog.1:113
11660 msgid "B<PLOTCHANGELOG_OPTIONS>"
11663 #. type: Plain text
11664 #: ../scripts/plotchangelog.1:118
11666 "This is a space-separated list of options to always use, for example \"-l "
11667 "-b\". Do not include \"-g\" or \"--gnuplot\" among this list as it may be "
11668 "ignored; see the next variable instead."
11672 #: ../scripts/plotchangelog.1:118
11674 msgid "B<PLOTCHANGELOG_GNUPLOT>"
11677 #. type: Plain text
11678 #: ../scripts/plotchangelog.1:124
11680 "These are B<gnuplot> commands which will be prepended to any such commands "
11681 "given on the command line."
11684 #. type: Plain text
11685 #: ../scripts/plotchangelog.1:127
11686 msgid "Joey Hess E<lt>joey@kitenet.netE<gt>"
11690 #: ../scripts/pts-subscribe.1:1
11692 msgid "PTS-SUBSCRIBE"
11695 #. type: Plain text
11696 #: ../scripts/pts-subscribe.1:4
11697 msgid "pts-subscribe - time-limited subscription to the PTS"
11700 #. type: Plain text
11701 #: ../scripts/pts-subscribe.1:6
11702 msgid "B<pts-subscribe> [options] I<package>"
11705 #. type: Plain text
11706 #: ../scripts/pts-subscribe.1:8
11707 msgid "B<pts-unsubscribe> [options] I<package>"
11710 #. type: Plain text
11711 #: ../scripts/pts-subscribe.1:12
11713 "B<pts-subscribe> sends a subscription request for I<package> to the Package "
11714 "Tracking System at pts@qa.debian.org, and cancels the subscription 30 days "
11718 #. type: Plain text
11719 #: ../scripts/pts-subscribe.1:15
11721 "If called as B<pts-unsubscribe>, send an unsubscription request for "
11722 "I<package> to the Package Tracking System."
11725 #. type: Plain text
11726 #: ../scripts/pts-subscribe.1:18
11728 "This utility is useful if a developer has made an NMU and wants to track the "
11729 "package for a limited period of time."
11733 #: ../scripts/pts-subscribe.1:19
11735 msgid "B<--until >I<time>, B<-u> I<time>"
11738 #. type: Plain text
11739 #: ../scripts/pts-subscribe.1:24
11741 "When B<at>(1) should cancel the subscription. I<time> must be specified "
11742 "using B<at>'s syntax. Default is 'now + 30 days'. This option will "
11743 "probably require quoting!"
11747 #: ../scripts/pts-subscribe.1:24
11749 msgid "B<--forever>"
11752 #. type: Plain text
11753 #: ../scripts/pts-subscribe.1:28
11755 "Don't cancel the subscription automatically. This can also be specified as "
11756 "B<--until forever>."
11760 #: ../scripts/pts-subscribe.1:35
11762 msgid "B<DEBEMAIL>, B<EMAIL>"
11765 #. type: Plain text
11766 #: ../scripts/pts-subscribe.1:42
11768 "If one of these is set (with preference give to DEBEMAIL), then this will be "
11769 "used for the subscription address. If neither is set, then the email will "
11770 "be sent without a specified subscription address, and the email's From: line "
11771 "will be used to determine the sender's address. This will be determined by "
11776 #: ../scripts/pts-subscribe.1:48
11778 msgid "B<PTS_UNTIL>"
11781 #. type: Plain text
11782 #: ../scripts/pts-subscribe.1:51
11783 msgid "Setting this is equivalent to giving a B<--until> option."
11786 #. type: Plain text
11787 #: ../scripts/pts-subscribe.1:56
11789 "B<at>(1), information about the Package Tracking System in the Developer's "
11791 "http://www.debian.org/doc/developers-reference/ch-resources#s-pkg-tracking-system"
11794 #. type: Plain text
11795 #: ../scripts/pts-subscribe.1:59
11797 "This program was written by Julian Gilbey E<lt>jdg@debian.orgE<gt> based on "
11798 "a public domain prototype by Raphael Hertzog E<lt>hertzog@debian.orgE<gt> "
11799 "and is copyright under the GPL, version 2 or later."
11803 #: ../scripts/rc-alert.1:1
11808 #. type: Plain text
11809 #: ../scripts/rc-alert.1:4
11810 msgid "rc-alert - check for installed packages with release-critical bugs"
11813 #. type: Plain text
11814 #: ../scripts/rc-alert.1:6
11816 "B<rc-alert [inclusion options] [--debtags [tag[,tag ...]] [--popcon] "
11820 #. type: Plain text
11821 #: ../scripts/rc-alert.1:8
11822 msgid "B<rc-alert --help|--version>"
11825 #. type: Plain text
11826 #: ../scripts/rc-alert.1:12
11828 "B<rc-alert> downloads the list of release-critical bugs from the Debian BTS "
11829 "webpages, and then outputs a list of packages installed on the system, or "
11830 "given on the command-line, which are in that list."
11833 #. type: Plain text
11834 #: ../scripts/rc-alert.1:17
11836 "If the directory I<~/.devscripts_cache> exists or the B<--cache> option is "
11837 "given, then the (sizable) downloaded list will be cached, and will only be "
11838 "downloaded again on a second invocation if it has changed."
11842 #: ../scripts/rc-alert.1:18
11847 #. type: Plain text
11848 #: ../scripts/rc-alert.1:21
11849 msgid "Force the creation of the I<~/.devscripts_cache> cache directory."
11852 #. type: Plain text
11853 #: ../scripts/rc-alert.1:31
11855 "It is also possible to filter the list of bugs reported based on the tags "
11856 "and distributions associated with the package. The filtering options are:"
11860 #: ../scripts/rc-alert.1:31
11862 msgid "B<--include-tags>, B<-f>"
11865 #. type: Plain text
11866 #: ../scripts/rc-alert.1:35
11868 "A list of tags which the bug must have, in the format used for output. For "
11869 "example, to include bugs tagged security or help wanted, use \"SH\"."
11873 #: ../scripts/rc-alert.1:35
11875 msgid "B<--include-tag-op>, B<-t>"
11878 #. type: Plain text
11879 #: ../scripts/rc-alert.1:39
11881 "If set to I<and>, a bug must have all of the tags specified by "
11882 "B<--include-tags>."
11886 #: ../scripts/rc-alert.1:39
11888 msgid "B<--exclude-tags>"
11891 #. type: Plain text
11892 #: ../scripts/rc-alert.1:43
11894 "A list of tags which the bug must not have, in the same format as "
11895 "B<--include-tags>."
11899 #: ../scripts/rc-alert.1:43
11901 msgid "B<--exclude-tag-op>"
11904 #. type: Plain text
11905 #: ../scripts/rc-alert.1:48
11907 "If set to I<and>, a bug must have none of the tags specified by "
11908 "B<--exclude-tags>. By default, the bug will be excluded if any tag matches."
11912 #: ../scripts/rc-alert.1:48
11914 msgid "B<--include-dists>, B<-d>"
11917 #. type: Plain text
11918 #: ../scripts/rc-alert.1:52
11920 "A list of distributions which the bug must apply to, in the format used for "
11921 "output. For example, to include bugs affecting testing or unstable, use "
11926 #: ../scripts/rc-alert.1:52
11928 msgid "B<--include-dist-op>, B<-o>"
11931 #. type: Plain text
11932 #: ../scripts/rc-alert.1:56
11934 "If set to I<and>, a bug must apply to all of the specified distributions in "
11935 "order to be included."
11939 #: ../scripts/rc-alert.1:56
11941 msgid "B<--exclude-dists>"
11944 #. type: Plain text
11945 #: ../scripts/rc-alert.1:60
11947 "A list of distributions to which the bug must not apply, in the same format "
11948 "as B<--include-dists>."
11952 #: ../scripts/rc-alert.1:60
11954 msgid "B<--exclude-dist-op>"
11957 #. type: Plain text
11958 #: ../scripts/rc-alert.1:65
11960 "If set to I<and>, a bug must apply to all of the specified distributions in "
11961 "order to be excluded. By default the bug will be excluded if it applies to "
11962 "any of the listed distributions."
11965 #. type: Plain text
11966 #: ../scripts/rc-alert.1:70
11968 "It is also possible to only list bugs which have specific debtags set. Note "
11969 "that you need to have debtags installed and also that it's not mandatory for "
11970 "maintainers to set proper debtags. The produced list will thus probably be "
11975 #: ../scripts/rc-alert.1:70
11977 msgid "B<--debtags>"
11980 #. type: Plain text
11981 #: ../scripts/rc-alert.1:75
11983 "Match packages based on the listed tags. Each package is matched only if it "
11984 "has all the listed tags; in the case of multiple tags within the same facet, "
11985 "a package is matched if it has any of the listed tags within the facet."
11989 #: ../scripts/rc-alert.1:75
11991 msgid "B<--debtags-database>"
11994 #. type: Plain text
11995 #: ../scripts/rc-alert.1:79
11997 "Use a non-standard debtags database. The default is "
11998 "I</var/lib/debtags/packages-tags>."
12001 #. type: Plain text
12002 #: ../scripts/rc-alert.1:83
12004 "Popularity-contest collects data about installation and usage of Debian "
12005 "packages. You can additionally sort the bugs by the popcon rank of the "
12006 "related packages."
12010 #: ../scripts/rc-alert.1:83
12012 msgid "B<--popcon>"
12015 #. type: Plain text
12016 #: ../scripts/rc-alert.1:86
12017 msgid "Sort bugs by the popcon rank of the package the bug belongs to."
12021 #: ../scripts/rc-alert.1:86
12023 msgid "B<--pc-vote>"
12026 #. type: Plain text
12027 #: ../scripts/rc-alert.1:92
12029 "By default, packages are sorted according to the number of people who have "
12030 "the package installed. This option enables sorting by the number of people "
12031 "regularly using the package instead. This option has no effect in "
12032 "combination with --pc-local."
12036 #: ../scripts/rc-alert.1:92
12038 msgid "B<--pc-local>"
12041 #. type: Plain text
12042 #: ../scripts/rc-alert.1:96
12044 "Instead of requesting remote data the information from the last popcon run "
12045 "is used (I</var/log/popularity-contest>)."
12049 #: ../scripts/rc-alert.1:97
12051 msgid "B<--include-dists> OS"
12054 #. type: Plain text
12055 #: ../scripts/rc-alert.1:100
12056 msgid "The bug must apply to at least one of oldstable or stable"
12060 #: ../scripts/rc-alert.1:100
12062 msgid "B<--include-dists> TUB< --include-dist-op> and"
12065 #. type: Plain text
12066 #: ../scripts/rc-alert.1:103
12067 msgid "The bug must apply to both testing and unstable"
12071 #: ../scripts/rc-alert.1:103
12073 msgid "B<--include-dists> OB< --include-tags> SB< --exclude-tags> +"
12076 #. type: Plain text
12077 #: ../scripts/rc-alert.1:106
12078 msgid "The bug must apply to oldstable and be tagged security but not patch"
12082 #: ../scripts/rc-alert.1:106
12084 msgid "B<--exclude-dists> SOTB< --include-tags> R"
12087 #. type: Plain text
12088 #: ../scripts/rc-alert.1:110
12090 "The bug must apply to only unstable or experimental (or both) and be tagged "
12095 #: ../scripts/rc-alert.1:110
12097 msgid "B<--debtags> implemented-in::perl,role::plugin,implemented-in::python"
12100 #. type: Plain text
12101 #: ../scripts/rc-alert.1:115
12103 "The bug must apply to packages matching the specified debtags, i.e. the "
12104 "match will only include packages that have the 'role::plugin' tag and that "
12105 "have either of the tags 'implemented-in::perl' or 'implemented-in::python'."
12109 #: ../scripts/rc-alert.1:115
12111 msgid "B<--popcon> B<--pc-local>"
12114 #. type: Plain text
12115 #: ../scripts/rc-alert.1:119
12117 "Read I</var/log/popularity-contest> and sort bugs by your personal popcon "
12118 "ranking (which is basically the atime of your packages' binaries)."
12121 #. type: Plain text
12122 #: ../scripts/rc-alert.1:121
12123 msgid "It is not possible to say \"does not apply only to unstable\""
12126 #. type: Plain text
12127 #: ../scripts/rc-alert.1:125
12128 msgid "B<debtags(1)> B<popbugs(1)> B<popularity-contest(8)>"
12131 #. type: Plain text
12132 #: ../scripts/rc-alert.1:129
12134 "B<rc-alert> was written by Anthony DeRobertis and modified by Julian Gilbey "
12135 "E<lt>jdg@debian.orgE<gt> and Adam D. Barratt "
12136 "E<lt>adam@adam-barratt.org.ukE<gt> for the devscripts package. Debtags and "
12137 "popcon functionality was added by Jan Hauke Rahm "
12138 "E<lt>info@jhr-online.deE<gt>."
12142 #: ../scripts/rmadison.pl:183
12143 msgid "rmadison -- Remotely query the Debian archive database about packages"
12147 #: ../scripts/rmadison.pl:189
12148 msgid "B<rmadison> [I<OPTIONS>] I<PACKAGE> ..."
12152 #: ../scripts/rmadison.pl:195
12154 "B<dak ls> queries the Debian archive database (\"projectb\") and displays "
12155 "which package version is registered per architecture/component/suite. The "
12156 "CGI at B<http://qa.debian.org/madison.php> provides that service without "
12157 "requiring ssh access to ftp-master.debian.org or the mirror on "
12158 "ries.debian.org. This script, B<rmadison>, is a command line frontend to "
12163 #: ../scripts/rmadison.pl:206
12164 msgid "B<-a>, B<--architecture=>I<ARCH>"
12168 #: ../scripts/rmadison.pl:208
12169 msgid "only show info for ARCH(s)"
12173 #: ../scripts/rmadison.pl:210
12174 msgid "B<-b>, B<--binary-type=>I<TYPE>"
12178 #: ../scripts/rmadison.pl:212
12179 msgid "only show info for binary TYPE"
12183 #: ../scripts/rmadison.pl:214
12184 msgid "B<-c>, B<--component=>I<COMPONENT>"
12188 #: ../scripts/rmadison.pl:216
12189 msgid "only show info for COMPONENT(s)"
12193 #: ../scripts/rmadison.pl:218
12194 msgid "B<-g>, B<--greaterorequal>"
12198 #: ../scripts/rmadison.pl:220
12199 msgid "show buildd 'dep-wait pkg >= {highest version}' info"
12203 #: ../scripts/rmadison.pl:222
12204 msgid "B<-G>, B<--greaterthan>"
12208 #: ../scripts/rmadison.pl:224
12209 msgid "show buildd 'dep-wait pkg >> {highest version}' info"
12213 #: ../scripts/rmadison.pl:228
12214 msgid "show this help and exit"
12218 #: ../scripts/rmadison.pl:230
12219 msgid "B<-s>, B<--suite=>I<SUITE>"
12223 #: ../scripts/rmadison.pl:232
12224 msgid "only show info for this suite"
12228 #: ../scripts/rmadison.pl:234
12229 msgid "B<-S>, B<--source-and-binary>"
12233 #: ../scripts/rmadison.pl:236
12234 msgid "show info for the binary children of source pkgs"
12238 #: ../scripts/rmadison.pl:238
12239 msgid "B<-t>, B<--time>"
12243 #: ../scripts/rmadison.pl:240
12244 msgid "show projectb snapshot and reload time (not supported by all archives)"
12248 #: ../scripts/rmadison.pl:242
12249 msgid "B<-u>, B<--url=>I<URL>[B<,>I<URL...>]"
12253 #: ../scripts/rmadison.pl:244
12256 "use I<URL> for the query. Supported shorthands are\n"
12257 " B<debian> or B<qa> http://qa.debian.org/madison.php (the default)\n"
12258 " B<bpo> http://backports.debian.org/cgi-bin/madison.cgi\n"
12259 " B<debug> http://debug.debian.net/cgi-bin/madison.cgi\n"
12260 " B<ubuntu> http://people.canonical.com/~ubuntu-archive/madison.cgi\n"
12265 #: ../scripts/rmadison.pl:250
12267 "See the B<RMADISON_URL_MAP_> variable below for a method to add new "
12272 #: ../scripts/rmadison.pl:255
12273 msgid "show version and exit"
12277 #: ../scripts/rmadison.pl:259
12278 msgid "don't read the devscripts configuration files"
12282 #: ../scripts/rmadison.pl:263
12284 "ARCH, COMPONENT and SUITE can be comma (or space) separated lists, e.g. "
12285 "--architecture=m68k,i386"
12289 #: ../scripts/rmadison.pl:276
12290 msgid "B<RMADISON_URL_MAP_>I<SHORTHAND>=I<URL>"
12294 #: ../scripts/rmadison.pl:278
12296 "Add an entry to the set of shorthand URLs listed above. I<SHORTHAND> should "
12297 "be replaced with the shorthand form to be used to refer to I<URL>."
12301 #: ../scripts/rmadison.pl:281
12303 "Multiple shorthand entries may be specified by using multiple "
12304 "B<RMADISON_URL_MAP_*> variables."
12308 #: ../scripts/rmadison.pl:284
12309 msgid "B<RMADISON_DEFAULT_URL>=I<URL>"
12313 #: ../scripts/rmadison.pl:286
12314 msgid "Set the default URL to use unless overridden by a command line option."
12318 #: ../scripts/rmadison.pl:292
12320 "B<dak ls> also supports B<-r>, B<--regex> to treat I<PACKAGE> as a "
12321 "regex. Since that can easily DoS the database (\"-r .\"), this option is not "
12322 "supported by the CGI and rmadison."
12326 #: ../scripts/rmadison.pl:296
12327 msgid "B<dak ls> was formerly called B<madison>."
12331 #: ../scripts/rmadison.pl:298
12333 "The protocol used by rmadison is fairly simple, the CGI accepts query the "
12334 "parameters a, b, c, g, G, s, S, t, and package. The parameter text is passed "
12335 "to enable plain-text output."
12339 #: ../scripts/rmadison.pl:304
12340 msgid "madison-lite(1), dak(1)."
12344 #: ../scripts/rmadison.pl:308
12346 "rmadison and http://qa.debian.org/madison.php were written by Christoph Berg "
12347 "<myon@debian.org>. dak was written by James Troup <james@nocrew.org>, "
12348 "Anthony Towns <ajt@debian.org>, and others."
12352 #: ../scripts/svnpath.pl:5
12353 msgid "svnpath - output svn url with support for tags and branches"
12357 #: ../scripts/svnpath.pl:9
12362 #: ../scripts/svnpath.pl:11
12363 msgid "svnpath tags"
12367 #: ../scripts/svnpath.pl:13
12368 msgid "svnpath branches"
12372 #: ../scripts/svnpath.pl:15
12373 msgid "svnpath trunk"
12377 #: ../scripts/svnpath.pl:19
12378 msgid "svnpath is intended to be run in a subversion working copy."
12382 #: ../scripts/svnpath.pl:21
12384 "In its simplest usage, svnpath with no parameters outputs the svn url for "
12385 "the repository associated with the working copy."
12389 #: ../scripts/svnpath.pl:24
12391 "If a parameter is given, svnpath attempts to instead output the url that "
12392 "would be used for the tags, branches, or trunk. This will only work if it's "
12393 "run in the top-level directory that is subject to tagging or branching."
12397 #: ../scripts/svnpath.pl:28
12399 "For example, if you want to tag what's checked into subversion as version "
12400 "1.0, you could use a command like this:"
12404 #: ../scripts/svnpath.pl:31
12407 " svn cp $(svnpath) $(svnpath tags)/1.0\n"
12412 #: ../scripts/svnpath.pl:33
12414 "That's much easier than using svn info to look up the repository url and "
12415 "manually modifying it to derive the url to use for the tag, and typing in "
12416 "something like this:"
12420 #: ../scripts/svnpath.pl:37
12423 " svn cp svn+ssh://my.server.example/svn/project/trunk "
12424 "svn+ssh://my.server.example/svn/project/tags/1.0\n"
12429 #: ../scripts/svnpath.pl:39
12431 "svnpath uses a simple heuristic to convert between the trunk, tags, and "
12432 "branches paths. It replaces the first occurrence of \"trunk\", \"tags\", or "
12433 "\"branches\" with the name of what you're looking for. This will work ok for "
12434 "most typical subversion repository layouts."
12438 #: ../scripts/svnpath.pl:44
12440 "If you have an atypical layout and it does not work, you can add a "
12441 "~/.svnpath file. This file is perl code, which can modify the path in $url. "
12442 "For example, the author uses this file:"
12446 #: ../scripts/svnpath.pl:48
12449 " #!/usr/bin/perl\n"
12450 " # svnpath personal override file\n"
12455 #: ../scripts/svnpath.pl:51
12458 " # For d-i I sometimes work from a full d-i tree branch. Remove that from\n"
12459 " # the path to get regular tags or branches directories.\n"
12460 " $url=~s!d-i/(rc|beta)[0-9]+/!!;\n"
12461 " $url=~s!d-i/sarge/!!;\n"
12467 #: ../scripts/svnpath.pl:95
12468 msgid "GPL version 2 or later"
12472 #: ../scripts/svnpath.pl:99
12473 msgid "Joey Hess <joey@kitenet.net>"
12477 #: ../scripts/tagpending.pl:82
12479 "tagpending - tags bugs that are to be closed in the latest changelog as "
12484 #: ../scripts/tagpending.pl:86
12485 msgid "B<tagpending> [options]"
12489 #: ../scripts/tagpending.pl:90
12491 "B<tagpending> parses debian/changelog to determine which bugs would be "
12492 "closed if the package were uploaded. Each bug is then marked as pending, "
12493 "using B<bts>(1) if it is not already so."
12497 #: ../scripts/tagpending.pl:98
12498 msgid "-n, --noact"
12502 #: ../scripts/tagpending.pl:100
12503 msgid "Check whether any bugs require tagging, but do not actually do so."
12507 #: ../scripts/tagpending.pl:102
12508 msgid "-s, --silent"
12512 #: ../scripts/tagpending.pl:104
12513 msgid "Do not output any messages."
12517 #: ../scripts/tagpending.pl:106
12518 msgid "-v, --verbose"
12522 #: ../scripts/tagpending.pl:108
12523 msgid "List each bug checked and tagged in turn."
12527 #: ../scripts/tagpending.pl:110
12528 msgid "-f, --force"
12532 #: ../scripts/tagpending.pl:112
12533 msgid "Do not query the BTS, but (re)tag all bugs closed in the changelog."
12537 #: ../scripts/tagpending.pl:114
12542 #: ../scripts/tagpending.pl:116
12544 "Include the changelog header line and the entries relating to the tagged "
12545 "bugs as comments in the generated mail. This is the default."
12549 #: ../scripts/tagpending.pl:119
12551 "Note that when used in combination with --to, the header line output will "
12552 "always be that of the most recent version."
12556 #: ../scripts/tagpending.pl:122
12557 msgid "--no-comments"
12561 #: ../scripts/tagpending.pl:124
12562 msgid "Do not include changelog entries in the generated mail."
12566 #: ../scripts/tagpending.pl:126
12567 msgid "-c, --confirm"
12571 #: ../scripts/tagpending.pl:128
12572 msgid "Tag bugs as both confirmed and pending."
12576 #: ../scripts/tagpending.pl:130
12577 msgid "-t, --to <version>"
12581 #: ../scripts/tagpending.pl:132
12582 msgid "Parse changelogs for all versions strictly greater than <version>."
12586 #: ../scripts/tagpending.pl:134
12587 msgid "Equivalent to dpkg-parsechangelog's -v option."
12591 #: ../scripts/tagpending.pl:138
12593 "Display the message which would be sent to the BTS and, except when --noact "
12594 "was used, prompt for confirmation before sending it."
12598 #: ../scripts/tagpending.pl:141
12603 #: ../scripts/tagpending.pl:143
12605 "For each bug that does not appear to belong to the current package, check "
12606 "whether it is filed against wnpp. If so, tag it. This allows e.g. ITAs and "
12607 "ITPs closed in an upload to be tagged."
12611 #: ../scripts/tagpending.pl:151
12612 msgid "B<bts>(1) and B<dpkg-parsechangelog>(1)"
12616 #: ../scripts/tagpending.pl:433
12618 "This program is Copyright 2008 by Adam D. Barratt "
12619 "<adam@adam-barratt.org.uk>."
12623 #: ../scripts/tagpending.pl:436
12625 "The shell script tagpending, on which this program is based, is Copyright "
12626 "2004 by Joshua Kwan <joshk@triplehelix.org> with changes copyright 2004-7 by "
12627 "their respective authors."
12631 #: ../scripts/transition-check.pl:25
12632 msgid "transition-check - check a package list for involvement in transitions"
12636 #: ../scripts/transition-check.pl:29
12637 msgid "B<transition-check> B<--help|--version>"
12641 #: ../scripts/transition-check.pl:31
12642 msgid "B<transition-check> [B<-f|--filename>=I<FILENAME>] [I<source package list>]"
12646 #: ../scripts/transition-check.pl:35
12648 "B<transition-check> checks whether any of the listed source packages are "
12649 "involved in a transition for which uploads to unstable are currently "
12654 #: ../scripts/transition-check.pl:39
12656 "If neither a filename nor a list of packages is supplied, "
12657 "B<transition-check> will use the source package name from I<debian/control>."
12661 #: ../scripts/transition-check.pl:46
12662 msgid "B<-f> B<--filename>=I<filename>"
12666 #: ../scripts/transition-check.pl:48
12668 "Read a source package name from I<filename>, which should be a Debian "
12669 "package control file or .changes file, and add that package to the list of "
12670 "packages to check."
12674 #: ../scripts/transition-check.pl:56
12676 "The exit status indicates whether any of the packages examined were found to "
12677 "be involved in a transition."
12681 #: ../scripts/transition-check.pl:61 ../scripts/uscan.1:502 ../scripts/wnpp-check.1:26
12687 #: ../scripts/transition-check.pl:63
12689 "Either B<--help> or B<--version> was used, or none of the packages examined "
12690 "was involved in a transition."
12694 #: ../scripts/transition-check.pl:68
12695 msgid "At least one package examined is involved in a current transition."
12699 #: ../scripts/transition-check.pl:74
12701 "This code is copyright by Adam D. Barratt <adam@adam-barratt.org.uk>, all "
12706 #: ../scripts/uscan.1:1
12711 #. type: Plain text
12712 #: ../scripts/uscan.1:4
12713 msgid "uscan - scan/watch upstream sources for new releases of software"
12716 #. type: Plain text
12717 #: ../scripts/uscan.1:6
12718 msgid "B<uscan> [I<options>] [I<path-to-debian-source-packages> ...]"
12721 #. type: Plain text
12722 #: ../scripts/uscan.1:16
12724 "B<uscan> scans the given directories (or the current directory if none are "
12725 "specified) and all of their subdirectories for packages containing a control "
12726 "file I<debian/watch>. Parameters are then read from those control files and "
12727 "upstream ftp or http sites are inspected for newly available updates (as "
12728 "compared with the upstream version number retrieved from the "
12729 "I<debian/changelog> file in the same directory). The newest updates are "
12730 "retrieved (as determined by their version numbers) and if specified in the "
12731 "watchfile, a program may then be executed on the newly downloaded source."
12734 #. type: Plain text
12735 #: ../scripts/uscan.1:21
12737 "The traditional I<debian/watch> files can still be used, but the current "
12738 "format offers both simpler and more flexible services. We do not describe "
12739 "the old format here; for their documentation, see the source code for uscan."
12743 #: ../scripts/uscan.1:22
12745 msgid "FORMAT of debian/watch files"
12748 #. type: Plain text
12749 #: ../scripts/uscan.1:28
12751 "The following demonstrates the type of entries which can appear in a "
12752 "I<debian/watch> file. Obviously, not all of these would appear in one such "
12753 "file; usually, one would have one line for the current package."
12756 #. type: Plain text
12757 #: ../scripts/uscan.1:33
12760 "# format version number, currently 3; this line is compulsory!\n"
12764 #. type: Plain text
12765 #: ../scripts/uscan.1:35
12767 msgid "# Line continuations are performed with \\e\n"
12770 #. type: Plain text
12771 #: ../scripts/uscan.1:40
12774 "# This is the format for an FTP site:\n"
12775 "# Full-site-with-pattern [Version [Action]]\n"
12776 "ftp://ftp.tex.ac.uk/tex-archive/web/c_cpp/cweb/cweb-(.*)\\e.tar\\e.gz \\e\n"
12777 " debian uupdate\n"
12780 #. type: Plain text
12781 #: ../scripts/uscan.1:44
12784 "# This is the format for an FTP site with regex special characters in\n"
12785 "# the filename part\n"
12786 "ftp://ftp.worldforge.org/pub/worldforge/libs/Atlas-C++/transitional/Atlas-C\\e+\\e+-(.*)\\e.tar\\e.gz\n"
12789 #. type: Plain text
12790 #: ../scripts/uscan.1:47
12793 "# This is the format for an FTP site with directory pattern matching\n"
12794 "ftp://ftp.nessus.org/pub/nessus/nessus-([\\ed\\e.]+)/src/nessus-core-([\\ed\\e.]+)\\e.tar\\e.gz\n"
12797 #. type: Plain text
12798 #: ../scripts/uscan.1:51
12801 "# This can be used if you want to override the PASV setting\n"
12802 "# for a specific site\n"
12803 "# opts=pasv ftp://.../...\n"
12806 #. type: Plain text
12807 #: ../scripts/uscan.1:57
12810 "# This is one format for an HTTP site, which is the same\n"
12811 "# as the FTP format. uscan starts by downloading the homepage,\n"
12812 "# obtained by removing the last component of the URL; in this case,\n"
12813 "# http://www.cpan.org/modules/by-module/Text/\n"
12814 "http://www.cpan.org/modules/by-module/Text/Text-CSV_XS-(.*)\\e.tar\\e.gz\n"
12817 #. type: Plain text
12818 #: ../scripts/uscan.1:63
12821 "# This is a variant HTTP format which allows direct specification of\n"
12822 "# the homepage:\n"
12823 "# Homepage Pattern [Version [Action]]\n"
12824 "http://www.dataway.ch/~lukasl/amph/amph.html \\e\n"
12825 " files/amphetamine-([\\ed\\e.]*).tar.bz2\n"
12828 #. type: Plain text
12829 #: ../scripts/uscan.1:70
12832 "# This one shows that recursive directory scanning works, in either of\n"
12833 "# two forms, as long as the website can handle requests of the form\n"
12834 "# http://site/inter/mediate/dir/\n"
12835 "http://tmrc.mit.edu/mirror/twisted/Twisted/(\\ed\\e.\\ed)/ \\e\n"
12836 " Twisted-([\\ed\\e.]*)\\e.tar\\e.bz2\n"
12837 "http://tmrc.mit.edu/mirror/twisted/Twisted/(\\ed\\e.\\ed)/Twisted-([\\ed\\e.]*)\\e.tar\\e.bz2\n"
12840 #. type: Plain text
12841 #: ../scripts/uscan.1:75
12844 "# qa.debian.org runs a redirector which allows a simpler form of URL\n"
12845 "# for SourceForge based projects. The format below will automatically\n"
12846 "# be rewritten to use the redirector.\n"
12847 "http://sf.net/audacity/audacity-src-(.+)\\e.tar\\e.gz\n"
12850 #. type: Plain text
12851 #: ../scripts/uscan.1:79
12854 "# githubredir.debian.net is a redirector for GitHub projects\n"
12855 "# It can be used as following:\n"
12856 "http://githubredir.debian.net/github/E<lt>userE<gt>/E<lt>projectE<gt> "
12860 #. type: Plain text
12861 #: ../scripts/uscan.1:84
12864 "# This is the format for a site which has funny version numbers;\n"
12865 "# the parenthesised groups will be joined with dots to make a\n"
12866 "# sanitised version number\n"
12867 "http://www.site.com/pub/foobar/foobar_v(\\ed+)_(\\ed+)\\e.tar\\e.gz\n"
12870 #. type: Plain text
12871 #: ../scripts/uscan.1:92
12874 "# This is another way of handling site with funny version numbers,\n"
12875 "# this time using mangling. (Note that multiple groups will be\n"
12876 "# concatenated before mangling is performed, and that mangling will\n"
12877 "# only be performed on the basename version number, not any path\n"
12878 "# version numbers.)\n"
12879 "opts=\"uversionmangle=s/^/0.0./\" \\e\n"
12881 "ftp://ftp.ibiblio.org/pub/Linux/ALPHA/wine/development/Wine-(.*)\\e.tar\\e.gz\n"
12884 #. type: Plain text
12885 #: ../scripts/uscan.1:97
12888 "# Similarly, the upstream part of the Debian version number can be\n"
12890 "opts=dversionmangle=s/\\e.dfsg\\e.\\ed+$// \\e\n"
12891 " http://some.site.org/some/path/foobar-(.*)\\e.tar\\e.gz\n"
12894 #. type: Plain text
12895 #: ../scripts/uscan.1:110
12898 "# The filename is found by taking the last component of the URL and\n"
12899 "# removing everything after any '?'. If this would not make a usable\n"
12900 "# filename, use filenamemangle. For example,\n"
12902 "href=\"http://foo.bar.org/download/?path=&download=foo-0.1.1.tar.gz\"E<gt>\n"
12903 "# could be handled as:\n"
12904 "# opts=filenamemangle=s/.*=(.*)/$1/ \\e\n"
12905 "# http://foo.bar.org/download/\\e?path=&download=foo-(.*)\\e.tar\\e.gz\n"
12908 "href=\"http://foo.bar.org/download/?path=&download_version=0.1.1\"E<gt>\n"
12909 "# could be handled as:\n"
12910 "# opts=filenamemangle=s/.*=(.*)/foo-$1\\e.tar\\e.gz/ \\e\n"
12911 "# http://foo.bar.org/download/\\e?path=&download_version=(.*)\n"
12914 #. type: Plain text
12915 #: ../scripts/uscan.1:118
12918 "# The option downloadurlmangle can be used to mangle the URL of the file\n"
12919 "# to download. This can only be used with http:// URLs. This may be\n"
12920 "# necessary if the link given on the webpage needs to be transformed in\n"
12921 "# some way into one which will work automatically, for example:\n"
12922 "# opts=downloadurlmangle=s/prdownload/download/ \\e\n"
12923 "# http://developer.berlios.de/project/showfiles.php?group_id=2051 \\e\n"
12924 "# http://prdownload.berlios.de/softdevice/vdr-softdevice-(.*).tgz\n"
12927 #. type: Plain text
12928 #: ../scripts/uscan.1:124
12930 "Comment lines may be introduced with a `#' character. Continuation lines "
12931 "may be indicated by terminating a line with a backslash character."
12934 #. type: Plain text
12935 #: ../scripts/uscan.1:128
12937 "The first (non-comment) line of the file must begin `version=3'. This "
12938 "allows for future extensions without having to change the name of the file."
12941 #. type: Plain text
12942 #: ../scripts/uscan.1:133
12944 "There are two possibilities for the syntax of an HTTP watchfile line, and "
12945 "only one for an FTP line. We begin with the common (and simpler) format. "
12946 "We describe the optional opts=... first field below, and ignore it in what "
12950 #. type: Plain text
12951 #: ../scripts/uscan.1:150
12953 "The first field gives the full pattern of URLs being searched for. In the "
12954 "case of an FTP site, the directory listing for the requested directory will "
12955 "be requested and this will be scanned for files matching the basename "
12956 "(everything after the trailing `/'). In the case of an HTTP site, the URL "
12957 "obtained by stripping everything after the trailing slash will be downloaded "
12958 "and searched for hrefs (links of the form E<lt>a href=...E<gt>) to either "
12959 "the full URL pattern given, or to the absolute part (everything without the "
12960 "http://host.name/ part), or to the basename (just the part after the final "
12961 "`/'). Everything up to the final slash is taken as a verbatim URL, as long "
12962 "as there are no parentheses (`(' and ')') in this part of the URL: if it "
12963 "does, the directory name will be matched in the same way as the final "
12964 "component of the URL as described below. (Note that regex metacharacters "
12965 "such as `+' are regarded literally unless they are in a path component "
12966 "containing parentheses; see the Atlas-C++ example above. Also, the "
12967 "parentheses must match within each path component.)"
12970 #. type: Plain text
12971 #: ../scripts/uscan.1:159
12973 "The pattern (after the final slash) is a Perl regexp (see B<perlre>(1) for "
12974 "details of these). You need to make the pattern so tight that it matches "
12975 "only the upstream software you are interested in and nothing else. Also, "
12976 "the pattern will be anchored at the beginning and at the end, so it must "
12977 "match the full filename. (Note that for HTTP URLs, the href may include the "
12978 "absolute path or full site and path and still be accepted.) The pattern "
12979 "must contain at least one Perl group as explained in the next paragraph."
12982 #. type: Plain text
12983 #: ../scripts/uscan.1:170
12985 "Having got a list of `files' matching the pattern, their version numbers are "
12986 "extracted by treating the part matching the Perl regexp groups, demarcated "
12987 "by `(...)', joining them with `.' as a separator, and using the result as "
12988 "the version number of the file. The version number will then be mangled if "
12989 "required by the uversionmangle option described below. Finally, the file "
12990 "versions are then compared to find the one with the greatest version number, "
12991 "as determined by B<dpkg --compare-versions>. Note that if you need Perl "
12992 "groups which are not to be used in the version number, either use `(?:...)' "
12993 "or use the uversionmangle option to clean up the mess!"
12996 #. type: Plain text
12997 #: ../scripts/uscan.1:189
12999 "The current (upstream) version can be specified as the second parameter in "
13000 "the watchfile line. If this is I<debian> or absent, then the current Debian "
13001 "version (as determined by I<debian/changelog>) is used to determine the "
13002 "current upstream version. The current upstream version may also be "
13003 "specified by the command-line option B<--upstream-version>, which specifies "
13004 "the upstream version number of the currently installed package (i.e., the "
13005 "Debian version number without epoch and Debian revision). The upstream "
13006 "version number will then be mangled using the dversionmangle option if one "
13007 "is specified, as described below. If the newest version available is newer "
13008 "than the current version, then it is downloaded into the parent directory, "
13009 "unless the B<--report> or --report-status option has been used. Once the "
13010 "file has been downloaded, then a symlink to the file is made from "
13011 "I<E<lt>packageE<gt>_E<lt>versionE<gt>.orig.tar.gz> if the file has a "
13012 "I<.tar.gz> or a I<.tgz> suffix and from "
13013 "I<E<lt>packageE<gt>_E<lt>versionE<gt>.orig.tar.bz2> if the file has a "
13014 "I<.tar.bz2> or a I<.tbz> or I<.tbz2> suffix."
13017 #. type: Plain text
13018 #: ../scripts/uscan.1:192
13020 "Finally, if a third parameter (an action) is given in the watchfile line, "
13021 "this is taken as the name of a command, and the command"
13024 #. type: Plain text
13025 #: ../scripts/uscan.1:194
13027 msgid " I<command >B<--upstream-version>I< version filename>\n"
13030 #. type: Plain text
13031 #: ../scripts/uscan.1:203
13033 "is executed, using either the original file or the symlink name. A common "
13034 "such command would be B<uupdate>(1). (Note that the calling syntax was "
13035 "slightly different when using watchfiles without a `version=...' line; there "
13036 "the command executed was `command filename version'.) If the command is "
13037 "B<uupdate>, then the B<--no-symlink> option is given to B<uupdate> as a "
13038 "first option, since any requested symlinking will already be done by "
13042 #. type: Plain text
13043 #: ../scripts/uscan.1:219
13045 "The alternative version of the watchfile syntax for HTTP URLs is as "
13046 "follows. The first field is a homepage which should be downloaded and then "
13047 "searched for hrefs matching the pattern given in the second field. (Again, "
13048 "this pattern will be anchored at the beginning and the end, so it must match "
13049 "the whole href. If you want to match just the basename of the href, you can "
13050 "use a pattern like \".*/name-(.*)\\e.tar\\e.gz\" if you know that there is a "
13051 "full URL, or better still: \"(?:.*/)?name-(.*)\\e.tar\\e.gz\" if there may "
13052 "or may not be. Note the use of (?:...) to avoid making a backreference.) "
13053 "If any of the hrefs in the homepage which match the (anchored) pattern are "
13054 "relative URLs, they will be taken as being relative to the base URL of the "
13055 "homepage (i.e., with everything after the trailing slash removed), or "
13056 "relative to the base URL specified in the homepage itself with a E<lt>base "
13057 "href=\"...\"E<gt> tag. The third and fourth fields are the version number "
13058 "and action fields as before."
13062 #: ../scripts/uscan.1:219
13064 msgid "PER-SITE OPTIONS"
13067 #. type: Plain text
13068 #: ../scripts/uscan.1:225
13070 "A watchfile line may be prefixed with `opts=I<options>', where I<options> is "
13071 "a comma-separated list of options. The whole I<options> string may be "
13072 "enclosed in double quotes, which is necessary if I<options> contains any "
13073 "spaces. The recognised options are as follows:"
13077 #: ../scripts/uscan.1:225
13079 msgid "B<active> and B<passive> (or B<pasv>)"
13082 #. type: Plain text
13083 #: ../scripts/uscan.1:230
13085 "If used on an FTP line, these override the choice of whether to use PASV "
13086 "mode or not, and force the use of the specified mode for this site."
13090 #: ../scripts/uscan.1:230
13092 msgid "B<uversionmangle=>I<rules>"
13095 #. type: Plain text
13096 #: ../scripts/uscan.1:237
13098 "This is used to mangle the upstream version number as matched by the "
13099 "ftp://... or http:// rules as follows. First, the I<rules> string is split "
13100 "into multiple rules at every `;'. Then the upstream version number is "
13101 "mangled by applying I<rule> to the version, in a similar way to executing "
13102 "the Perl command:"
13105 #. type: Plain text
13106 #: ../scripts/uscan.1:239
13108 msgid " $version =~ I<rule>;\n"
13111 #. type: Plain text
13112 #: ../scripts/uscan.1:244
13114 "for each rule. Thus, suitable rules might be `s/^/0./' to prepend `0.' to "
13115 "the version number and `s/_/./g' to change underscores into periods. Note "
13116 "that the I<rules> string may not contain commas; this should not be a "
13120 #. type: Plain text
13121 #: ../scripts/uscan.1:249
13123 "I<rule> may only use the 's', 'tr' and 'y' operations. When the 's' "
13124 "operation is used, only the 'g', 'i' and 'x' flags are available and I<rule> "
13125 "may not contain any expressions which have the potential to execute code "
13126 "(i.e. the (?{}) and (??{}) constructs are not supported)."
13130 #: ../scripts/uscan.1:249
13132 msgid "B<dversionmangle=>I<rules>"
13135 #. type: Plain text
13136 #: ../scripts/uscan.1:257
13138 "This is used to mangle the Debian version number of the currently installed "
13139 "package in the same way as the B<uversionmangle> option. Thus, a suitable "
13140 "rule might be `s/\\e.dfsg\\e.\\ed+$//' to remove a `.dfsg.1' suffix from the "
13141 "Debian version number, or to handle `.pre6' type version numbers. Again, "
13142 "the I<rules> string may not contain commas; this should not be a problem."
13146 #: ../scripts/uscan.1:257
13148 msgid "B<versionmangle=>I<rules>"
13151 #. type: Plain text
13152 #: ../scripts/uscan.1:262
13154 "This is a syntactic shorthand for "
13155 "B<uversionmangle=>I<rules>B<,dversionmangle=>I<rules>B<, applying the same "
13156 "rules to both the upstream and Debian version numbers.>"
13160 #: ../scripts/uscan.1:262
13162 msgid "B<filenamemangle=>I<rules>"
13165 #. type: Plain text
13166 #: ../scripts/uscan.1:268
13168 "This is used to mangle the filename with which the downloaded file will be "
13169 "saved, and is parsed in the same way as the B<uversionmangle> option. "
13170 "Examples of its use are given in the examples section above."
13174 #: ../scripts/uscan.1:268
13176 msgid "B<downloadurlmangle=>I<rules>"
13179 #. type: Plain text
13180 #: ../scripts/uscan.1:276
13182 "This is used to mangle the URL to be used for the download. The URL is "
13183 "first computed based on the homepage downloaded and the pattern matched, "
13184 "then the version number is determined from this URL. Finally, any rules "
13185 "given by this option are applied before the actual download attempt is "
13186 "made. An example of its use is given in the examples section above."
13189 #. type: Plain text
13190 #: ../scripts/uscan.1:291
13192 "Similarly to several other scripts in the B<devscripts> package, B<uscan> "
13193 "explores the requested directory trees looking for I<debian/changelog> and "
13194 "I<debian/watch> files. As a safeguard against stray files causing potential "
13195 "problems, and in order to promote efficiency, it will examine the name of "
13196 "the parent directory once it finds the I<debian/changelog> file, and check "
13197 "that the directory name corresponds to the package name. It will only "
13198 "attempt to download newer versions of the package and then perform any "
13199 "requested action if the directory name matches the package name. Precisely "
13200 "how it does this is controlled by two configuration file variables "
13201 "DEVSCRIPTS_CHECK_DIRNAME_LEVEL and DEVSCRIPTS_CHECK_DIRNAME_REGEX, and their "
13202 "corresponding command-line options B<--check-dirname-level> and "
13203 "B<--check-dirname-regex>."
13206 #. type: Plain text
13207 #: ../scripts/uscan.1:302
13209 "Only check the directory name if we have had to change directory in our "
13210 "search for I<debian/changelog>, that is, the directory containing "
13211 "I<debian/changelog> is not the directory from which B<uscan> was invoked. "
13212 "This is the default behaviour."
13215 #. type: Plain text
13216 #: ../scripts/uscan.1:320
13217 msgid "This script will perform a fully automatic upstream update."
13220 #. type: Plain text
13221 #: ../scripts/uscan.1:328
13225 "# called with '--upstream-version' E<lt>versionE<gt> E<lt>fileE<gt>\n"
13227 "package=`dpkg-parsechangelog | sed -n 's/^Source: //p'`\n"
13228 "cd ../$package-$2\n"
13232 #. type: Plain text
13233 #: ../scripts/uscan.1:333
13235 "Note that we don't call B<dupload> or B<dput> automatically, as the "
13236 "maintainer should perform sanity checks on the software before uploading it "
13241 #: ../scripts/uscan.1:334
13243 msgid "B<--report, --no-download>"
13246 #. type: Plain text
13247 #: ../scripts/uscan.1:337
13248 msgid "Only report about available newer versions but do not download anything."
13252 #: ../scripts/uscan.1:337
13254 msgid "B<--report-status>"
13257 #. type: Plain text
13258 #: ../scripts/uscan.1:341
13260 "Report on the status of all packages, even those which are up-to-date, but "
13261 "do not download anything."
13265 #: ../scripts/uscan.1:341
13267 msgid "B<--download>"
13270 #. type: Plain text
13271 #: ../scripts/uscan.1:344
13272 msgid "Report and download. (This is the default behaviour.)"
13276 #: ../scripts/uscan.1:344
13278 msgid "B<--destdir>"
13281 #. type: Plain text
13282 #: ../scripts/uscan.1:347
13283 msgid "Path of directory to which to download."
13287 #: ../scripts/uscan.1:347
13289 msgid "B<--force-download>"
13292 #. type: Plain text
13293 #: ../scripts/uscan.1:350
13295 "Download upstream even if up to date (will not overwrite local files, "
13300 #: ../scripts/uscan.1:350
13305 #. type: Plain text
13306 #: ../scripts/uscan.1:353
13307 msgid "Force PASV mode for FTP connections."
13311 #: ../scripts/uscan.1:353
13313 msgid "B<--no-pasv>"
13316 #. type: Plain text
13317 #: ../scripts/uscan.1:356
13318 msgid "Do not use PASV mode for FTP connections."
13322 #: ../scripts/uscan.1:356
13324 msgid "B<--timeout> I<N>"
13327 #. type: Plain text
13328 #: ../scripts/uscan.1:359
13329 msgid "Set timeout to N seconds (default 20 seconds)."
13333 #: ../scripts/uscan.1:359
13335 msgid "B<--symlink>"
13338 #. type: Plain text
13339 #: ../scripts/uscan.1:365
13341 "Make orig.tar.gz symlinks to any downloaded files if their extensions are "
13342 "I<.tar.gz> or I<.tgz>, and similarly for to orig.tar.bz2 for the suffixes "
13343 "I<.tar.gz>, I<.tbz> and I<.tbz2>. (This is the default behaviour.)"
13347 #: ../scripts/uscan.1:365
13349 msgid "B<--rename>"
13352 #. type: Plain text
13353 #: ../scripts/uscan.1:370
13355 "Instead of symlinking, rename the downloaded files to their Debian "
13356 "orig.tar.gz names if their extensions are I<.tar.gz> or I<.tgz>, and "
13357 "similarly for tar.bz2 files."
13361 #: ../scripts/uscan.1:370
13363 msgid "B<--repack>"
13366 #. type: Plain text
13367 #: ../scripts/uscan.1:381
13369 "After having downloaded an lzma tar, xz tar, bzip tar or zip archive, repack "
13370 "it to a gzip tar archive, which is still currently required as a member of a "
13371 "Debian source package. Does nothing if the downloaded archive is not an lzma "
13372 "tar archive, xz tar archive, bzip tar archive or a zip archive (i.e. it "
13373 "doesn't match a .tlz, .tar.lzma, .txz, .tar.xz \\^.tbz, .tbz2, .tar.bz2 or "
13374 ".zip extension). The unzip package must be installed in order to repack .zip "
13375 "archives, the lzma package must be installed to repack lzma tar archives, "
13376 "and the xz-utils package must be installed to repack xz tar archives."
13380 #: ../scripts/uscan.1:381 ../scripts/uupdate.1:74
13382 msgid "B<--no-symlink>"
13385 #. type: Plain text
13386 #: ../scripts/uscan.1:384
13387 msgid "Don't make these symlinks and don't rename the files."
13391 #: ../scripts/uscan.1:384
13396 #. type: Plain text
13397 #: ../scripts/uscan.1:387
13398 msgid "Use an XML format for output, as required by the DEHS system."
13402 #: ../scripts/uscan.1:387
13404 msgid "B<--no-dehs>"
13407 #. type: Plain text
13408 #: ../scripts/uscan.1:390
13409 msgid "Use the traditional uscan output format. (This is the default behaviour.)"
13412 #. type: Plain text
13413 #: ../scripts/uscan.1:399
13415 "Specify the name of the package to check for rather than examining "
13416 "I<debian/changelog>; this requires the B<--upstream-version> (unless a "
13417 "version is specified in the watchfile) and B<--watchfile> options as well. "
13418 "Furthermore, no directory scanning will be done and nothing will be "
13419 "downloaded. This option is probably most useful in conjunction with the "
13420 "DEHS system (and B<--dehs>)."
13424 #: ../scripts/uscan.1:399
13426 msgid "B<--upstream-version> I<upstream-version>"
13429 #. type: Plain text
13430 #: ../scripts/uscan.1:404
13432 "Specify the current upstream version rather than examine the watchfile or "
13433 "changelog to determine it. This is ignored if a directory scan is being "
13434 "performed and more than one watchfile is found."
13438 #: ../scripts/uscan.1:404
13440 msgid "B<--watchfile> I<watchfile>"
13443 #. type: Plain text
13444 #: ../scripts/uscan.1:411
13446 "Specify the watchfile rather than perform a directory scan to determine it. "
13447 "If this option is used without B<--package>, then B<uscan> must be called "
13448 "from within the Debian package source tree (so that I<debian/changelog> can "
13449 "be found simply by stepping up through the tree)."
13453 #: ../scripts/uscan.1:411
13455 msgid "B<--download-version> I<version>"
13458 #. type: Plain text
13459 #: ../scripts/uscan.1:415
13461 "Specify the version which the upstream release must match in order to be "
13462 "considered, rather than using the release with the highest version."
13466 #: ../scripts/uscan.1:415
13468 msgid "B<--download-current-version>"
13471 #. type: Plain text
13472 #: ../scripts/uscan.1:418
13473 msgid "Download the currently packaged version"
13476 #. type: Plain text
13477 #: ../scripts/uscan.1:421
13478 msgid "Give verbose output."
13482 #: ../scripts/uscan.1:421
13484 msgid "B<--no-verbose>"
13487 #. type: Plain text
13488 #: ../scripts/uscan.1:424
13489 msgid "Don't give verbose output. (This is the default behaviour.)"
13493 #: ../scripts/uscan.1:424
13498 #. type: Plain text
13499 #: ../scripts/uscan.1:427
13500 msgid "Dump the downloaded web pages to stdout for debugging your watch file."
13504 #: ../scripts/uscan.1:435
13506 msgid "B<--user-agent>, B<--useragent>"
13509 #. type: Plain text
13510 #: ../scripts/uscan.1:438
13511 msgid "Override the default user agent header."
13514 #. type: Plain text
13515 #: ../scripts/uscan.1:445
13516 msgid "Give brief usage information."
13519 #. type: Plain text
13520 #: ../scripts/uscan.1:455
13522 "The two configuration files I</etc/devscripts.conf> and I<~/.devscripts> are "
13523 "sourced by a shell in that order to set configuration variables. These may "
13524 "be overridden by command line options. Environment variable settings are "
13525 "ignored for this purpose. If the first command line option given is "
13526 "B<--noconf>, then these files will not be read. The currently recognised "
13531 #: ../scripts/uscan.1:455
13533 msgid "B<USCAN_DOWNLOAD>"
13536 #. type: Plain text
13537 #: ../scripts/uscan.1:460
13539 "If this is set to I<no>, then newer upstream files will not be downloaded; "
13540 "this is equivalent to the B<--report> or B<--no-download> options."
13544 #: ../scripts/uscan.1:460
13546 msgid "B<USCAN_PASV>"
13549 #. type: Plain text
13550 #: ../scripts/uscan.1:466
13552 "If this is set to I<yes> or I<no>, this will force FTP connections to use "
13553 "PASV mode or not to, respectively. If this is set to I<default>, then "
13554 "Net::FTP(3) make the choice (primarily based on the FTP_PASSIVE environment "
13559 #: ../scripts/uscan.1:466
13561 msgid "B<USCAN_TIMEOUT>"
13564 #. type: Plain text
13565 #: ../scripts/uscan.1:470
13567 "If set to a number I<N>, then set the timeout to I<N> seconds. This is "
13568 "equivalent to the B<--timeout> option."
13572 #: ../scripts/uscan.1:470
13574 msgid "B<USCAN_SYMLINK>"
13577 #. type: Plain text
13578 #: ../scripts/uscan.1:477
13580 "If this is set to I<no>, then a pkg_version.orig.tar.{gz|bz2} symlink will "
13581 "not be made (equivalent to the B<--no-symlink> option). If it is set to "
13582 "I<yes> or I<symlink>, then the symlinks will be made. If it is set to "
13583 "I<rename>, then the files are renamed (equivalent to the B<--rename> "
13588 #: ../scripts/uscan.1:477
13590 msgid "B<USCAN_DEHS_OUTPUT>"
13593 #. type: Plain text
13594 #: ../scripts/uscan.1:481
13596 "If this is set to I<yes>, then DEHS-style output will be used. This is "
13597 "equivalent to the B<--dehs> option."
13601 #: ../scripts/uscan.1:481
13603 msgid "B<USCAN_VERBOSE>"
13606 #. type: Plain text
13607 #: ../scripts/uscan.1:485
13609 "If this is set to I<yes>, then verbose output will be given. This is "
13610 "equivalent to the B<--verbose> option."
13614 #: ../scripts/uscan.1:485
13616 msgid "B<USCAN_USER_AGENT>"
13619 #. type: Plain text
13620 #: ../scripts/uscan.1:489
13622 "If set, the specified user agent string will be used in place of the "
13623 "default. This is equivalent to the B<--user-agent> option."
13627 #: ../scripts/uscan.1:489
13629 msgid "B<USCAN_DESTDIR>"
13632 #. type: Plain text
13633 #: ../scripts/uscan.1:493
13635 "If set, the downloaded files will be placed in this directory. This is "
13636 "equivalent to the B<--destdir> option."
13640 #: ../scripts/uscan.1:493
13642 msgid "B<USCAN_REPACK>"
13645 #. type: Plain text
13646 #: ../scripts/uscan.1:498
13648 "If this is set to I<yes>, then after having downloaded a bzip tar, lzma tar, "
13649 "xz tar, or zip archive, B<uscan> will repack it to a gzip tar. This is "
13650 "equivalent to the B<--repack> option."
13653 #. type: Plain text
13654 #: ../scripts/uscan.1:502
13656 "The exit status gives some indication of whether a newer version was found "
13657 "or not; one is advised to read the output to determine exactly what happened "
13658 "and whether there were any warnings to be noted."
13661 #. type: Plain text
13662 #: ../scripts/uscan.1:506
13664 "Either B<--help> or B<--version> was used, or for some watchfile which was "
13665 "examined, a newer upstream version was located."
13668 #. type: Plain text
13669 #: ../scripts/uscan.1:510
13670 msgid "No newer upstream versions were located for any of the watchfiles examined."
13674 #: ../scripts/uscan.1:510
13676 msgid "HISTORY AND UPGRADING"
13679 #. type: Plain text
13680 #: ../scripts/uscan.1:514
13682 "This section briefly describes the backwards-incompatible watchfile features "
13683 "which have been added in each watchfile version, and the first version of "
13684 "the B<devscripts> package which understood them."
13688 #: ../scripts/uscan.1:514
13690 msgid "I<Pre-version 2>"
13693 #. type: Plain text
13694 #: ../scripts/uscan.1:519
13696 "The watchfile syntax was significantly different in those days. Don't use "
13697 "it. If you are upgrading from a pre-version 2 watchfile, you are advised to "
13698 "read this manpage and to start from scratch."
13702 #: ../scripts/uscan.1:519
13704 msgid "I<Version 2>"
13707 #. type: Plain text
13708 #: ../scripts/uscan.1:523
13710 "devscripts version 2.6.90: The first incarnation of the current style of "
13715 #: ../scripts/uscan.1:523
13717 msgid "I<Version 3>"
13720 #. type: Plain text
13721 #: ../scripts/uscan.1:529
13723 "devscripts version 2.8.12: Introduced the following: correct handling of "
13724 "regex special characters in the path part, directory/path pattern matching, "
13725 "version number in several parts, version number mangling. Later versions "
13726 "have also introduced URL mangling."
13729 #. type: Plain text
13730 #: ../scripts/uscan.1:535
13732 "If you are upgrading from version 2, the key incompatibility is if you have "
13733 "multiple groups in the pattern part; whereas only the first one would be "
13734 "used in version 2, they will all be used in version 3. To avoid this "
13735 "behaviour, change the non-version-number groups to be (?:...) instead of a "
13736 "plain (...) group."
13739 #. type: Plain text
13740 #: ../scripts/uscan.1:541
13741 msgid "B<dpkg>(1), B<perlre>(1), B<uupdate>(1) and B<devscripts.conf>(5)."
13744 #. type: Plain text
13745 #: ../scripts/uscan.1:546
13747 "The original version of B<uscan> was written by Christoph Lameter "
13748 "E<lt>clameter@debian.orgE<gt>. Significant improvements, changes and "
13749 "bugfixes were made by Julian Gilbey E<lt>jdg@debian.orgE<gt>. HTTP support "
13750 "was added by Piotr Roszatycki E<lt>dexter@debian.orgE<gt>. The program was "
13751 "rewritten in Perl by Julian Gilbey."
13755 #: ../scripts/uupdate.1:1
13760 #. type: Plain text
13761 #: ../scripts/uupdate.1:4
13762 msgid "uupdate - upgrade a source code package from an upstream revision"
13765 #. type: Plain text
13766 #: ../scripts/uupdate.1:6
13767 msgid "B<uupdate> [I<options>] I<new_upstream_archive> [I<version>]"
13770 #. type: Plain text
13771 #: ../scripts/uupdate.1:8
13772 msgid "B<uupdate> [I<options>] B<--patch>|B<-p> I<patch_file>"
13775 #. type: Plain text
13776 #: ../scripts/uupdate.1:20
13778 "B<uupdate> modifies an existing Debian source code archive to reflect an "
13779 "upstream update supplied as a patch or from a wholly new source code "
13780 "archive. The utility needs to be invoked from the top directory of the old "
13781 "source code directory, and if a relative name is given for the new archive "
13782 "or patch file, it will be looked for first relative to the execution "
13783 "directory and then relative to the parent of the source tree. (For example, "
13784 "if the changelog file is I</usr/local/src/foo/foo-1.1/debian/changelog>, "
13785 "then the archive or patch file will be looked for relative to "
13786 "I</usr/local/src/foo>.) Note that the patch file or archive cannot be "
13787 "within the source tree itself. The full details of what the code does are "
13791 #. type: Plain text
13792 #: ../scripts/uupdate.1:30
13794 "Currently supported source code file types are I<.tar.gz>, I<.tar.bz2>, "
13795 "I<.tar.Z>, I<.tgz>, I<.tar>, I<.tar.lzma>, I<.tar.xz>, I<.7z> and I<.zip> "
13796 "archives. Also supported are already unpacked source code archives; simply "
13797 "give the path of the source code directory. Supported patch file types are "
13798 "B<gzip>-compressed, B<bzip2>-compressed, B<lzma>-compressed, "
13799 "B<xz>-compressed and uncompressed patch files. The file types are "
13800 "identified by the file names, so they must use the standard suffixes."
13803 #. type: Plain text
13804 #: ../scripts/uupdate.1:40
13806 "Usually B<uupdate> will be able to deduce the version number from the source "
13807 "archive name (as long as it only contains digits and periods). If that "
13808 "fails, you need to specify the version number explicitly (without the Debian "
13809 "release number which will always be initially ``1'', or ``0ubuntu1'' on "
13810 "Ubuntu-detected systems). This can be done with an initial "
13811 "B<--upstream-version> or B<-v> option, or in the case of an archive, with a "
13812 "version number after the filename. (The reason for the latter is so that "
13813 "B<uupdate> can be called directly from B<uscan>.)"
13816 #. type: Plain text
13817 #: ../scripts/uupdate.1:45
13819 "Since B<uupdate> uses B<debuild> to clean the current archive before trying "
13820 "to apply a patch file, it accepts a B<--rootcmd> or B<-r> option allowing "
13821 "the user to specify a gain-root command to be used. The default is to use "
13825 #. type: Plain text
13826 #: ../scripts/uupdate.1:52
13828 "If an archive is being built, the pristine upstream source should be used to "
13829 "create the I<.orig.tar.gz> file wherever possible. This means that MD5 sums "
13830 "or other similar methods can be used to easily compare the upstream source "
13831 "to Debian's copy of the upstream version. This is the default behaviour, "
13832 "and can be switched off using the B<--no-pristine> option below."
13835 #. type: Plain text
13836 #: ../scripts/uupdate.1:54
13837 msgid "This is a summary of what was explained above."
13841 #: ../scripts/uupdate.1:54
13843 msgid "B<--upstream-version >I<version>, B<-v >I<version>"
13846 #. type: Plain text
13847 #: ../scripts/uupdate.1:57
13848 msgid "Specify the version number of the upstream package explicitly."
13852 #: ../scripts/uupdate.1:57
13854 msgid "B<--rootcmd >I<gain-root-command>, B<-r >I<gain-root-command>"
13857 #. type: Plain text
13858 #: ../scripts/uupdate.1:61
13860 "Specify the command to be used to become root to build the package and is "
13861 "passed onto B<debuild>(1) if it is specified."
13865 #: ../scripts/uupdate.1:61
13867 msgid "B<--pristine>, B<-u>"
13870 #. type: Plain text
13871 #: ../scripts/uupdate.1:66
13873 "Treat the source as pristine upstream source and symlink to it from "
13874 "I<E<lt>packageE<gt>_E<lt>versionE<gt>.orig.tar.gz> whenever possible. This "
13875 "option has no meaning for patches. This is the default behaviour."
13879 #: ../scripts/uupdate.1:66
13881 msgid "B<--no-pristine>"
13884 #. type: Plain text
13885 #: ../scripts/uupdate.1:69
13887 "Do not attempt to make a I<E<lt>packageE<gt>_E<lt>versionE<gt>.orig.tar.gz> "
13892 #: ../scripts/uupdate.1:69
13894 msgid "B<--symlink>, B<-s>"
13897 #. type: Plain text
13898 #: ../scripts/uupdate.1:74
13900 "Simply create a symlink when moving a new upstream I<.tar.gz> archive to the "
13901 "new I<E<lt>packageE<gt>_E<lt>versionE<gt>.orig.tar.gz> location. This is "
13902 "the default behaviour."
13905 #. type: Plain text
13906 #: ../scripts/uupdate.1:78
13908 "Copy the upstream I<.tar.gz> to the new location instead of making a "
13913 #: ../scripts/uupdate.1:94
13915 msgid "B<UUPDATE_PRISTINE>"
13918 #. type: Plain text
13919 #: ../scripts/uupdate.1:98
13921 "If this is set to I<no>, then it is the same as the B<--no-pristine> command "
13922 "line parameter being used."
13926 #: ../scripts/uupdate.1:98
13928 msgid "B<UUPDATE_SYMLINK_ORIG>"
13931 #. type: Plain text
13932 #: ../scripts/uupdate.1:102
13934 "If this is set to I<no>, then it is the same as the B<--no-symlink> command "
13935 "line parameter being used."
13939 #: ../scripts/uupdate.1:102
13941 msgid "B<UUPDATE_ROOTCMD>"
13944 #. type: Plain text
13945 #: ../scripts/uupdate.1:105
13946 msgid "This is equivalent to the B<--rootcmd> option."
13950 #: ../scripts/uupdate.1:105
13952 msgid "ACTIONS TAKEN ON AN ARCHIVE"
13956 #: ../scripts/uupdate.1:106 ../scripts/uupdate.1:139
13958 msgid "B<Figure out new version number>"
13961 #. type: Plain text
13962 #: ../scripts/uupdate.1:112
13964 "Unless an explicit version number is provided, the archive name is analyzed "
13965 "for a sequence of digits separated by dots. If something like that is "
13966 "found, it is taken to be the new upstream version number. If not, "
13967 "processing is aborted."
13971 #: ../scripts/uupdate.1:112
13973 msgid "B<Create the .orig.tar.gz archive>"
13976 #. type: Plain text
13977 #: ../scripts/uupdate.1:117
13979 "If the B<--pristine> or B<-u> option is specified and the upstream archive "
13980 "is a I<.tar.gz> or I<.tgz> archive, then this will be copied directly to "
13981 "I<E<lt>packageE<gt>_E<lt>versionE<gt>.orig.tar.gz>."
13985 #: ../scripts/uupdate.1:117
13987 msgid "B<Unpacking>"
13990 #. type: Plain text
13991 #: ../scripts/uupdate.1:122
13993 "The archive is unpacked and placed in a directory with the correct name "
13994 "according to Debian policy: package-upstream_version.orig. Processing is "
13995 "aborted if this directory already exists."
13999 #: ../scripts/uupdate.1:122 ../scripts/uupdate.1:150
14001 msgid "B<Patching>"
14004 #. type: Plain text
14005 #: ../scripts/uupdate.1:130
14007 "The I<.diffs.gz> from the current version are applied to the unpackaged "
14008 "archive. A non-zero exit status and warning message will occur if the "
14009 "patches did not apply cleanly or if no patch file was found. Also, the list "
14010 "of rejected patches will be shown. The file I<debian/rules> is made "
14011 "executable and all of the I<.orig> files created by B<patch> are deleted."
14015 #: ../scripts/uupdate.1:130 ../scripts/uupdate.1:162
14017 msgid "B<Changelog update>"
14020 #. type: Plain text
14021 #: ../scripts/uupdate.1:134 ../scripts/uupdate.1:166
14023 "A changelog entry with the new version number is generated with the text "
14024 "``New upstream release''."
14027 #. type: Plain text
14028 #: ../scripts/uupdate.1:138 ../scripts/uupdate.1:170
14030 "When used on Ubuntu systems, B<lsb_release> detection is used to set the "
14031 "Debian revision to ``0ubuntu1''. You may change I<debian/changelog> "
14032 "manually afterwards."
14036 #: ../scripts/uupdate.1:138
14038 msgid "ACTIONS TAKEN ON A PATCH FILE"
14041 #. type: Plain text
14042 #: ../scripts/uupdate.1:145
14044 "Unless an explicit version number is provided, the patch file name is "
14045 "analyzed for a sequence of digits separated by dots. If something like that "
14046 "is found, it is taken to be the new upstream version number. If not, "
14047 "processing is aborted."
14051 #: ../scripts/uupdate.1:145
14053 msgid "B<Clean the current source tree>"
14056 #. type: Plain text
14057 #: ../scripts/uupdate.1:150
14059 "The command B<debuild clean> is executed within the current Debian source "
14060 "archive to clean it. If a B<-r> option is given to B<uupdate>, it is passed "
14061 "on to B<debuild>."
14064 #. type: Plain text
14065 #: ../scripts/uupdate.1:162
14067 "The current source archive (I<.orig.tar.gz>) is unpacked and the patch "
14068 "applied to the original sources. If this is successful, then the I<.orig> "
14069 "directory is renamed to reflect the new version number and the current "
14070 "Debian source directory is copied to a directory with the new version "
14071 "number, otherwise processing is aborted. The patch is then applied to the "
14072 "new copy of the Debian source directory. The file I<debian/rules> is made "
14073 "executable and all of the I<.orig> files created by B<patch> are deleted. "
14074 "If there was a problem with the patching, a warning is issued and the "
14075 "program will eventually exit with non-zero exit status."
14078 #. type: Plain text
14079 #: ../scripts/uupdate.1:177
14081 "B<debuild>(1), B<fakeroot>(1), B<patch>(1), I<The Debian Policy Manual> and "
14082 "B<devscripts.conf>(5)."
14085 #. type: Plain text
14086 #: ../scripts/uupdate.1:180
14088 "The original version of B<uupdate> was written by Christoph Lameter "
14089 "E<lt>clameter@debian.orgE<gt>. Several changes and improvements have been "
14090 "made by Julian Gilbey E<lt>jdg@debian.orgE<gt>."
14094 #: ../scripts/whodepends.1:1
14099 #. type: Plain text
14100 #: ../scripts/whodepends.1:4
14101 msgid "whodepends - check which maintainers' packages depend on a package"
14104 #. type: Plain text
14105 #: ../scripts/whodepends.1:6
14106 msgid "B<whodepends> [I<package>] [options]"
14109 #. type: Plain text
14110 #: ../scripts/whodepends.1:10
14112 "B<whodepends> gives the names, e-mail addresses and the packages they "
14113 "maintain of all maintainers who have packages depending on the given "
14118 #: ../scripts/whodepends.1:11
14120 msgid "B<--help, -h>"
14124 #: ../scripts/whodepends.1:14
14126 msgid "B<--version, -v>"
14129 #. type: Plain text
14130 #: ../scripts/whodepends.1:19
14131 msgid "B<whodepends> is not very efficient."
14134 #. type: Plain text
14135 #: ../scripts/whodepends.1:20
14136 msgid "B<whodepends> has been written by Moshe Zadka E<lt>moshez@debian.orgE<gt>."
14140 #: ../scripts/who-uploads.1:1
14142 msgid "WHO-UPLOADS"
14145 #. type: Plain text
14146 #: ../scripts/who-uploads.1:4
14147 msgid "who-uploads - identify the uploaders of Debian source packages"
14150 #. type: Plain text
14151 #: ../scripts/who-uploads.1:6
14152 msgid "B<who-uploads> [I<options>] I<source_package> [...]"
14155 #. type: Plain text
14156 #: ../scripts/who-uploads.1:12
14158 "B<who-uploads> uses the Package Tracking System (PTS) to identify the "
14159 "uploaders of the three most recent versions of the given source packages. "
14160 "Note that the uploaders are identified using their B<gpg>(1) keys; "
14161 "installing a recent version of the I<debian-keyring> package should provide "
14162 "most of the required keys."
14165 #. type: Plain text
14166 #: ../scripts/who-uploads.1:15
14168 "Note that because the PTS uses source packages, you must give the source "
14169 "package names, not the binary package names."
14173 #: ../scripts/who-uploads.1:16
14175 msgid "B<-M>, B<--max-uploads=>I<N>"
14178 #. type: Plain text
14179 #: ../scripts/who-uploads.1:21
14181 "Specify the maximum number of uploads to display for each package; the "
14182 "default is 3. Note that you may not see this many uploads if there are not "
14183 "this many recorded in the PTS."
14187 #: ../scripts/who-uploads.1:21
14189 msgid "B<--keyring >I<keyring>"
14192 #. type: Plain text
14193 #: ../scripts/who-uploads.1:25
14195 "Add I<keyring> to the list of keyrings to be searched for the uploader's GPG "
14199 #. type: Plain text
14200 #: ../scripts/who-uploads.1:33
14202 "By default, B<who-uploads> uses the three Debian keyrings "
14203 "I</usr/share/keyrings/debian-keyring.{gpg,pgp}> and "
14204 "I</usr/share/keyrings/debian-maintainers.gpg> (although this default can be "
14205 "changed in the configuration file, see below). Specifying this option means "
14206 "that the default keyrings will not be examined. The B<--keyring> option "
14207 "overrides this one."
14211 #: ../scripts/who-uploads.1:33
14216 #. type: Plain text
14217 #: ../scripts/who-uploads.1:36
14218 msgid "Show the date of the upload alongside the uploader's details"
14222 #: ../scripts/who-uploads.1:36
14224 msgid "B<--nodate>, B<--no-date>"
14227 #. type: Plain text
14228 #: ../scripts/who-uploads.1:40
14230 "Do not show the date of the upload alongside the uploader's details. This "
14231 "is the default behaviour."
14235 #: ../scripts/who-uploads.1:56
14237 msgid "B<WHOUPLOADS_DATE>"
14240 #. type: Plain text
14241 #: ../scripts/who-uploads.1:60
14243 "Show the date of the upload alongside the uploader's details. By default, "
14248 #: ../scripts/who-uploads.1:60
14250 msgid "B<WHOUPLOADS_MAXUPLOADS>"
14253 #. type: Plain text
14254 #: ../scripts/who-uploads.1:64
14256 "The maximum number of uploads to display for each package. By default, this "
14261 #: ../scripts/who-uploads.1:64
14263 msgid "B<WHOUPLOADS_KEYRINGS>"
14266 #. type: Plain text
14267 #: ../scripts/who-uploads.1:71
14269 "This is a colon-separated list of the default keyrings to be used. By "
14270 "default, it is the three Debian keyrings "
14271 "I</usr/share/keyrings/debian-keyring.{gpg,pgp}> and "
14272 "I</usr/share/keyrings/debian-maintainers.gpg>."
14275 #. type: Plain text
14276 #: ../scripts/who-uploads.1:74
14278 "The original version of B<who-uploads> was written by Adeodato Sim\\['o] "
14279 "E<lt>dato@net.com.org.esE<gt>. The current version is by Julian Gilbey "
14280 "E<lt>jdg@debian.orgE<gt>."
14284 #: ../scripts/wnpp-alert.1:1
14289 #. type: Plain text
14290 #: ../scripts/wnpp-alert.1:4
14291 msgid "wnpp-alert - check for installed packages up for adoption or orphaned"
14294 #. type: Plain text
14295 #: ../scripts/wnpp-alert.1:6
14296 msgid "B<wnpp-alert [--diff] [package ...]>"
14299 #. type: Plain text
14300 #: ../scripts/wnpp-alert.1:8
14301 msgid "B<wnpp-alert --help|--version>"
14304 #. type: Plain text
14305 #: ../scripts/wnpp-alert.1:14
14307 "B<wnpp-alert> downloads the lists of packages which have been orphaned (O), "
14308 "are up for adoption (RFA), or the maintainer has asked for help (RFH) from "
14309 "the WNPP webpages, and then outputs a list of packages installed on the "
14310 "system, or matching the listed packages, which are in those lists."
14313 #. type: Plain text
14314 #: ../scripts/wnpp-alert.1:17
14316 "Note that WNPP, and therefore B<wnpp-alert>'s output, is source package "
14321 #: ../scripts/wnpp-alert.1:18
14323 msgid "B<--diff>, B<-d>"
14326 #. type: Plain text
14327 #: ../scripts/wnpp-alert.1:23
14329 "If the I<~/.devscripts_cache> directory exists, compare the output of "
14330 "B<wnpp-alert> to the previous output (cached in the file I<wnpp-diff>) and "
14331 "output the differences."
14334 #. type: Plain text
14335 #: ../scripts/wnpp-alert.1:31 ../scripts/wnpp-check.1:25
14336 msgid "http://www.debian.org/devel/wnpp"
14339 #. type: Plain text
14340 #: ../scripts/wnpp-alert.1:34
14342 "B<wnpp-alert> was written by Arthur Korn E<lt>arthur@korn.chE<gt> and "
14343 "modified by Julian Gilbey E<lt>jdg@debian.orgE<gt> for the devscripts "
14344 "package. It is in the public domain."
14348 #: ../scripts/wnpp-check.1:1
14353 #. type: Plain text
14354 #: ../scripts/wnpp-check.1:4
14356 "wnpp-check - check if a package is being packaged or if this has been "
14360 #. type: Plain text
14361 #: ../scripts/wnpp-check.1:6
14362 msgid "B<wnpp-check package [...]>"
14365 #. type: Plain text
14366 #: ../scripts/wnpp-check.1:8
14367 msgid "B<wnpp-check --help|--version>"
14370 #. type: Plain text
14371 #: ../scripts/wnpp-check.1:13
14373 "B<wnpp-check> downloads the lists of packages which are listed as being "
14374 "packaged (ITPed) or for which a package has been requested (RFPed) from the "
14375 "WNPP website and lists any packages supplied on the command line which "
14376 "appear in those lists."
14379 #. type: Plain text
14380 #: ../scripts/wnpp-check.1:16
14382 "Note that WNPP, and therefore B<wnpp-check>'s output, is source package "
14386 #. type: Plain text
14387 #: ../scripts/wnpp-check.1:29
14388 msgid "None of the packages supplied has an open ITP or RFP"
14391 #. type: Plain text
14392 #: ../scripts/wnpp-check.1:33
14394 "Either an error occurred or at least one package supplied has an open ITP or "
14398 #. type: Plain text
14399 #: ../scripts/wnpp-check.1:39
14401 "B<wnpp-check> was written by David Paleino E<lt>d.paleino@gmail.comE<gt>; "
14402 "this man page was written by Adam D. Barratt "
14403 "E<lt>adam@adam-barratt.org.ukE<gt> for the devscripts package. "
14404 "B<wnpp-check> was originally based on B<wnpp-alert>, which was written by "
14405 "Arthur Korn E<lt>arthur@korn.chE<gt> and modified by Julian Gilbey "
14406 "E<lt>jdg@debian.orgE<gt> for the devscripts package. Both scripts are in "
14407 "the public domain."
14411 #: ../scripts/devscripts.conf.5:1
14413 msgid "DEVSCRIPTS.CONF"
14416 #. type: Plain text
14417 #: ../scripts/devscripts.conf.5:4
14418 msgid "devscripts.conf - configuration file for the devscripts package"
14421 #. type: Plain text
14422 #: ../scripts/devscripts.conf.5:9
14424 "The B<devscripts> package provides a collection of scripts which may be of "
14425 "use to Debian developers and others wishing to build Debian packages. Many "
14426 "of these have options which can be configured on a system-wide and per-user "
14430 #. type: Plain text
14431 #: ../scripts/devscripts.conf.5:15
14433 "Every script in the B<devscripts> package which makes use of values from "
14434 "these configuration files describes the specific settings recognised in its "
14435 "own manpage. (For a list of the scripts, either see "
14436 "I</usr/share/doc/devscripts/README.gz> or look at the output of I<dpkg -L "
14437 "devscripts | grep /usr/bin>.)"
14440 #. type: Plain text
14441 #: ../scripts/devscripts.conf.5:24
14443 "The two configuration files are I</etc/devscripts.conf> for system-wide "
14444 "defaults and I<~/.devscripts> for per-user settings. They are written with "
14445 "B<bash>(1) syntax, but should only have comments and simple variable "
14446 "assignments in them; they are both sourced (if present) by many of the "
14447 "B<devscripts> scripts. Variables corresponding to simple switches should "
14448 "have one of the values I<yes> and I<no>; any other setting is regarded as "
14449 "equivalent to the default setting."
14452 #. type: Plain text
14453 #: ../scripts/devscripts.conf.5:28
14455 "All variable names are written in uppercase, and begin with the script "
14456 "name. Package-wide variables begin with \"DEVSCRIPTS\", and are listed "
14457 "below, as well as in the relevant manpages."
14460 #. type: Plain text
14461 #: ../scripts/devscripts.conf.5:36
14463 "For a list of all of the available options variables, along with their "
14464 "default settings, see the example configuration file "
14465 "I</usr/share/doc/devscripts/devscripts.conf.ex>. This is copied to "
14466 "I</etc/devscripts.conf> when the B<devscripts> package is first installed. "
14467 "Information about configuration options introduced in newer versions of the "
14468 "package will be appended to I</etc/devscripts.conf> when the package is "
14472 #. type: Plain text
14473 #: ../scripts/devscripts.conf.5:40
14475 "Every script which reads the configuration files can be forced to ignore "
14476 "them by using B<--no-conf> as the I<first> command-line option."
14480 #: ../scripts/devscripts.conf.5:40
14482 msgid "PACKAGE-WIDE VARIABLES"
14485 #. type: Plain text
14486 #: ../scripts/devscripts.conf.5:42
14487 msgid "The currently recognised package-wide variables are:"
14490 #. type: Plain text
14491 #: ../scripts/devscripts.conf.5:54
14493 "These control scripts which change directory to find a I<debian/changelog> "
14494 "file or suchlike, and some other miscellaneous cases. In order to prevent "
14495 "unwanted, even possibly dangerous, behaviour, these variables control when "
14496 "actions will be performed. The scripts which currently make use of these "
14497 "variables are: B<debc>, B<debchange>/B<dch>, B<debclean>, B<debi>, "
14498 "B<debrelease>, B<debuild> and B<uscan>, but this list may change with time "
14499 "(and I may not remember to update this manpage). Please see the manpages of "
14500 "individual scripts for details of the specific behaviour for each script."
14503 #. type: Plain text
14504 #: ../scripts/devscripts.conf.5:58
14505 msgid "B<devscripts>(1) and I</usr/share/doc/devscripts/README.gz.>"
14508 #. type: Plain text
14509 #: ../scripts/devscripts.conf.5:60
14511 "This manpage was written for the B<devscripts> package by the package "
14512 "maintainer Julian Gilbey E<lt>jdg@debian.orgE<gt>."