po4a/po/tools.pot

   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.
   5 #
   6 #, fuzzy
   7 msgid ""
   8 msgstr ""
   9 "Project-Id-Version: PACKAGE VERSION\n"
  10 "POT-Creation-Date: 2011-03-03 11:18-0400\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"
  14 "Language: \n"
  15 "MIME-Version: 1.0\n"
  16 "Content-Type: text/plain; charset=UTF-8\n"
  17 "Content-Transfer-Encoding: 8bit\n"
  18
  19 #. type: Content of: <appendix><title>
  20 #: tools.dbk:7
  21 msgid "Overview of Debian Maintainer Tools"
  22 msgstr ""
  23
  24 #. type: Content of: <appendix><para>
  25 #: tools.dbk:9
  26 msgid ""
  27 "This section contains a rough overview of the tools available to "
  28 "maintainers.  The following is by no means complete or definitive, but just "
  29 "a guide to some of the more popular tools."
  30 msgstr ""
  31
  32 #. type: Content of: <appendix><para>
  33 #: tools.dbk:14
  34 msgid ""
  35 "Debian maintainer tools are meant to aid developers and free their time for "
  36 "critical tasks.  As Larry Wall says, there's more than one way to do it."
  37 msgstr ""
  38
  39 #. type: Content of: <appendix><para>
  40 #: tools.dbk:18
  41 msgid ""
  42 "Some people prefer to use high-level package maintenance tools and some do "
  43 "not.  Debian is officially agnostic on this issue; any tool which gets the "
  44 "job done is fine.  Therefore, this section is not meant to stipulate to "
  45 "anyone which tools they should use or how they should go about their duties "
  46 "of maintainership.  Nor is it meant to endorse any particular tool to the "
  47 "exclusion of a competing tool."
  48 msgstr ""
  49
  50 #. type: Content of: <appendix><para>
  51 #: tools.dbk:26
  52 msgid ""
  53 "Most of the descriptions of these packages come from the actual package "
  54 "descriptions themselves.  Further information can be found in the package "
  55 "documentation itself.  You can also see more info with the command "
  56 "<command>apt-cache show <replaceable>package-name</replaceable></command>."
  57 msgstr ""
  58
  59 #. type: Content of: <appendix><section><title>
  60 #: tools.dbk:32
  61 msgid "Core tools"
  62 msgstr ""
  63
  64 #. type: Content of: <appendix><section><para>
  65 #: tools.dbk:34
  66 msgid "The following tools are pretty much required for any maintainer."
  67 msgstr ""
  68
  69 #. type: Content of: <appendix><section><section><title>
  70 #: tools.dbk:37
  71 msgid "<systemitem role=\"package\">dpkg-dev</systemitem>"
  72 msgstr ""
  73
  74 #. type: Content of: <appendix><section><section><para>
  75 #: tools.dbk:39
  76 msgid ""
  77 "<systemitem role=\"package\">dpkg-dev</systemitem> contains the tools "
  78 "(including <command>dpkg-source</command>) required to unpack, build, and "
  79 "upload Debian source packages.  These utilities contain the fundamental, "
  80 "low-level functionality required to create and manipulate packages; as such, "
  81 "they are essential for any Debian maintainer."
  82 msgstr ""
  83
  84 #. type: Content of: <appendix><section><section><title>
  85 #: tools.dbk:48
  86 msgid "<systemitem role=\"package\">debconf</systemitem>"
  87 msgstr ""
  88
  89 #. type: Content of: <appendix><section><section><para>
  90 #: tools.dbk:50
  91 msgid ""
  92 "<systemitem role=\"package\">debconf</systemitem> provides a consistent "
  93 "interface to configuring packages interactively.  It is user interface "
  94 "independent, allowing end-users to configure packages with a text-only "
  95 "interface, an HTML interface, or a dialog interface.  New interfaces can be "
  96 "added as modules."
  97 msgstr ""
  98
  99 #. type: Content of: <appendix><section><section><para>
 100 #: tools.dbk:56
 101 msgid ""
 102 "You can find documentation for this package in the <systemitem "
 103 "role=\"package\">debconf-doc</systemitem> package."
 104 msgstr ""
 105
 106 #. type: Content of: <appendix><section><section><para>
 107 #: tools.dbk:60
 108 msgid ""
 109 "Many feel that this system should be used for all packages which require "
 110 "interactive configuration; see <xref linkend=\"bpp-config-mgmt\"/>.  "
 111 "<systemitem role=\"package\">debconf</systemitem> is not currently required "
 112 "by Debian Policy, but that may change in the future."
 113 msgstr ""
 114
 115 #. type: Content of: <appendix><section><section><title>
 116 #: tools.dbk:68
 117 msgid "<systemitem role=\"package\">fakeroot</systemitem>"
 118 msgstr ""
 119
 120 #. type: Content of: <appendix><section><section><para>
 121 #: tools.dbk:70
 122 msgid ""
 123 "<systemitem role=\"package\">fakeroot</systemitem> simulates root "
 124 "privileges.  This enables you to build packages without being root (packages "
 125 "usually want to install files with root ownership).  If you have <systemitem "
 126 "role=\"package\">fakeroot</systemitem> installed, you can build packages as "
 127 "a regular user: <literal>dpkg-buildpackage -rfakeroot</literal>."
 128 msgstr ""
 129
 130 #. type: Content of: <appendix><section><title>
 131 #: tools.dbk:81
 132 msgid "Package lint tools"
 133 msgstr ""
 134
 135 #. type: Content of: <appendix><section><para>
 136 #: tools.dbk:83
 137 msgid ""
 138 "According to the Free On-line Dictionary of Computing (FOLDOC), `lint' is a "
 139 "Unix C language processor which carries out more thorough checks on the code "
 140 "than is usual with C compilers.  Package lint tools help package maintainers "
 141 "by automatically finding common problems and policy violations in their "
 142 "packages."
 143 msgstr ""
 144
 145 #. type: Content of: <appendix><section><section><title>
 146 #: tools.dbk:89
 147 msgid "<systemitem role=\"package\">lintian</systemitem>"
 148 msgstr ""
 149
 150 #. type: Content of: <appendix><section><section><para>
 151 #: tools.dbk:91
 152 msgid ""
 153 "<systemitem role=\"package\">lintian</systemitem> dissects Debian packages "
 154 "and emits information about bugs and policy violations.  It contains "
 155 "automated checks for many aspects of Debian policy as well as some checks "
 156 "for common errors."
 157 msgstr ""
 158
 159 #. type: Content of: <appendix><section><section><para>
 160 #: tools.dbk:97
 161 msgid ""
 162 "You should periodically get the newest <systemitem "
 163 "role=\"package\">lintian</systemitem> from <literal>unstable</literal> and "
 164 "check over all your packages.  Notice that the <literal>-i</literal> option "
 165 "provides detailed explanations of what each error or warning means, what its "
 166 "basis in Policy is, and commonly how you can fix the problem."
 167 msgstr ""
 168
 169 #. type: Content of: <appendix><section><section><para>
 170 #: tools.dbk:104
 171 msgid ""
 172 "Refer to <xref linkend=\"sanitycheck\"/> for more information on how and "
 173 "when to use Lintian."
 174 msgstr ""
 175
 176 #. type: Content of: <appendix><section><section><para>
 177 #: tools.dbk:108
 178 msgid ""
 179 "You can also see a summary of all problems reported by Lintian on your "
 180 "packages at <ulink url=\"&url-lintian;\"></ulink>.  These reports contain "
 181 "the latest <command>lintian</command> output for the whole development "
 182 "distribution (<literal>unstable</literal>)."
 183 msgstr ""
 184
 185 #. type: Content of: <appendix><section><section><title>
 186 #: tools.dbk:116
 187 msgid "<command>debdiff</command>"
 188 msgstr ""
 189
 190 #. type: Content of: <appendix><section><section><para>
 191 #: tools.dbk:118
 192 msgid ""
 193 "<command>debdiff</command> (from the <systemitem "
 194 "role=\"package\">devscripts</systemitem> package, <xref "
 195 "linkend=\"devscripts\"/>)  compares file lists and control files of two "
 196 "packages.  It is a simple regression test, as it will help you notice if the "
 197 "number of binary packages has changed since the last upload, or if something "
 198 "has changed in the control file.  Of course, some of the changes it reports "
 199 "will be all right, but it can help you prevent various accidents."
 200 msgstr ""
 201
 202 #. type: Content of: <appendix><section><section><para>
 203 #: tools.dbk:127
 204 msgid "You can run it over a pair of binary packages:"
 205 msgstr ""
 206
 207 #. type: Content of: <appendix><section><section><screen>
 208 #: tools.dbk:130
 209 #, no-wrap
 210 msgid "debdiff package_1-1_arch.deb package_2-1_arch.deb\n"
 211 msgstr ""
 212
 213 #. type: Content of: <appendix><section><section><para>
 214 #: tools.dbk:133
 215 msgid "Or even a pair of changes files:"
 216 msgstr ""
 217
 218 #. type: Content of: <appendix><section><section><screen>
 219 #: tools.dbk:136
 220 #, no-wrap
 221 msgid "debdiff package_1-1_arch.changes package_2-1_arch.changes\n"
 222 msgstr ""
 223
 224 #. type: Content of: <appendix><section><section><para>
 225 #: tools.dbk:139
 226 msgid ""
 227 "For more information please see <citerefentry> "
 228 "<refentrytitle>debdiff</refentrytitle> <manvolnum>1</manvolnum> "
 229 "</citerefentry>."
 230 msgstr ""
 231
 232 #. type: Content of: <appendix><section><title>
 233 #: tools.dbk:148
 234 msgid "Helpers for <filename>debian/rules</filename>"
 235 msgstr ""
 236
 237 #. type: Content of: <appendix><section><para>
 238 #: tools.dbk:150
 239 msgid ""
 240 "Package building tools make the process of writing "
 241 "<filename>debian/rules</filename> files easier.  See <xref "
 242 "linkend=\"helper-scripts\"/> for more information about why these might or "
 243 "might not be desired."
 244 msgstr ""
 245
 246 #. type: Content of: <appendix><section><section><title>
 247 #: tools.dbk:156
 248 msgid "<systemitem role=\"package\">debhelper</systemitem>"
 249 msgstr ""
 250
 251 #. type: Content of: <appendix><section><section><para>
 252 #: tools.dbk:158
 253 msgid ""
 254 "<systemitem role=\"package\">debhelper</systemitem> is a collection of "
 255 "programs which can be used in <filename>debian/rules</filename> to automate "
 256 "common tasks related to building binary Debian packages.  <systemitem "
 257 "role=\"package\">debhelper</systemitem> includes programs to install various "
 258 "files into your package, compress files, fix file permissions, and integrate "
 259 "your package with the Debian menu system."
 260 msgstr ""
 261
 262 #. type: Content of: <appendix><section><section><para>
 263 #: tools.dbk:166
 264 msgid ""
 265 "Unlike some approaches, <systemitem role=\"package\">debhelper</systemitem> "
 266 "is broken into several small, simple commands which act in a consistent "
 267 "manner.  As such, it allows more fine-grained control than some of the other "
 268 "debian/rules tools."
 269 msgstr ""
 270
 271 #. type: Content of: <appendix><section><section><para>
 272 #: tools.dbk:172
 273 msgid ""
 274 "There are a number of little <systemitem "
 275 "role=\"package\">debhelper</systemitem> add-on packages, too transient to "
 276 "document.  You can see the list of most of them by doing <literal>apt-cache "
 277 "search ^dh-</literal>."
 278 msgstr ""
 279
 280 #. type: Content of: <appendix><section><section><title>
 281 #: tools.dbk:179
 282 msgid "<systemitem role=\"package\">dh-make</systemitem>"
 283 msgstr ""
 284
 285 #. type: Content of: <appendix><section><section><para>
 286 #: tools.dbk:181
 287 msgid ""
 288 "The <systemitem role=\"package\">dh-make</systemitem> package contains "
 289 "<command>dh_make</command>, a program that creates a skeleton of files "
 290 "necessary to build a Debian package out of a source tree.  As the name "
 291 "suggests, <command>dh_make</command> is a rewrite of <systemitem "
 292 "role=\"package\">debmake</systemitem> and its template files use "
 293 "<command>dh_*</command> programs from <systemitem "
 294 "role=\"package\">debhelper</systemitem>."
 295 msgstr ""
 296
 297 #. type: Content of: <appendix><section><section><para>
 298 #: tools.dbk:189
 299 msgid ""
 300 "While the rules files generated by <command>dh_make</command> are in general "
 301 "a sufficient basis for a working package, they are still just the "
 302 "groundwork: the burden still lies on the maintainer to finely tune the "
 303 "generated files and make the package entirely functional and "
 304 "Policy-compliant."
 305 msgstr ""
 306
 307 #. type: Content of: <appendix><section><section><title>
 308 #: tools.dbk:197
 309 msgid "<systemitem role=\"package\">yada</systemitem>"
 310 msgstr ""
 311
 312 #. type: Content of: <appendix><section><section><para>
 313 #: tools.dbk:199
 314 msgid ""
 315 "<systemitem role=\"package\">yada</systemitem> is another packaging helper "
 316 "tool.  It uses a <filename>debian/packages</filename> file to auto-generate "
 317 "<filename>debian/rules</filename> and other necessary files in the "
 318 "<filename>debian/</filename> subdirectory.  The "
 319 "<filename>debian/packages</filename> file contains instruction to build "
 320 "packages and there is no need to create any <filename>Makefile</filename> "
 321 "files.  There is possibility to use macro engine similar to the one used in "
 322 "SPECS files from RPM source packages."
 323 msgstr ""
 324
 325 #. type: Content of: <appendix><section><section><para>
 326 #: tools.dbk:209
 327 msgid ""
 328 "For more informations see <ulink "
 329 "url=\"http://yada.alioth.debian.org/\"><literal>YADA</literal> site</ulink>."
 330 msgstr ""
 331
 332 #. type: Content of: <appendix><section><section><title>
 333 #: tools.dbk:215
 334 msgid "<systemitem role=\"package\">equivs</systemitem>"
 335 msgstr ""
 336
 337 #. type: Content of: <appendix><section><section><para>
 338 #: tools.dbk:217
 339 msgid ""
 340 "<systemitem role=\"package\">equivs</systemitem> is another package for "
 341 "making packages.  It is often suggested for local use if you need to make a "
 342 "package simply to fulfill dependencies.  It is also sometimes used when "
 343 "making ``meta-packages'', which are packages whose only purpose is to depend "
 344 "on other packages."
 345 msgstr ""
 346
 347 #. type: Content of: <appendix><section><title>
 348 #: tools.dbk:228
 349 msgid "Package builders"
 350 msgstr ""
 351
 352 #. type: Content of: <appendix><section><para>
 353 #: tools.dbk:230
 354 msgid ""
 355 "The following packages help with the package building process, general "
 356 "driving <command>dpkg-buildpackage</command> as well as handling supporting "
 357 "tasks."
 358 msgstr ""
 359
 360 #. type: Content of: <appendix><section><section><title>
 361 #: tools.dbk:234
 362 msgid "<systemitem role=\"package\">cvs-buildpackage</systemitem>"
 363 msgstr ""
 364
 365 #. type: Content of: <appendix><section><section><para>
 366 #: tools.dbk:236
 367 msgid ""
 368 "<systemitem role=\"package\">cvs-buildpackage</systemitem> provides the "
 369 "capability to inject or import Debian source packages into a CVS repository, "
 370 "build a Debian package from the CVS repository, and helps in integrating "
 371 "upstream changes into the repository."
 372 msgstr ""
 373
 374 #. type: Content of: <appendix><section><section><para>
 375 #: tools.dbk:242
 376 msgid ""
 377 "These utilities provide an infrastructure to facilitate the use of CVS by "
 378 "Debian maintainers.  This allows one to keep separate CVS branches of a "
 379 "package for <literal>stable</literal>, <literal>unstable</literal> and "
 380 "possibly <literal>experimental</literal> distributions, along with the other "
 381 "benefits of a version control system."
 382 msgstr ""
 383
 384 #. type: Content of: <appendix><section><section><title>
 385 #: tools.dbk:251
 386 msgid "<systemitem role=\"package\">debootstrap</systemitem>"
 387 msgstr ""
 388
 389 #. type: Content of: <appendix><section><section><para>
 390 #: tools.dbk:253
 391 msgid ""
 392 "The <systemitem role=\"package\">debootstrap</systemitem> package and script "
 393 "allows you to bootstrap a Debian base system into any part of your "
 394 "filesystem.  By base system, we mean the bare minimum of packages required "
 395 "to operate and install the rest of the system."
 396 msgstr ""
 397
 398 #. type: Content of: <appendix><section><section><para>
 399 #: tools.dbk:259
 400 msgid ""
 401 "Having a system like this can be useful in many ways.  For instance, you can "
 402 "<command>chroot</command> into it if you want to test your build "
 403 "dependencies.  Or you can test how your package behaves when installed into "
 404 "a bare base system.  Chroot builders use this package; see below."
 405 msgstr ""
 406
 407 #. type: Content of: <appendix><section><section><title>
 408 #: tools.dbk:267
 409 msgid "<systemitem role=\"package\">pbuilder</systemitem>"
 410 msgstr ""
 411
 412 #. type: Content of: <appendix><section><section><para>
 413 #: tools.dbk:269
 414 msgid ""
 415 "<systemitem role=\"package\">pbuilder</systemitem> constructs a chrooted "
 416 "system, and builds a package inside the chroot.  It is very useful to check "
 417 "that a package's build-dependencies are correct, and to be sure that "
 418 "unnecessary and wrong build dependencies will not exist in the resulting "
 419 "package."
 420 msgstr ""
 421
 422 #. type: Content of: <appendix><section><section><para>
 423 #: tools.dbk:275
 424 msgid ""
 425 "A related package is <systemitem role=\"package\">pbuilder-uml</systemitem>, "
 426 "which goes even further by doing the build within a User Mode Linux "
 427 "environment."
 428 msgstr ""
 429
 430 #. type: Content of: <appendix><section><section><title>
 431 #: tools.dbk:282
 432 msgid "<systemitem role=\"package\">sbuild</systemitem>"
 433 msgstr ""
 434
 435 #. type: Content of: <appendix><section><section><para>
 436 #: tools.dbk:284
 437 msgid ""
 438 "<systemitem role=\"package\">sbuild</systemitem> is another automated "
 439 "builder.  It can use chrooted environments as well.  It can be used "
 440 "stand-alone, or as part of a networked, distributed build environment.  As "
 441 "the latter, it is part of the system used by porters to build binary "
 442 "packages for all the available architectures.  See <xref "
 443 "linkend=\"wanna-build\"/> for more information, and <ulink "
 444 "url=\"&url-buildd;\"></ulink> to see the system in action."
 445 msgstr ""
 446
 447 #. type: Content of: <appendix><section><title>
 448 #: tools.dbk:296
 449 msgid "Package uploaders"
 450 msgstr ""
 451
 452 #. type: Content of: <appendix><section><para>
 453 #: tools.dbk:298
 454 msgid ""
 455 "The following packages help automate or simplify the process of uploading "
 456 "packages into the official archive."
 457 msgstr ""
 458
 459 #. type: Content of: <appendix><section><section><title>
 460 #: tools.dbk:302
 461 msgid "<systemitem role=\"package\">dupload</systemitem>"
 462 msgstr ""
 463
 464 #. type: Content of: <appendix><section><section><para>
 465 #: tools.dbk:304
 466 msgid ""
 467 "<systemitem role=\"package\">dupload</systemitem> is a package and a script "
 468 "to automatically upload Debian packages to the Debian archive, to log the "
 469 "upload, and to send mail about the upload of a package.  You can configure "
 470 "it for new upload locations or methods."
 471 msgstr ""
 472
 473 #. type: Content of: <appendix><section><section><title>
 474 #: tools.dbk:312
 475 msgid "<systemitem role=\"package\">dput</systemitem>"
 476 msgstr ""
 477
 478 #. type: Content of: <appendix><section><section><para>
 479 #: tools.dbk:314
 480 msgid ""
 481 "The <systemitem role=\"package\">dput</systemitem> package and script does "
 482 "much the same thing as <systemitem role=\"package\">dupload</systemitem>, "
 483 "but in a different way.  It has some features over <systemitem "
 484 "role=\"package\">dupload</systemitem>, such as the ability to check the "
 485 "GnuPG signature and checksums before uploading, and the possibility of "
 486 "running <command>dinstall</command> in dry-run mode after the upload."
 487 msgstr ""
 488
 489 #. type: Content of: <appendix><section><section><title>
 490 #: tools.dbk:324
 491 msgid "<command>dcut</command>"
 492 msgstr ""
 493
 494 #. type: Content of: <appendix><section><section><para>
 495 #: tools.dbk:326
 496 msgid ""
 497 "The <command>dcut</command> script (part of the package <systemitem "
 498 "role=\"package\">dput</systemitem>, <xref linkend=\"dput\"/>) helps in "
 499 "removing files from the ftp upload directory."
 500 msgstr ""
 501
 502 #. type: Content of: <appendix><section><title>
 503 #: tools.dbk:334
 504 msgid "Maintenance automation"
 505 msgstr ""
 506
 507 #. type: Content of: <appendix><section><para>
 508 #: tools.dbk:336
 509 msgid ""
 510 "The following tools help automate different maintenance tasks, from adding "
 511 "changelog entries or signature lines and looking up bugs in Emacs to making "
 512 "use of the newest and official <filename>config.sub</filename>."
 513 msgstr ""
 514
 515 #. type: Content of: <appendix><section><section><title>
 516 #: tools.dbk:341
 517 msgid "<systemitem role=\"package\">devscripts</systemitem>"
 518 msgstr ""
 519
 520 #. type: Content of: <appendix><section><section><para>
 521 #: tools.dbk:343
 522 msgid ""
 523 "<systemitem role=\"package\">devscripts</systemitem> is a package containing "
 524 "wrappers and tools which are very helpful for maintaining your Debian "
 525 "packages.  Example scripts include <command>debchange</command> and "
 526 "<command>dch</command>, which manipulate your "
 527 "<filename>debian/changelog</filename> file from the command-line, and "
 528 "<command>debuild</command>, which is a wrapper around "
 529 "<command>dpkg-buildpackage</command>.  The <command>bts</command> utility is "
 530 "also very helpful to update the state of bug reports on the command line.  "
 531 "<command>uscan</command> can be used to watch for new upstream versions of "
 532 "your packages.  <command>debrsign</command> can be used to remotely sign a "
 533 "package prior to upload, which is nice when the machine you build the "
 534 "package on is different from where your GPG keys are."
 535 msgstr ""
 536
 537 #. type: Content of: <appendix><section><section><para>
 538 #: tools.dbk:357
 539 msgid ""
 540 "See the <citerefentry> <refentrytitle>devscripts</refentrytitle> "
 541 "<manvolnum>1</manvolnum> </citerefentry> manual page for a complete list of "
 542 "available scripts."
 543 msgstr ""
 544
 545 #. type: Content of: <appendix><section><section><title>
 546 #: tools.dbk:364
 547 msgid "<systemitem role=\"package\">autotools-dev</systemitem>"
 548 msgstr ""
 549
 550 #. type: Content of: <appendix><section><section><para>
 551 #: tools.dbk:366
 552 msgid ""
 553 "<systemitem role=\"package\">autotools-dev</systemitem> contains best "
 554 "practices for people who maintain packages which use "
 555 "<command>autoconf</command> and/or <command>automake</command>.  Also "
 556 "contains canonical <filename>config.sub</filename> and "
 557 "<filename>config.guess</filename> files which are known to work on all "
 558 "Debian ports."
 559 msgstr ""
 560
 561 #. type: Content of: <appendix><section><section><title>
 562 #: tools.dbk:375
 563 msgid "<systemitem role=\"package\">dpkg-repack</systemitem>"
 564 msgstr ""
 565
 566 #. type: Content of: <appendix><section><section><para>
 567 #: tools.dbk:377
 568 msgid ""
 569 "<command>dpkg-repack</command> creates Debian package file out of a package "
 570 "that has already been installed.  If any changes have been made to the "
 571 "package while it was unpacked (e.g., files in <filename>/etc</filename> were "
 572 "modified), the new package will inherit the changes."
 573 msgstr ""
 574
 575 #. type: Content of: <appendix><section><section><para>
 576 #: tools.dbk:383
 577 msgid ""
 578 "This utility can make it easy to copy packages from one computer to another, "
 579 "or to recreate packages which are installed on your system but no longer "
 580 "available elsewhere, or to save the current state of a package before you "
 581 "upgrade it."
 582 msgstr ""
 583
 584 #. type: Content of: <appendix><section><section><title>
 585 #: tools.dbk:390
 586 msgid "<systemitem role=\"package\">alien</systemitem>"
 587 msgstr ""
 588
 589 #. type: Content of: <appendix><section><section><para>
 590 #: tools.dbk:392
 591 msgid ""
 592 "<command>alien</command> converts binary packages between various packaging "
 593 "formats, including Debian, RPM (RedHat), LSB (Linux Standard Base), Solaris, "
 594 "and Slackware packages."
 595 msgstr ""
 596
 597 #. type: Content of: <appendix><section><section><title>
 598 #: tools.dbk:399
 599 msgid "<systemitem role=\"package\">debsums</systemitem>"
 600 msgstr ""
 601
 602 #. type: Content of: <appendix><section><section><para>
 603 #: tools.dbk:401
 604 msgid ""
 605 "<command>debsums</command> checks installed packages against their MD5 "
 606 "sums.  Note that not all packages have MD5 sums, since they aren't required "
 607 "by Policy."
 608 msgstr ""
 609
 610 #. type: Content of: <appendix><section><section><title>
 611 #: tools.dbk:407
 612 msgid "<systemitem role=\"package\">dpkg-dev-el</systemitem>"
 613 msgstr ""
 614
 615 #. type: Content of: <appendix><section><section><para>
 616 #: tools.dbk:409
 617 msgid ""
 618 "<systemitem role=\"package\">dpkg-dev-el</systemitem> is an Emacs lisp "
 619 "package which provides assistance when editing some of the files in the "
 620 "<filename>debian</filename> directory of your package.  For instance, there "
 621 "are handy functions for listing a package's current bugs, and for finalizing "
 622 "the latest entry in a <filename>debian/changelog</filename> file."
 623 msgstr ""
 624
 625 #. type: Content of: <appendix><section><section><title>
 626 #: tools.dbk:418
 627 msgid "<command>dpkg-depcheck</command>"
 628 msgstr ""
 629
 630 #. type: Content of: <appendix><section><section><para>
 631 #: tools.dbk:420
 632 msgid ""
 633 "<command>dpkg-depcheck</command> (from the <systemitem "
 634 "role=\"package\">devscripts</systemitem> package, <xref "
 635 "linkend=\"devscripts\"/>)  runs a command under <command>strace</command> to "
 636 "determine all the packages that were used by the said command."
 637 msgstr ""
 638
 639 #. type: Content of: <appendix><section><section><para>
 640 #: tools.dbk:426
 641 msgid ""
 642 "For Debian packages, this is useful when you have to compose a "
 643 "<literal>Build-Depends</literal> line for your new package: running the "
 644 "build process through <command>dpkg-depcheck</command> will provide you with "
 645 "a good first approximation of the build-dependencies.  For example:"
 646 msgstr ""
 647
 648 #. type: Content of: <appendix><section><section><screen>
 649 #: tools.dbk:432
 650 #, no-wrap
 651 msgid "dpkg-depcheck -b debian/rules build\n"
 652 msgstr ""
 653
 654 #. type: Content of: <appendix><section><section><para>
 655 #: tools.dbk:435
 656 msgid ""
 657 "<command>dpkg-depcheck</command> can also be used to check for run-time "
 658 "dependencies, especially if your package uses <citerefentry> "
 659 "<refentrytitle>exec</refentrytitle> <manvolnum>2</manvolnum> </citerefentry> "
 660 "to run other programs."
 661 msgstr ""
 662
 663 #. type: Content of: <appendix><section><section><para>
 664 #: tools.dbk:441
 665 msgid ""
 666 "For more information please see <citerefentry> "
 667 "<refentrytitle>dpkg-depcheck</refentrytitle> <manvolnum>1</manvolnum> "
 668 "</citerefentry>."
 669 msgstr ""
 670
 671 #. type: Content of: <appendix><section><title>
 672 #: tools.dbk:450
 673 msgid "Porting tools"
 674 msgstr ""
 675
 676 #. type: Content of: <appendix><section><para>
 677 #: tools.dbk:452
 678 msgid "The following tools are helpful for porters and for cross-compilation."
 679 msgstr ""
 680
 681 #. type: Content of: <appendix><section><section><title>
 682 #: tools.dbk:455
 683 msgid "<systemitem role=\"package\">quinn-diff</systemitem>"
 684 msgstr ""
 685
 686 #. type: Content of: <appendix><section><section><para>
 687 #: tools.dbk:457
 688 msgid ""
 689 "<systemitem role=\"package\">quinn-diff</systemitem> is used to locate the "
 690 "differences from one architecture to another.  For instance, it could tell "
 691 "you which packages need to be ported for architecture "
 692 "<replaceable>Y</replaceable>, based on architecture "
 693 "<replaceable>X</replaceable>."
 694 msgstr ""
 695
 696 #. type: Content of: <appendix><section><section><title>
 697 #: tools.dbk:465
 698 msgid "<systemitem role=\"package\">dpkg-cross</systemitem>"
 699 msgstr ""
 700
 701 #. type: Content of: <appendix><section><section><para>
 702 #: tools.dbk:467
 703 msgid ""
 704 "<systemitem role=\"package\">dpkg-cross</systemitem> is a tool for "
 705 "installing libraries and headers for cross-compiling in a way similar to "
 706 "<systemitem role=\"package\">dpkg</systemitem>.  Furthermore, the "
 707 "functionality of <command>dpkg-buildpackage</command> and "
 708 "<command>dpkg-shlibdeps</command> is enhanced to support cross-compiling."
 709 msgstr ""
 710
 711 #. type: Content of: <appendix><section><title>
 712 #: tools.dbk:478
 713 msgid "Documentation and information"
 714 msgstr ""
 715
 716 #. type: Content of: <appendix><section><para>
 717 #: tools.dbk:480
 718 msgid ""
 719 "The following packages provide information for maintainers or help with "
 720 "building documentation."
 721 msgstr ""
 722
 723 #. type: Content of: <appendix><section><section><title>
 724 #: tools.dbk:485
 725 msgid "<systemitem role=\"package\">docbook-xml</systemitem>"
 726 msgstr ""
 727
 728 #. type: Content of: <appendix><section><section><para>
 729 #: tools.dbk:487
 730 msgid ""
 731 "<systemitem role=\"package\">docbook-xml</systemitem> provides the DocBook "
 732 "XML DTDs, which are commonly used for Debian documentation (as is the older "
 733 "debiandoc SGML DTD). This manual, for instance, is written in DocBook XML."
 734 msgstr ""
 735
 736 #. type: Content of: <appendix><section><section><para>
 737 #: tools.dbk:493
 738 msgid ""
 739 "The <systemitem role=\"package\">docbook-xsl</systemitem> package provides "
 740 "the XSL files for building and styling the source to various output "
 741 "formats. You will need an XSLT processor, such as <systemitem "
 742 "role=\"package\">xsltproc</systemitem>, to use the XSL stylesheets.  "
 743 "Documentation for the stylesheets can be found in the various <systemitem "
 744 "role=\"package\">docbook-xsl-doc-*</systemitem> packages."
 745 msgstr ""
 746
 747 #. type: Content of: <appendix><section><section><para>
 748 #: tools.dbk:501
 749 msgid ""
 750 "To produce PDF from FO, you need an FO processor, such as <systemitem "
 751 "role=\"package\">xmlroff</systemitem> or <systemitem "
 752 "role=\"package\">fop</systemitem>. Another tool to generate PDF from DocBook "
 753 "XML is <systemitem role=\"package\">dblatex</systemitem>."
 754 msgstr ""
 755
 756 #. type: Content of: <appendix><section><section><title>
 757 #: tools.dbk:509
 758 msgid "<systemitem role=\"package\">debiandoc-sgml</systemitem>"
 759 msgstr ""
 760
 761 #. type: Content of: <appendix><section><section><para>
 762 #: tools.dbk:511
 763 msgid ""
 764 "<systemitem role=\"package\">debiandoc-sgml</systemitem> provides the "
 765 "DebianDoc SGML DTD, which is commonly used for Debian documentation, but is "
 766 "now deprecated (<systemitem role=\"package\">docbook-xml</systemitem> should "
 767 "be used instead).  It also provides scripts for building and styling the "
 768 "source to various output formats."
 769 msgstr ""
 770
 771 #. type: Content of: <appendix><section><section><para>
 772 #: tools.dbk:520
 773 msgid ""
 774 "Documentation for the DTD can be found in the <systemitem "
 775 "role=\"package\">debiandoc-sgml-doc</systemitem> package."
 776 msgstr ""
 777
 778 #. type: Content of: <appendix><section><section><title>
 779 #: tools.dbk:526
 780 msgid "<systemitem role=\"package\">debian-keyring</systemitem>"
 781 msgstr ""
 782
 783 #. type: Content of: <appendix><section><section><para>
 784 #: tools.dbk:528
 785 msgid ""
 786 "Contains the public GPG and PGP keys of Debian developers.  See <xref "
 787 "linkend=\"key-maint\"/> and the package documentation for more information."
 788 msgstr ""
 789
 790 #. type: Content of: <appendix><section><section><title>
 791 #: tools.dbk:534
 792 msgid "<systemitem role=\"package\">debian-maintainers</systemitem>"
 793 msgstr ""
 794
 795 #. type: Content of: <appendix><section><section><para>
 796 #: tools.dbk:536
 797 msgid ""
 798 "Contains the public GPG keys of Debian Maintainers.  See <ulink "
 799 "url=\"&url-wiki-dm;\"></ulink> for more information."
 800 msgstr ""
 801
 802 #. type: Content of: <appendix><section><section><title>
 803 #: tools.dbk:542
 804 msgid "<systemitem role=\"package\">debview</systemitem>"
 805 msgstr ""
 806
 807 #. type: Content of: <appendix><section><section><para>
 808 #: tools.dbk:544
 809 msgid ""
 810 "<systemitem role=\"package\">debview</systemitem> provides an Emacs mode for "
 811 "viewing Debian binary packages.  This lets you examine a package without "
 812 "unpacking it."
 813 msgstr ""