[Build-common-hackers] Bug#500224: Patch for localization support of the CDBS documentation using Po4a

[Kobayashi Noritada]

Package: cdbs
Version: 0.4.52
Severity: wishlist
Tags: l10n patch


Hi,

First of all, thanks for developing such a nice tool to ease maintenance
of Debian packages.

Well, some Japanese developers asked me for localization of the CDBS
documentation since they want to diffuse the use of CDBS in Japan and
hence to translate the documentation to Japanese.  However, as a
translator of some documentation, I do not think it's good to translate
an original DocBook file to another one since it is hard to maintain
afterward by merging manually.

So, I have created the attached patches to add localization support
using Po4a.  The first patch "cdbs-doc-fix.diff" is only for fixing XML
by adding an end tag.  The second patch "cdbs-doc-l10n.diff" is the main
one.  Currently, this patch is useful only for translating the
documentation and not for building localized HTML/PDF files since no
enough translation is available.

The changelog is like this:

[[[
Add a localization support of the CDBS documentation using Po4a

Currently, it is possible only to translate the documentation and not to
build localized HTML/PDF files since no enough translation is available.

* doc/Makefile (update-po): New target for updating POT/PO files using
  the "po4a" command.  This target also generates localized XML files.

* doc/po4a.cfg: New configuration file used by the "po4a" command.

* doc/po/cdbs-doc.pot: New POT file generated from doc/cdbs-doc.xml.

* doc/po/ja.po: New (still newborn) Japanese translation.
]]]

Best regards,

-nori


-- System Information:
Debian Release: 4.0
  APT prefers stable
  APT policy: (500, 'stable'), (90, 'testing')
Architecture: i386 (i686)
Shell:  /bin/sh linked to /bin/bash
Kernel: Linux 2.6.18-6-686
Locale: LANG=ja_JP.eucJP, LC_CTYPE=ja_JP.eucJP (charmap=EUC-JP)

cdbs depends on no packages.

Versions of packages cdbs recommends:
ii  autotools-dev                 20060702.1 Update infrastructure for config.{
ii  debhelper                     5.0.42     helper programs for debian/rules

-- no debconf information
-------------- next part --------------
Index: doc/cdbs-doc.xml
===================================================================
--- doc/cdbs-doc.xml	(revision 281)
+++ doc/cdbs-doc.xml	(working copy)
@@ -1207,6 +1207,7 @@
 <programlisting>
 include /usr/share/cdbs/1/class/perlmodule.mk
 </programlisting>
+      </para>
 
       <para>The installation directory defaults to
       <filename><replaceable>first_pkg</replaceable>/usr</filename>
-------------- next part --------------
Index: doc/Makefile
===================================================================
--- doc/Makefile	(????? 281)
+++ doc/Makefile	(?????)
@@ -39,7 +39,10 @@
 depgraph.dot: depgraph-tmp.dot
 	unflatten -l 5 -o $@ $^
 
+update-po:
+	po4a -k 0 po4a.cfg
 
+
 clean:
 	rm -f *.aux *.dvi *.out *.log *.glo *.idx *.ind *.ilg *.lot *.lof *.toc *.tex *.fo *.png *.pdf *.eps *.tex-* *.html *.ps *.txt xmllint-stamp-*
 	rm -f depgraph.dot depgraph-tmp.dot
Index: doc/po4a.cfg
===================================================================
--- doc/po4a.cfg	(????? 0)
+++ doc/po4a.cfg	(????? 0)
@@ -0,0 +1,5 @@
+[po4a_langs] ja
+
+[po4a_paths] po/cdbs-doc.pot $lang:po/$lang.po
+
+[type: docbook] cdbs-doc.xml $lang:cdbs-doc.$lang.xml
Index: doc/po/cdbs-doc.pot
===================================================================
--- doc/po/cdbs-doc.pot	(????? 0)
+++ doc/po/cdbs-doc.pot	(????? 0)
@@ -0,0 +1,3644 @@
+# SOME DESCRIPTIVE TITLE
+# Copyright (C) YEAR Free Software Foundation, Inc.
+# This file is distributed under the same license as the PACKAGE package.
+# FIRST AUTHOR <EMAIL at ADDRESS>, YEAR.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"POT-Creation-Date: 2008-09-24 20:28+0900\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
+"Language-Team: LANGUAGE <LL at li.org>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=utf-8\n"
+"Content-Transfer-Encoding: ENCODING"
+
+# type: Attribute 'lang' of: <book>
+#: cdbs-doc.xml:4
+msgid "en"
+msgstr ""
+
+# type: Content of: <book><bookinfo><title>
+#: cdbs-doc.xml:6
+msgid "The Common Debian Build System"
+msgstr ""
+
+# type: Content of: <book><bookinfo><authorgroup><author>
+#: cdbs-doc.xml:9
+msgid ""
+"<author> <firstname>Marc</firstname> <othername>(Duck)</othername> "
+"<surname>Dequ?nes</surname>"
+msgstr ""
+
+# type: Content of: <book><bookinfo><authorgroup><author><affiliation>
+#: cdbs-doc.xml:14
+msgid "<orgname>DuckCorp</orgname>"
+msgstr ""
+
+# type: Content of: <book><bookinfo><legalnotice><para>
+#: cdbs-doc.xml:40
+msgid ""
+"Permission is granted to copy, distribute and/or modify this document under "
+"the terms of the <ulink url=\"http://www.gnu.org/licenses/gpl.html\">GNU "
+"General Public License</ulink>, Version 2 or any later version published by "
+"the Free Software Foundation."
+msgstr ""
+
+# type: Content of: <book><bookinfo><copyright><holder>
+#: cdbs-doc.xml:49
+msgid "Peter Eisentraut"
+msgstr ""
+
+# type: Content of: <book><bookinfo><copyright><holder>
+#: cdbs-doc.xml:55
+msgid "DuckCorp"
+msgstr ""
+
+# type: Content of: <book><bookinfo><copyright><holder>
+#: cdbs-doc.xml:60
+msgid "Colin Walters"
+msgstr ""
+
+# type: Content of: <book><chapter><title>
+#: cdbs-doc.xml:65
+msgid "Introduction"
+msgstr ""
+
+# type: Content of: <book><chapter><para>
+#: cdbs-doc.xml:67
+msgid ""
+"CDBS is essentially a set of makefile fragments that you may include into "
+"your <filename>debian/rules</filename> for building Debian packages.  Each "
+"makefile fragment can have effects in different parts of the package build "
+"process."
+msgstr ""
+
+# type: Content of: <book><chapter><para>
+#: cdbs-doc.xml:72
+msgid ""
+"The motivating factor for CDBS was originally that more and more programs "
+"today are created using GNU Autoconf configure scripts and GNU Automake, and "
+"as such they are all very similar to configure and build.  It was realized "
+"that a lot of duplicated code in everyone's "
+"<filename>debian/rules</filename> could be factored out.  But CDBS isn't "
+"only useful for packages that use the GNU autotools.  It is a flexible core "
+"upon which you can create your own custom build systems."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:82
+msgid "Why Does CDBS Exist?"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:84
+msgid ""
+"The current generally accepted practice for creating new Debian packages is "
+"to run <command>dh_make</command>, which generates a bunch of files, the "
+"most important of which are <filename>debian/control</filename>, "
+"<filename>debian/copyright</filename>, and "
+"<filename>debian/rules</filename>.  The first two are relatively "
+"straightforward.  But <filename>debian/rules</filename> is not.  Debhelper "
+"was an enormous step forward in this area, greatly reducing redundant and "
+"incomprehensible code from the Debian package creation process.  But it "
+"doesn't go far enough; the typical <command>dh_make</command> generated "
+"<filename>debian/rules</filename> is hundreds of lines, only some of which "
+"apply.  From experience with helping several people to learn Debian "
+"packaging, <filename>debian/rules</filename> was by far the hardest part for "
+"them to understand."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:101
+msgid ""
+"Moreover, this generated code will become stale with time, as the Debian "
+"policy changes.  At some time in the past, the "
+"<varname>DEB_BUILD_OPTIONS</varname> variable dropped the "
+"<literal>debug</literal> flag in favor of <literal>noopt</literal>.  But "
+"gradually it was realized that since the code to check this variable was "
+"duplicated over hundreds (if not thousands) of "
+"<command>dh_make</command>-generated source packages (and had possibly been "
+"modified), it would likely be years before most packages were updated.  And "
+"there are many packages that predate <varname>DEB_BUILD_OPTIONS</varname> "
+"and don't even use it at all, when they easily could."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:114
+msgid ""
+"The Unix and hacker cultures in general have long looked down upon generated "
+"code, and for good reason.  It is often hard to edit, and there is almost "
+"always no way to regenerate the code but keep your local changes.  Instead "
+"of generating code (like all the Microsoft tools tend to do), the Unix "
+"tradition is to create a metalanguage, a compiler, or some other form of "
+"abstraction."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:122
+msgid ""
+"CDBS is that abstraction.  It's not the first attempt at abstracting the "
+"Debian build process; before Debhelper, many attempts came along and had "
+"only marginal success, if any.  So now the question you're asking yourself "
+"is probably:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:129
+msgid "What Makes CDBS Better?"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:131
+msgid ""
+"First of all, it is not monolithic (as opposed to debstd, for instance).  "
+"CDBS is quite simply a set of makefile fragments that can be included; if "
+"you don't want a particular part, you just don't include the makefile "
+"fragment for it."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:136
+msgid ""
+"Second, CDBS does not attempt to supplant Debhelper (which has generally "
+"done an excellent job at the <literal>binary</literal> stage of Debian "
+"package building).  CDBS can optionally use Debhelper to implement various "
+"parts of building a Debian package.  This is the recommended mode of "
+"operation, actually.  But some people may find Debhelper doesn't work for "
+"them; if that's the case, you just don't include "
+"<filename>debhelper.mk</filename>, and you can do the work yourself."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:146
+msgid ""
+"Third, CDBS tries to make the common case easy.  If you have a package that "
+"uses the GNU autotools and such, you can have a working build system simply "
+"by including about two or three makefile fragments.  No custom code required "
+"at all.  Additionally, CDBS has even higher-level makefile fragments; for "
+"example, there are <filename>gnome.mk</filename> and "
+"<filename>kde.mk</filename> rule files which handle a number of common "
+"things required by GNOME and KDE packages."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:155
+msgid ""
+"Finally, CDBS (along with Debhelper) should make it much easier to effect "
+"systemwide changes.  For example, if we later decide to switch our default "
+"<literal>i386</literal> architecture to <literal>i486</literal> (as we "
+"probably will), all we have to do is change "
+"<filename>autotools.mk</filename>, and the correct"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><option>
+#: cdbs-doc.xml:160
+msgid "--host"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:160
+msgid "and"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><option>
+#: cdbs-doc.xml:161
+msgid "--build"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:161
+msgid ""
+"will be passed to all <literal>./configure</literal> invocations.  Currently "
+"<emphasis>some</emphasis> packages have the <varname>DEB_HOST_ARCH</varname> "
+"boilerplate code in their <filename>debian/rules</filename>, but many don't."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:169
+msgid "Why Not Just Debhelper?"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:171
+msgid ""
+"Some things done in CDBS could just as well go into a "
+"<command>dh_foo</command> program (for example, some of "
+"<filename>autotools.mk</filename>).  Likewise, some "
+"<command>dh_foo</command> programs would probably do better as CDBS makefile "
+"fragments (<command>dh_python</command> comes to mind)."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:178
+msgid ""
+"But CDBS' makefile fragment orientation allows it to do things that "
+"Debhelper can't, or can't easily do.  For example, CDBS automatically "
+"generates a ton of makefile rules corresponding to package building.  This "
+"saves a great deal of redundant code in <filename>debian/rules</filename>."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:184
+msgid ""
+"CDBS automatically creates <literal>build-arch</literal> and "
+"<literal>build-indep</literal> targets, and builds architecture-dependent "
+"and -independent packages under them.  It also can cleanly affect a number "
+"of different parts of the build system (e.g., <literal>clean</literal>, "
+"<literal>configure</literal>, <literal>build</literal>) by simply including "
+"one makefile fragment; doing this as a <command>dh_foo</command> would "
+"require inserting a call like <literal>dh_foo --clean</literal>, "
+"<literal>dh_foo --configure</literal> at each step.  And doing things this "
+"way wouldn't allow future expansion; you'd have to change your code to say "
+"<literal>dh_foo --build</literal> if the foo helper wanted to modify the "
+"build process, too."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:198
+msgid ""
+"So CDBS complements Debhelper (or it can; again, CDBS does not require "
+"Debhelper)."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:203
+msgid "Summary"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:205
+msgid ""
+"In summary, we believe CDBS (typically combined with Debhelper) is the "
+"future of Debian packaging.  By reducing the complexity in each package, we "
+"make sweeping changes much easier.  Debian has made several major "
+"transitions in the past, and will in the future.  It shouldn't be as painful "
+"as it has been.  Moreover, CDBS makes creating simple packages very easy, as "
+"it should be."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:213
+msgid "CDBS advantages:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:217
+msgid "short and readable <filename>debian/rules</filename>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:221
+msgid ""
+"automates Debhelper and autotools for you so you don't have to bother with "
+"these repetitive tasks"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:226
+msgid ""
+"maintainer can focus on real packaging problems because CDBS helps you but "
+"does not limit customization"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:232
+msgid "rules used in CDBS have been well tested"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:236
+msgid "switching to CDBS is easy"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:240
+msgid ""
+"can be used to generate debian files (like "
+"<filename>debian/control</filename> for GNOME Team Uploaders inclusion)"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:246
+msgid "CDBS is easily extensible"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:250
+msgid "It |70&gt;&lt; !!!"
+msgstr ""
+
+# type: Content of: <book><chapter><title>
+#: cdbs-doc.xml:258
+msgid "First Steps"
+msgstr ""
+
+# type: Content of: <book><chapter><para>
+#: cdbs-doc.xml:260
+msgid ""
+"The best documentation for CDBS are the makefile fragments under "
+"<filename>/usr/share/cdbs/1/</filename>.  The following will tell you how to "
+"get started with CDBS and explain what is possible, but since you can pretty "
+"much override or customize anything in CDBS, you will sooner or later want "
+"to look at the code itself."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:268
+msgid "Switching the Package to CDBS"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:270
+msgid ""
+"Switching to CDBS is easy.  A simple <filename>debian/rules</filename> for "
+"an autotools-using C or C++ software with no extra rules would be written as "
+"this:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:274
+#, no-wrap
+msgid ""
+"\n"
+"#!/usr/bin/make -f\n"
+"\n"
+"include /usr/share/cdbs/1/rules/debhelper.mk\n"
+"include /usr/share/cdbs/1/class/autotools.mk\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:282
+msgid ""
+"Yes, really.  This is sufficient, and it handles autotools management, like "
+"updating <filename>config.guess</filename> and "
+"<filename>config.sub</filename>, cleaning up temporary files after the "
+"build, and running all common debhelper commands."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:288
+msgid ""
+"Create your <filename><replaceable>package</replaceable>.install</filename>, "
+"<filename><replaceable>package</replaceable>.info</filename>, etc. as you "
+"usually do with <command>dh_*</command> commands, and CDBS will call them if "
+"necessary, autodetecting a lot of things.  In case of missing Debhelper "
+"compatibility information, CDBS will create a "
+"<filename>debian/compat</filename> file with compatibility level 5."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:297
+msgid ""
+"Incidentally, you should usually include <filename>debhelper.mk</filename> "
+"first, before other files.  This will turn on optional Debhelper-using parts "
+"of other rules files, if any, which is usually what you want."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:302
+msgid ""
+"Naturally, if you switch a package to use CDBS, you must add a build "
+"dependency on <literal>cdbs</literal> to your package."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><note><title>
+#: cdbs-doc.xml:307
+msgid "Versioning note"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><note><para>
+#: cdbs-doc.xml:309
+msgid ""
+"CDBS might change incompatibly in the future, and to allow for this, all the "
+"rules and classes are in a version-specific subdirectory.  That's the reason "
+"for the <literal>1</literal> in <filename>/usr/share/cdbs/1</filename>."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><warning><para>
+#: cdbs-doc.xml:317
+msgid ""
+"CDBS does not work if the name of the current directory contains spaces or "
+"some other special characters such as quotation marks.  This situation is "
+"very hard to handle in <command>make</command>, so it is best to stick to "
+"<quote>sane</quote> directory names."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:326
+msgid "Basic Settings and Available Variables"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:328
+msgid ""
+"Every CDBS-using <filename>debian/rules</filename> should eventually include "
+"<filename>/usr/share/cdbs/1/rules/buildcore.mk</filename>.  (It might be "
+"included automatically via dependencies, as we will see later.)  This "
+"makefile fragment sets up all of the core default makefile structure and "
+"variables, but doesn't actually <emphasis>do</emphasis> anything on its own."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:336
+msgid ""
+"You can use the <filename>buildcore.mk</filename> rules to hook in your own "
+"build system to actually implement each stage of compiling, installing, and "
+"building <filename>.deb</filename>s if you wish, but typically you will use "
+"the rules and classes that CDBS has prepared for you."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:342
+msgid "You can change common build parameters this way:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:343
+#, no-wrap
+msgid ""
+"\n"
+"# where sources are\n"
+"DEB_SRCDIR = $(CURDIR)/src\n"
+"\n"
+"# in which directory to build\n"
+"DEB_BUILDDIR = $(DEB_SRCDIR)/build\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:350
+msgid ""
+"Remember that you can get the package directory using the "
+"<varname>CURDIR</varname> variable."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:353
+msgid ""
+"Note that the variables should be set <emphasis>after</emphasis> the rule "
+"fragments are included.  This is necessary for them to have any effect.  "
+"There are a few exceptions to this; but generally variables should be set "
+"after rule fragments are included."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:360
+msgid "Some of the variables you can use in <filename>debian/rules</filename>:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><term>
+#: cdbs-doc.xml:365
+msgid "<varname>DEB_SOURCE_PACKAGE</varname>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:366
+msgid "name of the source package"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><term>
+#: cdbs-doc.xml:370
+msgid "<varname>DEB_VERSION</varname>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:371
+msgid "full Debian version"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><term>
+#: cdbs-doc.xml:375
+msgid "<varname>DEB_NOEPOCH_VERSION</varname>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:376
+msgid "Debian version without epoch"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><term>
+#: cdbs-doc.xml:380
+msgid "<varname>DEB_ISNATIVE</varname>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:381
+msgid "nonemtpy if the package is native"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><term>
+#: cdbs-doc.xml:385
+msgid "<varname>DEB_ALL_PACKAGES</varname>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:386
+msgid "list of all binary packages"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><term>
+#: cdbs-doc.xml:390
+msgid "<varname>DEB_INDEP_PACKAGES</varname>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:391
+msgid "list of architecture-independent binary packages"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><term>
+#: cdbs-doc.xml:395
+msgid "<varname>DEB_ARCH_PACKAGES</varname>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:396
+msgid "list of architecture-dependent binary packages"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><term>
+#: cdbs-doc.xml:400
+msgid "<varname>DEB_PACKAGES</varname>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:401
+msgid "list of normal (non-udeb) binary packages"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><term>
+#: cdbs-doc.xml:405
+msgid "<varname>DEB_UDEB_PACKAGES</varname>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:406
+msgid "list of udeb binary packages, if any"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><term>
+#: cdbs-doc.xml:410
+msgid "<varname>DEB_ARCH</varname>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:411
+msgid ""
+"the old Debian architecture name (deprecated, only use to provide backward "
+"compatibility; see <command>dpkg-architecture</command> man page for more "
+"information)"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><term>
+#: cdbs-doc.xml:418
+msgid "<varname>DEB_HOST_ARCH_CPU</varname>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:419
+msgid "the CPU part of the Debian architecture (e.g., <literal>powerpc</literal>)"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><term>
+#: cdbs-doc.xml:423
+msgid "<varname>DEB_HOST_ARCH_OS</varname>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:424
+msgid ""
+"the operating system part of the Debian architecture (e.g., "
+"<literal>linux</literal>)"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><term>
+#: cdbs-doc.xml:428
+msgid "<varname>DEB_DESTDIR</varname>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:429
+msgid ""
+"The directory in which to install the package.  This is automatically set to "
+"<filename>$(CURDIR)/debian/<replaceable>packagename</replaceable></filename> "
+"if there is one package and <filename>$(CURDIR)/debian/tmp</filename> if "
+"there are multiple packages.  In the latter case you would usually use "
+"<filename>.install</filename> files to install the package files into the "
+"final directories.  In some exceptional cases, you may need to set "
+"<varname>DEB_DESTDIR</varname> yourself.  One case is when some packages are "
+"only built on some architectures, which could make CDBS set the variable "
+"inconsistently across architectures, which in turn would create problems "
+"with the <filename>.install</filename> files."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:449
+msgid "Custom Rules"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:451
+msgid ""
+"Suppose that your package generates extra cruft as a side effect of the "
+"build process that's not taken care of by the upstream "
+"<literal>clean</literal> rule and ends up bloating your diff.  To handle "
+"this (until upstream fixes it), you can simply add stuff to the "
+"<literal>clean</literal> rule as follows:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:458
+#, no-wrap
+msgid ""
+"\n"
+"clean::\n"
+"\trm -f foo/blah.o po/.intltool-merge-cache\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:463
+msgid ""
+"Almost all of the current rules are <firstterm>double-colon</firstterm> "
+"rules (see the <citetitle>GNU Make Manual</citetitle>).  This means you can "
+"simply add to them without overriding the default."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:468
+msgid ""
+"You can also add dependencies to the rules.  For example, suppose you have a "
+"multiple-binary package that builds both a program and a shared library, and "
+"the program depends on the shared library.  To tell CDBS to build the shared "
+"library before the program, just do something like:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:474
+#, no-wrap
+msgid ""
+"\n"
+"binary/program:: binary/libfoo\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:478
+msgid ""
+"However, this must come <emphasis>before</emphasis> you include "
+"<filename>buildcore.mk</filename>.  This is due to the way make works."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:482
+msgid ""
+"Targets of the form "
+"<literal><replaceable>something</replaceable>/<replaceable>package</replaceable></literal> "
+"exist for many stages of the package build process and allow you to hook in "
+"additional commands.  Suppose you want custom rules for the source package "
+"<literal>foo</literal>, creating binary packages <literal>foo</literal> "
+"(architecture-depependent) and <literal>foo-data</literal> "
+"(architecture-independent).  You simply need to add some lines like the "
+"following to <filename>debian/rules</filename>."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:492
+msgid "To add pre-configure actions:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:493
+#, no-wrap
+msgid ""
+"\n"
+"makebuilddir/foo::\n"
+"\tln -s plop plop2\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:499
+msgid "To add post-configure actions:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:500
+#, no-wrap
+msgid ""
+"\n"
+"configure/foo::\n"
+"\tsed -ri 's/PLOP/PLIP/' Makefile\n"
+"\n"
+"configure/foo-data::\n"
+"\ttouch src/z.xml\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:507
+msgid ""
+"In this case we are talking about package configuration and not about a "
+"<filename>configure</filename> script made with autotools (although such a "
+"<filename>configure</filename> script would normally also be called in that "
+"very package configuration phase)."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:513
+msgid "To add post-build actions:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:514
+#, no-wrap
+msgid ""
+"\n"
+"build/foo::\n"
+"\t$(SHELL) debian/scripts/toto.sh\n"
+"\n"
+"build/foo-data::\n"
+"\t$(MAKE) helpfiles\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:523
+msgid "To add post-install actions:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:524
+#, no-wrap
+msgid ""
+"\n"
+"install/foo::\n"
+"\tcp debian/tmp/myfoocmd debian/foo/foocmd\n"
+"\tfind debian/foo/ -name \"CVS\" -depth -exec rm -rf {} \\;\n"
+"\tstrip --remove-section=.comment --remove-section=.note --strip-unneeded "
+"\\\n"
+"\t    debian/foo/usr/lib/foo/totoz.so\n"
+"\n"
+"install/foo-data::\n"
+"\tcp data/*.png debian/foo-data/usr/share/foo-data/images/\n"
+"\tdh_stuff -m ipot -f plop.bz3 debian/foo-data/libexec/\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:537
+msgid "To add post deb preparation actions (usually not very useful):"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:539
+#, no-wrap
+msgid ""
+"\n"
+"binary/foo::\n"
+"\t at echo 'Package foo successfully built.'\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:545
+msgid "To add pre-clean actions:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:546
+#, no-wrap
+msgid ""
+"\n"
+"cleanbuilddir/foo::\n"
+"\trm -f debian/fooman.1\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:552
+msgid ""
+"Now, let's suppose your package is a little bit strange (e.g. Perl); perhaps "
+"it has a <command>Configure</command> script that isn't made by Autoconf; "
+"this script might instead expect the user to interactively configure the "
+"program.  In that case, you can just implement the "
+"<literal>common-configure</literal> rule, by adding something like the "
+"following to your <filename>debian/rules</filename>:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:561
+#, no-wrap
+msgid ""
+"\n"
+"common-configure::\n"
+"\t./Configure --blah --blargh &lt; debian/answers\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:567
+msgid ""
+"Note that if you do this, you can't include "
+"<filename>autotools.mk</filename>, since then you'll get "
+"<emphasis>two</emphasis> implementations of common-configure, which is sure "
+"to fail.  It would be nice to be able to partially override rule fragments, "
+"but that is a tricky problem."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:573
+msgid ""
+"<xref linkend=\"fig:buildcore\"/> gives an overview of the targets provided "
+"by <filename>buildcore.mk</filename> where you can hook in custom rules.  "
+"The bold ellipses are the targets required by the Debian policy.  For "
+"illustration, the diamond-shaped nodes show how a typical autotools-using "
+"build process would be hooked into these rules.  These are not actually "
+"provided by <filename>buildcore.mk</filename> of course."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><figure><title>
+#: cdbs-doc.xml:583
+msgid "Buildcore targets"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:595
+msgid ""
+"Rules that add commands should normally be written "
+"<emphasis>after</emphasis> including any CDBS rule fragments, unless you "
+"know exactly what you're doing.  The reason for this is as follows.  The "
+"commands for double-colon rules are accumulated in the order in which they "
+"appear in the makefile.  That is, writing"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:601
+#, no-wrap
+msgid ""
+"\n"
+"target::\n"
+"\tfoo\n"
+"\n"
+"target::\n"
+"\tbar\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:608
+msgid "will have approximately the same effect as"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:609
+#, no-wrap
+msgid ""
+"\n"
+"target:\n"
+"\tfoo\n"
+"\tbar\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:614
+msgid ""
+"Now if you have, for example, an autotools-using package and wrote something "
+"like"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:616
+#, no-wrap
+msgid ""
+"\n"
+"build/myprog::\n"
+"\t$(MAKE) extrastuff\n"
+"\n"
+"include /usr/share/cdbs/1/class/autotools.mk\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:622
+msgid ""
+"(more on the autotools class below), this would end up running "
+"<literal>$(MAKE) extrastuff</literal> before <literal>autotools.mk</literal> "
+"has a chance to run <command>configure</command>, so there will probably not "
+"be any instantiated makefile yet and the build will fail."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:628
+msgid ""
+"Again, the recommended practice is to include all the CDBS rule fragments "
+"first on your <filename>debian/rules</filename> and put variable assignments "
+"and extra rules afterwards, unless an exception is explicitly pointed out in "
+"this manual."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:635
+msgid "Common Build Options"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:638
+msgid ""
+"<varname>CFLAGS</varname> and <varname>CXXFLAGS</varname> are set to "
+"<literal>-g -Wall -O2</literal> by default."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:643
+msgid ""
+"<varname>DEB_BUILD_OPTIONS</varname> is a well known Debian environment "
+"variable, not a CDBS one, containing special build options (a "
+"comma-separated list of key words).  CDBS does check "
+"<varname>DEB_BUILD_OPTIONS</varname> to take these options into account; see "
+"details in each class."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:652
+msgid "Debhelper Support"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:654
+msgid ""
+"An important piece of the puzzle after configuring and building the software "
+"is to actually build <filename>.deb</filename>s from there.  You could "
+"implement this step yourself if you wished, but most people will want to "
+"take advantage of Debhelper to do it mostly automatically.  To do this, "
+"simply add a line like"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:661
+#, no-wrap
+msgid ""
+"\n"
+"include /usr/share/cdbs/1/rules/debhelper.mk\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:664
+msgid "in <filename>debian/rules</filename>."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:667
+msgid ""
+"CDBS debhelper rules handle the following <command>dh_*</command> commands "
+"for each binary package automatically:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:672
+msgid "dh_builddeb"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:673
+msgid "dh_clean"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:674
+msgid "dh_compress"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:675
+msgid "dh_fixperms"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:676
+msgid "dh_gencontrol"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:677
+msgid "dh_install"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:678
+msgid "dh_installcatalogs"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:679
+msgid "dh_installchangelogs"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:680
+msgid "dh_installcron"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:681
+msgid "dh_installdeb"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:682
+msgid "dh_installdebconf"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:683
+msgid "dh_installdirs"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:684
+msgid "dh_installdocs"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:685
+msgid "dh_installemacsen"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:686
+msgid "dh_installexamples"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:687
+msgid "dh_installinfo"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:688
+msgid "dh_installinit"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:689
+msgid "dh_installlogcheck"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:690
+msgid "dh_installlogrotate"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:691
+msgid "dh_installman"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:692
+msgid "dh_installmenu"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:693
+msgid "dh_installmime"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:694
+msgid "dh_installpam"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:695
+msgid "dh_installudev"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:696
+msgid "dh_link"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:697
+msgid "dh_lintian"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:698
+msgid "dh_makeshlibs"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:699
+msgid "dh_md5sums"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:700
+msgid "dh_perl"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:701
+msgid "dh_shlibdeps"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:702
+msgid "dh_strip"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:705
+msgid ""
+"Of course, these are called in the correct order, not in the one shown "
+"above.  Other debhelper commands can be handled in specific classes or may "
+"be called in custom rules."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:709
+msgid ""
+"If you use <filename>debhelper.mk</filename>, you must add a build "
+"dependency on <literal>debhelper</literal>.  If you use Debhelper "
+"compatibility level 5, then the dependency should be (at least) "
+"<literal>debhelper (>= 5)</literal>, if you use version 4 then (at least) "
+"<literal>debhelper (>= 4.2.0)</literal>."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><title>
+#: cdbs-doc.xml:717
+msgid "Debhelper Parameters"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:719
+msgid ""
+"The following variables allow Debhelper call customization while leaving the "
+"other calls to be handled without writing any rule.  Some of them apply on "
+"all binary packages, for instance <varname>DEB_INSTALL_DOCS_ALL</varname>, "
+"and some apply only to a specific package, for instance "
+"<varname>DEB_SHLIBDEPS_LIBRARY_<replaceable>package</replaceable></varname> "
+"(where <replaceable>package</replaceable> is the name of a binary package).  "
+"Read the comments in "
+"<filename>/usr/share/cdbs/1/rules/debhelper.mk</filename> for a complete "
+"listing.  Some non-exhaustive examples follow."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:732
+msgid "To specify a tight dependency on a package containing shared libraries:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para><programlisting>
+#: cdbs-doc.xml:733
+#, no-wrap
+msgid ""
+"\n"
+"DEB_DH_MAKESHLIBS_ARGS_libfoo = -V\"libfoo (>= 0.1.2-3)\"\n"
+"DEB_SHLIBDEPS_LIBRARY_arkrpg = libfoo\n"
+"DEB_SHLIBDEPS_INCLUDE_arkrpg = debian/libfoo/usr/lib/\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:741
+msgid ""
+"To install a changelog file with an uncommon name like "
+"<filename>ProjectChanges.txt.gz</filename>:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para><programlisting>
+#: cdbs-doc.xml:743
+#, no-wrap
+msgid ""
+"\n"
+"DEB_INSTALL_CHANGELOGS_ALL = ProjectChanges.txt\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:746
+msgid ""
+"(CDBS automatically recognizes a fair number of possible changelog names, "
+"but not that one.)"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:751
+msgid "To avoid compressing files with a <filename>.py</filename> extension:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para><programlisting>
+#: cdbs-doc.xml:753
+#, no-wrap
+msgid ""
+"\n"
+"DEB_COMPRESS_EXCLUDE = .py\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:759
+msgid ""
+"Perl-specific debhelper options (The <command>dh_perl</command> call is "
+"always performed.):"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para><programlisting>
+#: cdbs-doc.xml:761
+#, no-wrap
+msgid ""
+"\n"
+"# Add a space-separated list of paths to search for perl modules\n"
+"DEB_PERL_INCLUDE = /usr/lib/perl-z\n"
+"\n"
+"# Like the above, but for the 'libperl-stuff' package\n"
+"DEB_PERL_INCLUDE_libperl-stuff = /usr/lib/perl-plop\n"
+"\n"
+"# Overrides options passed to dh_perl\n"
+"DEB_DH_PERL_ARGS = -d\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><title>
+#: cdbs-doc.xml:775
+msgid "Debhelper Custom Build Rules"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:778
+msgid ""
+"CDBS debhelper rules also add more adequate build rules.  For example, to "
+"add post deb preparation (including debhelper stuff) actions:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para><programlisting>
+#: cdbs-doc.xml:781
+#, no-wrap
+msgid ""
+"\n"
+"binary-install/foo::\n"
+"\tchmod a+x debian/foo/usr/bin/pouet\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:788
+msgid "Several other rules exists, for rarer cases:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:792
+msgid "<literal>binary-strip/foo</literal> (called after stripping)"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:797
+msgid ""
+"<literal>binary-fixup/foo</literal> (called after gzipping and fixing "
+"permissions)"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:803
+msgid ""
+"<literal>binary-predeb</literal> (called just before creating the "
+"<filename>.deb</filename>)"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><title>
+#: cdbs-doc.xml:811
+msgid "Debug Package Support"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:813
+msgid ""
+"A debug package is a binary package named "
+"<literal><replaceable>package</replaceable>-dbg</literal> that contains the "
+"debugging symbols for the binaries (programs, libraries, etc.) in other "
+"packages, typically all other binary packages built from the same source "
+"package.  Debhelper facilitates the creation of these debug packages by the"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para><option>
+#: cdbs-doc.xml:819
+msgid "--dbg-package"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:819
+msgid ""
+"option in the command <command>dh_strip</command>.  CDBS has support for "
+"creating debug packages, if Debhelper level 5 compatibility is used."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:824
+msgid ""
+"CDBS will automatically call <command>dh_strip</command> with the right "
+"options if exactly one debug package is mentioned in "
+"<filename>debian/control</filename> and so that the debugging symbols of all "
+"other binary packages are included in that debug package.  This takes care "
+"of the most common situation."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:831
+msgid ""
+"To control more finely which debug symbols go where, in particular if you "
+"want to build more than one debug package, there are variables "
+"<varname>DEB_DBG_PACKAGE_<replaceable>package</replaceable></varname> that "
+"specify the debug package target for each individual binary package.  An "
+"example usage would be:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para><programlisting>
+#: cdbs-doc.xml:837
+#, no-wrap
+msgid ""
+"\n"
+"DEB_DBG_PACKAGE_libfoo4 = libfoo-dbg\n"
+"DEB_DBG_PACKAGE_foo-bin = foo-bin-dbg\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:843
+msgid ""
+"If exactly one debug package is defined, setting any variable "
+"<varname>DEB_DBG_PACKAGE_<replaceable>package</replaceable></varname> "
+"disables the behavior of putting all debug symbols in that package."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:849
+msgid ""
+"If there is more than one debug package defined and each debug package is "
+"named <literal>foo-dbg</literal> such that there is a package called "
+"<literal>foo</literal>, then the assignments <literal>DEB_DBG_PACKAGE_foo = "
+"foo-dbg</literal> are done automatically.  Again, this only happens if all "
+"debug packages can be assigned this way.  Of course, all these assignments "
+"can be overridden if you find that this behavior doesn't quite work for you."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><note><para>
+#: cdbs-doc.xml:859
+msgid ""
+"If a source package builds a single binary package, and then a debug package "
+"is added, this changes the automatic assignment of "
+"<varname>DEB_DESTDIR</varname> to <literal>$(CURDIR)/debian/tmp</literal>, "
+"as described in <xref linkend=\"basic-settings\"/>, which will likely "
+"invalid the installation rules and leave you with a nearly-empty package.  "
+"To work around this behavior, set <varname>DEB_DESTDIR</varname> manually in "
+"<filename>debian/rules</filename> as"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><note><para><programlisting>
+#: cdbs-doc.xml:868
+#, no-wrap
+msgid ""
+"\n"
+"DEB_DESTDIR = $(CURDIR)/debian/<replaceable>packagename</replaceable>\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><note><para>
+#: cdbs-doc.xml:871
+msgid ""
+"Alternatively, write a "
+"<filename><replaceable>packagename</replaceable>.install</filename> file "
+"listing"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><note><para><programlisting>
+#: cdbs-doc.xml:874
+#, no-wrap
+msgid ""
+"\n"
+"debian/tmp/*\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><note><para>
+#: cdbs-doc.xml:877
+msgid "or whatever subset you need."
+msgstr ""
+
+# type: Content of: <book><chapter><title>
+#: cdbs-doc.xml:885
+msgid "Classes"
+msgstr ""
+
+# type: Content of: <book><chapter><para>
+#: cdbs-doc.xml:887
+msgid ""
+"CDBS provides <firstterm>classes</firstterm> which contain makefile rules "
+"and variables implementing compilation, installation, and building of Debian "
+"packages.  There are a number of classes covering different types of ways a "
+"software is built.  Classes tend to be declarative; they say your package "
+"has particular properties.  Suppose for instance that your package uses a "
+"regular makefile to compile, and has the normal <command>make</command> and "
+"<command>make install</command> targets.  In that case you would use the "
+"<quote>makefile</quote> class, and you can say:"
+msgstr ""
+
+# type: Content of: <book><chapter><para><programlisting>
+#: cdbs-doc.xml:898
+#, no-wrap
+msgid "include /usr/share/cdbs/1/class/makefile.mk"
+msgstr ""
+
+# type: Content of: <book><chapter><para>
+#: cdbs-doc.xml:900
+msgid ""
+"This gives you all the code to run <command>make</command> automatically.  "
+"It basically works by adding code to the "
+"<literal>common-build-arch</literal>, <literal>common-build-indep</literal>, "
+"<literal>common-install-arch</literal>, and "
+"<literal>common-install-indep</literal> targets inside "
+"<filename>buildcore.mk</filename>.  It might be instructive to look at "
+"<filename>makefile.mk</filename> now."
+msgstr ""
+
+# type: Content of: <book><chapter><para>
+#: cdbs-doc.xml:909
+msgid ""
+"Some classes actually include another class, or <quote>inherit</quote> if "
+"you like.  For example, the autotools class inherits the makefile class "
+"because much of the build process is the same between them, only the "
+"configuration stage is different.  The effect is that all the variables "
+"provided by the inherited class are available in the inheriting class as "
+"well.  <xref linkend=\"fig:depgraph\"/> shows the relationship between the "
+"classes and other rule sets provided by CDBS."
+msgstr ""
+
+# type: Content of: <book><chapter><figure><title>
+#: cdbs-doc.xml:919
+msgid "Dependencies between the CDBS class and rule files"
+msgstr ""
+
+# type: Content of: <book><chapter><para>
+#: cdbs-doc.xml:931
+msgid "The rest of this chapter explains all the classes supported by CDBS."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:935
+msgid "The Makefile Class"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:937
+msgid ""
+"The makefile class is for the packages who only have a makefile to build the "
+"program.  (If the package uses Autoconf, use the autotools class instead.)  "
+"You only need to have four rules in the makefile:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:944
+msgid "one for cleaning the build directory (e.g., <literal>clean</literal>)"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:949
+msgid "one for building the software (e.g. <literal>all</literal>)"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:954
+msgid ""
+"one for checking if the software is working properly "
+"(e.g. <literal>check</literal>)"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:959
+msgid "one for installing the software (e.g. <literal>install</literal>)"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:964
+msgid ""
+"The installation and check rules are optional, but it always helps a lot "
+"when you've got them."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:967
+msgid ""
+"The first step is to write the <filename>debian/rules</filename>.  First, we "
+"add the include lines:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:970
+#, no-wrap
+msgid ""
+"\n"
+"include /usr/share/cdbs/1/class/makefile.mk\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:973
+msgid ""
+"Now, it remains to tell CDBS the name of our four makefile rules.  For the "
+"previous examples it gives:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:975
+#, no-wrap
+msgid ""
+"\n"
+"DEB_MAKE_CLEAN_TARGET   = clean\n"
+"DEB_MAKE_BUILD_TARGET   = all\n"
+"DEB_MAKE_INSTALL_TARGET = install DESTDIR=$(CURDIR)/debian/tmp/\n"
+"# no check for this software\n"
+"DEB_MAKE_CHECK_TARGET   =\n"
+"\n"
+"# example when changing environment variables is necessary\n"
+"DEB_MAKE_ENVVARS        = CFLAGS=\"-pwet\"\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:987 cdbs-doc.xml:1184 cdbs-doc.xml:1448 cdbs-doc.xml:1491 cdbs-doc.xml:1530 cdbs-doc.xml:1642
+msgid "<varname>DEB_BUILD_OPTIONS</varname> is checked for the following options:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><term>
+#: cdbs-doc.xml:991 cdbs-doc.xml:1188 cdbs-doc.xml:1452 cdbs-doc.xml:1495 cdbs-doc.xml:1534 cdbs-doc.xml:1651
+msgid "<literal>noopt</literal>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:992 cdbs-doc.xml:1189 cdbs-doc.xml:1496 cdbs-doc.xml:1535
+msgid "use"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para><option>
+#: cdbs-doc.xml:992 cdbs-doc.xml:1189 cdbs-doc.xml:1496 cdbs-doc.xml:1535
+msgid "-O0"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:992 cdbs-doc.xml:1189 cdbs-doc.xml:1496 cdbs-doc.xml:1535
+msgid "instead of"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para><option>
+#: cdbs-doc.xml:992 cdbs-doc.xml:1189 cdbs-doc.xml:1496 cdbs-doc.xml:1535
+msgid "-O2"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><term>
+#: cdbs-doc.xml:996 cdbs-doc.xml:1193 cdbs-doc.xml:1646
+msgid "<literal>nocheck</literal>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:997 cdbs-doc.xml:1194
+msgid "skip the check rule"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1002
+msgid ""
+"If your makefile doesn't support the <varname>DESTDIR</varname> variable, "
+"take a look in it and find the variable responsible for setting installation "
+"directory.  If you don't find some variable to do this, you'll have to patch "
+"the makefile."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><title>
+#: cdbs-doc.xml:1009
+msgid "Build Problems"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:1011
+msgid ""
+"Sometimes, when using the makefile class (or a derived one), a build fails "
+"because of missing include files or something like that.  Often this is "
+"caused by the fact that CDBS passes <varname>CFLAGS</varname> (and "
+"<varname>CPPFLAGS</varname>) along with the make invocation.  A sane build "
+"system allows this: <varname>CFLAGS</varname> are for the user to "
+"customize.  Setting <varname>CFLAGS</varname> shouldn't override other "
+"internal flags used in the package, such as"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para><option>
+#: cdbs-doc.xml:1019
+msgid "-I"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:1019
+msgid ".  If fixing the upstream source is too difficult, however, you may do this:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para><programlisting>
+#: cdbs-doc.xml:1022
+#, no-wrap
+msgid ""
+"\n"
+"DEB_MAKE_INVOKE = $(DEB_MAKE_ENVVARS) make -C $(DEB_BUILDDIR)\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:1026
+msgid ""
+"That will avoid passing <varname>CFLAGS</varname>.  But note that this "
+"breaks the automatic implementation of <varname>DEB_BUILD_OPTIONS</varname>."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><title>
+#: cdbs-doc.xml:1032
+msgid "The Makefile Class and Single vs. Multiple Binary Packages"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:1035
+msgid ""
+"If you have a single binary package, the default "
+"<literal>common-install</literal> implementation in "
+"<filename>makefile.mk</filename> tries to use the upstream "
+"<filename>Makefile</filename> to install everything into "
+"<filename>debian/packagename</filename>, so it will all appear in the binary "
+"package.  If you're using <filename>debhelper.mk</filename> to remove files "
+"or move them around, just override the "
+"<literal>binary-post-install/<replaceable>package</replaceable></literal> "
+"target:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para><programlisting>
+#: cdbs-doc.xml:1046
+#, no-wrap
+msgid ""
+"\n"
+"binary-post-install/mypackage::\n"
+"\tmv debian/mypackage/usr/sbin/myprogram "
+"debian/mypackage/usr/bin/myprogram\n"
+"\trm debian/mypackage/usr/share/doc/mypackage/INSTALL\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:1053
+msgid ""
+"If you have a multiple-binary package, <filename>makefile.mk</filename> (by "
+"default) uses the upstream <filename>Makefile</filename> to install "
+"everything in <filename>debian/tmp</filename>.  After this, the recommended "
+"method is to use <filename>debhelper.mk</filename> (which uses "
+"<command>dh_install</command>) to copy these files into the appropriate "
+"package.  To do this, just create "
+"<filename><replaceable>package</replaceable>.install</filename> files; see "
+"the <command>dh_install</command> man page."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:1066
+msgid "The Autotools Class"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1068
+msgid ""
+"The autotools class is for software that uses GNU Autoconf and possibly "
+"Automake and Libtool.  The class will take care of details such as updating "
+"the <filename>config.{sub,guess}</filename> files, running "
+"<command>configure</command> with the standard arguments, etc.  The "
+"autotools class actually builds upon the makefile class."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1076
+msgid ""
+"To use the autotools class, just add this line to your "
+"<filename>debian/rules</filename>:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1078
+#, no-wrap
+msgid ""
+"\n"
+"include /usr/share/cdbs/1/class/autotools.mk\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1083
+msgid ""
+"Suppose you need to pass some additional options to "
+"<command>configure</command>.  The <filename>autotools.mk</filename> file "
+"includes a number of variables that you can override for that purpose, like "
+"this:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1088
+#, no-wrap
+msgid ""
+"\n"
+"DEB_CONFIGURE_EXTRA_FLAGS = --enable-ipv6 --with-foo\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1093
+msgid ""
+"If the build system uses non-standard configure options you can override the "
+"CDBS default behavior:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1095
+#, no-wrap
+msgid ""
+"\n"
+"DEB_CONFIGURE_NORMAL_ARGS = --program-dir=/usr\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1098
+msgid ""
+"Note that <varname>DEB_CONFIGURE_EXTRA_FLAGS</varname> will still be "
+"appended."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1101
+msgid "If some specific environnement variables need to be setup, use:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1103
+#, no-wrap
+msgid ""
+"\n"
+"DEB_CONFIGURE_SCRIPT_ENV += LDFLAGS=\" -Wl,-z,defs -Wl,-O1\"\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><tip><para>
+#: cdbs-doc.xml:1109
+msgid ""
+"Prefer the use of <literal>+=</literal> over <literal>=</literal> lest you "
+"override other environment variables like <varname>CC</varname> or "
+"<varname>CXX</varname> defined in the CDBS default."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1116
+msgid ""
+"CDBS will automatically update <filename>config.sub</filename>, "
+"<filename>config.guess</filename>, and <filename>config.rpath</filename> "
+"before the build and restore the old ones at the clean stage (even if using "
+"the tarball system).  If needed, and if <filename>debian/control</filename> "
+"management is activated, <literal>autotools-dev</literal> and "
+"<literal>gnulib</literal>, respectively, will then be automatically added to "
+"the build dependencies (needed to obtain updated versions of the files).  If "
+"the program does not use the top source directory to store autoconf files, "
+"you can teach CDBS where they are to be found:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1128
+#, no-wrap
+msgid ""
+"\n"
+"DEB_AC_AUX_DIR = $(DEB_SRCDIR)/autoconf\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1133
+msgid ""
+"CDBS automatically cleans autotools files generated during the build "
+"(<filename>config.cache</filename>, <filename>config.log</filename>, and "
+"<filename>config.status</filename>)."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1138
+msgid ""
+"CDBS can be asked to update Autoconf, Automake, and Libtool generated files, "
+"but this behavior is likely to break the build system and is "
+"<emphasis>strongly</emphasis> discouraged.  Nevertheless, if you still want "
+"this feature, set the following variables:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:1145
+msgid ""
+"<varname>DEB_AUTO_UPDATE_AUTOCONF</varname> to the version of Autoconf to "
+"use; e.g., <literal>2.61</literal>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:1149
+msgid ""
+"<varname>DEB_AUTO_UPDATE_AUTOMAKE</varname> to the version of Automake to "
+"use; e.g., <literal>1.10</literal>.  To pass extra arguments to "
+"<command>automake</command>, such as <literal>--add-missing "
+"--copy</literal>, put them into the variable "
+"<varname>DEB_AUTOMAKE_ARGS</varname>."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:1156
+msgid ""
+"<varname>DEB_AUTO_UPDATE_LIBTOOL</varname> to <literal>pre</literal> to run "
+"<command>libtoolize</command> before the build, or to "
+"<literal>post</literal> to copy the system-supplied "
+"<command>libtool</command> program into the build tree after the configure "
+"run"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1163
+msgid "(Corresponding build dependencies will automatically be added.)"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1166
+msgid "The following make parameters can also be overridden :"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1167
+#, no-wrap
+msgid ""
+"\n"
+"# these are the defaults CDBS provides\n"
+"DEB_MAKE_INSTALL_TARGET = install DESTDIR=$(DEB_DESTDIR)\n"
+"DEB_MAKE_CLEAN_TARGET = distclean\n"
+"DEB_MAKE_CHECK_TARGET =\n"
+"\n"
+"# example to work around dirty makefile\n"
+"DEB_MAKE_INSTALL_TARGET = install prefix=$(CURDIR)/debian/tmp/usr\n"
+"\n"
+"# example with unexistant install rule for make\n"
+"DEB_MAKE_INSTALL_TARGET =\n"
+"\n"
+"# example to activate check rule\n"
+"DEB_MAKE_CHECK_TARGET = check\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:1201
+msgid "The Perl Class"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1203
+msgid ""
+"The Perl class can manage Perl module packages using MakeMaker.  To use this "
+"class, add this line to your <filename>debian/rules</filename>:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1207
+#, no-wrap
+msgid ""
+"\n"
+"include /usr/share/cdbs/1/class/perlmodule.mk\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1212
+msgid ""
+"The installation directory defaults to "
+"<filename><replaceable>first_pkg</replaceable>/usr</filename> where "
+"<replaceable>first_pkg</replaceable> is the first package in "
+"<filename>debian/control</filename>."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1217 cdbs-doc.xml:1280
+msgid "You can customize build options like this:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1218
+#, no-wrap
+msgid ""
+"\n"
+"# change MakeMaker defaults (hardly ever useful)\n"
+"DEB_MAKE_BUILD_TARGET = build-all\n"
+"DEB_MAKE_CLEAN_TARGET = realclean\n"
+"DEB_MAKE_CHECK_TARGET =\n"
+"DEB_MAKE_INSTALL_TARGET = install PREFIX=debian/stuff\n"
+"\n"
+"# add custom MakeMaker options\n"
+"DEB_MAKEMAKER_USER_FLAGS = --with-foo\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1230
+msgid ""
+"Common makefile or general options can still be overridden: "
+"<varname>DEB_MAKE_ENVVARS</varname>, <varname>DEB_BUILDDIR</varname> (must "
+"match <varname>DEB_SRCDIR</varname> for Perl)."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1236
+msgid "Have a look at the Perl-specific debhelper options described above."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><important><para>
+#: cdbs-doc.xml:1240
+msgid ""
+"If <filename>debian/control</filename> management is activated (see below), "
+"a build dependency on <literal>perl</literal> is automatically added.  If "
+"not, you will have to do it yourself."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:1248
+msgid "The Python Class"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1250
+msgid ""
+"The Python class can manage Python module packages using Distutils.  To use "
+"this class, add this line to your <filename>debian/rules</filename>:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1254
+#, no-wrap
+msgid ""
+"\n"
+"include /usr/share/cdbs/1/class/python-distutils.mk\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1258
+msgid ""
+"Optionally, this class can take care of using <command>dh_python</command>, "
+"if the CDBS debhelper rules are included before the Python class."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1262
+msgid ""
+"Most Python packages are architecture-independent and then don't need to be "
+"built for multiple Python versions; your package should then be called "
+"<literal>python-<replaceable>foo</replaceable></literal> and CDBS will "
+"automatically use the current Python version in Debian to build it.  If your "
+"package contains a compiled part or a binding to an external library, then "
+"you will have packages named "
+"<literal>python2.3-<replaceable>foo</replaceable></literal>, "
+"<literal>python2.4-<replaceable>foo</replaceable></literal>, and so on, "
+"depending on <literal>${python:Depends}</literal> (and perhaps other "
+"packages); then CDBS will automatically build each package with the "
+"corresponding Python version.  In this case, don't forget to add a "
+"<literal>python-<replaceable>foo</replaceable></literal> convenience dummy "
+"package depending on the current Python version in Debian."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1281
+#, no-wrap
+msgid ""
+"\n"
+"# force using a specific Python version for build\n"
+"# (should not be necessary)\n"
+"DEB_PYTHON_COMPILE_VERSION = 2.3\n"
+"\n"
+"# change the python build script name (default is 'setup.py')\n"
+"DEB_PYTHON_SETUP_CMD = install.py\n"
+"\n"
+"# clean options for the python build script\n"
+"DEB_PYTHON_CLEAN_ARGS = -all\n"
+"\n"
+"# build options for the python build script\n"
+"DEB_PYTHON_BUILD_ARGS = "
+"--build-base=\"$(DEB_BUILDDIR)/specific-build-dir\"\n"
+"\n"
+"# common additional install options for all binary packages\n"
+"# ('--root' option is always set)\n"
+"DEB_PYTHON_INSTALL_ARGS_ALL = --no-compile --optimize --force\n"
+"\n"
+"# specific additional install options for binary package 'foo'\n"
+"# ('--root' option is always set)\n"
+"DEB_PYTHON_INSTALL_ARGS_foo = --root=debian/foo-install-dir/\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1305
+msgid ""
+"Occassionally, you might have a package called "
+"<literal>python-something</literal> that you don't want handled by this "
+"class, for example a <literal>-doc</literal> package.  You can list these "
+"packages in the variable <varname>DEB_PYTHON_PACKAGES_EXCLUDE</varname>.  "
+"For example:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1310
+#, no-wrap
+msgid ""
+"\n"
+"DEB_PYTHON_PACKAGES_EXCLUDE = python-mylib-doc\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:1317
+msgid "The GNOME Class"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1319
+msgid ""
+"The GNOME class is obviously for building GNOME software.  It inherits the "
+"autotools class, so everything that was said there also applies to the GNOME "
+"class."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1323
+msgid "The GNOME class can call the following debhelper scripts automatically:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:1327
+msgid "dh_desktop"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:1328
+msgid "dh_gconf"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:1329
+msgid "dh_icons"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:1330
+msgid "dh_scrollkeeper"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1333
+msgid "Moreover it adds some more clean rules:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:1335
+msgid "to remove <command>intltool</command> generated files"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:1336
+msgid "to remove <command>scrollkeeper</command> generated files"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1340
+msgid ""
+"To use it, just add this line to your <filename>debian/rules</filename>, "
+"after the debhelper class include:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1343
+#, no-wrap
+msgid ""
+"\n"
+"include /usr/share/cdbs/1/class/gnome.mk\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1348
+msgid ""
+"The GNOME class adds a make environement variable "
+"<literal>GCONF_DISABLE_MAKEFILE_SCHEMA_INSTALL = 1</literal>.  This is "
+"necessary because the Gconf schemas have to be registered at install time.  "
+"In the case of packaging, this registration cannot be done when building the "
+"package, so this variable disables schema registration in <literal>make "
+"install</literal>.  This procedure is deferred until "
+"<command>gconftool-2</command> is called in "
+"<filename>debian/postinst</filename> to register them, and in "
+"<filename>debian/prerm</filename> to unregister them.  The "
+"<command>dh_gconf</command> command is able to add the right rules "
+"automatically for you."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1362
+msgid ""
+"For more information on GNOME-specific packaging rules, look at the Debian "
+"GNOME packaging policy."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><title>
+#: cdbs-doc.xml:1366
+msgid "The Debian GNOME Team Class"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:1368
+msgid ""
+"If you are part of the GNOME team or have the team as uploaders, and you "
+"feel bored maintaining the list of developers, the GNOME Team class is made "
+"for you."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1372 cdbs-doc.xml:1672
+msgid "To use this class, add this line to your <filename>debian/rules</filename>:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para><programlisting>
+#: cdbs-doc.xml:1374
+#, no-wrap
+msgid ""
+"\n"
+"include /usr/share/gnome-pkg-tools/1/rules/uploaders.mk\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:1379
+msgid ""
+"Rename your <filename>debian/control</filename> file to "
+"<filename>debian/control.in</filename> and run the clean rule "
+"(<literal>fakeroot debian/rules clean</literal>) to regenerate the "
+"<filename>debian/control</filename> file, which will replace the "
+"<literal>@GNOME_TEAM@</literal> tag with the list of developers "
+"automatically."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><warning><para>
+#: cdbs-doc.xml:1387
+msgid ""
+"If you are using the <filename>debian/control</filename> file management "
+"described below, please note this class will override this feature.  To cope "
+"with this problem, allowing at least <literal>Build-Depends</literal> "
+"handling, use the following work-arround (until it is solved in a proper "
+"way):"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><warning><para><programlisting>
+#: cdbs-doc.xml:1393
+#, no-wrap
+msgid ""
+"\n"
+"# deactivate 'debian/control' file management\n"
+"#DEB_AUTO_UPDATE_DEBIAN_CONTROL = yes\n"
+"\n"
+"# ...\n"
+"# includes and other stuff\n"
+"# ...\n"
+"\n"
+"clean::\n"
+"\tsed -i \"s/@cdbs@/$(CDBS_BUILD_DEPENDS)/g\" debian/control\n"
+"\t# other clean stuff\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:1411
+msgid "The KDE Class"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1413
+msgid ""
+"To use the KDE class, add this line to your "
+"<filename>debian/rules</filename> file:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1415
+#, no-wrap
+msgid ""
+"\n"
+"include /usr/share/cdbs/1/class/kde.mk\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1418
+msgid ""
+"The KDE class inherits the autotools class, so everything that was said "
+"there also applies here."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1421
+msgid "CDBS automatically exports the following variables with the right values:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:1423
+msgid "<varname>kde_cgidir</varname> (<literal>/usr/lib/cgi-bin</literal>)"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:1424
+msgid "<varname>kde_confdir</varname> (<literal>/etc/kde3</literal>)"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:1425
+msgid "<varname>kde_htmldir</varname> (<literal>/usr/share/doc/kde/HTML</literal>)"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1430
+msgid ""
+"<varname>DEB_BUILDDIR</varname>, <varname>DEB_AC_AUX_DIR</varname>, and "
+"<varname>DEB_CONFIGURE_INCLUDEDIR</varname> are set to KDE defaults."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1436
+msgid "The following files are excluded from compression:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:1438
+msgid "<filename>.dcl</filename>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:1439
+msgid "<filename>.docbook</filename>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:1440
+msgid "<filename>-license</filename>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1444
+msgid ""
+"The class handles configure options specific to KDE (not forgetting to "
+"disable rpath and activating xinerama), set the correct autotools directory, "
+"and launch make rules adequately."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:1453
+msgid "disable KDE final mode"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><term>
+#: cdbs-doc.xml:1457 cdbs-doc.xml:1500
+msgid "<literal>nostrip</literal>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:1458
+msgid "enable KDE debug mode and disable KDE final mode"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><term>
+#: cdbs-doc.xml:1462
+msgid "<literal>debug</literal>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:1463
+msgid "enable full KDE debug mode"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:1470
+msgid "The Qmake Class"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1472
+msgid ""
+"Qmake is a build tool for software written for the Qt toolkit library.  To "
+"use the Qmake class, add this include to your "
+"<filename>debian/rules</filename>:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1476
+#, no-wrap
+msgid ""
+"\n"
+"include /usr/share/cdbs/1/class/qmake.mk\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1480
+msgid ""
+"The class takes care of the call to <command>qmake</command> and the "
+"subsequent calls to <command>make</command>, with all the necessary options "
+"to honor <varname>DEB_BUILD_OPTIONS</varname>, for example.  To that end, "
+"the Qmake class builds upon the makefile class."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1486
+msgid ""
+"The Qmake class will call <literal>make install</literal>, but many Qmake "
+"projects are not set up to have a functioning install target, in which case "
+"the installation of the package components has to be handled manually."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:1501
+msgid ""
+"pass the <literal>nostrip</literal> option to <command>qmake</command> "
+"though the <varname>CONFIG</varname> variable"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:1508
+msgid "The CMake Class"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1510
+msgid ""
+"CMake is a cross-platform build tool.  On Unix-like systems it typically "
+"generates makefiles, which are then run through make normally.  To use the "
+"CMake class, add this include to your <filename>debian/rules</filename>:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1515
+#, no-wrap
+msgid ""
+"\n"
+"include /usr/share/cdbs/1/class/cmake.mk\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1519
+msgid ""
+"The class takes care of the call to <command>cmake</command> and the "
+"subsequent calls to <command>make</command>, with all the necessary options "
+"to honor <varname>DEB_BUILD_OPTIONS</varname>, for example.  To that end, "
+"the CMake class builds upon the makefile class."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1525
+msgid ""
+"CMake is designed to always use separate source and build directories.  "
+"Therefore, the CMake class by default builds the project in a separate build "
+"directory named like "
+"<filename>obj-<replaceable>platform</replaceable></filename> under the "
+"top-level source directory."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:1542
+msgid "The Ant Class"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1544
+msgid ""
+"Ant is a build tool for software written in the Java programming language.  "
+"To use the Ant class, add this include to your "
+"<filename>debian/rules</filename>:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1548
+#, no-wrap
+msgid ""
+"\n"
+"include /usr/share/cdbs/1/class/ant.mk\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1552
+msgid ""
+"Additionally, you need to set the variable <varname>JAVA_HOME</varname> to "
+"the home directory of the Java Runtime Environment (JRE) or Java Development "
+"Kit (JDK).  You can either set <varname>JAVA_HOME</varname> directly or set "
+"<varname>JAVA_HOME_DIRS</varname> to multiple possible home directories.  "
+"The first directory from this list that provides a <command>java</command> "
+"command is used for <varname>JAVA_HOME</varname>.  For Ant-using packages in "
+"the Debian main archive, you would typically use either"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1561
+#, no-wrap
+msgid ""
+"\n"
+"JAVA_HOME = /usr/lib/kaffe\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1564
+msgid "which requires a build dependency on <literal>kaffe</literal>, or"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1565
+#, no-wrap
+msgid ""
+"\n"
+"JAVA_HOME = /usr/lib/jvm/java-gcj\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1568
+msgid ""
+"which requires a build dependency on "
+"<literal>java-gcj-compat-dev</literal>.  Setting the Java home is required; "
+"there is no default."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1572
+msgid ""
+"You can also override <varname>JAVACMD</varname> in case you don't want to "
+"use the default "
+"<literal><replaceable>JAVA_HOME</replaceable>/bin/java</literal>."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1576
+msgid "You may add additional JARs to the build like in the following example:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1579
+#, no-wrap
+msgid ""
+"\n"
+"DEB_JARS = xerces /usr/lib/java-bonus/ldap-connector.jar\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1583
+msgid ""
+"The <filename>.jar</filename> extension may be omitted.  The file name must "
+"be absolute or relative to <filename>/usr/share/java</filename>.  "
+"<filename>ant.jar</filename>, <filename>ant-launcher.jar</filename>, and "
+"<filename>$(JAVA_HOME)/lib/tools.jar</filename> are automatically added if "
+"they exist."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1591
+msgid ""
+"To use a specific Java compiler, override the variable "
+"<varname>DEB_ANT_COMPILER</varname>, for example"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1593
+#, no-wrap
+msgid ""
+"\n"
+"DEB_ANT_COMPILER = jikes\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1598
+msgid ""
+"If your package does not put the file <filename>build.xml</filename> in the "
+"package root directory, where Ant would find it by default, you can point "
+"CDBS to the right place like this:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1602
+#, no-wrap
+msgid ""
+"\n"
+"DEB_ANT_BUILDFILE = build/build.xml\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1607
+msgid ""
+"Finally, you need to set the targets to invoke for building, installing, "
+"testing and cleaning up.  Unless overridden, building uses the default "
+"target from <filename>build.xml</filename>, installing and testing is only "
+"called if the corresponding variable is set, cleaning uses the "
+"<literal>clean</literal> target.  You can also specify multiple targets for "
+"each step.  To override these rules, or run the install or check rules, set "
+"the following variables to your needs:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1616
+#, no-wrap
+msgid ""
+"\n"
+"DEB_ANT_BUILD_TARGET = makeitrule\n"
+"DEB_ANT_CHECK_TARGET = check\n"
+"DEB_ANT_INSTALL_TARGET = install-all\n"
+"DEB_ANT_CLEAN_TARGET = super-clean\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1624
+msgid ""
+"Ant called by CDBS will read a property file, by default at "
+"<filename>debian/ant.properties</filename> if it exists.  There you may "
+"define additional properties that are referenced from "
+"<filename>build.xml</filename> so that you don't have to modify upstream's "
+"<filename>build.xml</filename>.  Please note that command-line arguments in "
+"<varname>ANT_ARGS</varname> (see below) override the settings in "
+"<filename>build.xml</filename> and the property file.  The use a different "
+"property file, set the variable <varname>DEB_ANT_PROPERTYFILE</varname>."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1634
+msgid ""
+"You can provide additionnal JVM arguments using the variable "
+"<varname>ANT_OPTS</varname>.  You can moreover provide additional Ant "
+"command line arguments using <varname>ANT_ARGS</varname> (global) or "
+"<varname>ANT_ARGS_<replaceable>package</replaceable></varname>, thus "
+"overriding the settings in <filename>build.xml</filename> and the property "
+"file."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:1647
+msgid "skip the check target"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:1652
+msgid "set Ant option <literal>compile.optimize</literal> to false"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1657
+msgid ""
+"See <xref linkend=\"example-ant\"/> for a complete example that uses this "
+"Ant class.  You can also get some more information on Ant at the <ulink "
+"url=\"http://ant.apache.org/\">Ant Apache web site</ulink>."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:1664
+msgid "The HBuild Class"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1666
+msgid ""
+"HBuild is the Haskell mini-distutils.  CDBS can take care of "
+"<literal>-hugs</literal> and <literal>-ghc</literal> packages: invoke "
+"<filename>Setup.lhs</filename> properly for the clean and install part."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1674
+#, no-wrap
+msgid ""
+"\n"
+"include /usr/share/cdbs/1/class/hbuild.mk\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1680
+msgid ""
+"You should be able to fetch some more information on Haskell distutils in "
+"<ulink "
+"url=\"http://www.haskell.org/pipermail/libraries/2003-July/001239.html\">this "
+"thread</ulink>."
+msgstr ""
+
+# type: Content of: <book><chapter><title>
+#: cdbs-doc.xml:1689
+msgid "Common Tasks"
+msgstr ""
+
+# type: Content of: <book><chapter><para>
+#: cdbs-doc.xml:1691
+msgid ""
+"CDBS also supports other tasks that regularly occur during the course of "
+"building Debian packages."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:1695
+msgid "Patching Sources Using the Simple Patch System"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1697
+msgid ""
+"Suppose you'd like to keep separated patches, instead of having them all in "
+"your <filename>.diff.gz</filename>.  CDBS lets you hook in arbitrary patch "
+"systems, but (as with the rest of CDBS), it has its own default "
+"implementation, called <filename>simple-patchsys.mk</filename>.  To use it, "
+"just add"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1704
+#, no-wrap
+msgid "include /usr/share/cdbs/1/rules/simple-patchsys.mk"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1706
+msgid ""
+"to your <filename>debian/rules</filename>.  Now, you can drop patch files "
+"into the <filename>debian/patches</filename> directory, and they will be "
+"automatically applied and unapplied.  Files should be named so as to reflect "
+"in which order they have to be applied, and must end in a "
+"<filename>.patch</filename> or <filename>.diff</filename> suffix.  The "
+"simple patchsys rules will then take care of patching before configure and "
+"unpatching after clean.  It is possible to use patch level 0 to 3, and CDBS "
+"will try them and use the right level automatically.  The system can handle "
+"compressed patches with an additionnal <filename>.gz</filename> or "
+"<filename>.bz2</filename> suffix as well as uuencoded patches with a "
+"<filename>.uu</filename> suffix."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1720
+msgid ""
+"You can customize the directories where patches are searched and the suffix "
+"like this:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1722
+#, no-wrap
+msgid ""
+"\n"
+"DEB_PATCHDIRS = debian/mypatches\n"
+"DEB_PATCH_SUFFIX = .plop\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1726
+msgid ""
+"The defaults are: <filename>.diff</filename>, <filename>.diff.gz</filename>, "
+"<filename>.diff.bz2</filename>, <filename>.diff.uu</filename>, "
+"<filename>.patch</filename>, <filename>.patch.gz</filename>, "
+"<filename>.patch.bz2</filename>, <filename>.patch.uu</filename>."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1732
+msgid ""
+"In case of errors when applying, for example "
+"<filename>debian/pacthes/01_hurd_ftbfs_pathmax.patch</filename>, you can "
+"read the log for this patch in "
+"<filename>debian/pacthes/01_hurd_ftbfs_pathmax.patch.level-0.log</filename> "
+"(<quote>0</quote> because it's a level 0 patch)."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1738
+msgid ""
+"When using the simple patch system, a build dependency on "
+"<literal>patchutils</literal> should be added to the package."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1742
+msgid ""
+"The script <command>cdbs-edit-patch</command> is intended to help lazy "
+"people edit or create patches easily.  Invoke this script with the name of "
+"the patch as argument, and you will enter a copy of your working directory "
+"in a subshell where you can edit the sources.  When your work is done and "
+"you are satisfied with your changes, just exit the subshell and you will get "
+"back to normal world with "
+"<filename>debian/patches/<replaceable>patch_name</replaceable>.patch</filename> "
+"created or modified accordingly.  The script takes care to apply previous "
+"patches (ordered patches needed!), the current patch if already existing (in "
+"case you want to update it), then generate an incremental diff to only get "
+"desired modifications.  If you want to cancel the patch creation or "
+"modification, you only need to exit the subshell with a nonzero value and "
+"the diff will not be generated (only cleanups will be done)."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:1760
+msgid "Patching Sources Using Dpatch"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1762
+msgid ""
+"Like the simple patch system detailed previously, the Dpatch patch system "
+"allows you to seperate your changes to the upstream tarball into multiple "
+"seperate patches instead of a monolithic <filename>diff.gz</filename>.  This "
+"is a wrapper to the tools contained in the <literal>dpatch</literal> Debian "
+"package, and it's named <filename>dpatch.mk</filename>.  To use it, add"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1770
+#, no-wrap
+msgid "include /usr/share/cdbs/1/rules/dpatch.mk"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1772
+msgid ""
+"to your <filename>debian/rules</filename>.  If you use "
+"<filename>autotools.mk</filename>, be sure to include "
+"<filename>dpatch.mk</filename> <emphasis>after</emphasis> "
+"<filename>autotools.mk</filename>.  Additionally, remember to add "
+"<literal>dpatch</literal> to your build dependencies."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1778
+msgid ""
+"Now you can use Dpatch as usual and CDBS will call it automatically.  For a "
+"more complete treatment of Dpatch files, their format, and their "
+"application, please read the documentation included in the "
+"<literal>dpatch</literal> package, notably "
+"<filename>/usr/share/doc/dpatch/README.gz</filename> and the "
+"<command>dpatch</command> man page."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:1787
+msgid "Patching Sources Using Quilt"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1789
+msgid ""
+"Quilt is yet another patch management system.  CDBS itself does not actually "
+"contain any Quilt support, but the Quilt package contains CDBS integration, "
+"so there is really no difference from the perspective of the user.  To use "
+"Quilt with CDBS, add"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1795
+#, no-wrap
+msgid "/usr/share/cdbs/1/rules/patchsys-quilt.mk"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1797
+msgid ""
+"to your <filename>debian/rules</filename> and add <literal>quilt</literal> "
+"to the build dependencies.  Read the documentation in the Quilt package for "
+"more information."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:1803
+msgid "Standard Patch System Targets"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1805
+msgid ""
+"The most popular patch systems in Debian, the CDBS Simple Patch System, "
+"DPatch, and Quilt, support the following uniform make targets that you can "
+"use directly to apply and unapply the patches.  This could be useful during "
+"package development.  Of course, the patches are automatically applied or "
+"unapplied as necessary when a full package build is performed."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><variablelist><varlistentry><term>
+#: cdbs-doc.xml:1814
+msgid "<literal>patch</literal>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:1815
+msgid "to apply the patches"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><variablelist><varlistentry><term>
+#: cdbs-doc.xml:1819
+msgid "<literal>unpatch</literal>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:1820
+msgid "to unapply the patches"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:1826
+msgid "Tarball-Inside-a-Tarball Build System"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1828
+msgid ""
+"Some Debian packagers may be familiar with DBS, where you include a tarball "
+"of the upstream source inside the Debian source package itself.  This has "
+"some advantages and some disadvantages, but CDBS supports it anyhow.  To use "
+"the CDBS tarball system, just add this line to your "
+"<filename>debian/rules</filename>, and specify the name of the top directory "
+"of the extracted tarball:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1835
+#, no-wrap
+msgid ""
+"\n"
+"DEB_TAR_SRCDIR = foosoft\n"
+"\n"
+"include /usr/share/cdbs/1/rules/tarball.mk\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1840
+msgid ""
+"Note that <filename>tarball.mk</filename> must be <emphasis>first</emphasis> "
+"in the list of included rules."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1843
+msgid ""
+"CDBS will recognize tarballs with the following extensions: "
+"<filename>.tar</filename>, <filename>.tgz</filename>, "
+"<filename>.tar.gz</filename>, <filename>.tar.bz</filename>, "
+"<filename>.tar.bz2</filename>, <filename>.zip</filename>.  The tarball "
+"location is autodetected if it is in the top source directory, or can be "
+"specified:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1849
+#, no-wrap
+msgid ""
+"\n"
+"DEB_TARBALL = $(CURDIR)/tarballdir/mygnustuff_beta-1.2.3.tar.gz\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1854
+msgid ""
+"CDBS will handle automatic extraction and cleanups, automatically set "
+"<varname>DEB_SRCDIR</varname> and <varname>DEB_BUILDDIR</varname> for you, "
+"and take care of proper integration with other CDBS parts (such as the "
+"autotools class)."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1860
+msgid ""
+"Note that a build dependency on <filename>bzip2</filename> or "
+"<filename>unzip</filename> may be in order if that is the format of the "
+"tarball.  The <filename>gzip</filename> package is essential, so no build "
+"dependency is necessary for it."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><procedure><title>
+#: cdbs-doc.xml:1867 cdbs-doc.xml:1927
+msgid "<filename>debian/control</filename> Management"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><warning><para>
+#: cdbs-doc.xml:1870
+msgid ""
+"This feature is considered broken and packages using it are not allowed into "
+"the Debian archive."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1874
+msgid "The <filename>debian/control</filename> management feature allows:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:1879
+msgid "CDBS to manage some build dependencies automatically"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:1884
+msgid "use of shell commands embedded in <filename>debian/control</filename>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:1889
+msgid "use of CPU and system criteria to specify architecture (experimental)"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1895
+msgid ""
+"Build dependencies are introduced by the use of certain CDBS features or "
+"autodetected."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1898
+msgid "Embedded shell commands allows including hacks like:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1899
+#, no-wrap
+msgid ""
+"\n"
+"Build-Depends: libgpm-dev [`type-handling any linux-gnu`]\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1904
+msgid ""
+"CPU and system criteria implement support for "
+"<literal>Cpu</literal>/<literal>System</literal> fields, as a replacement "
+"for the Architecture field (which is to be implemented in dpkg in the long "
+"term, but still experimental).  Here is an example: before:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1909
+#, no-wrap
+msgid ""
+"\n"
+"Architecture: all\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1912
+msgid "and after:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1913
+#, no-wrap
+msgid ""
+"\n"
+"Cpu: all\n"
+"System: all\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1917
+msgid ""
+"If these fields are used, it is also possible to include special tags to "
+"easily take advantage of the <command>type-handling</command> tool, like in "
+"this example:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1920
+#, no-wrap
+msgid ""
+"\n"
+"Build-Depends: @cdbs@, procps [system: linux], plop [cpu: s390]\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1923
+msgid ""
+"(Look at the <command>type-handling</command> package documentation for more "
+"information.)"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><procedure><step><para>
+#: cdbs-doc.xml:1930
+msgid ""
+"Rename <filename>debian/control</filename> to "
+"<filename>debian/control.in</filename>."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><procedure><step><para>
+#: cdbs-doc.xml:1935
+msgid ""
+"Replace <literal>cdbs</literal> and <literal>debhelper</literal> build "
+"dependencies with <literal>@cdbs@</literal> in your "
+"<filename>debian/control.in</filename> like this:"
+msgstr ""
+
+# type: CDATA
+#: cdbs-doc.xml:1940
+#, no-wrap
+msgid ""
+"Build-Depends-Indep: @cdbs@, python-dev (>= 2.3), python-soya (>= 0.9), "
+"python-soya (<< 0.10), python-openal(>= 0.1.4-4), gettext]]"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><procedure><step><para>
+#: cdbs-doc.xml:1946
+msgid ""
+"Add the following line to <filename>debian/rules</filename>, before "
+"<emphasis>any</emphasis> include:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><procedure><step><para><programlisting>
+#: cdbs-doc.xml:1949
+#, no-wrap
+msgid ""
+"\n"
+"DEB_AUTO_UPDATE_DEBIAN_CONTROL = yes\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><procedure><step><para>
+#: cdbs-doc.xml:1956
+msgid ""
+"Then do a <command>debian/rules clean</command> run to (re)generate "
+"<filename>debian/control</filename>."
+msgstr ""
+
+# type: Content of: <book><chapter><title>
+#: cdbs-doc.xml:1964
+msgid "Hall of Examples"
+msgstr ""
+
+# type: Content of: <book><chapter><para>
+#: cdbs-doc.xml:1966
+msgid ""
+"There are as of this writing more than a thousand packages in the Debian "
+"archive that use CDBS, so there is a rich source of examples.  Nonetheless, "
+"to complete this manual, here are a few representative examples of real "
+"packages using CDBS so you get an idea of how to put these things together."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:1973
+msgid "GNOME + Autotools + Simple Patch System Example"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1975
+msgid "This example is from the package <literal>gnome-panel</literal>."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1978
+msgid "<filename>debian/control.in</filename>:"
+msgstr ""
+
+# type: CDATA
+#: cdbs-doc.xml:1979
+#, no-wrap
+msgid ""
+"Source: gnome-panel\n"
+"Section: gnome\n"
+"Priority: optional\n"
+"Maintainer: Guilherme de S. Pastore <guilherme.pastore at terra.com.br>\n"
+"Uploaders: Sebastien Bacher <seb128 at debian.org>, Arnaud Patard "
+"<arnaud.patard at rtp-net.org>, @GNOME_TEAM@\n"
+"Standards-Version: 3.6.2.1\n"
+"Build-Depends: @cdbs@, liborbit2-dev (>= 1:2.12.1-1), intltool, "
+"gnome-pkg-tools, libgtk2.0-dev (>= 2.7.1), libglade2-dev (>= 1:2.5.1), "
+"libwnck-dev (>= 2.11.91-1), scrollkeeper (>= 0.3.14-9.1), "
+"libgnome-desktop-dev (>= 2.11.1), libpng3-dev, libbonobo2-dev (>= 2.8.1-2), "
+"libxmu-dev, libedata-cal1.2-dev (>= 1.2.1-1) [!hurd-i386], libgnome-menu-dev "
+"(>= 2.11.1-1), libgnomevfs2-dev (>= 2.10.0-1), libnspr-dev, libxres-dev, "
+"sharutils, gnome-doc-utils, libedataserverui1.2-dev (>= 1.3.0)\n"
+"\n"
+"Package: gnome-panel\n"
+"Architecture: any\n"
+"Depends: ${shlibs:Depends}, ${misc:Depends}, gnome-panel-data (= "
+"${Source-Version}), gnome-desktop-data (>= 2.10.0-1), gnome\n"
+"-control-center (>= 1:2.8.2-3), gnome-menus (>= 2.11.1-1), gnome-about (>= "
+"2.10.0-1)\n"
+"Recommends: gnome-applets (>= 2.12.1-1), gnome-session, menu-xdg (>= 0.2)\n"
+"Suggests: yelp, gnome2-user-guide, gnome-terminal, gnome-system-tools, "
+"nautilus\n"
+"Description: launcher and docking facility for GNOME 2\n"
+"...]]"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1998 cdbs-doc.xml:2261
+msgid "<filename>debian/rules</filename>:"
+msgstr ""
+
+# type: CDATA
+#: cdbs-doc.xml:1999
+#, no-wrap
+msgid ""
+"#!/usr/bin/make -f\n"
+"\n"
+"# Gnome Team\n"
+"include /usr/share/gnome-pkg-tools/1/rules/uploaders.mk\n"
+"\n"
+"include /usr/share/cdbs/1/rules/debhelper.mk\n"
+"# Including this file gets us a simple patch system.  You can just\n"
+"# drop patches in debian/patches, and they will be automatically\n"
+"# applied and unapplied.\n"
+"include /usr/share/cdbs/1/rules/simple-patchsys.mk\n"
+"# Including this gives us a number of rules typical to a GNOME\n"
+"# program, including setting GCONF_DISABLE_MAKEFILE_SCHEMA_INSTALL=1.\n"
+"# Note that this class inherits from autotools.mk and docbookxml.mk,\n"
+"# so you don't need to include those too.\n"
+"include /usr/share/cdbs/1/class/gnome.mk\n"
+"\n"
+"DEB_CONFIGURE_SCRIPT_ENV += LDFLAGS=\"-Wl,-z,defs -Wl,-O1 "
+"-Wl,--as-needed\"\n"
+"DEB_CONFIGURE_EXTRA_FLAGS := --disable-scrollkeeper\n"
+"ifneq ($(DEB_BUILD_GNU_SYSTEM),gnu)\n"
+"\tDEB_CONFIGURE_EXTRA_FLAGS += --enable-eds\n"
+"endif\n"
+"\n"
+"# debug lib\n"
+"DEB_DH_STRIP_ARGS := --dbg-package=libpanel-applet-2\n"
+"\n"
+"# tight versioning\n"
+"DEB_NOREVISION_VERSION := $(shell dpkg-parsechangelog | egrep '^Version:' | "
+"cut -f 2 -d ' ' | cut -f 1 -d '-')\n"
+"DEB_DH_MAKESHLIBS_ARGS_libpanel-applet2-0 := -V\"libpanel-applet2-0 (>= "
+"$(DEB_NOREVISION_VERSION))\"\n"
+"DEB_SHLIBDEPS_LIBRARY_gnome-panel:= libpanel-applet2-0\n"
+"DEB_SHLIBDEPS_INCLUDE_gnome-panel := debian/libpanel-applet2-0/usr/lib/\n"
+"\n"
+"\n"
+"binary-install/gnome-panel::\n"
+"\tchmod a+x debian/gnome-panel/usr/lib/gnome-panel/*\n"
+"\n"
+"binary-install/gnome-panel-data::\n"
+"\tchmod a+x debian/gnome-panel-data/etc/menu-methods/gnome-panel-data\n"
+"\tfind debian/gnome-panel-data/usr/share -type f -exec chmod -R a-x {} \\;\n"
+"\n"
+"binary-install/libpanel-applet2-doc::\n"
+"\tfind debian/libpanel-applet2-doc/usr/share/doc/libpanel-applet2-doc/ -name "
+"\".arch-ids\" -depth -exec rm -rf {} \\;\n"
+"\n"
+"clean::\n"
+"\t# GNOME Team 'uploaders.mk' should not override this behavior, here is a "
+"workarround :\n"
+"\tsed -i \"s/@cdbs@/$(CDBS_BUILD_DEPENDS)/g\" debian/control]]"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:2049
+msgid "Python Example"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:2051
+msgid ""
+"This example is from the package <literal>pmock</literal>.  It builds Python "
+"modules for version 2.3 and 2.4 as well as a metapackage without writing any "
+"custom rules."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:2055 cdbs-doc.xml:2293
+msgid "<filename>debian/control</filename>:"
+msgstr ""
+
+# type: CDATA
+#: cdbs-doc.xml:2056
+#, no-wrap
+msgid ""
+"Source: pmock\n"
+"Section: python\n"
+"Priority: optional\n"
+"Maintainer: Jan Alonzo <jmalonzo at unpluggable.com>\n"
+"Build-Depends: debhelper (>= 4.1.67), cdbs, python2.3-dev, python2.4-dev, "
+"python-dev (>= 2.3)\n"
+"Standards-Version: 3.6.1.1\n"
+"\n"
+"Package: python-pmock\n"
+"Architecture: all\n"
+"Depends: ${python:Depends}, python (>= 2.3), python (<< 2.5)\n"
+"Description: Python module for unit testing using mock objects\n"
+" Mock Objects is a test-first development process for building "
+"object-oriented\n"
+" software and a generic unit testing framework that supports that process.\n"
+" .\n"
+" This package allows you to use Mock Objects for unit testing Python "
+"programs.\n"
+" .\n"
+" This is a dependency package which selects Debian's default Python "
+"version.\n"
+" .\n"
+"  Homepage: http://pmock.sourceforge.net\n"
+"\n"
+"Package: python2.3-pmock\n"
+"Architecture: all\n"
+"Depends: ${python:Depends}, python2.3\n"
+"Description: Python module for unit testing using mock objects\n"
+" Mock Objects is a test-first development process for building "
+"object-oriented\n"
+" software and a generic unit testing framework that supports that process.\n"
+" .\n"
+" This package allows you to use Mock Objects for unit testing Python "
+"programs.\n"
+" .\n"
+"  Homepage: http://pmock.sourceforge.net\n"
+"\n"
+"Package: python2.4-pmock\n"
+"Architecture: all\n"
+"Depends: ${python:Depends}, python2.4\n"
+"Description: Python module for unit testing using mock objects\n"
+" Mock Objects is a test-first development process for building "
+"object-oriented\n"
+" software and a generic unit testing framework that supports that process.\n"
+" .\n"
+" This package allows you to use Mock Objects for unit testing Python "
+"programs.\n"
+" .\n"
+"  Homepage: http://pmock.sourceforge.net]]></programlisting>\n"
+"      </para>\n"
+"\n"
+"      <para>\n"
+"        <filename>debian/rules</filename>:\n"
+"          <programlisting><![CDATA[\n"
+"#!/usr/bin/make -f\n"
+"# -*- makefile -*-\n"
+"\n"
+"include /usr/share/cdbs/1/rules/debhelper.mk\n"
+"include /usr/share/cdbs/1/class/python-distutils.mk]]></programlisting>\n"
+"      </para>\n"
+"    </sect1>\n"
+"\n"
+"    <sect1>\n"
+"      <title>Makefile + Dpatch example</title>\n"
+"\n"
+"      <para>This example is from the package "
+"<literal>apg</literal>.</para>\n"
+"\n"
+"      <para><filename>debian/control.in</filename>:\n"
+"          <programlisting><![CDATA[\n"
+"Source: apg\n"
+"Section: admin\n"
+"Priority: optional\n"
+"Maintainer: Marc Haber <mh+debian-packages at zugschlus.de>\n"
+"Build-Depends: @cdbs@\n"
+"Standards-Version: 3.6.1\n"
+"\n"
+"Package: apg\n"
+"Architecture: any\n"
+"Depends: ${shlibs:Depends}\n"
+"Description: Automated Password Generator - Standalone version\n"
+" APG (Automated Password Generator) is the tool set for random\n"
+" password generation. It generates some random words of required type\n"
+" and prints them to standard output. This binary package contains only\n"
+" the standalone version of apg.\n"
+" Advantages:\n"
+"  * Built-in ANSI X9.17 RNG (Random Number Generator)(CAST/SHA1)\n"
+"  * Built-in password quality checking system (now it has support for "
+"Bloom\n"
+"    filter for faster access)\n"
+"  * Two Password Generation Algorithms:\n"
+"     1. Pronounceable Password Generation Algorithm (according to NIST\n"
+"        FIPS 181)\n"
+"     2. Random Character Password Generation Algorithm with 35\n"
+"        configurable modes of operation\n"
+"  * Configurable password length parameters\n"
+"  * Configurable amount of generated passwords\n"
+"  * Ability to initialize RNG with user string\n"
+"  * Support for /dev/random\n"
+"  * Ability to crypt() generated passwords and print them as additional "
+"output.\n"
+"  * Special parameters to use APG in script\n"
+"  * Ability to log password generation requests for network version\n"
+"  * Ability to control APG service access using tcpd\n"
+"  * Ability to use password generation service from any type of box (Mac,\n"
+"    WinXX, etc.) that connected to network\n"
+"  * Ability to enforce remote users to use only allowed type of password\n"
+"    generation\n"
+" The client/server version of apg has been deliberately omitted.\n"
+" .\n"
+" Upstream URL: "
+"http://www.adel.nursat.kz/apg/download.shtml]]></programlisting>\n"
+"      </para>\n"
+"\n"
+"      <para>\n"
+"        <filename>debian/rules</filename>:\n"
+"          <programlisting><![CDATA[\n"
+"#!/usr/bin/make -f\n"
+"\n"
+"# to re-generate debian/control, invoke\n"
+"# fakeroot debian/rules debian/control DEB_AUTO_UPDATE_DEBIAN_CONTROL:=yes\n"
+"\n"
+"# automatic debian/control generation disabled, cdbs bug #311724.\n"
+"\n"
+"DEB_MAKE_CLEAN_TARGET    := clean\n"
+"DEB_MAKE_BUILD_TARGET    := standalone\n"
+"DEB_MAKE_INSTALL_TARGET  := install "
+"INSTALL_PREFIX=$(CURDIR)/debian/apg/usr\n"
+"\n"
+"include /usr/share/cdbs/1/rules/debhelper.mk\n"
+"include /usr/share/cdbs/1/rules/dpatch.mk\n"
+"include /usr/share/cdbs/1/class/makefile.mk\n"
+"\n"
+"cleanbuilddir/apg::\n"
+"\trm -f build-stamp configure-stamp php.tar.gz\n"
+"\n"
+"install/apg::\n"
+"\tmv $(CURDIR)/debian/apg/usr/bin/apg $(CURDIR)/debian/apg/usr/lib/apg/apg\n"
+"\ttar --create --gzip --file php.tar.gz --directory $(CURDIR)/php/apgonline/ "
+".\n"
+"\tinstall -D --mode=0644 php.tar.gz "
+"$(CURDIR)/debian/apg/usr/share/doc/apg/php.tar.gz\n"
+"\trm php.tar.gz\n"
+"\tinstall -D --mode=0755 $(CURDIR)/debian/apg.wrapper "
+"$(CURDIR)/debian/apg/usr/bin/apg\n"
+"\tinstall -D --mode=0644 $(CURDIR)/debian/apg.conf "
+"$(CURDIR)/debian/apg/etc/apg.conf\n"
+"\n"
+"# bug #284231\n"
+"unpatch: deapply-dpatches]]></programlisting>\n"
+"\n"
+"       (Be advised that bug #284231 has been fixed in the "
+"meantime.)</para>\n"
+"    </sect1>\n"
+"\n"
+"    <sect1>\n"
+"      <title>Perl Examples</title>\n"
+"\n"
+"      <para>This example is from the package\n"
+"      <literal>libmidi-perl</literal>.  It builds a Perl\n"
+"      module.</para>\n"
+"\n"
+"      <para><filename>debian/control</filename>:\n"
+"<programlisting><![CDATA[\n"
+"Source: libmidi-perl\n"
+"Section: interpreters\n"
+"Priority: optional\n"
+"Build-Depends: cdbs (>= 0.4.4), debhelper (>= 4.1.0), perl (>= 5.8.0-7)\n"
+"Maintainer: Mario Lang <mlang at debian.org>\n"
+"Standards-Version: 3.5.10\n"
+"\n"
+"Package: libmidi-perl\n"
+"Architecture: all\n"
+"Depends: ${perl:Depends}\n"
+"Description: read, compose, modify, and write MIDI files in Perl\n"
+" This suite of Perl modules provides routines for reading, composing,\n"
+" modifying, and writing MIDI files.]]></programlisting>\n"
+"      </para>\n"
+"\n"
+"      <para><filename>debian/rules</filename>:\n"
+"<programlisting><![CDATA[\n"
+"#!/usr/bin/make -f\n"
+"\n"
+"include /usr/share/cdbs/1/rules/debhelper.mk\n"
+"include /usr/share/cdbs/1/class/perlmodule.mk]]></programlisting>\n"
+"      </para>\n"
+"\n"
+"      <para>This example is from the package\n"
+"      <literal>libgd-graph-perl</literal>.  It illustrates the\n"
+"      occasional need to set variables and add customized\n"
+"      rules.</para>\n"
+"\n"
+"      <para><filename>debian/control</filename>:\n"
+"<programlisting><![CDATA[\n"
+"Source: libgd-graph-perl\n"
+"Section: perl\n"
+"Priority: extra\n"
+"Maintainer: Jonas Smedegaard <dr at jones.dk>\n"
+"Standards-Version: 3.6.1\n"
+"Build-Depends-indep: cdbs, debhelper (>= 4.1), perl (>= 5.6.0-16), "
+"libgd-text-perl (>= 0.80), imagemagick, dh-buildinfo\n"
+"\n"
+"Package: libgd-graph-perl\n"
+"Architecture: all\n"
+"Depends: libgd-text-perl (>= 0.80)\n"
+"Description:  Graph Plotting Module for Perl 5\n"
+" GD::Graph is a perl5 module to create charts using the GD module.\n"
+" The following classes for graphs with axes are defined:\n"
+" .\n"
+" GD::Graph::lines - Create a line chart.\n"
+" GD::Graph::bars - Create a bar chart.\n"
+" GD::Graph::points - Create an chart, displaying the data as points.\n"
+" GD::Graph::linespoints - Combination of lines and points.\n"
+" GD::Graph::area - Create a graph, representing the data as areas under a\n"
+"     line.\n"
+" GD::Graph::mixed - Create a mixed type graph, any combination of the\n"
+"     above. At the moment this is fairly limited. Some of\n"
+"     the options that can be used with some of the\n"
+"     individual graph types won't work very well. Multiple\n"
+"     bar graphs in a mixed graph won't display very nicely.\n"
+" GD::Graph::pie - Create a pie chart.]]"
+msgstr ""
+
+# type: CDATA
+#: cdbs-doc.xml:2262
+#, no-wrap
+msgid ""
+"#!/usr/bin/make -f\n"
+"# -*- mode: makefile; coding: utf-8 -*-\n"
+"# Copyright ~~ 2003 Jonas Smedegaard <dr at jones.dk>\n"
+"\n"
+"# Put perlmodule.mk last to dh_clean temporary files not in MANIFEST\n"
+"include /usr/share/cdbs/1/rules/debhelper.mk\n"
+"include /usr/share/cdbs/1/class/perlmodule.mk\n"
+"\n"
+"DEB_INSTALL_EXAMPLES_libgd-graph-perl := samples Dustismo_Sans.ttf\n"
+"\n"
+"# Upstream says creating samples is a better test so do both\n"
+"DEB_MAKE_CHECK_TARGET := test samples\n"
+"\n"
+"# Clean explicitly, as upstream make target \"clean\" in samples is broken\n"
+"clean::\n"
+"\trm -f $(CURDIR)/samples/sample*.png $(CURDIR)/samples/sample*.gif "
+"$(CURDIR)/samples/logo.gif\n"
+"\n"
+"# Add build info\n"
+"common-binary-post-install-indep::\n"
+"\tdh_buildinfo]]"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:2287
+msgid "Ant Example"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:2289
+msgid ""
+"This example is from the package <literal>jline</literal>.  Here you can see "
+"how to use the Ant class and set up rules that install the package in a "
+"policy-conforming way."
+msgstr ""
+
+# type: CDATA
+#: cdbs-doc.xml:2294
+#, no-wrap
+msgid ""
+"Source: jline\n"
+"Section: libs\n"
+"Priority: optional\n"
+"Maintainer: Debian Java Maintainers "
+"<pkg-java-maintainers at lists.alioth.debian.org>\n"
+"Uploaders: Peter Eisentraut <petere at debian.org>\n"
+"Build-Depends-Indep: cdbs (>= 0.4.36), debhelper (>= 5), kaffe, jikes, ant, "
+"junit\n"
+"Standards-Version: 3.6.2\n"
+"\n"
+"Package: libjline-java\n"
+"Section: libs\n"
+"Architecture: all\n"
+"Depends: kaffe | java2-runtime | java1-runtime\n"
+"Suggests: kaffe | java-virtual-machine, libjline-java-doc\n"
+"Description: Java library for handling console input\n"
+" JLine is a 100% pure Java library for reading and editing console input.\n"
+" It is similar in functionality to BSD editline and GNU readline.  People\n"
+" familiar with the readline/editline capabilities for modern shells will\n"
+" find most of the command editing features of JLine to be familiar.\n"
+" .\n"
+" Web site: http://jline.sourceforge.net/\n"
+"\n"
+"Package: libjline-java-doc\n"
+"Section: doc\n"
+"Architecture: all\n"
+"Suggests: libjline-java\n"
+"Description: documentation for JLine\n"
+" JLine is a 100% pure Java library for reading and editing console input.\n"
+" It is similar in functionality to BSD editline and GNU readline.  People\n"
+" familiar with the readline/editline capabilities for modern shells will\n"
+" find most of the command editing features of JLine to be familiar.\n"
+" .\n"
+" This package contains the documentation for JLine.\n"
+" .\n"
+" Web site: http://jline.sourceforge.net/\n"
+"]]"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:2332
+msgid "<filename>debian/rules</filename>"
+msgstr ""
+
+# type: CDATA
+#: cdbs-doc.xml:2333
+#, no-wrap
+msgid ""
+"#!/usr/bin/make -f\n"
+"\n"
+"include /usr/share/cdbs/1/class/ant.mk\n"
+"include /usr/share/cdbs/1/rules/debhelper.mk\n"
+"include /usr/share/cdbs/1/rules/simple-patchsys.mk\n"
+"\n"
+"PACKAGE_VERSION := $(shell dpkg-parsechangelog | sed -n 's/^Version: "
+"\\(.*\\)-[^-]*$$/\\1/p')\n"
+"\n"
+"JAVA_HOME = /usr/lib/kaffe\n"
+"DEB_JARS = junit\n"
+"DEB_ANT_BUILD_TARGET = jars\n"
+"DEB_ANT_COMPILER = jikes\n"
+"\n"
+"DEB_INSTALL_DOCS_ALL =\n"
+"DEB_INSTALL_EXAMPLES_libjline-java-doc = release/jline-demo.jar\n"
+"\n"
+"\n"
+"install/libjline-java:: DEB_FINALDIR=$(CURDIR)/debian/libjline-java\n"
+"install/libjline-java::\n"
+"\tinstall -m 644 -D release/jline-0_9_5.jar "
+"$(DEB_FINALDIR)/usr/share/java/jline-$(PACKAGE_VERSION).jar\n"
+"\tdh_link /usr/share/java/jline-$(PACKAGE_VERSION).jar "
+"/usr/share/java/jline.jar\n"
+"\n"
+"\n"
+"clean::\n"
+"\trm -rf build/ release/ reports/ tmp/\n"
+"\trm -f VERSION.txt]]"
+msgstr ""
+
+# type: Content of: <book><chapter><title>
+#: cdbs-doc.xml:2365
+msgid "Conclusion"
+msgstr ""
+
+# type: Content of: <book><chapter><para>
+#: cdbs-doc.xml:2367
+msgid ""
+"CDBS solves most common problems in building Debian packages, and it is very "
+"pleasant to use.  More and more Debian packagers are using it, not because "
+"they are obliged to, but because they tasted and found it could improve "
+"their packages and avoid losing time on constantly reinventing silly and "
+"complicated rules."
+msgstr ""
+
+# type: Content of: <book><chapter><para>
+#: cdbs-doc.xml:2374
+msgid ""
+"CDBS is not perfect.  It is not yet capable of handling very complicated "
+"situations, like packages where multiple C or C++ builds with different "
+"options and/or patches are required, but this only affects a very small "
+"number of packages.  These limitations are planned to be solved in CDBS2, "
+"which is work in progress."
+msgstr ""
+
+# type: Content of: <book><chapter><para>
+#: cdbs-doc.xml:2380
+msgid ""
+"Using CDBS more widely would improve Debian's overall quality.  Don't "
+"hesitate trying it, talking to your friends about it, and contributing."
+msgstr ""
+
+# type: Content of: <book><chapter><para>
+#: cdbs-doc.xml:2384
+msgid "Have a lot of fun with CDBS !!! :-)"
+msgstr ""
+
+# type: Content of: <book><colophon><title>
+#: cdbs-doc.xml:2388
+msgid "Thanks"
+msgstr ""
+
+# type: Content of: <book><colophon><para>
+#: cdbs-doc.xml:2390
+msgid ""
+"This document was originally written by Marc Dequ?nes and Arnaud Patard with "
+"the following revision history:"
+msgstr ""
+
+# type: Content of: <book><colophon><para><revhistory><revision><revnumber>
+#: cdbs-doc.xml:2395
+msgid "0.1.0"
+msgstr ""
+
+# type: Content of: <book><colophon><para><revhistory><revision><date>
+#: cdbs-doc.xml:2396
+msgid "2005-04-03"
+msgstr ""
+
+# type: Content of: <book><colophon><para><revhistory><revision><revremark>
+#: cdbs-doc.xml:2397
+msgid "First Public Release (for CDBS V0.4.27-3)"
+msgstr ""
+
+# type: Content of: <book><colophon><para><revhistory><revision><revnumber>
+#: cdbs-doc.xml:2400
+msgid "0.1.1"
+msgstr ""
+
+# type: Content of: <book><colophon><para><revhistory><revision><date>
+#: cdbs-doc.xml:2401
+msgid "2005-06-07"
+msgstr ""
+
+# type: Content of: <book><colophon><para><revhistory><revision><revremark>
+#: cdbs-doc.xml:2402
+msgid ""
+"Updated for CDBS V0.4.30 (perl class build dependency management, "
+"cdbs-edit-patch script)"
+msgstr ""
+
+# type: Content of: <book><colophon><para><revhistory><revision><revnumber>
+#: cdbs-doc.xml:2405
+msgid "0.1.2"
+msgstr ""
+
+# type: Content of: <book><colophon><para><revhistory><revision><date>
+#: cdbs-doc.xml:2406
+msgid "2005-07-05"
+msgstr ""
+
+# type: Content of: <book><colophon><para><revhistory><revision><revremark>
+#: cdbs-doc.xml:2407
+msgid "Added DEB_CONFIGURE_SCRIPT_ENV usage warning, fixed typo."
+msgstr ""
+
+# type: Content of: <book><colophon><para>
+#: cdbs-doc.xml:2412
+msgid ""
+"Thanks to Jeff Bailey for his patience and for replying to so many "
+"questions."
+msgstr ""
+
+# type: Content of: <book><colophon><para>
+#: cdbs-doc.xml:2415
+msgid "Special thanks to GuiHome for helping by reviewing this documentation."
+msgstr ""
+
+# type: Content of: <book><colophon><para>
+#: cdbs-doc.xml:2418
+msgid ""
+"This document is a <ulink url=\"http://docbook.org/\">DocBook</ulink> "
+"application, checked using xmllint (from <ulink "
+"url=\"http://www.xmlsoft.org/\">libxml2</ulink>), produced using xsltproc "
+"(from <ulink url=\"http://xmlsoft.org/XSLT/\">libxslt</ulink>), using the "
+"<ulink url=\"http://nwalsh.com/\">N. Walsh</ulink> and <ulink "
+"url=\"http://dblatex.sourceforge.net/\">dblatex</ulink> XLST stylesheets, "
+"and converted with <ulink "
+"url=\"http://www.latex-project.org/\">LaTeX</ulink> tools (latex, mkindex, "
+"pdflatex &amp; dvips) / <ulink "
+"url=\"http://research.compaq.com/SRC/virtualpaper/pstotext.html\">pstotext</ulink> "
+"(with <ulink url=\"http://www.cs.wisc.edu/~ghost/\">GS</ulink>)."
+msgstr ""
Index: doc/po/ja.po
===================================================================
--- doc/po/ja.po	(????? 0)
+++ doc/po/ja.po	(????? 0)
@@ -0,0 +1,3578 @@
+# Japanese translations of documentation for CDBS
+# CDBS ????????????
+# Copyright (C) 2008 Noritada Kobayashi <noritadak at gmail.com>.
+# This file is distributed under the same license as the cdbs package.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: cdbs-doc trunk\n"
+"POT-Creation-Date: 2008-09-24 20:28+0900\n"
+"PO-Revision-Date: 2008-09-26 19:21+0900\n"
+"Last-Translator: Noritada Kobayashi <noritadak at gmail.com>\n"
+"Language-Team: Japanese <debian-doc at debian.or.jp>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+# type: Attribute 'lang' of: <book>
+#: cdbs-doc.xml:4
+msgid "en"
+msgstr "ja"
+
+# type: Content of: <book><bookinfo><title>
+#: cdbs-doc.xml:6
+msgid "The Common Debian Build System"
+msgstr "The Common Debian Build System"
+
+# type: Content of: <book><bookinfo><authorgroup><author>
+#: cdbs-doc.xml:9
+msgid ""
+"<author> <firstname>Marc</firstname> <othername>(Duck)</othername> "
+"<surname>Dequ?nes</surname>"
+msgstr ""
+"<author> <firstname>Marc</firstname> <othername>(Duck)</othername> "
+"<surname>Dequ?nes</surname>"
+
+# type: Content of: <book><bookinfo><authorgroup><author><affiliation>
+#: cdbs-doc.xml:14
+msgid "<orgname>DuckCorp</orgname>"
+msgstr "<orgname>DuckCorp</orgname>"
+
+# type: Content of: <book><bookinfo><legalnotice><para>
+#: cdbs-doc.xml:40
+msgid ""
+"Permission is granted to copy, distribute and/or modify this document under "
+"the terms of the <ulink url=\"http://www.gnu.org/licenses/gpl.html\">GNU "
+"General Public License</ulink>, Version 2 or any later version published by "
+"the Free Software Foundation."
+msgstr ""
+
+# type: Content of: <book><bookinfo><copyright><holder>
+#: cdbs-doc.xml:49
+msgid "Peter Eisentraut"
+msgstr "Peter Eisentraut"
+
+# type: Content of: <book><bookinfo><copyright><holder>
+#: cdbs-doc.xml:55
+msgid "DuckCorp"
+msgstr "DuckCorp"
+
+# type: Content of: <book><bookinfo><copyright><holder>
+#: cdbs-doc.xml:60
+msgid "Colin Walters"
+msgstr "Colin Walters"
+
+# type: Content of: <book><chapter><title>
+#: cdbs-doc.xml:65
+msgid "Introduction"
+msgstr "????"
+
+# type: Content of: <book><chapter><para>
+#: cdbs-doc.xml:67
+msgid ""
+"CDBS is essentially a set of makefile fragments that you may include into "
+"your <filename>debian/rules</filename> for building Debian packages.  Each "
+"makefile fragment can have effects in different parts of the package build "
+"process."
+msgstr ""
+
+# type: Content of: <book><chapter><para>
+#: cdbs-doc.xml:72
+msgid ""
+"The motivating factor for CDBS was originally that more and more programs "
+"today are created using GNU Autoconf configure scripts and GNU Automake, and "
+"as such they are all very similar to configure and build.  It was realized "
+"that a lot of duplicated code in everyone's <filename>debian/rules</"
+"filename> could be factored out.  But CDBS isn't only useful for packages "
+"that use the GNU autotools.  It is a flexible core upon which you can create "
+"your own custom build systems."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:82
+msgid "Why Does CDBS Exist?"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:84
+msgid ""
+"The current generally accepted practice for creating new Debian packages is "
+"to run <command>dh_make</command>, which generates a bunch of files, the "
+"most important of which are <filename>debian/control</filename>, "
+"<filename>debian/copyright</filename>, and <filename>debian/rules</"
+"filename>.  The first two are relatively straightforward.  But "
+"<filename>debian/rules</filename> is not.  Debhelper was an enormous step "
+"forward in this area, greatly reducing redundant and incomprehensible code "
+"from the Debian package creation process.  But it doesn't go far enough; the "
+"typical <command>dh_make</command> generated <filename>debian/rules</"
+"filename> is hundreds of lines, only some of which apply.  From experience "
+"with helping several people to learn Debian packaging, <filename>debian/"
+"rules</filename> was by far the hardest part for them to understand."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:101
+msgid ""
+"Moreover, this generated code will become stale with time, as the Debian "
+"policy changes.  At some time in the past, the <varname>DEB_BUILD_OPTIONS</"
+"varname> variable dropped the <literal>debug</literal> flag in favor of "
+"<literal>noopt</literal>.  But gradually it was realized that since the code "
+"to check this variable was duplicated over hundreds (if not thousands) of "
+"<command>dh_make</command>-generated source packages (and had possibly been "
+"modified), it would likely be years before most packages were updated.  And "
+"there are many packages that predate <varname>DEB_BUILD_OPTIONS</varname> "
+"and don't even use it at all, when they easily could."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:114
+msgid ""
+"The Unix and hacker cultures in general have long looked down upon generated "
+"code, and for good reason.  It is often hard to edit, and there is almost "
+"always no way to regenerate the code but keep your local changes.  Instead "
+"of generating code (like all the Microsoft tools tend to do), the Unix "
+"tradition is to create a metalanguage, a compiler, or some other form of "
+"abstraction."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:122
+msgid ""
+"CDBS is that abstraction.  It's not the first attempt at abstracting the "
+"Debian build process; before Debhelper, many attempts came along and had "
+"only marginal success, if any.  So now the question you're asking yourself "
+"is probably:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:129
+msgid "What Makes CDBS Better?"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:131
+msgid ""
+"First of all, it is not monolithic (as opposed to debstd, for instance).  "
+"CDBS is quite simply a set of makefile fragments that can be included; if "
+"you don't want a particular part, you just don't include the makefile "
+"fragment for it."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:136
+msgid ""
+"Second, CDBS does not attempt to supplant Debhelper (which has generally "
+"done an excellent job at the <literal>binary</literal> stage of Debian "
+"package building).  CDBS can optionally use Debhelper to implement various "
+"parts of building a Debian package.  This is the recommended mode of "
+"operation, actually.  But some people may find Debhelper doesn't work for "
+"them; if that's the case, you just don't include <filename>debhelper.mk</"
+"filename>, and you can do the work yourself."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:146
+msgid ""
+"Third, CDBS tries to make the common case easy.  If you have a package that "
+"uses the GNU autotools and such, you can have a working build system simply "
+"by including about two or three makefile fragments.  No custom code required "
+"at all.  Additionally, CDBS has even higher-level makefile fragments; for "
+"example, there are <filename>gnome.mk</filename> and <filename>kde.mk</"
+"filename> rule files which handle a number of common things required by "
+"GNOME and KDE packages."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:155
+msgid ""
+"Finally, CDBS (along with Debhelper) should make it much easier to effect "
+"systemwide changes.  For example, if we later decide to switch our default "
+"<literal>i386</literal> architecture to <literal>i486</literal> (as we "
+"probably will), all we have to do is change <filename>autotools.mk</"
+"filename>, and the correct"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><option>
+#: cdbs-doc.xml:160
+msgid "--host"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:160
+msgid "and"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><option>
+#: cdbs-doc.xml:161
+msgid "--build"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:161
+msgid ""
+"will be passed to all <literal>./configure</literal> invocations.  Currently "
+"<emphasis>some</emphasis> packages have the <varname>DEB_HOST_ARCH</varname> "
+"boilerplate code in their <filename>debian/rules</filename>, but many don't."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:169
+msgid "Why Not Just Debhelper?"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:171
+msgid ""
+"Some things done in CDBS could just as well go into a <command>dh_foo</"
+"command> program (for example, some of <filename>autotools.mk</filename>).  "
+"Likewise, some <command>dh_foo</command> programs would probably do better "
+"as CDBS makefile fragments (<command>dh_python</command> comes to mind)."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:178
+msgid ""
+"But CDBS' makefile fragment orientation allows it to do things that "
+"Debhelper can't, or can't easily do.  For example, CDBS automatically "
+"generates a ton of makefile rules corresponding to package building.  This "
+"saves a great deal of redundant code in <filename>debian/rules</filename>."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:184
+msgid ""
+"CDBS automatically creates <literal>build-arch</literal> and <literal>build-"
+"indep</literal> targets, and builds architecture-dependent and -independent "
+"packages under them.  It also can cleanly affect a number of different parts "
+"of the build system (e.g., <literal>clean</literal>, <literal>configure</"
+"literal>, <literal>build</literal>) by simply including one makefile "
+"fragment; doing this as a <command>dh_foo</command> would require inserting "
+"a call like <literal>dh_foo --clean</literal>, <literal>dh_foo --configure</"
+"literal> at each step.  And doing things this way wouldn't allow future "
+"expansion; you'd have to change your code to say <literal>dh_foo --build</"
+"literal> if the foo helper wanted to modify the build process, too."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:198
+msgid ""
+"So CDBS complements Debhelper (or it can; again, CDBS does not require "
+"Debhelper)."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:203
+msgid "Summary"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:205
+msgid ""
+"In summary, we believe CDBS (typically combined with Debhelper) is the "
+"future of Debian packaging.  By reducing the complexity in each package, we "
+"make sweeping changes much easier.  Debian has made several major "
+"transitions in the past, and will in the future.  It shouldn't be as painful "
+"as it has been.  Moreover, CDBS makes creating simple packages very easy, as "
+"it should be."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:213
+msgid "CDBS advantages:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:217
+msgid "short and readable <filename>debian/rules</filename>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:221
+msgid ""
+"automates Debhelper and autotools for you so you don't have to bother with "
+"these repetitive tasks"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:226
+msgid ""
+"maintainer can focus on real packaging problems because CDBS helps you but "
+"does not limit customization"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:232
+msgid "rules used in CDBS have been well tested"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:236
+msgid "switching to CDBS is easy"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:240
+msgid ""
+"can be used to generate debian files (like <filename>debian/control</"
+"filename> for GNOME Team Uploaders inclusion)"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:246
+msgid "CDBS is easily extensible"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:250
+msgid "It |70&gt;&lt; !!!"
+msgstr ""
+
+# type: Content of: <book><chapter><title>
+#: cdbs-doc.xml:258
+msgid "First Steps"
+msgstr ""
+
+# type: Content of: <book><chapter><para>
+#: cdbs-doc.xml:260
+msgid ""
+"The best documentation for CDBS are the makefile fragments under <filename>/"
+"usr/share/cdbs/1/</filename>.  The following will tell you how to get "
+"started with CDBS and explain what is possible, but since you can pretty "
+"much override or customize anything in CDBS, you will sooner or later want "
+"to look at the code itself."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:268
+msgid "Switching the Package to CDBS"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:270
+msgid ""
+"Switching to CDBS is easy.  A simple <filename>debian/rules</filename> for "
+"an autotools-using C or C++ software with no extra rules would be written as "
+"this:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:274
+#, no-wrap
+msgid ""
+"\n"
+"#!/usr/bin/make -f\n"
+"\n"
+"include /usr/share/cdbs/1/rules/debhelper.mk\n"
+"include /usr/share/cdbs/1/class/autotools.mk\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:282
+msgid ""
+"Yes, really.  This is sufficient, and it handles autotools management, like "
+"updating <filename>config.guess</filename> and <filename>config.sub</"
+"filename>, cleaning up temporary files after the build, and running all "
+"common debhelper commands."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:288
+msgid ""
+"Create your <filename><replaceable>package</replaceable>.install</filename>, "
+"<filename><replaceable>package</replaceable>.info</filename>, etc. as you "
+"usually do with <command>dh_*</command> commands, and CDBS will call them if "
+"necessary, autodetecting a lot of things.  In case of missing Debhelper "
+"compatibility information, CDBS will create a <filename>debian/compat</"
+"filename> file with compatibility level 5."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:297
+msgid ""
+"Incidentally, you should usually include <filename>debhelper.mk</filename> "
+"first, before other files.  This will turn on optional Debhelper-using parts "
+"of other rules files, if any, which is usually what you want."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:302
+msgid ""
+"Naturally, if you switch a package to use CDBS, you must add a build "
+"dependency on <literal>cdbs</literal> to your package."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><note><title>
+#: cdbs-doc.xml:307
+msgid "Versioning note"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><note><para>
+#: cdbs-doc.xml:309
+msgid ""
+"CDBS might change incompatibly in the future, and to allow for this, all the "
+"rules and classes are in a version-specific subdirectory.  That's the reason "
+"for the <literal>1</literal> in <filename>/usr/share/cdbs/1</filename>."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><warning><para>
+#: cdbs-doc.xml:317
+msgid ""
+"CDBS does not work if the name of the current directory contains spaces or "
+"some other special characters such as quotation marks.  This situation is "
+"very hard to handle in <command>make</command>, so it is best to stick to "
+"<quote>sane</quote> directory names."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:326
+msgid "Basic Settings and Available Variables"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:328
+msgid ""
+"Every CDBS-using <filename>debian/rules</filename> should eventually include "
+"<filename>/usr/share/cdbs/1/rules/buildcore.mk</filename>.  (It might be "
+"included automatically via dependencies, as we will see later.)  This "
+"makefile fragment sets up all of the core default makefile structure and "
+"variables, but doesn't actually <emphasis>do</emphasis> anything on its own."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:336
+msgid ""
+"You can use the <filename>buildcore.mk</filename> rules to hook in your own "
+"build system to actually implement each stage of compiling, installing, and "
+"building <filename>.deb</filename>s if you wish, but typically you will use "
+"the rules and classes that CDBS has prepared for you."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:342
+msgid "You can change common build parameters this way:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:343
+#, no-wrap
+msgid ""
+"\n"
+"# where sources are\n"
+"DEB_SRCDIR = $(CURDIR)/src\n"
+"\n"
+"# in which directory to build\n"
+"DEB_BUILDDIR = $(DEB_SRCDIR)/build\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:350
+msgid ""
+"Remember that you can get the package directory using the <varname>CURDIR</"
+"varname> variable."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:353
+msgid ""
+"Note that the variables should be set <emphasis>after</emphasis> the rule "
+"fragments are included.  This is necessary for them to have any effect.  "
+"There are a few exceptions to this; but generally variables should be set "
+"after rule fragments are included."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:360
+msgid "Some of the variables you can use in <filename>debian/rules</filename>:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><term>
+#: cdbs-doc.xml:365
+msgid "<varname>DEB_SOURCE_PACKAGE</varname>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:366
+msgid "name of the source package"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><term>
+#: cdbs-doc.xml:370
+msgid "<varname>DEB_VERSION</varname>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:371
+msgid "full Debian version"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><term>
+#: cdbs-doc.xml:375
+msgid "<varname>DEB_NOEPOCH_VERSION</varname>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:376
+msgid "Debian version without epoch"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><term>
+#: cdbs-doc.xml:380
+msgid "<varname>DEB_ISNATIVE</varname>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:381
+msgid "nonemtpy if the package is native"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><term>
+#: cdbs-doc.xml:385
+msgid "<varname>DEB_ALL_PACKAGES</varname>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:386
+msgid "list of all binary packages"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><term>
+#: cdbs-doc.xml:390
+msgid "<varname>DEB_INDEP_PACKAGES</varname>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:391
+msgid "list of architecture-independent binary packages"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><term>
+#: cdbs-doc.xml:395
+msgid "<varname>DEB_ARCH_PACKAGES</varname>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:396
+msgid "list of architecture-dependent binary packages"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><term>
+#: cdbs-doc.xml:400
+msgid "<varname>DEB_PACKAGES</varname>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:401
+msgid "list of normal (non-udeb) binary packages"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><term>
+#: cdbs-doc.xml:405
+msgid "<varname>DEB_UDEB_PACKAGES</varname>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:406
+msgid "list of udeb binary packages, if any"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><term>
+#: cdbs-doc.xml:410
+msgid "<varname>DEB_ARCH</varname>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:411
+msgid ""
+"the old Debian architecture name (deprecated, only use to provide backward "
+"compatibility; see <command>dpkg-architecture</command> man page for more "
+"information)"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><term>
+#: cdbs-doc.xml:418
+msgid "<varname>DEB_HOST_ARCH_CPU</varname>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:419
+msgid ""
+"the CPU part of the Debian architecture (e.g., <literal>powerpc</literal>)"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><term>
+#: cdbs-doc.xml:423
+msgid "<varname>DEB_HOST_ARCH_OS</varname>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:424
+msgid ""
+"the operating system part of the Debian architecture (e.g., <literal>linux</"
+"literal>)"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><term>
+#: cdbs-doc.xml:428
+msgid "<varname>DEB_DESTDIR</varname>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:429
+msgid ""
+"The directory in which to install the package.  This is automatically set to "
+"<filename>$(CURDIR)/debian/<replaceable>packagename</replaceable></filename> "
+"if there is one package and <filename>$(CURDIR)/debian/tmp</filename> if "
+"there are multiple packages.  In the latter case you would usually use "
+"<filename>.install</filename> files to install the package files into the "
+"final directories.  In some exceptional cases, you may need to set "
+"<varname>DEB_DESTDIR</varname> yourself.  One case is when some packages are "
+"only built on some architectures, which could make CDBS set the variable "
+"inconsistently across architectures, which in turn would create problems "
+"with the <filename>.install</filename> files."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:449
+msgid "Custom Rules"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:451
+msgid ""
+"Suppose that your package generates extra cruft as a side effect of the "
+"build process that's not taken care of by the upstream <literal>clean</"
+"literal> rule and ends up bloating your diff.  To handle this (until "
+"upstream fixes it), you can simply add stuff to the <literal>clean</literal> "
+"rule as follows:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:458
+#, no-wrap
+msgid ""
+"\n"
+"clean::\n"
+"\trm -f foo/blah.o po/.intltool-merge-cache\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:463
+msgid ""
+"Almost all of the current rules are <firstterm>double-colon</firstterm> "
+"rules (see the <citetitle>GNU Make Manual</citetitle>).  This means you can "
+"simply add to them without overriding the default."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:468
+msgid ""
+"You can also add dependencies to the rules.  For example, suppose you have a "
+"multiple-binary package that builds both a program and a shared library, and "
+"the program depends on the shared library.  To tell CDBS to build the shared "
+"library before the program, just do something like:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:474
+#, no-wrap
+msgid ""
+"\n"
+"binary/program:: binary/libfoo\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:478
+msgid ""
+"However, this must come <emphasis>before</emphasis> you include "
+"<filename>buildcore.mk</filename>.  This is due to the way make works."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:482
+msgid ""
+"Targets of the form <literal><replaceable>something</replaceable>/"
+"<replaceable>package</replaceable></literal> exist for many stages of the "
+"package build process and allow you to hook in additional commands.  Suppose "
+"you want custom rules for the source package <literal>foo</literal>, "
+"creating binary packages <literal>foo</literal> (architecture-depependent) "
+"and <literal>foo-data</literal> (architecture-independent).  You simply need "
+"to add some lines like the following to <filename>debian/rules</filename>."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:492
+msgid "To add pre-configure actions:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:493
+#, no-wrap
+msgid ""
+"\n"
+"makebuilddir/foo::\n"
+"\tln -s plop plop2\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:499
+msgid "To add post-configure actions:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:500
+#, no-wrap
+msgid ""
+"\n"
+"configure/foo::\n"
+"\tsed -ri 's/PLOP/PLIP/' Makefile\n"
+"\n"
+"configure/foo-data::\n"
+"\ttouch src/z.xml\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:507
+msgid ""
+"In this case we are talking about package configuration and not about a "
+"<filename>configure</filename> script made with autotools (although such a "
+"<filename>configure</filename> script would normally also be called in that "
+"very package configuration phase)."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:513
+msgid "To add post-build actions:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:514
+#, no-wrap
+msgid ""
+"\n"
+"build/foo::\n"
+"\t$(SHELL) debian/scripts/toto.sh\n"
+"\n"
+"build/foo-data::\n"
+"\t$(MAKE) helpfiles\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:523
+msgid "To add post-install actions:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:524
+#, no-wrap
+msgid ""
+"\n"
+"install/foo::\n"
+"\tcp debian/tmp/myfoocmd debian/foo/foocmd\n"
+"\tfind debian/foo/ -name \"CVS\" -depth -exec rm -rf {} \\;\n"
+"\tstrip --remove-section=.comment --remove-section=.note --strip-unneeded \\\n"
+"\t    debian/foo/usr/lib/foo/totoz.so\n"
+"\n"
+"install/foo-data::\n"
+"\tcp data/*.png debian/foo-data/usr/share/foo-data/images/\n"
+"\tdh_stuff -m ipot -f plop.bz3 debian/foo-data/libexec/\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:537
+msgid "To add post deb preparation actions (usually not very useful):"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:539
+#, no-wrap
+msgid ""
+"\n"
+"binary/foo::\n"
+"\t at echo 'Package foo successfully built.'\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:545
+msgid "To add pre-clean actions:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:546
+#, no-wrap
+msgid ""
+"\n"
+"cleanbuilddir/foo::\n"
+"\trm -f debian/fooman.1\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:552
+msgid ""
+"Now, let's suppose your package is a little bit strange (e.g. Perl); perhaps "
+"it has a <command>Configure</command> script that isn't made by Autoconf; "
+"this script might instead expect the user to interactively configure the "
+"program.  In that case, you can just implement the <literal>common-"
+"configure</literal> rule, by adding something like the following to your "
+"<filename>debian/rules</filename>:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:561
+#, no-wrap
+msgid ""
+"\n"
+"common-configure::\n"
+"\t./Configure --blah --blargh &lt; debian/answers\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:567
+msgid ""
+"Note that if you do this, you can't include <filename>autotools.mk</"
+"filename>, since then you'll get <emphasis>two</emphasis> implementations of "
+"common-configure, which is sure to fail.  It would be nice to be able to "
+"partially override rule fragments, but that is a tricky problem."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:573
+msgid ""
+"<xref linkend=\"fig:buildcore\"/> gives an overview of the targets provided "
+"by <filename>buildcore.mk</filename> where you can hook in custom rules.  "
+"The bold ellipses are the targets required by the Debian policy.  For "
+"illustration, the diamond-shaped nodes show how a typical autotools-using "
+"build process would be hooked into these rules.  These are not actually "
+"provided by <filename>buildcore.mk</filename> of course."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><figure><title>
+#: cdbs-doc.xml:583
+msgid "Buildcore targets"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:595
+msgid ""
+"Rules that add commands should normally be written <emphasis>after</"
+"emphasis> including any CDBS rule fragments, unless you know exactly what "
+"you're doing.  The reason for this is as follows.  The commands for double-"
+"colon rules are accumulated in the order in which they appear in the "
+"makefile.  That is, writing"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:601
+#, no-wrap
+msgid ""
+"\n"
+"target::\n"
+"\tfoo\n"
+"\n"
+"target::\n"
+"\tbar\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:608
+msgid "will have approximately the same effect as"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:609
+#, no-wrap
+msgid ""
+"\n"
+"target:\n"
+"\tfoo\n"
+"\tbar\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:614
+msgid ""
+"Now if you have, for example, an autotools-using package and wrote something "
+"like"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:616
+#, no-wrap
+msgid ""
+"\n"
+"build/myprog::\n"
+"\t$(MAKE) extrastuff\n"
+"\n"
+"include /usr/share/cdbs/1/class/autotools.mk\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:622
+msgid ""
+"(more on the autotools class below), this would end up running <literal>"
+"$(MAKE) extrastuff</literal> before <literal>autotools.mk</literal> has a "
+"chance to run <command>configure</command>, so there will probably not be "
+"any instantiated makefile yet and the build will fail."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:628
+msgid ""
+"Again, the recommended practice is to include all the CDBS rule fragments "
+"first on your <filename>debian/rules</filename> and put variable assignments "
+"and extra rules afterwards, unless an exception is explicitly pointed out in "
+"this manual."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:635
+msgid "Common Build Options"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:638
+msgid ""
+"<varname>CFLAGS</varname> and <varname>CXXFLAGS</varname> are set to "
+"<literal>-g -Wall -O2</literal> by default."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:643
+msgid ""
+"<varname>DEB_BUILD_OPTIONS</varname> is a well known Debian environment "
+"variable, not a CDBS one, containing special build options (a comma-"
+"separated list of key words).  CDBS does check <varname>DEB_BUILD_OPTIONS</"
+"varname> to take these options into account; see details in each class."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:652
+msgid "Debhelper Support"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:654
+msgid ""
+"An important piece of the puzzle after configuring and building the software "
+"is to actually build <filename>.deb</filename>s from there.  You could "
+"implement this step yourself if you wished, but most people will want to "
+"take advantage of Debhelper to do it mostly automatically.  To do this, "
+"simply add a line like"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:661
+#, no-wrap
+msgid ""
+"\n"
+"include /usr/share/cdbs/1/rules/debhelper.mk\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:664
+msgid "in <filename>debian/rules</filename>."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:667
+msgid ""
+"CDBS debhelper rules handle the following <command>dh_*</command> commands "
+"for each binary package automatically:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:672
+msgid "dh_builddeb"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:673
+msgid "dh_clean"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:674
+msgid "dh_compress"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:675
+msgid "dh_fixperms"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:676
+msgid "dh_gencontrol"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:677
+msgid "dh_install"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:678
+msgid "dh_installcatalogs"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:679
+msgid "dh_installchangelogs"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:680
+msgid "dh_installcron"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:681
+msgid "dh_installdeb"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:682
+msgid "dh_installdebconf"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:683
+msgid "dh_installdirs"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:684
+msgid "dh_installdocs"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:685
+msgid "dh_installemacsen"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:686
+msgid "dh_installexamples"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:687
+msgid "dh_installinfo"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:688
+msgid "dh_installinit"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:689
+msgid "dh_installlogcheck"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:690
+msgid "dh_installlogrotate"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:691
+msgid "dh_installman"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:692
+msgid "dh_installmenu"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:693
+msgid "dh_installmime"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:694
+msgid "dh_installpam"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:695
+msgid "dh_installudev"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:696
+msgid "dh_link"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:697
+msgid "dh_lintian"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:698
+msgid "dh_makeshlibs"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:699
+msgid "dh_md5sums"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:700
+msgid "dh_perl"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:701
+msgid "dh_shlibdeps"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:702
+msgid "dh_strip"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:705
+msgid ""
+"Of course, these are called in the correct order, not in the one shown "
+"above.  Other debhelper commands can be handled in specific classes or may "
+"be called in custom rules."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:709
+msgid ""
+"If you use <filename>debhelper.mk</filename>, you must add a build "
+"dependency on <literal>debhelper</literal>.  If you use Debhelper "
+"compatibility level 5, then the dependency should be (at least) "
+"<literal>debhelper (>= 5)</literal>, if you use version 4 then (at least) "
+"<literal>debhelper (>= 4.2.0)</literal>."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><title>
+#: cdbs-doc.xml:717
+msgid "Debhelper Parameters"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:719
+msgid ""
+"The following variables allow Debhelper call customization while leaving the "
+"other calls to be handled without writing any rule.  Some of them apply on "
+"all binary packages, for instance <varname>DEB_INSTALL_DOCS_ALL</varname>, "
+"and some apply only to a specific package, for instance "
+"<varname>DEB_SHLIBDEPS_LIBRARY_<replaceable>package</replaceable></varname> "
+"(where <replaceable>package</replaceable> is the name of a binary package).  "
+"Read the comments in <filename>/usr/share/cdbs/1/rules/debhelper.mk</"
+"filename> for a complete listing.  Some non-exhaustive examples follow."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:732
+msgid "To specify a tight dependency on a package containing shared libraries:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para><programlisting>
+#: cdbs-doc.xml:733
+#, no-wrap
+msgid ""
+"\n"
+"DEB_DH_MAKESHLIBS_ARGS_libfoo = -V\"libfoo (>= 0.1.2-3)\"\n"
+"DEB_SHLIBDEPS_LIBRARY_arkrpg = libfoo\n"
+"DEB_SHLIBDEPS_INCLUDE_arkrpg = debian/libfoo/usr/lib/\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:741
+msgid ""
+"To install a changelog file with an uncommon name like "
+"<filename>ProjectChanges.txt.gz</filename>:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para><programlisting>
+#: cdbs-doc.xml:743
+#, no-wrap
+msgid ""
+"\n"
+"DEB_INSTALL_CHANGELOGS_ALL = ProjectChanges.txt\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:746
+msgid ""
+"(CDBS automatically recognizes a fair number of possible changelog names, "
+"but not that one.)"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:751
+msgid "To avoid compressing files with a <filename>.py</filename> extension:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para><programlisting>
+#: cdbs-doc.xml:753
+#, no-wrap
+msgid ""
+"\n"
+"DEB_COMPRESS_EXCLUDE = .py\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:759
+msgid ""
+"Perl-specific debhelper options (The <command>dh_perl</command> call is "
+"always performed.):"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para><programlisting>
+#: cdbs-doc.xml:761
+#, no-wrap
+msgid ""
+"\n"
+"# Add a space-separated list of paths to search for perl modules\n"
+"DEB_PERL_INCLUDE = /usr/lib/perl-z\n"
+"\n"
+"# Like the above, but for the 'libperl-stuff' package\n"
+"DEB_PERL_INCLUDE_libperl-stuff = /usr/lib/perl-plop\n"
+"\n"
+"# Overrides options passed to dh_perl\n"
+"DEB_DH_PERL_ARGS = -d\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><title>
+#: cdbs-doc.xml:775
+msgid "Debhelper Custom Build Rules"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:778
+msgid ""
+"CDBS debhelper rules also add more adequate build rules.  For example, to "
+"add post deb preparation (including debhelper stuff) actions:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para><programlisting>
+#: cdbs-doc.xml:781
+#, no-wrap
+msgid ""
+"\n"
+"binary-install/foo::\n"
+"\tchmod a+x debian/foo/usr/bin/pouet\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:788
+msgid "Several other rules exists, for rarer cases:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:792
+msgid "<literal>binary-strip/foo</literal> (called after stripping)"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:797
+msgid ""
+"<literal>binary-fixup/foo</literal> (called after gzipping and fixing "
+"permissions)"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:803
+msgid ""
+"<literal>binary-predeb</literal> (called just before creating the <filename>."
+"deb</filename>)"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><title>
+#: cdbs-doc.xml:811
+msgid "Debug Package Support"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:813
+msgid ""
+"A debug package is a binary package named <literal><replaceable>package</"
+"replaceable>-dbg</literal> that contains the debugging symbols for the "
+"binaries (programs, libraries, etc.) in other packages, typically all other "
+"binary packages built from the same source package.  Debhelper facilitates "
+"the creation of these debug packages by the"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para><option>
+#: cdbs-doc.xml:819
+msgid "--dbg-package"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:819
+msgid ""
+"option in the command <command>dh_strip</command>.  CDBS has support for "
+"creating debug packages, if Debhelper level 5 compatibility is used."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:824
+msgid ""
+"CDBS will automatically call <command>dh_strip</command> with the right "
+"options if exactly one debug package is mentioned in <filename>debian/"
+"control</filename> and so that the debugging symbols of all other binary "
+"packages are included in that debug package.  This takes care of the most "
+"common situation."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:831
+msgid ""
+"To control more finely which debug symbols go where, in particular if you "
+"want to build more than one debug package, there are variables "
+"<varname>DEB_DBG_PACKAGE_<replaceable>package</replaceable></varname> that "
+"specify the debug package target for each individual binary package.  An "
+"example usage would be:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para><programlisting>
+#: cdbs-doc.xml:837
+#, no-wrap
+msgid ""
+"\n"
+"DEB_DBG_PACKAGE_libfoo4 = libfoo-dbg\n"
+"DEB_DBG_PACKAGE_foo-bin = foo-bin-dbg\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:843
+msgid ""
+"If exactly one debug package is defined, setting any variable "
+"<varname>DEB_DBG_PACKAGE_<replaceable>package</replaceable></varname> "
+"disables the behavior of putting all debug symbols in that package."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:849
+msgid ""
+"If there is more than one debug package defined and each debug package is "
+"named <literal>foo-dbg</literal> such that there is a package called "
+"<literal>foo</literal>, then the assignments <literal>DEB_DBG_PACKAGE_foo = "
+"foo-dbg</literal> are done automatically.  Again, this only happens if all "
+"debug packages can be assigned this way.  Of course, all these assignments "
+"can be overridden if you find that this behavior doesn't quite work for you."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><note><para>
+#: cdbs-doc.xml:859
+msgid ""
+"If a source package builds a single binary package, and then a debug package "
+"is added, this changes the automatic assignment of <varname>DEB_DESTDIR</"
+"varname> to <literal>$(CURDIR)/debian/tmp</literal>, as described in <xref "
+"linkend=\"basic-settings\"/>, which will likely invalid the installation "
+"rules and leave you with a nearly-empty package.  To work around this "
+"behavior, set <varname>DEB_DESTDIR</varname> manually in <filename>debian/"
+"rules</filename> as"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><note><para><programlisting>
+#: cdbs-doc.xml:868
+#, no-wrap
+msgid ""
+"\n"
+"DEB_DESTDIR = $(CURDIR)/debian/<replaceable>packagename</replaceable>\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><note><para>
+#: cdbs-doc.xml:871
+msgid ""
+"Alternatively, write a <filename><replaceable>packagename</replaceable>."
+"install</filename> file listing"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><note><para><programlisting>
+#: cdbs-doc.xml:874
+#, no-wrap
+msgid ""
+"\n"
+"debian/tmp/*\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><note><para>
+#: cdbs-doc.xml:877
+msgid "or whatever subset you need."
+msgstr ""
+
+# type: Content of: <book><chapter><title>
+#: cdbs-doc.xml:885
+msgid "Classes"
+msgstr ""
+
+# type: Content of: <book><chapter><para>
+#: cdbs-doc.xml:887
+msgid ""
+"CDBS provides <firstterm>classes</firstterm> which contain makefile rules "
+"and variables implementing compilation, installation, and building of Debian "
+"packages.  There are a number of classes covering different types of ways a "
+"software is built.  Classes tend to be declarative; they say your package "
+"has particular properties.  Suppose for instance that your package uses a "
+"regular makefile to compile, and has the normal <command>make</command> and "
+"<command>make install</command> targets.  In that case you would use the "
+"<quote>makefile</quote> class, and you can say:"
+msgstr ""
+
+# type: Content of: <book><chapter><para><programlisting>
+#: cdbs-doc.xml:898
+#, no-wrap
+msgid "include /usr/share/cdbs/1/class/makefile.mk"
+msgstr ""
+
+# type: Content of: <book><chapter><para>
+#: cdbs-doc.xml:900
+msgid ""
+"This gives you all the code to run <command>make</command> automatically.  "
+"It basically works by adding code to the <literal>common-build-arch</"
+"literal>, <literal>common-build-indep</literal>, <literal>common-install-"
+"arch</literal>, and <literal>common-install-indep</literal> targets inside "
+"<filename>buildcore.mk</filename>.  It might be instructive to look at "
+"<filename>makefile.mk</filename> now."
+msgstr ""
+
+# type: Content of: <book><chapter><para>
+#: cdbs-doc.xml:909
+msgid ""
+"Some classes actually include another class, or <quote>inherit</quote> if "
+"you like.  For example, the autotools class inherits the makefile class "
+"because much of the build process is the same between them, only the "
+"configuration stage is different.  The effect is that all the variables "
+"provided by the inherited class are available in the inheriting class as "
+"well.  <xref linkend=\"fig:depgraph\"/> shows the relationship between the "
+"classes and other rule sets provided by CDBS."
+msgstr ""
+
+# type: Content of: <book><chapter><figure><title>
+#: cdbs-doc.xml:919
+msgid "Dependencies between the CDBS class and rule files"
+msgstr ""
+
+# type: Content of: <book><chapter><para>
+#: cdbs-doc.xml:931
+msgid "The rest of this chapter explains all the classes supported by CDBS."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:935
+msgid "The Makefile Class"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:937
+msgid ""
+"The makefile class is for the packages who only have a makefile to build the "
+"program.  (If the package uses Autoconf, use the autotools class instead.)  "
+"You only need to have four rules in the makefile:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:944
+msgid "one for cleaning the build directory (e.g., <literal>clean</literal>)"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:949
+msgid "one for building the software (e.g. <literal>all</literal>)"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:954
+msgid ""
+"one for checking if the software is working properly (e.g. <literal>check</"
+"literal>)"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:959
+msgid "one for installing the software (e.g. <literal>install</literal>)"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:964
+msgid ""
+"The installation and check rules are optional, but it always helps a lot "
+"when you've got them."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:967
+msgid ""
+"The first step is to write the <filename>debian/rules</filename>.  First, we "
+"add the include lines:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:970
+#, no-wrap
+msgid ""
+"\n"
+"include /usr/share/cdbs/1/class/makefile.mk\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:973
+msgid ""
+"Now, it remains to tell CDBS the name of our four makefile rules.  For the "
+"previous examples it gives:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:975
+#, no-wrap
+msgid ""
+"\n"
+"DEB_MAKE_CLEAN_TARGET   = clean\n"
+"DEB_MAKE_BUILD_TARGET   = all\n"
+"DEB_MAKE_INSTALL_TARGET = install DESTDIR=$(CURDIR)/debian/tmp/\n"
+"# no check for this software\n"
+"DEB_MAKE_CHECK_TARGET   =\n"
+"\n"
+"# example when changing environment variables is necessary\n"
+"DEB_MAKE_ENVVARS        = CFLAGS=\"-pwet\"\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:987 cdbs-doc.xml:1184 cdbs-doc.xml:1448 cdbs-doc.xml:1491
+#: cdbs-doc.xml:1530 cdbs-doc.xml:1642
+msgid ""
+"<varname>DEB_BUILD_OPTIONS</varname> is checked for the following options:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><term>
+#: cdbs-doc.xml:991 cdbs-doc.xml:1188 cdbs-doc.xml:1452 cdbs-doc.xml:1495
+#: cdbs-doc.xml:1534 cdbs-doc.xml:1651
+msgid "<literal>noopt</literal>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:992 cdbs-doc.xml:1189 cdbs-doc.xml:1496 cdbs-doc.xml:1535
+msgid "use"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para><option>
+#: cdbs-doc.xml:992 cdbs-doc.xml:1189 cdbs-doc.xml:1496 cdbs-doc.xml:1535
+msgid "-O0"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:992 cdbs-doc.xml:1189 cdbs-doc.xml:1496 cdbs-doc.xml:1535
+msgid "instead of"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para><option>
+#: cdbs-doc.xml:992 cdbs-doc.xml:1189 cdbs-doc.xml:1496 cdbs-doc.xml:1535
+msgid "-O2"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><term>
+#: cdbs-doc.xml:996 cdbs-doc.xml:1193 cdbs-doc.xml:1646
+msgid "<literal>nocheck</literal>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:997 cdbs-doc.xml:1194
+msgid "skip the check rule"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1002
+msgid ""
+"If your makefile doesn't support the <varname>DESTDIR</varname> variable, "
+"take a look in it and find the variable responsible for setting installation "
+"directory.  If you don't find some variable to do this, you'll have to patch "
+"the makefile."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><title>
+#: cdbs-doc.xml:1009
+msgid "Build Problems"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:1011
+msgid ""
+"Sometimes, when using the makefile class (or a derived one), a build fails "
+"because of missing include files or something like that.  Often this is "
+"caused by the fact that CDBS passes <varname>CFLAGS</varname> (and "
+"<varname>CPPFLAGS</varname>) along with the make invocation.  A sane build "
+"system allows this: <varname>CFLAGS</varname> are for the user to "
+"customize.  Setting <varname>CFLAGS</varname> shouldn't override other "
+"internal flags used in the package, such as"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para><option>
+#: cdbs-doc.xml:1019
+msgid "-I"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:1019
+msgid ""
+".  If fixing the upstream source is too difficult, however, you may do this:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para><programlisting>
+#: cdbs-doc.xml:1022
+#, no-wrap
+msgid ""
+"\n"
+"DEB_MAKE_INVOKE = $(DEB_MAKE_ENVVARS) make -C $(DEB_BUILDDIR)\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:1026
+msgid ""
+"That will avoid passing <varname>CFLAGS</varname>.  But note that this "
+"breaks the automatic implementation of <varname>DEB_BUILD_OPTIONS</varname>."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><title>
+#: cdbs-doc.xml:1032
+msgid "The Makefile Class and Single vs. Multiple Binary Packages"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:1035
+msgid ""
+"If you have a single binary package, the default <literal>common-install</"
+"literal> implementation in <filename>makefile.mk</filename> tries to use the "
+"upstream <filename>Makefile</filename> to install everything into "
+"<filename>debian/packagename</filename>, so it will all appear in the binary "
+"package.  If you're using <filename>debhelper.mk</filename> to remove files "
+"or move them around, just override the <literal>binary-post-install/"
+"<replaceable>package</replaceable></literal> target:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para><programlisting>
+#: cdbs-doc.xml:1046
+#, no-wrap
+msgid ""
+"\n"
+"binary-post-install/mypackage::\n"
+"\tmv debian/mypackage/usr/sbin/myprogram debian/mypackage/usr/bin/myprogram\n"
+"\trm debian/mypackage/usr/share/doc/mypackage/INSTALL\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:1053
+msgid ""
+"If you have a multiple-binary package, <filename>makefile.mk</filename> (by "
+"default) uses the upstream <filename>Makefile</filename> to install "
+"everything in <filename>debian/tmp</filename>.  After this, the recommended "
+"method is to use <filename>debhelper.mk</filename> (which uses "
+"<command>dh_install</command>) to copy these files into the appropriate "
+"package.  To do this, just create <filename><replaceable>package</"
+"replaceable>.install</filename> files; see the <command>dh_install</command> "
+"man page."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:1066
+msgid "The Autotools Class"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1068
+msgid ""
+"The autotools class is for software that uses GNU Autoconf and possibly "
+"Automake and Libtool.  The class will take care of details such as updating "
+"the <filename>config.{sub,guess}</filename> files, running "
+"<command>configure</command> with the standard arguments, etc.  The "
+"autotools class actually builds upon the makefile class."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1076
+msgid ""
+"To use the autotools class, just add this line to your <filename>debian/"
+"rules</filename>:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1078
+#, no-wrap
+msgid ""
+"\n"
+"include /usr/share/cdbs/1/class/autotools.mk\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1083
+msgid ""
+"Suppose you need to pass some additional options to <command>configure</"
+"command>.  The <filename>autotools.mk</filename> file includes a number of "
+"variables that you can override for that purpose, like this:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1088
+#, no-wrap
+msgid ""
+"\n"
+"DEB_CONFIGURE_EXTRA_FLAGS = --enable-ipv6 --with-foo\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1093
+msgid ""
+"If the build system uses non-standard configure options you can override the "
+"CDBS default behavior:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1095
+#, no-wrap
+msgid ""
+"\n"
+"DEB_CONFIGURE_NORMAL_ARGS = --program-dir=/usr\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1098
+msgid ""
+"Note that <varname>DEB_CONFIGURE_EXTRA_FLAGS</varname> will still be "
+"appended."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1101
+msgid "If some specific environnement variables need to be setup, use:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1103
+#, no-wrap
+msgid ""
+"\n"
+"DEB_CONFIGURE_SCRIPT_ENV += LDFLAGS=\" -Wl,-z,defs -Wl,-O1\"\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><tip><para>
+#: cdbs-doc.xml:1109
+msgid ""
+"Prefer the use of <literal>+=</literal> over <literal>=</literal> lest you "
+"override other environment variables like <varname>CC</varname> or "
+"<varname>CXX</varname> defined in the CDBS default."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1116
+msgid ""
+"CDBS will automatically update <filename>config.sub</filename>, "
+"<filename>config.guess</filename>, and <filename>config.rpath</filename> "
+"before the build and restore the old ones at the clean stage (even if using "
+"the tarball system).  If needed, and if <filename>debian/control</filename> "
+"management is activated, <literal>autotools-dev</literal> and "
+"<literal>gnulib</literal>, respectively, will then be automatically added to "
+"the build dependencies (needed to obtain updated versions of the files).  If "
+"the program does not use the top source directory to store autoconf files, "
+"you can teach CDBS where they are to be found:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1128
+#, no-wrap
+msgid ""
+"\n"
+"DEB_AC_AUX_DIR = $(DEB_SRCDIR)/autoconf\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1133
+msgid ""
+"CDBS automatically cleans autotools files generated during the build "
+"(<filename>config.cache</filename>, <filename>config.log</filename>, and "
+"<filename>config.status</filename>)."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1138
+msgid ""
+"CDBS can be asked to update Autoconf, Automake, and Libtool generated files, "
+"but this behavior is likely to break the build system and is "
+"<emphasis>strongly</emphasis> discouraged.  Nevertheless, if you still want "
+"this feature, set the following variables:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:1145
+msgid ""
+"<varname>DEB_AUTO_UPDATE_AUTOCONF</varname> to the version of Autoconf to "
+"use; e.g., <literal>2.61</literal>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:1149
+msgid ""
+"<varname>DEB_AUTO_UPDATE_AUTOMAKE</varname> to the version of Automake to "
+"use; e.g., <literal>1.10</literal>.  To pass extra arguments to "
+"<command>automake</command>, such as <literal>--add-missing --copy</"
+"literal>, put them into the variable <varname>DEB_AUTOMAKE_ARGS</varname>."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:1156
+msgid ""
+"<varname>DEB_AUTO_UPDATE_LIBTOOL</varname> to <literal>pre</literal> to run "
+"<command>libtoolize</command> before the build, or to <literal>post</"
+"literal> to copy the system-supplied <command>libtool</command> program into "
+"the build tree after the configure run"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1163
+msgid "(Corresponding build dependencies will automatically be added.)"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1166
+msgid "The following make parameters can also be overridden :"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1167
+#, no-wrap
+msgid ""
+"\n"
+"# these are the defaults CDBS provides\n"
+"DEB_MAKE_INSTALL_TARGET = install DESTDIR=$(DEB_DESTDIR)\n"
+"DEB_MAKE_CLEAN_TARGET = distclean\n"
+"DEB_MAKE_CHECK_TARGET =\n"
+"\n"
+"# example to work around dirty makefile\n"
+"DEB_MAKE_INSTALL_TARGET = install prefix=$(CURDIR)/debian/tmp/usr\n"
+"\n"
+"# example with unexistant install rule for make\n"
+"DEB_MAKE_INSTALL_TARGET =\n"
+"\n"
+"# example to activate check rule\n"
+"DEB_MAKE_CHECK_TARGET = check\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:1201
+msgid "The Perl Class"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1203
+msgid ""
+"The Perl class can manage Perl module packages using MakeMaker.  To use this "
+"class, add this line to your <filename>debian/rules</filename>:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1207
+#, no-wrap
+msgid ""
+"\n"
+"include /usr/share/cdbs/1/class/perlmodule.mk\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1212
+msgid ""
+"The installation directory defaults to <filename><replaceable>first_pkg</"
+"replaceable>/usr</filename> where <replaceable>first_pkg</replaceable> is "
+"the first package in <filename>debian/control</filename>."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1217 cdbs-doc.xml:1280
+msgid "You can customize build options like this:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1218
+#, no-wrap
+msgid ""
+"\n"
+"# change MakeMaker defaults (hardly ever useful)\n"
+"DEB_MAKE_BUILD_TARGET = build-all\n"
+"DEB_MAKE_CLEAN_TARGET = realclean\n"
+"DEB_MAKE_CHECK_TARGET =\n"
+"DEB_MAKE_INSTALL_TARGET = install PREFIX=debian/stuff\n"
+"\n"
+"# add custom MakeMaker options\n"
+"DEB_MAKEMAKER_USER_FLAGS = --with-foo\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1230
+msgid ""
+"Common makefile or general options can still be overridden: "
+"<varname>DEB_MAKE_ENVVARS</varname>, <varname>DEB_BUILDDIR</varname> (must "
+"match <varname>DEB_SRCDIR</varname> for Perl)."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1236
+msgid "Have a look at the Perl-specific debhelper options described above."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><important><para>
+#: cdbs-doc.xml:1240
+msgid ""
+"If <filename>debian/control</filename> management is activated (see below), "
+"a build dependency on <literal>perl</literal> is automatically added.  If "
+"not, you will have to do it yourself."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:1248
+msgid "The Python Class"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1250
+msgid ""
+"The Python class can manage Python module packages using Distutils.  To use "
+"this class, add this line to your <filename>debian/rules</filename>:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1254
+#, no-wrap
+msgid ""
+"\n"
+"include /usr/share/cdbs/1/class/python-distutils.mk\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1258
+msgid ""
+"Optionally, this class can take care of using <command>dh_python</command>, "
+"if the CDBS debhelper rules are included before the Python class."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1262
+msgid ""
+"Most Python packages are architecture-independent and then don't need to be "
+"built for multiple Python versions; your package should then be called "
+"<literal>python-<replaceable>foo</replaceable></literal> and CDBS will "
+"automatically use the current Python version in Debian to build it.  If your "
+"package contains a compiled part or a binding to an external library, then "
+"you will have packages named <literal>python2.3-<replaceable>foo</"
+"replaceable></literal>, <literal>python2.4-<replaceable>foo</replaceable></"
+"literal>, and so on, depending on <literal>${python:Depends}</literal> (and "
+"perhaps other packages); then CDBS will automatically build each package "
+"with the corresponding Python version.  In this case, don't forget to add a "
+"<literal>python-<replaceable>foo</replaceable></literal> convenience dummy "
+"package depending on the current Python version in Debian."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1281
+#, no-wrap
+msgid ""
+"\n"
+"# force using a specific Python version for build\n"
+"# (should not be necessary)\n"
+"DEB_PYTHON_COMPILE_VERSION = 2.3\n"
+"\n"
+"# change the python build script name (default is 'setup.py')\n"
+"DEB_PYTHON_SETUP_CMD = install.py\n"
+"\n"
+"# clean options for the python build script\n"
+"DEB_PYTHON_CLEAN_ARGS = -all\n"
+"\n"
+"# build options for the python build script\n"
+"DEB_PYTHON_BUILD_ARGS = --build-base=\"$(DEB_BUILDDIR)/specific-build-dir\"\n"
+"\n"
+"# common additional install options for all binary packages\n"
+"# ('--root' option is always set)\n"
+"DEB_PYTHON_INSTALL_ARGS_ALL = --no-compile --optimize --force\n"
+"\n"
+"# specific additional install options for binary package 'foo'\n"
+"# ('--root' option is always set)\n"
+"DEB_PYTHON_INSTALL_ARGS_foo = --root=debian/foo-install-dir/\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1305
+msgid ""
+"Occassionally, you might have a package called <literal>python-something</"
+"literal> that you don't want handled by this class, for example a <literal>-"
+"doc</literal> package.  You can list these packages in the variable "
+"<varname>DEB_PYTHON_PACKAGES_EXCLUDE</varname>.  For example:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1310
+#, no-wrap
+msgid ""
+"\n"
+"DEB_PYTHON_PACKAGES_EXCLUDE = python-mylib-doc\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:1317
+msgid "The GNOME Class"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1319
+msgid ""
+"The GNOME class is obviously for building GNOME software.  It inherits the "
+"autotools class, so everything that was said there also applies to the GNOME "
+"class."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1323
+msgid "The GNOME class can call the following debhelper scripts automatically:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:1327
+msgid "dh_desktop"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:1328
+msgid "dh_gconf"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:1329
+msgid "dh_icons"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:1330
+msgid "dh_scrollkeeper"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1333
+msgid "Moreover it adds some more clean rules:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:1335
+msgid "to remove <command>intltool</command> generated files"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:1336
+msgid "to remove <command>scrollkeeper</command> generated files"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1340
+msgid ""
+"To use it, just add this line to your <filename>debian/rules</filename>, "
+"after the debhelper class include:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1343
+#, no-wrap
+msgid ""
+"\n"
+"include /usr/share/cdbs/1/class/gnome.mk\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1348
+msgid ""
+"The GNOME class adds a make environement variable "
+"<literal>GCONF_DISABLE_MAKEFILE_SCHEMA_INSTALL = 1</literal>.  This is "
+"necessary because the Gconf schemas have to be registered at install time.  "
+"In the case of packaging, this registration cannot be done when building the "
+"package, so this variable disables schema registration in <literal>make "
+"install</literal>.  This procedure is deferred until <command>gconftool-2</"
+"command> is called in <filename>debian/postinst</filename> to register them, "
+"and in <filename>debian/prerm</filename> to unregister them.  The "
+"<command>dh_gconf</command> command is able to add the right rules "
+"automatically for you."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1362
+msgid ""
+"For more information on GNOME-specific packaging rules, look at the Debian "
+"GNOME packaging policy."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><title>
+#: cdbs-doc.xml:1366
+msgid "The Debian GNOME Team Class"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:1368
+msgid ""
+"If you are part of the GNOME team or have the team as uploaders, and you "
+"feel bored maintaining the list of developers, the GNOME Team class is made "
+"for you."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1372 cdbs-doc.xml:1672
+msgid ""
+"To use this class, add this line to your <filename>debian/rules</filename>:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para><programlisting>
+#: cdbs-doc.xml:1374
+#, no-wrap
+msgid ""
+"\n"
+"include /usr/share/gnome-pkg-tools/1/rules/uploaders.mk\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><para>
+#: cdbs-doc.xml:1379
+msgid ""
+"Rename your <filename>debian/control</filename> file to <filename>debian/"
+"control.in</filename> and run the clean rule (<literal>fakeroot debian/rules "
+"clean</literal>) to regenerate the <filename>debian/control</filename> file, "
+"which will replace the <literal>@GNOME_TEAM@</literal> tag with the list of "
+"developers automatically."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><warning><para>
+#: cdbs-doc.xml:1387
+msgid ""
+"If you are using the <filename>debian/control</filename> file management "
+"described below, please note this class will override this feature.  To cope "
+"with this problem, allowing at least <literal>Build-Depends</literal> "
+"handling, use the following work-arround (until it is solved in a proper "
+"way):"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><sect2><warning><para><programlisting>
+#: cdbs-doc.xml:1393
+#, no-wrap
+msgid ""
+"\n"
+"# deactivate 'debian/control' file management\n"
+"#DEB_AUTO_UPDATE_DEBIAN_CONTROL = yes\n"
+"\n"
+"# ...\n"
+"# includes and other stuff\n"
+"# ...\n"
+"\n"
+"clean::\n"
+"\tsed -i \"s/@cdbs@/$(CDBS_BUILD_DEPENDS)/g\" debian/control\n"
+"\t# other clean stuff\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:1411
+msgid "The KDE Class"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1413
+msgid ""
+"To use the KDE class, add this line to your <filename>debian/rules</"
+"filename> file:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1415
+#, no-wrap
+msgid ""
+"\n"
+"include /usr/share/cdbs/1/class/kde.mk\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1418
+msgid ""
+"The KDE class inherits the autotools class, so everything that was said "
+"there also applies here."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1421
+msgid ""
+"CDBS automatically exports the following variables with the right values:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:1423
+msgid "<varname>kde_cgidir</varname> (<literal>/usr/lib/cgi-bin</literal>)"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:1424
+msgid "<varname>kde_confdir</varname> (<literal>/etc/kde3</literal>)"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:1425
+msgid ""
+"<varname>kde_htmldir</varname> (<literal>/usr/share/doc/kde/HTML</literal>)"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1430
+msgid ""
+"<varname>DEB_BUILDDIR</varname>, <varname>DEB_AC_AUX_DIR</varname>, and "
+"<varname>DEB_CONFIGURE_INCLUDEDIR</varname> are set to KDE defaults."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1436
+msgid "The following files are excluded from compression:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:1438
+msgid "<filename>.dcl</filename>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:1439
+msgid "<filename>.docbook</filename>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:1440
+msgid "<filename>-license</filename>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1444
+msgid ""
+"The class handles configure options specific to KDE (not forgetting to "
+"disable rpath and activating xinerama), set the correct autotools directory, "
+"and launch make rules adequately."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:1453
+msgid "disable KDE final mode"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><term>
+#: cdbs-doc.xml:1457 cdbs-doc.xml:1500
+msgid "<literal>nostrip</literal>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:1458
+msgid "enable KDE debug mode and disable KDE final mode"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><term>
+#: cdbs-doc.xml:1462
+msgid "<literal>debug</literal>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:1463
+msgid "enable full KDE debug mode"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:1470
+msgid "The Qmake Class"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1472
+msgid ""
+"Qmake is a build tool for software written for the Qt toolkit library.  To "
+"use the Qmake class, add this include to your <filename>debian/rules</"
+"filename>:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1476
+#, no-wrap
+msgid ""
+"\n"
+"include /usr/share/cdbs/1/class/qmake.mk\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1480
+msgid ""
+"The class takes care of the call to <command>qmake</command> and the "
+"subsequent calls to <command>make</command>, with all the necessary options "
+"to honor <varname>DEB_BUILD_OPTIONS</varname>, for example.  To that end, "
+"the Qmake class builds upon the makefile class."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1486
+msgid ""
+"The Qmake class will call <literal>make install</literal>, but many Qmake "
+"projects are not set up to have a functioning install target, in which case "
+"the installation of the package components has to be handled manually."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:1501
+msgid ""
+"pass the <literal>nostrip</literal> option to <command>qmake</command> "
+"though the <varname>CONFIG</varname> variable"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:1508
+msgid "The CMake Class"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1510
+msgid ""
+"CMake is a cross-platform build tool.  On Unix-like systems it typically "
+"generates makefiles, which are then run through make normally.  To use the "
+"CMake class, add this include to your <filename>debian/rules</filename>:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1515
+#, no-wrap
+msgid ""
+"\n"
+"include /usr/share/cdbs/1/class/cmake.mk\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1519
+msgid ""
+"The class takes care of the call to <command>cmake</command> and the "
+"subsequent calls to <command>make</command>, with all the necessary options "
+"to honor <varname>DEB_BUILD_OPTIONS</varname>, for example.  To that end, "
+"the CMake class builds upon the makefile class."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1525
+msgid ""
+"CMake is designed to always use separate source and build directories.  "
+"Therefore, the CMake class by default builds the project in a separate build "
+"directory named like <filename>obj-<replaceable>platform</replaceable></"
+"filename> under the top-level source directory."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:1542
+msgid "The Ant Class"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1544
+msgid ""
+"Ant is a build tool for software written in the Java programming language.  "
+"To use the Ant class, add this include to your <filename>debian/rules</"
+"filename>:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1548
+#, no-wrap
+msgid ""
+"\n"
+"include /usr/share/cdbs/1/class/ant.mk\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1552
+msgid ""
+"Additionally, you need to set the variable <varname>JAVA_HOME</varname> to "
+"the home directory of the Java Runtime Environment (JRE) or Java Development "
+"Kit (JDK).  You can either set <varname>JAVA_HOME</varname> directly or set "
+"<varname>JAVA_HOME_DIRS</varname> to multiple possible home directories.  "
+"The first directory from this list that provides a <command>java</command> "
+"command is used for <varname>JAVA_HOME</varname>.  For Ant-using packages in "
+"the Debian main archive, you would typically use either"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1561
+#, no-wrap
+msgid ""
+"\n"
+"JAVA_HOME = /usr/lib/kaffe\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1564
+msgid "which requires a build dependency on <literal>kaffe</literal>, or"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1565
+#, no-wrap
+msgid ""
+"\n"
+"JAVA_HOME = /usr/lib/jvm/java-gcj\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1568
+msgid ""
+"which requires a build dependency on <literal>java-gcj-compat-dev</"
+"literal>.  Setting the Java home is required; there is no default."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1572
+msgid ""
+"You can also override <varname>JAVACMD</varname> in case you don't want to "
+"use the default <literal><replaceable>JAVA_HOME</replaceable>/bin/java</"
+"literal>."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1576
+msgid "You may add additional JARs to the build like in the following example:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1579
+#, no-wrap
+msgid ""
+"\n"
+"DEB_JARS = xerces /usr/lib/java-bonus/ldap-connector.jar\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1583
+msgid ""
+"The <filename>.jar</filename> extension may be omitted.  The file name must "
+"be absolute or relative to <filename>/usr/share/java</filename>.  "
+"<filename>ant.jar</filename>, <filename>ant-launcher.jar</filename>, and "
+"<filename>$(JAVA_HOME)/lib/tools.jar</filename> are automatically added if "
+"they exist."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1591
+msgid ""
+"To use a specific Java compiler, override the variable "
+"<varname>DEB_ANT_COMPILER</varname>, for example"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1593
+#, no-wrap
+msgid ""
+"\n"
+"DEB_ANT_COMPILER = jikes\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1598
+msgid ""
+"If your package does not put the file <filename>build.xml</filename> in the "
+"package root directory, where Ant would find it by default, you can point "
+"CDBS to the right place like this:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1602
+#, no-wrap
+msgid ""
+"\n"
+"DEB_ANT_BUILDFILE = build/build.xml\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1607
+msgid ""
+"Finally, you need to set the targets to invoke for building, installing, "
+"testing and cleaning up.  Unless overridden, building uses the default "
+"target from <filename>build.xml</filename>, installing and testing is only "
+"called if the corresponding variable is set, cleaning uses the "
+"<literal>clean</literal> target.  You can also specify multiple targets for "
+"each step.  To override these rules, or run the install or check rules, set "
+"the following variables to your needs:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1616
+#, no-wrap
+msgid ""
+"\n"
+"DEB_ANT_BUILD_TARGET = makeitrule\n"
+"DEB_ANT_CHECK_TARGET = check\n"
+"DEB_ANT_INSTALL_TARGET = install-all\n"
+"DEB_ANT_CLEAN_TARGET = super-clean\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1624
+msgid ""
+"Ant called by CDBS will read a property file, by default at <filename>debian/"
+"ant.properties</filename> if it exists.  There you may define additional "
+"properties that are referenced from <filename>build.xml</filename> so that "
+"you don't have to modify upstream's <filename>build.xml</filename>.  Please "
+"note that command-line arguments in <varname>ANT_ARGS</varname> (see below) "
+"override the settings in <filename>build.xml</filename> and the property "
+"file.  The use a different property file, set the variable "
+"<varname>DEB_ANT_PROPERTYFILE</varname>."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1634
+msgid ""
+"You can provide additionnal JVM arguments using the variable "
+"<varname>ANT_OPTS</varname>.  You can moreover provide additional Ant "
+"command line arguments using <varname>ANT_ARGS</varname> (global) or "
+"<varname>ANT_ARGS_<replaceable>package</replaceable></varname>, thus "
+"overriding the settings in <filename>build.xml</filename> and the property "
+"file."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:1647
+msgid "skip the check target"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:1652
+msgid "set Ant option <literal>compile.optimize</literal> to false"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1657
+msgid ""
+"See <xref linkend=\"example-ant\"/> for a complete example that uses this "
+"Ant class.  You can also get some more information on Ant at the <ulink url="
+"\"http://ant.apache.org/\">Ant Apache web site</ulink>."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:1664
+msgid "The HBuild Class"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1666
+msgid ""
+"HBuild is the Haskell mini-distutils.  CDBS can take care of <literal>-hugs</"
+"literal> and <literal>-ghc</literal> packages: invoke <filename>Setup.lhs</"
+"filename> properly for the clean and install part."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1674
+#, no-wrap
+msgid ""
+"\n"
+"include /usr/share/cdbs/1/class/hbuild.mk\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1680
+msgid ""
+"You should be able to fetch some more information on Haskell distutils in "
+"<ulink url=\"http://www.haskell.org/pipermail/libraries/2003-July/001239.html"
+"\">this thread</ulink>."
+msgstr ""
+
+# type: Content of: <book><chapter><title>
+#: cdbs-doc.xml:1689
+msgid "Common Tasks"
+msgstr ""
+
+# type: Content of: <book><chapter><para>
+#: cdbs-doc.xml:1691
+msgid ""
+"CDBS also supports other tasks that regularly occur during the course of "
+"building Debian packages."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:1695
+msgid "Patching Sources Using the Simple Patch System"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1697
+msgid ""
+"Suppose you'd like to keep separated patches, instead of having them all in "
+"your <filename>.diff.gz</filename>.  CDBS lets you hook in arbitrary patch "
+"systems, but (as with the rest of CDBS), it has its own default "
+"implementation, called <filename>simple-patchsys.mk</filename>.  To use it, "
+"just add"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1704
+#, no-wrap
+msgid "include /usr/share/cdbs/1/rules/simple-patchsys.mk"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1706
+msgid ""
+"to your <filename>debian/rules</filename>.  Now, you can drop patch files "
+"into the <filename>debian/patches</filename> directory, and they will be "
+"automatically applied and unapplied.  Files should be named so as to reflect "
+"in which order they have to be applied, and must end in a <filename>.patch</"
+"filename> or <filename>.diff</filename> suffix.  The simple patchsys rules "
+"will then take care of patching before configure and unpatching after "
+"clean.  It is possible to use patch level 0 to 3, and CDBS will try them and "
+"use the right level automatically.  The system can handle compressed patches "
+"with an additionnal <filename>.gz</filename> or <filename>.bz2</filename> "
+"suffix as well as uuencoded patches with a <filename>.uu</filename> suffix."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1720
+msgid ""
+"You can customize the directories where patches are searched and the suffix "
+"like this:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1722
+#, no-wrap
+msgid ""
+"\n"
+"DEB_PATCHDIRS = debian/mypatches\n"
+"DEB_PATCH_SUFFIX = .plop\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1726
+msgid ""
+"The defaults are: <filename>.diff</filename>, <filename>.diff.gz</filename>, "
+"<filename>.diff.bz2</filename>, <filename>.diff.uu</filename>, <filename>."
+"patch</filename>, <filename>.patch.gz</filename>, <filename>.patch.bz2</"
+"filename>, <filename>.patch.uu</filename>."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1732
+msgid ""
+"In case of errors when applying, for example <filename>debian/"
+"pacthes/01_hurd_ftbfs_pathmax.patch</filename>, you can read the log for "
+"this patch in <filename>debian/pacthes/01_hurd_ftbfs_pathmax.patch.level-0."
+"log</filename> (<quote>0</quote> because it's a level 0 patch)."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1738
+msgid ""
+"When using the simple patch system, a build dependency on "
+"<literal>patchutils</literal> should be added to the package."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1742
+msgid ""
+"The script <command>cdbs-edit-patch</command> is intended to help lazy "
+"people edit or create patches easily.  Invoke this script with the name of "
+"the patch as argument, and you will enter a copy of your working directory "
+"in a subshell where you can edit the sources.  When your work is done and "
+"you are satisfied with your changes, just exit the subshell and you will get "
+"back to normal world with <filename>debian/patches/<replaceable>patch_name</"
+"replaceable>.patch</filename> created or modified accordingly.  The script "
+"takes care to apply previous patches (ordered patches needed!), the current "
+"patch if already existing (in case you want to update it), then generate an "
+"incremental diff to only get desired modifications.  If you want to cancel "
+"the patch creation or modification, you only need to exit the subshell with "
+"a nonzero value and the diff will not be generated (only cleanups will be "
+"done)."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:1760
+msgid "Patching Sources Using Dpatch"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1762
+msgid ""
+"Like the simple patch system detailed previously, the Dpatch patch system "
+"allows you to seperate your changes to the upstream tarball into multiple "
+"seperate patches instead of a monolithic <filename>diff.gz</filename>.  This "
+"is a wrapper to the tools contained in the <literal>dpatch</literal> Debian "
+"package, and it's named <filename>dpatch.mk</filename>.  To use it, add"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1770
+#, no-wrap
+msgid "include /usr/share/cdbs/1/rules/dpatch.mk"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1772
+msgid ""
+"to your <filename>debian/rules</filename>.  If you use <filename>autotools."
+"mk</filename>, be sure to include <filename>dpatch.mk</filename> "
+"<emphasis>after</emphasis> <filename>autotools.mk</filename>.  Additionally, "
+"remember to add <literal>dpatch</literal> to your build dependencies."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1778
+msgid ""
+"Now you can use Dpatch as usual and CDBS will call it automatically.  For a "
+"more complete treatment of Dpatch files, their format, and their "
+"application, please read the documentation included in the <literal>dpatch</"
+"literal> package, notably <filename>/usr/share/doc/dpatch/README.gz</"
+"filename> and the <command>dpatch</command> man page."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:1787
+msgid "Patching Sources Using Quilt"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1789
+msgid ""
+"Quilt is yet another patch management system.  CDBS itself does not actually "
+"contain any Quilt support, but the Quilt package contains CDBS integration, "
+"so there is really no difference from the perspective of the user.  To use "
+"Quilt with CDBS, add"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1795
+#, no-wrap
+msgid "/usr/share/cdbs/1/rules/patchsys-quilt.mk"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1797
+msgid ""
+"to your <filename>debian/rules</filename> and add <literal>quilt</literal> "
+"to the build dependencies.  Read the documentation in the Quilt package for "
+"more information."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:1803
+msgid "Standard Patch System Targets"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1805
+msgid ""
+"The most popular patch systems in Debian, the CDBS Simple Patch System, "
+"DPatch, and Quilt, support the following uniform make targets that you can "
+"use directly to apply and unapply the patches.  This could be useful during "
+"package development.  Of course, the patches are automatically applied or "
+"unapplied as necessary when a full package build is performed."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><variablelist><varlistentry><term>
+#: cdbs-doc.xml:1814
+msgid "<literal>patch</literal>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:1815
+msgid "to apply the patches"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><variablelist><varlistentry><term>
+#: cdbs-doc.xml:1819
+msgid "<literal>unpatch</literal>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><variablelist><varlistentry><listitem><para>
+#: cdbs-doc.xml:1820
+msgid "to unapply the patches"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:1826
+msgid "Tarball-Inside-a-Tarball Build System"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1828
+msgid ""
+"Some Debian packagers may be familiar with DBS, where you include a tarball "
+"of the upstream source inside the Debian source package itself.  This has "
+"some advantages and some disadvantages, but CDBS supports it anyhow.  To use "
+"the CDBS tarball system, just add this line to your <filename>debian/rules</"
+"filename>, and specify the name of the top directory of the extracted "
+"tarball:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1835
+#, no-wrap
+msgid ""
+"\n"
+"DEB_TAR_SRCDIR = foosoft\n"
+"\n"
+"include /usr/share/cdbs/1/rules/tarball.mk\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1840
+msgid ""
+"Note that <filename>tarball.mk</filename> must be <emphasis>first</emphasis> "
+"in the list of included rules."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1843
+msgid ""
+"CDBS will recognize tarballs with the following extensions: <filename>.tar</"
+"filename>, <filename>.tgz</filename>, <filename>.tar.gz</filename>, "
+"<filename>.tar.bz</filename>, <filename>.tar.bz2</filename>, <filename>.zip</"
+"filename>.  The tarball location is autodetected if it is in the top source "
+"directory, or can be specified:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1849
+#, no-wrap
+msgid ""
+"\n"
+"DEB_TARBALL = $(CURDIR)/tarballdir/mygnustuff_beta-1.2.3.tar.gz\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1854
+msgid ""
+"CDBS will handle automatic extraction and cleanups, automatically set "
+"<varname>DEB_SRCDIR</varname> and <varname>DEB_BUILDDIR</varname> for you, "
+"and take care of proper integration with other CDBS parts (such as the "
+"autotools class)."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1860
+msgid ""
+"Note that a build dependency on <filename>bzip2</filename> or "
+"<filename>unzip</filename> may be in order if that is the format of the "
+"tarball.  The <filename>gzip</filename> package is essential, so no build "
+"dependency is necessary for it."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><procedure><title>
+#: cdbs-doc.xml:1867 cdbs-doc.xml:1927
+msgid "<filename>debian/control</filename> Management"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><warning><para>
+#: cdbs-doc.xml:1870
+msgid ""
+"This feature is considered broken and packages using it are not allowed into "
+"the Debian archive."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1874
+msgid "The <filename>debian/control</filename> management feature allows:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:1879
+msgid "CDBS to manage some build dependencies automatically"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:1884
+msgid "use of shell commands embedded in <filename>debian/control</filename>"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
+#: cdbs-doc.xml:1889
+msgid "use of CPU and system criteria to specify architecture (experimental)"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1895
+msgid ""
+"Build dependencies are introduced by the use of certain CDBS features or "
+"autodetected."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1898
+msgid "Embedded shell commands allows including hacks like:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1899
+#, no-wrap
+msgid ""
+"\n"
+"Build-Depends: libgpm-dev [`type-handling any linux-gnu`]\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1904
+msgid ""
+"CPU and system criteria implement support for <literal>Cpu</literal>/"
+"<literal>System</literal> fields, as a replacement for the Architecture "
+"field (which is to be implemented in dpkg in the long term, but still "
+"experimental).  Here is an example: before:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1909
+#, no-wrap
+msgid ""
+"\n"
+"Architecture: all\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1912
+msgid "and after:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1913
+#, no-wrap
+msgid ""
+"\n"
+"Cpu: all\n"
+"System: all\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1917
+msgid ""
+"If these fields are used, it is also possible to include special tags to "
+"easily take advantage of the <command>type-handling</command> tool, like in "
+"this example:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para><programlisting>
+#: cdbs-doc.xml:1920
+#, no-wrap
+msgid ""
+"\n"
+"Build-Depends: @cdbs@, procps [system: linux], plop [cpu: s390]\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1923
+msgid ""
+"(Look at the <command>type-handling</command> package documentation for more "
+"information.)"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><procedure><step><para>
+#: cdbs-doc.xml:1930
+msgid ""
+"Rename <filename>debian/control</filename> to <filename>debian/control.in</"
+"filename>."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><procedure><step><para>
+#: cdbs-doc.xml:1935
+msgid ""
+"Replace <literal>cdbs</literal> and <literal>debhelper</literal> build "
+"dependencies with <literal>@cdbs@</literal> in your <filename>debian/control."
+"in</filename> like this:"
+msgstr ""
+
+# type: CDATA
+#: cdbs-doc.xml:1940
+#, no-wrap
+msgid "Build-Depends-Indep: @cdbs@, python-dev (>= 2.3), python-soya (>= 0.9), python-soya (<< 0.10), python-openal(>= 0.1.4-4), gettext]]"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><procedure><step><para>
+#: cdbs-doc.xml:1946
+msgid ""
+"Add the following line to <filename>debian/rules</filename>, before "
+"<emphasis>any</emphasis> include:"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><procedure><step><para><programlisting>
+#: cdbs-doc.xml:1949
+#, no-wrap
+msgid ""
+"\n"
+"DEB_AUTO_UPDATE_DEBIAN_CONTROL = yes\n"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><procedure><step><para>
+#: cdbs-doc.xml:1956
+msgid ""
+"Then do a <command>debian/rules clean</command> run to (re)generate "
+"<filename>debian/control</filename>."
+msgstr ""
+
+# type: Content of: <book><chapter><title>
+#: cdbs-doc.xml:1964
+msgid "Hall of Examples"
+msgstr ""
+
+# type: Content of: <book><chapter><para>
+#: cdbs-doc.xml:1966
+msgid ""
+"There are as of this writing more than a thousand packages in the Debian "
+"archive that use CDBS, so there is a rich source of examples.  Nonetheless, "
+"to complete this manual, here are a few representative examples of real "
+"packages using CDBS so you get an idea of how to put these things together."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:1973
+msgid "GNOME + Autotools + Simple Patch System Example"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1975
+msgid "This example is from the package <literal>gnome-panel</literal>."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1978
+msgid "<filename>debian/control.in</filename>:"
+msgstr ""
+
+# type: CDATA
+#: cdbs-doc.xml:1979
+#, no-wrap
+msgid ""
+"Source: gnome-panel\n"
+"Section: gnome\n"
+"Priority: optional\n"
+"Maintainer: Guilherme de S. Pastore <guilherme.pastore at terra.com.br>\n"
+"Uploaders: Sebastien Bacher <seb128 at debian.org>, Arnaud Patard <arnaud.patard at rtp-net.org>, @GNOME_TEAM@\n"
+"Standards-Version: 3.6.2.1\n"
+"Build-Depends: @cdbs@, liborbit2-dev (>= 1:2.12.1-1), intltool, gnome-pkg-tools, libgtk2.0-dev (>= 2.7.1), libglade2-dev (>= 1:2.5.1), libwnck-dev (>= 2.11.91-1), scrollkeeper (>= 0.3.14-9.1), libgnome-desktop-dev (>= 2.11.1), libpng3-dev, libbonobo2-dev (>= 2.8.1-2), libxmu-dev, libedata-cal1.2-dev (>= 1.2.1-1) [!hurd-i386], libgnome-menu-dev (>= 2.11.1-1), libgnomevfs2-dev (>= 2.10.0-1), libnspr-dev, libxres-dev, sharutils, gnome-doc-utils, libedataserverui1.2-dev (>= 1.3.0)\n"
+"\n"
+"Package: gnome-panel\n"
+"Architecture: any\n"
+"Depends: ${shlibs:Depends}, ${misc:Depends}, gnome-panel-data (= ${Source-Version}), gnome-desktop-data (>= 2.10.0-1), gnome\n"
+"-control-center (>= 1:2.8.2-3), gnome-menus (>= 2.11.1-1), gnome-about (>= 2.10.0-1)\n"
+"Recommends: gnome-applets (>= 2.12.1-1), gnome-session, menu-xdg (>= 0.2)\n"
+"Suggests: yelp, gnome2-user-guide, gnome-terminal, gnome-system-tools, nautilus\n"
+"Description: launcher and docking facility for GNOME 2\n"
+"...]]"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:1998 cdbs-doc.xml:2261
+msgid "<filename>debian/rules</filename>:"
+msgstr ""
+
+# type: CDATA
+#: cdbs-doc.xml:1999
+#, no-wrap
+msgid ""
+"#!/usr/bin/make -f\n"
+"\n"
+"# Gnome Team\n"
+"include /usr/share/gnome-pkg-tools/1/rules/uploaders.mk\n"
+"\n"
+"include /usr/share/cdbs/1/rules/debhelper.mk\n"
+"# Including this file gets us a simple patch system.  You can just\n"
+"# drop patches in debian/patches, and they will be automatically\n"
+"# applied and unapplied.\n"
+"include /usr/share/cdbs/1/rules/simple-patchsys.mk\n"
+"# Including this gives us a number of rules typical to a GNOME\n"
+"# program, including setting GCONF_DISABLE_MAKEFILE_SCHEMA_INSTALL=1.\n"
+"# Note that this class inherits from autotools.mk and docbookxml.mk,\n"
+"# so you don't need to include those too.\n"
+"include /usr/share/cdbs/1/class/gnome.mk\n"
+"\n"
+"DEB_CONFIGURE_SCRIPT_ENV += LDFLAGS=\"-Wl,-z,defs -Wl,-O1 -Wl,--as-needed\"\n"
+"DEB_CONFIGURE_EXTRA_FLAGS := --disable-scrollkeeper\n"
+"ifneq ($(DEB_BUILD_GNU_SYSTEM),gnu)\n"
+"\tDEB_CONFIGURE_EXTRA_FLAGS += --enable-eds\n"
+"endif\n"
+"\n"
+"# debug lib\n"
+"DEB_DH_STRIP_ARGS := --dbg-package=libpanel-applet-2\n"
+"\n"
+"# tight versioning\n"
+"DEB_NOREVISION_VERSION := $(shell dpkg-parsechangelog | egrep '^Version:' | cut -f 2 -d ' ' | cut -f 1 -d '-')\n"
+"DEB_DH_MAKESHLIBS_ARGS_libpanel-applet2-0 := -V\"libpanel-applet2-0 (>= $(DEB_NOREVISION_VERSION))\"\n"
+"DEB_SHLIBDEPS_LIBRARY_gnome-panel:= libpanel-applet2-0\n"
+"DEB_SHLIBDEPS_INCLUDE_gnome-panel := debian/libpanel-applet2-0/usr/lib/\n"
+"\n"
+"\n"
+"binary-install/gnome-panel::\n"
+"\tchmod a+x debian/gnome-panel/usr/lib/gnome-panel/*\n"
+"\n"
+"binary-install/gnome-panel-data::\n"
+"\tchmod a+x debian/gnome-panel-data/etc/menu-methods/gnome-panel-data\n"
+"\tfind debian/gnome-panel-data/usr/share -type f -exec chmod -R a-x {} \\;\n"
+"\n"
+"binary-install/libpanel-applet2-doc::\n"
+"\tfind debian/libpanel-applet2-doc/usr/share/doc/libpanel-applet2-doc/ -name \".arch-ids\" -depth -exec rm -rf {} \\;\n"
+"\n"
+"clean::\n"
+"\t# GNOME Team 'uploaders.mk' should not override this behavior, here is a workarround :\n"
+"\tsed -i \"s/@cdbs@/$(CDBS_BUILD_DEPENDS)/g\" debian/control]]"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:2049
+msgid "Python Example"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:2051
+msgid ""
+"This example is from the package <literal>pmock</literal>.  It builds Python "
+"modules for version 2.3 and 2.4 as well as a metapackage without writing any "
+"custom rules."
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:2055 cdbs-doc.xml:2293
+msgid "<filename>debian/control</filename>:"
+msgstr ""
+
+# type: CDATA
+#: cdbs-doc.xml:2056
+#, no-wrap
+msgid ""
+"Source: pmock\n"
+"Section: python\n"
+"Priority: optional\n"
+"Maintainer: Jan Alonzo <jmalonzo at unpluggable.com>\n"
+"Build-Depends: debhelper (>= 4.1.67), cdbs, python2.3-dev, python2.4-dev, python-dev (>= 2.3)\n"
+"Standards-Version: 3.6.1.1\n"
+"\n"
+"Package: python-pmock\n"
+"Architecture: all\n"
+"Depends: ${python:Depends}, python (>= 2.3), python (<< 2.5)\n"
+"Description: Python module for unit testing using mock objects\n"
+" Mock Objects is a test-first development process for building object-oriented\n"
+" software and a generic unit testing framework that supports that process.\n"
+" .\n"
+" This package allows you to use Mock Objects for unit testing Python programs.\n"
+" .\n"
+" This is a dependency package which selects Debian's default Python version.\n"
+" .\n"
+"  Homepage: http://pmock.sourceforge.net\n"
+"\n"
+"Package: python2.3-pmock\n"
+"Architecture: all\n"
+"Depends: ${python:Depends}, python2.3\n"
+"Description: Python module for unit testing using mock objects\n"
+" Mock Objects is a test-first development process for building object-oriented\n"
+" software and a generic unit testing framework that supports that process.\n"
+" .\n"
+" This package allows you to use Mock Objects for unit testing Python programs.\n"
+" .\n"
+"  Homepage: http://pmock.sourceforge.net\n"
+"\n"
+"Package: python2.4-pmock\n"
+"Architecture: all\n"
+"Depends: ${python:Depends}, python2.4\n"
+"Description: Python module for unit testing using mock objects\n"
+" Mock Objects is a test-first development process for building object-oriented\n"
+" software and a generic unit testing framework that supports that process.\n"
+" .\n"
+" This package allows you to use Mock Objects for unit testing Python programs.\n"
+" .\n"
+"  Homepage: http://pmock.sourceforge.net]]></programlisting>\n"
+"      </para>\n"
+"\n"
+"      <para>\n"
+"        <filename>debian/rules</filename>:\n"
+"          <programlisting><![CDATA[\n"
+"#!/usr/bin/make -f\n"
+"# -*- makefile -*-\n"
+"\n"
+"include /usr/share/cdbs/1/rules/debhelper.mk\n"
+"include /usr/share/cdbs/1/class/python-distutils.mk]]></programlisting>\n"
+"      </para>\n"
+"    </sect1>\n"
+"\n"
+"    <sect1>\n"
+"      <title>Makefile + Dpatch example</title>\n"
+"\n"
+"      <para>This example is from the package <literal>apg</literal>.</para>\n"
+"\n"
+"      <para><filename>debian/control.in</filename>:\n"
+"          <programlisting><![CDATA[\n"
+"Source: apg\n"
+"Section: admin\n"
+"Priority: optional\n"
+"Maintainer: Marc Haber <mh+debian-packages at zugschlus.de>\n"
+"Build-Depends: @cdbs@\n"
+"Standards-Version: 3.6.1\n"
+"\n"
+"Package: apg\n"
+"Architecture: any\n"
+"Depends: ${shlibs:Depends}\n"
+"Description: Automated Password Generator - Standalone version\n"
+" APG (Automated Password Generator) is the tool set for random\n"
+" password generation. It generates some random words of required type\n"
+" and prints them to standard output. This binary package contains only\n"
+" the standalone version of apg.\n"
+" Advantages:\n"
+"  * Built-in ANSI X9.17 RNG (Random Number Generator)(CAST/SHA1)\n"
+"  * Built-in password quality checking system (now it has support for Bloom\n"
+"    filter for faster access)\n"
+"  * Two Password Generation Algorithms:\n"
+"     1. Pronounceable Password Generation Algorithm (according to NIST\n"
+"        FIPS 181)\n"
+"     2. Random Character Password Generation Algorithm with 35\n"
+"        configurable modes of operation\n"
+"  * Configurable password length parameters\n"
+"  * Configurable amount of generated passwords\n"
+"  * Ability to initialize RNG with user string\n"
+"  * Support for /dev/random\n"
+"  * Ability to crypt() generated passwords and print them as additional output.\n"
+"  * Special parameters to use APG in script\n"
+"  * Ability to log password generation requests for network version\n"
+"  * Ability to control APG service access using tcpd\n"
+"  * Ability to use password generation service from any type of box (Mac,\n"
+"    WinXX, etc.) that connected to network\n"
+"  * Ability to enforce remote users to use only allowed type of password\n"
+"    generation\n"
+" The client/server version of apg has been deliberately omitted.\n"
+" .\n"
+" Upstream URL: http://www.adel.nursat.kz/apg/download.shtml]]></programlisting>\n"
+"      </para>\n"
+"\n"
+"      <para>\n"
+"        <filename>debian/rules</filename>:\n"
+"          <programlisting><![CDATA[\n"
+"#!/usr/bin/make -f\n"
+"\n"
+"# to re-generate debian/control, invoke\n"
+"# fakeroot debian/rules debian/control DEB_AUTO_UPDATE_DEBIAN_CONTROL:=yes\n"
+"\n"
+"# automatic debian/control generation disabled, cdbs bug #311724.\n"
+"\n"
+"DEB_MAKE_CLEAN_TARGET    := clean\n"
+"DEB_MAKE_BUILD_TARGET    := standalone\n"
+"DEB_MAKE_INSTALL_TARGET  := install INSTALL_PREFIX=$(CURDIR)/debian/apg/usr\n"
+"\n"
+"include /usr/share/cdbs/1/rules/debhelper.mk\n"
+"include /usr/share/cdbs/1/rules/dpatch.mk\n"
+"include /usr/share/cdbs/1/class/makefile.mk\n"
+"\n"
+"cleanbuilddir/apg::\n"
+"\trm -f build-stamp configure-stamp php.tar.gz\n"
+"\n"
+"install/apg::\n"
+"\tmv $(CURDIR)/debian/apg/usr/bin/apg $(CURDIR)/debian/apg/usr/lib/apg/apg\n"
+"\ttar --create --gzip --file php.tar.gz --directory $(CURDIR)/php/apgonline/ .\n"
+"\tinstall -D --mode=0644 php.tar.gz $(CURDIR)/debian/apg/usr/share/doc/apg/php.tar.gz\n"
+"\trm php.tar.gz\n"
+"\tinstall -D --mode=0755 $(CURDIR)/debian/apg.wrapper $(CURDIR)/debian/apg/usr/bin/apg\n"
+"\tinstall -D --mode=0644 $(CURDIR)/debian/apg.conf $(CURDIR)/debian/apg/etc/apg.conf\n"
+"\n"
+"# bug #284231\n"
+"unpatch: deapply-dpatches]]></programlisting>\n"
+"\n"
+"       (Be advised that bug #284231 has been fixed in the meantime.)</para>\n"
+"    </sect1>\n"
+"\n"
+"    <sect1>\n"
+"      <title>Perl Examples</title>\n"
+"\n"
+"      <para>This example is from the package\n"
+"      <literal>libmidi-perl</literal>.  It builds a Perl\n"
+"      module.</para>\n"
+"\n"
+"      <para><filename>debian/control</filename>:\n"
+"<programlisting><![CDATA[\n"
+"Source: libmidi-perl\n"
+"Section: interpreters\n"
+"Priority: optional\n"
+"Build-Depends: cdbs (>= 0.4.4), debhelper (>= 4.1.0), perl (>= 5.8.0-7)\n"
+"Maintainer: Mario Lang <mlang at debian.org>\n"
+"Standards-Version: 3.5.10\n"
+"\n"
+"Package: libmidi-perl\n"
+"Architecture: all\n"
+"Depends: ${perl:Depends}\n"
+"Description: read, compose, modify, and write MIDI files in Perl\n"
+" This suite of Perl modules provides routines for reading, composing,\n"
+" modifying, and writing MIDI files.]]></programlisting>\n"
+"      </para>\n"
+"\n"
+"      <para><filename>debian/rules</filename>:\n"
+"<programlisting><![CDATA[\n"
+"#!/usr/bin/make -f\n"
+"\n"
+"include /usr/share/cdbs/1/rules/debhelper.mk\n"
+"include /usr/share/cdbs/1/class/perlmodule.mk]]></programlisting>\n"
+"      </para>\n"
+"\n"
+"      <para>This example is from the package\n"
+"      <literal>libgd-graph-perl</literal>.  It illustrates the\n"
+"      occasional need to set variables and add customized\n"
+"      rules.</para>\n"
+"\n"
+"      <para><filename>debian/control</filename>:\n"
+"<programlisting><![CDATA[\n"
+"Source: libgd-graph-perl\n"
+"Section: perl\n"
+"Priority: extra\n"
+"Maintainer: Jonas Smedegaard <dr at jones.dk>\n"
+"Standards-Version: 3.6.1\n"
+"Build-Depends-indep: cdbs, debhelper (>= 4.1), perl (>= 5.6.0-16), libgd-text-perl (>= 0.80), imagemagick, dh-buildinfo\n"
+"\n"
+"Package: libgd-graph-perl\n"
+"Architecture: all\n"
+"Depends: libgd-text-perl (>= 0.80)\n"
+"Description:  Graph Plotting Module for Perl 5\n"
+" GD::Graph is a perl5 module to create charts using the GD module.\n"
+" The following classes for graphs with axes are defined:\n"
+" .\n"
+" GD::Graph::lines - Create a line chart.\n"
+" GD::Graph::bars - Create a bar chart.\n"
+" GD::Graph::points - Create an chart, displaying the data as points.\n"
+" GD::Graph::linespoints - Combination of lines and points.\n"
+" GD::Graph::area - Create a graph, representing the data as areas under a\n"
+"     line.\n"
+" GD::Graph::mixed - Create a mixed type graph, any combination of the\n"
+"     above. At the moment this is fairly limited. Some of\n"
+"     the options that can be used with some of the\n"
+"     individual graph types won't work very well. Multiple\n"
+"     bar graphs in a mixed graph won't display very nicely.\n"
+" GD::Graph::pie - Create a pie chart.]]"
+msgstr ""
+
+# type: CDATA
+#: cdbs-doc.xml:2262
+#, no-wrap
+msgid ""
+"#!/usr/bin/make -f\n"
+"# -*- mode: makefile; coding: utf-8 -*-\n"
+"# Copyright ~~ 2003 Jonas Smedegaard <dr at jones.dk>\n"
+"\n"
+"# Put perlmodule.mk last to dh_clean temporary files not in MANIFEST\n"
+"include /usr/share/cdbs/1/rules/debhelper.mk\n"
+"include /usr/share/cdbs/1/class/perlmodule.mk\n"
+"\n"
+"DEB_INSTALL_EXAMPLES_libgd-graph-perl := samples Dustismo_Sans.ttf\n"
+"\n"
+"# Upstream says creating samples is a better test so do both\n"
+"DEB_MAKE_CHECK_TARGET := test samples\n"
+"\n"
+"# Clean explicitly, as upstream make target \"clean\" in samples is broken\n"
+"clean::\n"
+"\trm -f $(CURDIR)/samples/sample*.png $(CURDIR)/samples/sample*.gif $(CURDIR)/samples/logo.gif\n"
+"\n"
+"# Add build info\n"
+"common-binary-post-install-indep::\n"
+"\tdh_buildinfo]]"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><title>
+#: cdbs-doc.xml:2287
+msgid "Ant Example"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:2289
+msgid ""
+"This example is from the package <literal>jline</literal>.  Here you can see "
+"how to use the Ant class and set up rules that install the package in a "
+"policy-conforming way."
+msgstr ""
+
+# type: CDATA
+#: cdbs-doc.xml:2294
+#, no-wrap
+msgid ""
+"Source: jline\n"
+"Section: libs\n"
+"Priority: optional\n"
+"Maintainer: Debian Java Maintainers <pkg-java-maintainers at lists.alioth.debian.org>\n"
+"Uploaders: Peter Eisentraut <petere at debian.org>\n"
+"Build-Depends-Indep: cdbs (>= 0.4.36), debhelper (>= 5), kaffe, jikes, ant, junit\n"
+"Standards-Version: 3.6.2\n"
+"\n"
+"Package: libjline-java\n"
+"Section: libs\n"
+"Architecture: all\n"
+"Depends: kaffe | java2-runtime | java1-runtime\n"
+"Suggests: kaffe | java-virtual-machine, libjline-java-doc\n"
+"Description: Java library for handling console input\n"
+" JLine is a 100% pure Java library for reading and editing console input.\n"
+" It is similar in functionality to BSD editline and GNU readline.  People\n"
+" familiar with the readline/editline capabilities for modern shells will\n"
+" find most of the command editing features of JLine to be familiar.\n"
+" .\n"
+" Web site: http://jline.sourceforge.net/\n"
+"\n"
+"Package: libjline-java-doc\n"
+"Section: doc\n"
+"Architecture: all\n"
+"Suggests: libjline-java\n"
+"Description: documentation for JLine\n"
+" JLine is a 100% pure Java library for reading and editing console input.\n"
+" It is similar in functionality to BSD editline and GNU readline.  People\n"
+" familiar with the readline/editline capabilities for modern shells will\n"
+" find most of the command editing features of JLine to be familiar.\n"
+" .\n"
+" This package contains the documentation for JLine.\n"
+" .\n"
+" Web site: http://jline.sourceforge.net/\n"
+"]]"
+msgstr ""
+
+# type: Content of: <book><chapter><sect1><para>
+#: cdbs-doc.xml:2332
+msgid "<filename>debian/rules</filename>"
+msgstr ""
+
+# type: CDATA
+#: cdbs-doc.xml:2333
+#, no-wrap
+msgid ""
+"#!/usr/bin/make -f\n"
+"\n"
+"include /usr/share/cdbs/1/class/ant.mk\n"
+"include /usr/share/cdbs/1/rules/debhelper.mk\n"
+"include /usr/share/cdbs/1/rules/simple-patchsys.mk\n"
+"\n"
+"PACKAGE_VERSION := $(shell dpkg-parsechangelog | sed -n 's/^Version: \\(.*\\)-[^-]*$$/\\1/p')\n"
+"\n"
+"JAVA_HOME = /usr/lib/kaffe\n"
+"DEB_JARS = junit\n"
+"DEB_ANT_BUILD_TARGET = jars\n"
+"DEB_ANT_COMPILER = jikes\n"
+"\n"
+"DEB_INSTALL_DOCS_ALL =\n"
+"DEB_INSTALL_EXAMPLES_libjline-java-doc = release/jline-demo.jar\n"
+"\n"
+"\n"
+"install/libjline-java:: DEB_FINALDIR=$(CURDIR)/debian/libjline-java\n"
+"install/libjline-java::\n"
+"\tinstall -m 644 -D release/jline-0_9_5.jar $(DEB_FINALDIR)/usr/share/java/jline-$(PACKAGE_VERSION).jar\n"
+"\tdh_link /usr/share/java/jline-$(PACKAGE_VERSION).jar /usr/share/java/jline.jar\n"
+"\n"
+"\n"
+"clean::\n"
+"\trm -rf build/ release/ reports/ tmp/\n"
+"\trm -f VERSION.txt]]"
+msgstr ""
+
+# type: Content of: <book><chapter><title>
+#: cdbs-doc.xml:2365
+msgid "Conclusion"
+msgstr ""
+
+# type: Content of: <book><chapter><para>
+#: cdbs-doc.xml:2367
+msgid ""
+"CDBS solves most common problems in building Debian packages, and it is very "
+"pleasant to use.  More and more Debian packagers are using it, not because "
+"they are obliged to, but because they tasted and found it could improve "
+"their packages and avoid losing time on constantly reinventing silly and "
+"complicated rules."
+msgstr ""
+
+# type: Content of: <book><chapter><para>
+#: cdbs-doc.xml:2374
+msgid ""
+"CDBS is not perfect.  It is not yet capable of handling very complicated "
+"situations, like packages where multiple C or C++ builds with different "
+"options and/or patches are required, but this only affects a very small "
+"number of packages.  These limitations are planned to be solved in CDBS2, "
+"which is work in progress."
+msgstr ""
+
+# type: Content of: <book><chapter><para>
+#: cdbs-doc.xml:2380
+msgid ""
+"Using CDBS more widely would improve Debian's overall quality.  Don't "
+"hesitate trying it, talking to your friends about it, and contributing."
+msgstr ""
+
+# type: Content of: <book><chapter><para>
+#: cdbs-doc.xml:2384
+msgid "Have a lot of fun with CDBS !!! :-)"
+msgstr ""
+
+# type: Content of: <book><colophon><title>
+#: cdbs-doc.xml:2388
+msgid "Thanks"
+msgstr ""
+
+# type: Content of: <book><colophon><para>
+#: cdbs-doc.xml:2390
+msgid ""
+"This document was originally written by Marc Dequ?nes and Arnaud Patard with "
+"the following revision history:"
+msgstr ""
+
+# type: Content of: <book><colophon><para><revhistory><revision><revnumber>
+#: cdbs-doc.xml:2395
+msgid "0.1.0"
+msgstr ""
+
+# type: Content of: <book><colophon><para><revhistory><revision><date>
+#: cdbs-doc.xml:2396
+msgid "2005-04-03"
+msgstr ""
+
+# type: Content of: <book><colophon><para><revhistory><revision><revremark>
+#: cdbs-doc.xml:2397
+msgid "First Public Release (for CDBS V0.4.27-3)"
+msgstr ""
+
+# type: Content of: <book><colophon><para><revhistory><revision><revnumber>
+#: cdbs-doc.xml:2400
+msgid "0.1.1"
+msgstr ""
+
+# type: Content of: <book><colophon><para><revhistory><revision><date>
+#: cdbs-doc.xml:2401
+msgid "2005-06-07"
+msgstr ""
+
+# type: Content of: <book><colophon><para><revhistory><revision><revremark>
+#: cdbs-doc.xml:2402
+msgid ""
+"Updated for CDBS V0.4.30 (perl class build dependency management, cdbs-edit-"
+"patch script)"
+msgstr ""
+
+# type: Content of: <book><colophon><para><revhistory><revision><revnumber>
+#: cdbs-doc.xml:2405
+msgid "0.1.2"
+msgstr ""
+
+# type: Content of: <book><colophon><para><revhistory><revision><date>
+#: cdbs-doc.xml:2406
+msgid "2005-07-05"
+msgstr ""
+
+# type: Content of: <book><colophon><para><revhistory><revision><revremark>
+#: cdbs-doc.xml:2407
+msgid "Added DEB_CONFIGURE_SCRIPT_ENV usage warning, fixed typo."
+msgstr ""
+
+# type: Content of: <book><colophon><para>
+#: cdbs-doc.xml:2412
+msgid ""
+"Thanks to Jeff Bailey for his patience and for replying to so many questions."
+msgstr ""
+
+# type: Content of: <book><colophon><para>
+#: cdbs-doc.xml:2415
+msgid "Special thanks to GuiHome for helping by reviewing this documentation."
+msgstr ""
+
+# type: Content of: <book><colophon><para>
+#: cdbs-doc.xml:2418
+msgid ""
+"This document is a <ulink url=\"http://docbook.org/\">DocBook</ulink> "
+"application, checked using xmllint (from <ulink url=\"http://www.xmlsoft.org/"
+"\">libxml2</ulink>), produced using xsltproc (from <ulink url=\"http://"
+"xmlsoft.org/XSLT/\">libxslt</ulink>), using the <ulink url=\"http://nwalsh."
+"com/\">N. Walsh</ulink> and <ulink url=\"http://dblatex.sourceforge.net/"
+"\">dblatex</ulink> XLST stylesheets, and converted with <ulink url=\"http://"
+"www.latex-project.org/\">LaTeX</ulink> tools (latex, mkindex, pdflatex &amp; "
+"dvips) / <ulink url=\"http://research.compaq.com/SRC/virtualpaper/pstotext."
+"html\">pstotext</ulink> (with <ulink url=\"http://www.cs.wisc.edu/~ghost/"
+"\">GS</ulink>)."
+msgstr ""