maint-guide 1.2.52 - en to de translation catalogue (1015 entries)

note: type: Attribute 'lang' of: <book>
en: en
de: de

note: type: Content of: <book><title>
en: Debian New Maintainers' Guide
de: Debian-Leitfaden für Neue Paketbetreuer

note: type: Content of: <book><bookinfo><authorgroup><author><contrib>
en: original contents
de: Ursprüngliche Inhalte

note: type: Content of: <book><bookinfo><authorgroup><author><contrib>
en: updated contents
de: Aktualisierte Inhalte

note: type: Content of: <book><bookinfo><releaseinfo>
en: version &docversion;
de: Version &docversion;

note: type: Content of: <book><bookinfo><legalnotice><para>
en: This document may be used under the terms of the GNU General Public License version 2 or higher.
de: Dieses Dokument darf gemäß der Bedingungen der GNU General Public License Version 2 oder neuer verwendet werden.

note: type: Content of: <book><bookinfo><legalnotice><para>
en: This document was made using these two documents as examples:
de: Diesem Dokument liegen die Beispiele der folgenden zwei Dokumente zu Grunde:

note: type: Content of: <book><bookinfo><legalnotice><itemizedlist><listitem><para>
en: Making a Debian Package (AKA the Debmake Manual), copyright © 1997 Jaldhar Vyas.
de: Making a Debian Package (AKA the Debmake Manual), Copyright © 1997 Jaldhar Vyas.

note: type: Content of: <book><bookinfo><legalnotice><itemizedlist><listitem><para>
en: The New-Maintainer's Debian Packaging Howto, copyright © 1997 Will Lowe.
de: The New-Maintainer's Debian Packaging Howto, Copyright © 1997 Will Lowe.

note: type: Content of: <book><bookinfo><legalnotice><itemizedlist><listitem><para>
en: The rewrite of this tutorial document with updated contents and more practical examples is available as "Guide for Debian Maintainers".  Please use this new tutorial as the primary tutorial document.
de: Die Überarbeitung dieser Anleitung mit aktualisierten Inhalten und weiteren praktischen Beispielen ist unter »Guide for Debian Maintainers« verfügbar. Bitte verwenden Sie diese neue Anleitung als primäre Anleitung.

note: type: Content of: <book><chapter><title>
en: Getting started The Right Way
de: Einstieg, aber richtig!

note: type: Content of: <book><appendix><para>
en: The rewrite of this tutorial document with updated contents and more practical examples is available as <ulink url="&guidedeb;">Guide for Debian Maintainers</ulink>.  Please use this new tutorial as the primary tutorial document.
de: Die Überarbeitung dieser Anleitung mit aktualisierten Inhalten und weiteren praktischen Beispielen ist unter <ulink url="&guidedeb;">Guide for Debian Maintainers</ulink> verfügbar. Bitte verwenden Sie diese neue Anleitung als primäre Anleitung.

note: type: Content of: <book><chapter><para>
en: This document tries to describe the building of a Debian package to ordinary Debian users and prospective developers.  It uses fairly non-technical language, and it's well covered with working examples.  There is an old Latin saying: <emphasis>Longum iter est per praecepta, breve et efficax per exempla</emphasis> (It's a long way by the rules, but short and efficient with examples).
de: Dieses Dokument versucht, einem typischen Debian-Benutzer und zukünftigen Entwickler in einer verständlichen Sprache die Technik der Paketerstellung für Debian beizubringen, begleitet von funktionierenden Beispielen. Ein altes lateinisches Sprichwort lautet: <emphasis>Longum iter est per praecepta, breve et efficax per exempla!</emphasis> (Es ist ein langer Weg mit Regeln, aber ein kurzer und effizienter mit Beispielen!)

note: type: Content of: <book><chapter><para><footnote><para>
en: The document assumes you are using a <literal>&base-release;</literal> or newer system.  If you need to follow this text in an older system (including an older Ubuntu system etc.), you must install backported <systemitem role="package">dpkg</systemitem> and <systemitem role="package">debhelper</systemitem> packages, at least.
de: In diesem Dokument wird davon ausgegangen, dass Sie ein <literal>&Base-release;</literal>-System oder ein neueres System verwenden. Wenn Sie diesen Text auf einem älteren System (auch einem älteren Ubuntu-System o.ä.) lesen, müssen Sie mindestens die zurückportierten Pakete <systemitem role="package">dpkg</systemitem> und <systemitem role="package">debhelper</systemitem> installieren.

note: type: Content of: <book><chapter><para>
en: This document is made available for the Debian <literal>Buster</literal> release since this offers many translations.  This document will be dropped in the following releases since contents are getting outdated.  <placeholder type="footnote" id="0"/>
de: Dieses Dokument wird für die Debian-Veröffentlichung <literal>Buster</literal> bereitgestellt, da sie viele Übersetzungen enthält. Sie wird aber in den nachfolgenden Veröffentlichungen entfernt, da die Inhalte zunehmend veralten. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><para><footnote><para>
en: You can learn about the basic handling of a Debian system from the <ulink url="&debref;">Debian Reference</ulink>.  It contains some pointers to learn about Unix programming, too.
de: Sie können aus der <ulink url="&debref;">Debian-Referenz</ulink> den grundlegenden Umgang mit einem Debian-System lernen. Sie enthält auch einige Hinweise, um etwas über Unix-Programmierung zu lernen.

note: type: Content of: <book><chapter><para>
en: One of the things that makes Debian such a top-notch distribution is its package system.  While there is a vast quantity of software already in the Debian format, sometimes you need to install software that isn't.  You may be wondering how you can make your own packages; and perhaps you think it is a very difficult task.  Well, if you are a real novice on Linux, it is hard, but if you were a rookie, you wouldn't be reading this document now&nbsp;:-)  You do need to know a little about Unix programming but you certainly don't need to be a wizard.  <placeholder type="footnote" id="0"/>
de: Eines der Dinge, die Debian zu einer hervorragenden Distribution machen, ist das Paket-System. Obwohl massenhaft Software im Debian-Format vorhanden ist, muss man manchmal auch Software installieren, die nicht in diesem Format vorliegt. Sie fragen sich vermutlich, wie man eigene Pakete erstellt und vielleicht meinen Sie, es sei eine sehr komplizierte Aufgabe. Nun, wenn Sie ein absoluter Linux-Neuling sind, dann ist es wirklich schwierig, aber als Anfänger würden Sie dieses Dokument jetzt nicht lesen. :-) Sie sollten schon ein wenig Kenntnisse über die Unix-Programmierung mitbringen, aber Sie brauchen ganz sicher kein Guru zu sein. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><para>
en: One thing is certain, though: to properly create and maintain Debian packages takes many hours.  Make no mistake, for our system to work the maintainers need to be both technically competent and diligent.
de: Eines ist wohl sicher: um Debian-Pakete richtig zu bauen und zu warten, brauchen Sie viel Zeit. Schätzen Sie das nicht falsch ein; damit unser System funktioniert, muss der Betreuer sowohl technisch kompetent sein als auch fleißig und sorgfältig arbeiten.

note: type: Content of: <book><chapter><para>
en: If you need some help with packaging, please read <xref linkend="helpme"/>.
de: Falls Sie Hilfe beim Erstellen des Pakets brauchen, lesen Sie bitte <xref linkend="helpme"/>.

note: type: Content of: <book><chapter><para>
en: Newer versions of this document should always be available online at <ulink url="&maint-guide;"/> and in the <systemitem role="package">maint-guide</systemitem> package.  The translations may be available in packages such as <systemitem role="package">maint-guide-es</systemitem>.  Please note that this documentation may be slightly outdated.
de: Neuere Versionen dieses Dokuments sollten immer online über <ulink url="&maint-guide;"/> und in dem Paket <systemitem role="package">maint-guide</systemitem> zu finden sein. Die Übersetzungen sind in Paketen wie beispielsweise <systemitem role="package">maint-guide-es</systemitem> verfügbar. Bitte beachten Sie, dass diese Dokumentation etwas veraltet sein kann.

note: type: Content of: <book><chapter><para>
en: Since this is a tutorial, I choose to explain each detailed step for some important topics.  Some of them may look irrelevant to you.  Please be patient.  I have also intentionally skipped some corner cases and provided only pointers to keep this document simple.
de: Da dies eine Anleitung ist, wird bei wichtigen Themen jeder Schritt im Detail erklärt. Teile davon mögen Ihnen irrelevant vorkommen. Haben Sie Geduld! Einige seltene Fälle werden übersprungen und stattdessen werden nur Verweise geliefert, um dieses Dokument nicht zu kompliziert werden zu lassen.

note: type: Content of: <book><chapter><section><title>
en: Social dynamics of Debian
de: Soziale Dynamik von Debian

note: type: Content of: <book><chapter><section><para>
en: Here are some observations of Debian's social dynamics, presented in the hope that it will prepare you for interactions with Debian:
de: Es folgen einige Beobachtungen über Debians soziale Dynamik. Die Darstellung ist mit der Hoffnung verbunden, dass es Sie für Ihre Arbeit mit Debian vorbereiten wird.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: We all are volunteers.
de: Wir sind alle Freiwillige.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You cannot impose on others what to do.
de: Sie können anderen nicht vorgeben, was getan werden soll.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You should be motivated to do things by yourself.
de: Sie sollten sich selbst für Ihre Tätigkeit motivieren.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Friendly cooperation is the driving force.
de: Freundliche Zusammenarbeit ist die Triebfeder.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Your contribution should not overstrain others.
de: Ihr Beitrag sollte andere nicht zu sehr belasten.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Your contribution is valuable only when others appreciate it.
de: Ihr Beitrag ist nur wertvoll, wenn andere ihn würdigen.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Debian is not your school where you get automatic attention of teachers.
de: Debian ist keine Schulklasse, in der Sie automatisch vom Lehrer Aufmerksamkeit bekommen.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You should be able to learn many things by yourself.
de: Sie sollten in der Lage sein, viele Sachen selbst zu lernen.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Attention from other volunteers is a very scarce resource.
de: Aufmerksamkeit von anderen Freiwilligen ist eine sehr knappe Ressource.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Debian is constantly improving.
de: Debian verbessert sich ständig.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You are expected to make high quality packages.
de: Es wird von Ihnen erwartet, hochqualitative Pakete zu erstellen.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You should adapt yourself to change.
de: Sie sollten sich an Änderungen selbst anpassen.

note: type: Content of: <book><chapter><section><para>
en: There are several types of people interacting around Debian with different roles:
de: Es gibt mehrere Arten von Personen, die innerhalb von Debian mit verschiedenen Rollen zusammenarbeiten:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">upstream author</emphasis>: the person who made the original program.
de: <emphasis role="strong">Ursprünglicher Autor (»upstream author«)</emphasis>: Die Person, die das ursprüngliche Programm geschrieben hat.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">upstream maintainer</emphasis>: the person who currently maintains the program.
de: <emphasis role="strong">Betreuer des Originalprogramms (»upstream maintainer«)</emphasis>: Die Person, die das Programm zurzeit betreut.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">maintainer</emphasis>: the person making the Debian package of the program.
de: <emphasis role="strong">Betreuer (»maintainer«)</emphasis>: Die Person, die ein Debian-Paket des Programms erstellt oder betreut.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">sponsor</emphasis>: a person who helps maintainers to upload packages to the official Debian package archive (after checking their contents).
de: <emphasis role="strong">Sponsor</emphasis>: Eine Person, die Betreuern hilft, Pakete in das offizielle Debian-Paketarchiv hochzuladen (nachdem sie den Inhalt überprüft hat).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">mentor</emphasis>: a person who helps novice maintainers with packaging etc.
de: <emphasis role="strong">Mentor</emphasis>: Eine Person, die neuen Betreuern beim Paketieren usw. hilft.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">Debian Developer</emphasis> (DD): a member of the Debian project with full upload rights to the official Debian package archive.
de: <emphasis role="strong">Debian-Entwickler (»Debian Developer«, DD)</emphasis>: Ein Mitglied des Debian-Projekts mit unbeschränkten Rechten, Pakete in das offizielle Debian-Paketarchiv hochzuladen.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">Debian Maintainer</emphasis> (DM): a person with limited upload rights to the official Debian package archive.
de: <emphasis role="strong">Debian-Betreuer (»Debian Maintainer«, DM)</emphasis>: Eine Person, die beschränkte Rechte hat, Pakete in das offizielle Debian-Paketarchiv hochzuladen.

note: type: Content of: <book><chapter><section><para>
en: Please note that you cannot become an official <emphasis role="strong">Debian Developer</emphasis> (DD) overnight, because it takes more than technical skill.  Please do not be discouraged by this.  If it is useful to others, you can still upload your package either as a <emphasis role="strong">maintainer</emphasis> through a <emphasis role="strong">sponsor</emphasis> or as a <emphasis role="strong">Debian Maintainer</emphasis>.
de: Bitte beachten Sie, dass Sie nicht über Nacht offizieller <emphasis role="strong">Debian-Entwickler</emphasis> (»Debian Developer«, DD) werden können, weil es dafür mehr als nur technische Fähigkeiten braucht. Bitte lassen Sie sich davon nicht entmutigen. Wenn Ihr Paket für andere nützlich ist, können Sie es entweder als <emphasis role="strong">Betreuer</emphasis> über einen <emphasis role="strong">Sponsor</emphasis> oder als <emphasis role="strong">Debian-Betreuer</emphasis> trotzdem hochladen.

note: type: Content of: <book><chapter><section><para>
en: Please note that you do not need to create any new package to become an official Debian Developer.  Contributing to the existing packages can provide a path to becoming an official Debian Developer too.  There are many packages waiting for good maintainers (see <xref linkend="choose"/>).
de: Bitte beachten Sie, dass Sie kein neues Paket erstellen müssen, um offizieller Debian-Entwickler zu werden. Auch Beiträge zu existierenden Paketen können ein Weg sein, offizieller Debian-Entwickler zu werden. Es gibt viele Pakete, die auf einen guten Betreuer warten (siehe <xref linkend="choose"/>).

note: type: Content of: <book><chapter><section><para>
en: Since we focus only on technical aspects of packaging in this document, please refer to the following to learn how Debian functions and how you can get involved:
de: Da in diesem Dokument nur auf technische Aspekte der Paketierung fokussiert wird, lesen Sie bitte die folgenden Texte, um zu erfahren, wie Debian funktioniert und wie Sie daran mitarbeiten können:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&logiciellibre;">Debian: 17 years of Free Software, "do-ocracy", and democracy</ulink> (Introductory slides)
de: <ulink url="&logiciellibre;">Debian: 17 years of Free Software, "do-ocracy", and democracy</ulink> (einführenden Folien)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&debianorghelp;">How can you help Debian?</ulink> (official)
de: <ulink url="&debianorghelp;">Wie können Sie Debian helfen?</ulink> (offiziell)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&debianfaqhelp;">The Debian GNU/Linux FAQ, Chapter 13 - "Contributing to the Debian Project"</ulink> (semi-official)
de: <ulink url="https://www.debian.org/doc/manuals/debian-faq/contributing.de.html">Die Debian GNU/Linux-FAQ, Kapitel 13 - »Zum Debian-Projekt beitragen«</ulink> (semi-offiziell)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&debianwikihelp;">Debian Wiki, HelpDebian</ulink> (supplemental)
de: <ulink url="&debianwikihelp;">Debian Wiki, HelpDebian</ulink> (ergänzend)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&nm-do;">Debian New Member site</ulink> (official)
de: <ulink url="&nm-do;">Debian New Member site</ulink> (offiziell)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&debianmentorfaq;">Debian Mentors FAQ</ulink> (supplemental)
de: <ulink url="&debianmentorfaq;">Debian Mentors FAQ</ulink> (ergänzend)

note: type: Content of: <book><chapter><section><title>
en: Programs needed for development
de: Programme, die zum Entwickeln notwendig sind

note: type: Content of: <book><chapter><section><para>
en: Before you start anything, you should make sure that you have properly installed some additional packages needed for development.  Note that the list doesn't contain any packages marked <literal>essential</literal> or <literal>required</literal> - we expect that you have those installed already.
de: Bevor Sie loslegen können, müssen Sie sicherstellen, dass einige zusätzliche Pakete richtig installiert sind, die für die Entwicklung benötigt werden. Beachten Sie, dass die Liste keine Pakete enthält, die als <literal>essential</literal> oder <literal>required</literal> markiert sind - wir gehen davon aus, dass Sie diese schon installiert haben.

note: type: Content of: <book><chapter><section><para>
en: The following packages come with the standard Debian installation, so you probably have them already (along with any additional packages they depend on).  Still, you should check them with <literal>aptitude show <replaceable>package</replaceable></literal> or with <literal>dpkg -s <replaceable>package</replaceable></literal>.
de: Die folgenden Pakete sind in der Standardinstallation von Debian enthalten, also werden Sie sie vermutlich schon haben (und zusätzliche Pakete, von denen diese abhängen). Sie sollten diese dennoch mit <literal>aptitude show <replaceable>Paket</replaceable></literal> oder <literal>dpkg -s <replaceable>Paket</replaceable></literal> überprüfen.

note: type: Content of: <book><chapter><section><para>
en: The most important package to install on your development system is the <systemitem role="package">build-essential</systemitem> package.  Once you try to install that, it will <emphasis>pull in</emphasis> other packages required to have a basic build environment.
de: Das wichtigste Paket, dass auf Ihrem Entwicklungssystem installiert werden sollte, ist das Paket <systemitem role="package">build-essential</systemitem>. Wenn Sie es installieren, wird es andere Pakete <emphasis>hinterherziehen (»pull in«)</emphasis>, die für eine grundlegende Build-Umgebung notwendig sind.

note: type: Content of: <book><chapter><section><para>
en: For some types of packages, that is all you will require; however, there is another set of packages that while not essential for all package builds are useful to have installed or may be required by your package:
de: Für manche Arten von Paketen ist das alles, was Sie benötigen. Es gibt allerdings noch eine weitere Sammlung von Paketen, die - obwohl sie nicht essenziell für jede Paketerstellung sind - sinnvoll installiert werden können oder sogar von Ihrem Paket benötigt werden:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">autoconf</systemitem>, <systemitem role="package">automake</systemitem>, and <systemitem role="package">autotools-dev</systemitem> - many newer programs use configure scripts and <filename>Makefile</filename> files preprocessed with the help of programs like these (see <literal>info autoconf</literal>, <literal>info automake</literal>).  <systemitem role="package">autotools-dev</systemitem> keeps up-to-date versions of certain auto files and has documentation about the best way to use those files.
de: <systemitem role="package">autoconf</systemitem>, <systemitem role="package">automake</systemitem> und <systemitem role="package">autotools-dev</systemitem> - Viele neuere Programme benutzen configure-Skripte und <filename>Makefile</filename>-Dateien, die mit Hilfe dieser Programme vorproduziert wurden (siehe »<literal>info autoconf</literal>«, »<literal>info automake</literal>«). Das Paket <systemitem role="package">autotools-dev</systemitem> enthält aktuelle Versionen von bestimmten auto-Dateien sowie Informationen über die beste Art und Weise, diese Dateien zu verwenden.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para><footnote><para>
en: There are also some more specialized but similar packages such as <systemitem role="package">dh-make-perl</systemitem>, <systemitem role="package">dh-make-php</systemitem>, etc.
de: Es gibt auch einige spezialisierte aber ähnliche Pakete wie <systemitem role="package">dh-make-perl</systemitem>, <systemitem role="package">dh-make-php</systemitem> usw.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">debhelper</systemitem> and <systemitem role="package">dh-make</systemitem> - <systemitem role="package">dh-make</systemitem> is necessary to create the skeleton of our example package, and it will use some of the <systemitem role="package">debhelper</systemitem> tools for creating packages.  They are not essential for this purpose, but are <emphasis>highly</emphasis> recommended for new maintainers.  It makes the whole process very much easier to start, and to control afterwards.  (See <citerefentry> <refentrytitle>dh_make</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>debhelper</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.) <placeholder type="footnote" id="0"/>
de: <systemitem role="package">dh-make</systemitem> und <systemitem role="package">debhelper</systemitem> - <systemitem role="package">dh-make</systemitem> wird benötigt, um ein Gerüst unseres Beispielpakets zu erstellen. Es verwendet einige der <systemitem role="package">debhelper</systemitem>-Werkzeuge für die Paketerstellung. Sie sind nicht zwingend erforderlich, um Pakete zu erstellen, aber für neue Betreuer <emphasis>sehr</emphasis> empfohlen. Sie vereinfachen den Einstieg in den ganzen Prozess sehr, ebenso die spätere Kontrolle (siehe <citerefentry> <refentrytitle>dh_make</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>debhelper</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <filename>/usr/share/doc/debhelper/README</filename>). <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The new <systemitem role="package">debmake</systemitem> may be used as the alternative to the standard <systemitem role="package">dh-make</systemitem>.  It does more and comes with HTML documentation with extensive packaging examples in <systemitem role="package">debmake-doc</systemitem>.
de: Das neue <systemitem role="package">debmake</systemitem> kann als Alternative zum Standard <systemitem role="package">dh-make</systemitem> verwendet werden. Es enthält mehr Funktionalitäten und außerdem HTML-Dokumentation mit ausführlichen Paketierungsbeispielen (im Paket <systemitem role="package">debmake-doc</systemitem>).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">devscripts</systemitem> - this package contains some useful scripts that can be helpful for maintainers, but they are also not necessary for building packages.  Packages recommended and suggested by this package are worth looking into.  (See <filename>&devscripts-readme;</filename>.)
de: <systemitem role="package">devscripts</systemitem> - Dieses Paket enthält einige nützliche Skripte, die für die Betreuer hilfreich sein können, aber nicht zum Bauen der Pakete benötigt werden. Die von diesem Paket empfohlenen und vorgeschlagenen Pakete sind ebenfalls einen Blick wert (siehe <filename>&devscripts-readme;</filename>).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">fakeroot</systemitem> - this utility lets you emulate being root, which is necessary for some parts of the build process.  (See <citerefentry> <refentrytitle>fakeroot</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
de: <systemitem role="package">fakeroot</systemitem> - Dieses Hilfsprogramm ermöglicht Ihnen, die Identität von »root« vorzutäuschen, was für einige Teile des Build-Prozesses benötigt wird (siehe <citerefentry> <refentrytitle>fakeroot</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">file</systemitem> - this handy program can determine what type a file is.  (See <citerefentry> <refentrytitle>file</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
de: <systemitem role="package">file</systemitem> - Dieses nützliche Programm kann den Typ einer Datei feststellen (siehe <citerefentry> <refentrytitle>file</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">gfortran</systemitem> - the GNU Fortran 95 compiler, necessary if your program is written in Fortran.  (See <citerefentry> <refentrytitle>gfortran</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
de: <systemitem role="package">gfortran</systemitem> - Der GNU-Fortran-95-Compiler wird benötigt, wenn Ihr Programm in Fortran geschrieben ist (siehe <citerefentry> <refentrytitle>gfortran</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">git</systemitem> - this package provides a popular version control system designed to handle very large projects with speed and efficiency; it is used for many high profile open source projects, most notably the Linux kernel.  (See <citerefentry> <refentrytitle>git</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, git Manual (<filename>&git-doc;</filename>).)
de: <systemitem role="package">git</systemitem> - Dieses Paket stellt ein beliebtes Versionskontrollsystem zur Verfügung, das dafür entworfen wurde, bei sehr großen Projekten schnell und effizient zu arbeiten. Es wird in vielen hoch angesehenen Open-Source-Projekten eingesetzt, beispielsweise beim Linux-Kernel (siehe <citerefentry> <refentrytitle>git</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, Git-Handbuch (<filename>&git-doc;</filename>)).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">gnupg</systemitem> - a tool that enables you to digitally <emphasis>sign</emphasis> packages.  This is especially important if you want to distribute packages to other people, and you will certainly be doing that when your work gets included in the Debian distribution.  (See <citerefentry> <refentrytitle>gpg</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
de: <systemitem role="package">gnupg</systemitem> - Ein Werkzeug, mit dem Sie Pakete digital <emphasis>unterschreiben</emphasis> können. Dies ist besonders wichtig, wenn Sie Pakete an andere Leute verteilen wollen und das werden Sie sicher, wenn Ihre Arbeit in die Debian-Distribution aufgenommen wird (siehe <citerefentry> <refentrytitle>gpg</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">gpc</systemitem> - the GNU Pascal compiler, necessary if your program is written in Pascal.  Worthy of note here is <systemitem role="package">fp-compiler</systemitem>, the Free Pascal Compiler, which is also good at this task.  (See <citerefentry> <refentrytitle>gpc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>ppc386</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
de: <systemitem role="package">gpc</systemitem> - Der GNU-Pascal-Compiler wird benötigt, wenn Ihr Programm in Pascal geschrieben ist. Erwähnenswert ist an dieser Stelle der »Free Pascal Compiler« <systemitem role="package">fp-compiler</systemitem>, der sich dafür ebenfalls gut eignet (siehe <citerefentry> <refentrytitle>gpc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>ppc386</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">lintian</systemitem> - this is the Debian package checker, which lets you know of any common mistakes after you build the package and explains the errors found.  (See <citerefentry> <refentrytitle>lintian</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <ulink url="&lintian-doc;">Lintian User's Manual</ulink>.)
de: <systemitem role="package">lintian</systemitem> - Das ist Debians Paket-Prüfer, der Sie nach der Paketerstellung über häufige Fehler informiert und die gefundenen Fehler erklärt (siehe <citerefentry> <refentrytitle>lintian</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <ulink url="&lintian-doc;">Lintians Benutzerhandbuch</ulink>).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">patch</systemitem> - this very useful utility will take a file containing a difference listing (produced by the <command>diff</command> program) and apply it to the original file, producing a patched version.  (See <citerefentry> <refentrytitle>patch</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
de: <systemitem role="package">patch</systemitem> - Ein sehr nützliches Programm, das eine Datei mit einer Auflistung der Unterschiede im Dateiinhalt (erstellt mit dem Programm <command>diff</command>) auf die ursprüngliche Datei anwendet und daraus die neue Version erzeugt (siehe <citerefentry> <refentrytitle>patch</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">patchutils</systemitem> - this package contains some utilities to work with patches such as the <command>lsdiff</command>, <command>interdiff</command> and <command>filterdiff</command> commands.
de: <systemitem role="package">patchutils</systemitem> - Dieses Paket enthält einige Hilfsprogramme, um mit Patches zu arbeiten, beispielsweise die Befehle <command>lsdiff</command>, <command>interdiff</command> und <command>filterdiff</command>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">pbuilder</systemitem> - this package contains programs which are used for creating and maintaining a <command>chroot</command> environment.  Building a Debian package in this <command>chroot</command> environment verifies the proper build dependency and avoids FTBFS (Fails To Build From Source) bugs.  (see <citerefentry> <refentrytitle>pbuilder</refentrytitle> <manvolnum>8</manvolnum> </citerefentry> and <citerefentry> <refentrytitle>pdebuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>)
de: <systemitem role="package">pbuilder</systemitem> - Dieses Paket enthält Programme, um eine <command>chroot</command>-Umgebung aufzubauen und zu betreuen. Beim Bauen eines Debian-Pakets in dieser <command>chroot</command>-Umgebung wird geprüft, ob die Build-Abhängigkeiten stimmen, wodurch FTBFS-Fehler (»Fails To Build From Source«, kann nicht aus den Quellen gebaut werden) verhindert werden (siehe <citerefentry> <refentrytitle>pbuilder</refentrytitle> <manvolnum>8</manvolnum> </citerefentry> und <citerefentry> <refentrytitle>pdebuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">perl</systemitem> - Perl is one of the most used interpreted scripting languages on today's Unix-like systems, often referred to as Unix's Swiss Army Chainsaw. (See <citerefentry> <refentrytitle>perl</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
de: <systemitem role="package">perl</systemitem> - Perl ist eine der am meisten gebrauchten interpretierten Skriptsprachen auf heutigen Unix-ähnlichen Systemen, oft bezeichnet als »Unix' Schweizer Offizierskettensäge« (siehe <citerefentry> <refentrytitle>perl</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">python</systemitem> - Python is another of the most used interpreted scripting languages on the Debian system, combining remarkable power with very clear syntax. (See <citerefentry> <refentrytitle>python</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
de: <systemitem role="package">python</systemitem> - Python ist eine weitere der am meisten gebrauchten interpretierten Skriptsprachen auf Debian-Systemen, die bemerkenswerte Stärke mit einer sehr klaren Syntax kombiniert (siehe <citerefentry> <refentrytitle>python</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">quilt</systemitem> - this package helps you to manage large numbers of patches by keeping track of the changes each patch makes. Patches can be applied, un-applied, refreshed, and more.  (See <citerefentry> <refentrytitle>quilt</refentrytitle> <manvolnum>1</manvolnum></citerefentry>, and <filename>&quilt-pdf;</filename>.)
de: <systemitem role="package">quilt</systemitem> - Dieses Paket hilft Ihnen dabei, eine große Anzahl von Patches zu verwalten, indem es die Änderungen verfolgt, die jeder Patch vornimmt. Patches können angewandt, entfernt und erneuert werden sowie vieles mehr. (Lesen Sie <citerefentry> <refentrytitle>quilt</refentrytitle> <manvolnum>1</manvolnum></citerefentry> und <filename>&quilt-pdf;</filename>).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">xutils-dev</systemitem> - some programs, usually those made for X11, also use these programs to generate <filename>Makefile</filename> files from sets of macro functions.  (See <citerefentry> <refentrytitle>imake</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>xmkmf</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
de: <systemitem role="package">xutils-dev</systemitem> - Einige Programme, üblicherweise die für X11 erstellten, benutzen diese Programme zum Erzeugen von <filename>Makefile</filename>-Dateien aus einer Gruppe von Makro-Funktionen (siehe <citerefentry> <refentrytitle>imake</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>xmkmf</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>).

note: type: Content of: <book><chapter><section><para>
en: The short descriptions that are given above only serve to introduce you to what each package does.  Before continuing please read the documentation of each relevant program including ones installed through the package dependency such as <command>make</command>, at least, for the standard usage.  It may seem like heavy going now, but later on you'll be <emphasis>very</emphasis> glad you read it.  If you have specific questions later, I would suggest re-reading the documents mentioned above.
de: Die kurzen Erklärungen oben dienen nur dazu, Ihnen eine Einführung in die verschiedenen Pakete zu geben. Bevor Sie weitermachen, lesen Sie bitte die Dokumentation jedes relevanten Programms, auch die, die als Abhängigkeiten installiert wurden wie <command>make</command>, zumindest was die normale Arbeitsweise angeht. Das mag Ihnen am Anfang überflüssig vorkommen, aber schon bald werden Sie <emphasis>sehr</emphasis> froh darüber sein, sich schon vorher informiert zu haben. Falls Sie später gezielte Fragen haben, wird empfohlen, die oben erwähnten Dokumente erneut zu lesen.

note: type: Content of: <book><chapter><section><title>
en: Documentation needed for development
de: Dokumentation, die zum Entwickeln gebraucht wird

note: type: Content of: <book><chapter><section><para>
en: The following is the <emphasis>very important</emphasis> documentation which you should read along with this document:
de: Es folgen <emphasis>sehr wichtige</emphasis> Dokumente, die Sie neben diesem Dokument auch lesen sollten:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">debian-policy</systemitem> - the <ulink url="&debian-policy;">Debian Policy Manual</ulink> includes explanations of the structure and contents of the Debian archive, several OS design issues, the <ulink url="&fhs;">Filesystem Hierarchy Standard</ulink> (FHS, which says where each file and directory should be), etc.  For you, the most important thing is that it describes requirements that each package must satisfy to be included in the distribution. (See the local copies of <filename>&policy-pdf;</filename> and <filename>&fhs-pdf;</filename>.)
de: <systemitem role="package">debian-policy</systemitem> - Das <ulink url="&debian-policy;">Debian Policy Manual</ulink> (Debian-Richtlinien-Handbuch) beinhaltet Beschreibungen der Struktur und des Inhalts des Debian-Archivs, mehrere Besonderheiten des Betriebssystemdesigns, den »<ulink url="&fhs;">Filesystem Hierarchy Standard</ulink>« (der beschreibt, wo jede Datei und jedes Verzeichnis sein sollte) usw. Das Wichtigste für Sie ist, dass es die Anforderungen beschreibt, die ein Paket erfüllen muss, um in die Distribution aufgenommen zu werden (lesen Sie die lokalen Kopien <filename>&policy-pdf;</filename> und <filename>&fhs-pdf;</filename>).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">developers-reference</systemitem> - the <ulink url="&developers-reference;">Debian Developer's Reference</ulink> describes all matters not specifically about the technical details of packaging, like the structure of the archive, how to rename, orphan, or adopt packages, how to do NMUs, how to manage bugs, best packaging practices, when and where to upload, etc.  (See the local copy of <filename>&developers-refpdf;</filename>.)
de: <systemitem role="package">developers-reference</systemitem> - Die <ulink url="&developers-reference;">Debian-Entwicklerreferenz</ulink> beschreibt alle Dinge, die nicht speziell die technischen Details der Paketerstellung betreffen, beispielsweise die Struktur des Archivs, wie man Pakete umbenennt, aufgibt, adoptiert, NMUs durchführt, Fehler verwaltet, gute Pakete erstellt, wie und wo man ins Archiv hochlädt usw. (lesen Sie die lokale Kopie <filename>&developers-refpdf;</filename>).

note: type: Content of: <book><chapter><section><para>
en: The following is the <emphasis>important</emphasis> documentation which you should read along with this document:
de: Hier einige <emphasis>wichtige</emphasis> Dokumente, die Sie zusätzlich zu diesem Dokument auch lesen sollten:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&autotools-tutorial;">Autotools Tutorial</ulink> provides a very good tutorial for <ulink url="&gnu-build-system;">the GNU Build System known as the GNU Autotools</ulink>, whose most important components are Autoconf, Automake, Libtool, and gettext.
de: Das <ulink url="&autotools-tutorial;">Autotools Tutorial</ulink> ist eine sehr gute Einführung für <ulink url="http://de.wikipedia.org/wiki/GNU_Build_System">das GNU-Build-System, das als GNU Autotools bekannt ist</ulink>. Die wichtigsten Komponenten sind Autoconf, Automake, Libtool und Gettext.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">gnu-standards</systemitem> - this package contains two pieces of documentation from the GNU project: <ulink url="&gnu-standard;">GNU Coding Standards</ulink>, and <ulink url="&gnu-maintainer;">Information for Maintainers of GNU Software</ulink>.  Although Debian does not require these to be followed, these are still helpful as guidelines and common sense.  (See the local copies of <filename>&gnu-standard-pdf;</filename> and <filename>&gnu-maintainer-pdf;</filename>.)
de: <systemitem role="package">gnu-standards</systemitem> - Dieses Paket enthält zwei Teile der Dokumentation des GNU-Projekts: die <ulink url="&gnu-standard;">GNU Coding Standards</ulink> und <ulink url="&gnu-maintainer;">Informationen für Betreuer von GNU-Software</ulink>. Obwohl Debian nicht verlangt, dass diese befolgt werden, sind sie trotzdem hilfreich als Richtlinie und sinnvoll (lesen Sie die lokalen Kopien in <filename>&gnu-standard-pdf;</filename> und <filename>&gnu-maintainer-pdf;</filename>).

note: type: Content of: <book><chapter><section><para>
en: If this document contradicts any of the documents mentioned above, they are correct.  Please file a bug report on the <systemitem role="package">maint-guide</systemitem> package using <command>reportbug</command>.
de: Falls dieses Dokument einem der oben erwähnten Dokumente widerspricht, dann haben diese Recht. Bitte schreiben Sie einen Fehlerbericht zu dem Paket <systemitem role="package">maint-guide</systemitem>.

note: type: Content of: <book><chapter><section><para>
en: The following is an alternative tutorial document that you may read along with this document:
de: Das Folgende ist eine alternative Anleitung, die Sie zusammen mit diesem Dokument auch lesen können:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&debpkg-tutorial0;">Debian Packaging Tutorial</ulink>
de: <ulink url="&debpkg-tutorial0;">Debian-Paketier-Anleitung</ulink>

note: type: Content of: <book><chapter><section><title>
en: Where to ask for help
de: Wo man Hilfe bekommen kann

note: type: Content of: <book><chapter><section><para>
en: Before you decide to ask your question in some public place, please read this fine documentation:
de: Bevor Sie sich entschließen, Ihre Frage an einer öffentlichen Stelle zu stellen, lesen Sie bitte diese gute Dokumentation:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: files in <filename>/usr/share/doc/<replaceable>package</replaceable></filename> for all pertinent packages
de: Dateien in <filename>/usr/share/doc/<replaceable>Paket</replaceable></filename> für alle einschlägigen Pakete

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: contents of <literal><command>man</command> <replaceable>command</replaceable></literal> for all pertinent commands
de: Inhalte von <literal><command>man</command> <replaceable>Befehl</replaceable></literal> für alle einschlägigen Pakete

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: contents of <literal><command>info</command> <replaceable>command</replaceable></literal> for all pertinent commands
de: Inhalte von <literal><command>info</command> <replaceable>Befehl</replaceable></literal> für alle einschlägigen Pakete

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: contents of <ulink url="&debian-mentors-ldo;">debian-mentors@lists.debian.org mailing list archive</ulink>
de: Inhalte des <ulink url="&debian-mentors-ldo;">Mailinglistenarchivs von debian-mentors@lists.debian.org</ulink>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: contents of <ulink url="&debian-devel-ldo;">debian-devel@lists.debian.org mailing list archive</ulink>
de: Inhalte des <ulink url="&debian-devel-ldo;"> Mailinglistenarchivs von debian-devel@lists.debian.org</ulink>

note: type: Content of: <book><chapter><section><para>
en: You can use web search engines more effectively by including search strings such as <literal>site:lists.debian.org</literal> to limit the domain.
de: Sie können Websuchmaschinen effizienter benutzen, indem Sie bei dem Suchausdruck Angaben wie <literal>site:lists.debian.org</literal> verwenden, um den Suchbereich einzuschränken.

note: type: Content of: <book><chapter><section><para>
en: Making a small test package is a good way to learn details of packaging.  Inspecting existing well maintained packages is the best way to learn how other people make packages.
de: Das Erstellen eines kleinen Testpakets ist ein guter Weg, um die Details der Paketerstellung zu lernen. Das Untersuchen von existierenden, gut betreuten Paketen ist die beste Art, zu lernen, wie andere Leute Pakete machen.

note: type: Content of: <book><chapter><section><para>
en: If you still have questions about packaging that you couldn't find answers to in the available documentation and web resources, you can ask them interactively:
de: Falls Sie immer noch Fragen über das Paketieren haben, für die Sie keine Antworten in der verfügbaren Dokumentation und den Web-Ressourcen finden konnten, können Sie diese interaktiv stellen:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&debian-mentors-ldo;">debian-mentors@lists.debian.org mailing list</ulink>. (This mailing list is for the novice.)
de: <ulink url="&debian-mentors-ldo;">debian-mentors@lists.debian.org-Mailingliste</ulink> (eine Mailingliste für Anfänger),

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&debian-devel-ldo;">debian-devel@lists.debian.org mailing list</ulink>. (This mailing list is for the expert.)
de: <ulink url="&debian-devel-ldo;">debian-devel@lists.debian.org-Mailingliste</ulink> (eine Mailingliste für Experten),

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&irc-debian;">IRC</ulink> such as <literal>#debian-mentors</literal>.
de: <ulink url="&irc-debian;">IRC</ulink> wie <literal>#debian-mentors</literal>,

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Teams focusing on a specific set of packages. (Full list at <ulink url="&wikiteams;">https://wiki.debian.org/Teams</ulink>)
de: Teams konzentrieren sich auf bestimmte Paketgruppen (vollständige Liste unter <ulink url="&wikiteams;">https://wiki.debian.org/Teams</ulink>);

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Language-specific mailing lists such as debian-devel-{french,italian,portuguese,spanish}@lists.debian.org or debian-devel@debian.or.jp. (Full listing at <ulink url="&listdevel;">https://lists.debian.org/devel.html</ulink> and <ulink url="&listusers;">https://lists.debian.org/users.html</ulink>)
de: Sprachspezifische Mailinglisten wie debian-devel-{french,italian,portuguese,spanish}@lists.debian.org oder debian-devel@debian.or.jp. (Vollständige Listen unter <ulink url="&listdevel;">https://lists.debian.org/devel.html</ulink> und <ulink url="&listusers;">https://lists.debian.org/users.html</ulink>).

note: type: Content of: <book><chapter><section><para>
en: The more experienced Debian developers will gladly help you, if you ask properly after making your required efforts.
de: Die erfahreneren Debian-Entwickler werden Ihnen gerne helfen, falls Sie nach den verlangten Recherchen Ihre Frage vernünftig formulieren.

note: type: Content of: <book><chapter><section><para>
en: When you receive a bug report (yes, actual bug reports!), you will know that it is time for you to dig into the <ulink url="&bts;">Debian Bug Tracking System</ulink> and read the documentation there, to be able to deal with the reports efficiently.  I highly recommend reading the <ulink url="&devref-bug-handling;">Debian Developer's Reference, 5.8.  "Handling bugs"</ulink>.
de: Wenn Sie einen Fehlerbericht erhalten (ja, tatsächliche Fehlerberichte!), ist es Zeit für Sie, tiefer in die <ulink url="&bts;">Debian-Fehlerdatenbank</ulink> einzusteigen und die dort vorhandene Dokumentation zu lesen, damit Sie mit den Berichten effizient umgehen können. Ich empfehle dringend, die <ulink url="&devref-bug-handling;">Debian-Entwicklerreferenz, 5.8. »Fehlerbehandlung«</ulink> zu lesen.

note: type: Content of: <book><chapter><section><para>
en: Even if it all worked well, it's time to start praying.  Why? Because in just a few hours (or days) users from all around the world will start to use your package, and if you made some critical error you'll get mailbombed by numerous angry Debian users&#x2026; Just kidding.  :-)
de: Selbst wenn alles gut funktioniert hat, ist es jetzt an der Zeit, mit dem Beten anzufangen. Warum? Weil in wenigen Stunden (oder Tagen) Benutzer überall auf der Welt Ihr Paket verwenden werden, und wenn Sie einen kritischen Fehler gemacht haben, werden Sie von unzähligen verärgerten Debian-Benutzern mit E-Mails überschüttet &#x2026; war nur ein Scherz. :-)

note: type: Content of: <book><chapter><section><para>
en: Relax and be ready for bug reports, because there is a lot more work to be done before your package will be fully in line with Debian policies and its best practice guidelines (once again, read the <emphasis>real documentation</emphasis> for details).  Good luck!
de: Entspannen Sie sich und stellen Sie sich auf Fehlerberichte ein, denn es ist noch viel mehr Arbeit zu erledigen, bevor Ihr Paket vollständig im Einklang mit den Debian-Richtlinien sowie dessen bewährten Verfahren ist (nochmals: lesen Sie die <emphasis>wirkliche Dokumentation</emphasis> für Details). Viel Glück!

note: type: Content of: <book><chapter><title>
en: First steps
de: Erste Schritte

note: type: Content of: <book><chapter><para>
en: Let's start by creating a package of your own (or, even better, adopting an existing one).
de: Lassen Sie uns anfangen, indem Sie Ihr eigenes Paket erstellen (oder, noch besser, ein vorhandenes übernehmen).

note: type: Content of: <book><chapter><section><title>
en: Debian package building workflow
de: Arbeitsschritte beim Bau von Debian-Paketen

note: type: Content of: <book><chapter><section><para>
en: If you are making a Debian package with an upstream program, the typical workflow of Debian package building involves generating several specifically named files for each step as follows:
de: Falls Sie ein Debian-Paket mit einem Programm von (anderen) Originalautoren erstellen, ist ein Teil der typischen Arbeitsschritte des Debian-Paketbaus die Erstellung mehrerer speziell benannter Dateien für jeden Schritt, wie folgt:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Get a copy of the upstream software, usually in a compressed tar format.
de: Besorgen Sie sich eine Kopie der Software der Originalautoren, normalerweise in einem komprimierten Tar-Format.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>-<replaceable>version</replaceable>.tar.gz
de: <replaceable>Paket</replaceable>-<replaceable>Version</replaceable>.tar.gz

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Add Debian-specific packaging modifications to the upstream program under the <filename>debian</filename> directory, and create a non-native source package (that is, the set of input files used for Debian package building) in <literal>3.0 (quilt)</literal> format.
de: Fügen Sie Debian-spezifische Paketanpassungen zu dem Programm der Originalautoren im Verzeichnis <filename>debian</filename> hinzu und erstellen Sie ein nicht natives Quellpaket (d.h. die Menge an Eingabedateien, die zum Bau des Debian-Pakets verwandt wird) im Format <literal>3.0 (quilt)</literal>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>_<replaceable>version</replaceable>.orig.tar.gz
de: <replaceable>Paket</replaceable>_<replaceable>Version</replaceable>.orig.tar.gz

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>_<replaceable>version</replaceable>-<replaceable>revision</replaceable>.debian.tar.gz
de: <replaceable>Paket</replaceable>_<replaceable>Version</replaceable>-<replaceable>Revision</replaceable>.debian.tar.gz

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><footnote><para>
en: For the older style of non-native Debian source packages in <literal>1.0</literal> format, <literal><replaceable>package</replaceable>_<replaceable>version</replaceable>-<replaceable>revision</replaceable>.diff.gz</literal> is used instead.
de: Für die Debian-Quellpakete im älteren <literal>1.0</literal>-Format wird stattdessen <literal><replaceable>Paket</replaceable>_<replaceable>Version</replaceable>-<replaceable>Revision</replaceable>.diff.gz</literal> benutzt.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>_<replaceable>version</replaceable>-<replaceable>revision</replaceable>.dsc
de: <replaceable>Paket</replaceable>_<replaceable>Version</replaceable>-<replaceable>Revision</replaceable>.dsc

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Build Debian binary packages, which are ordinary installable package files in <literal>.deb</literal> format (or <literal>.udeb</literal> format, used by the Debian Installer) from the Debian source package.
de: Erstellen Sie aus den Debian-Quellpaketen die Debian-Binärpakete, das sind normale installierbare Paketdateien im <literal>.deb</literal>- (oder in dem vom Debian-Installer verwandten <literal>.udeb</literal>-)Format.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>_<replaceable>version</replaceable>-<replaceable>revision</replaceable>_<replaceable>arch</replaceable>.deb
de: <replaceable>Paket</replaceable>_<replaceable>Version</replaceable>-<replaceable>Revision</replaceable>_<replaceable>Arch</replaceable>.deb

note: type: Content of: <book><chapter><section><para>
en: Please note that the character separating <literal><replaceable>package</replaceable></literal> and <literal><replaceable>version</replaceable></literal> was changed from <literal>-</literal> (hyphen) in the tarball name to <literal>_</literal> (underscore) in the Debian package filenames.
de: Bitte beachten Sie, dass das Zeichen, das <literal><replaceable>Paket</replaceable></literal> und <literal><replaceable>Version</replaceable></literal> trennt, von <literal>-</literal> (Bindestrich) im Tarball-Namen zu <literal>_</literal> (Unterstrich) im Debian-Paketdateinamen geändert wurde.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&policy-source;">5.6.1 "Source"</ulink>, <ulink url="&policy-package;">5.6.7 "Package"</ulink>, and <ulink url="&policy-version;">5.6.12 "Version"</ulink>.  The <emphasis role="strong">package architecture</emphasis> follows the <ulink url="&policy-architecture;">Debian Policy Manual, 5.6.8 "Architecture"</ulink> and is automatically assigned by the package build process.
de: Lesen Sie <ulink url="&policy-source;">5.6.1 "Source"</ulink>, <ulink url="&policy-package;">5.6.7 "Package"</ulink> und <ulink url="&policy-version;">5.6.12 "Version"</ulink>. Die <emphasis role="strong">Paketarchitektur</emphasis> folgt dem <ulink url="&policy-architecture;">Debian Policy Manual, Kapitel 5.6.8 »Architecture«</ulink> und wird während des Paketbauprozesses automatisch zugewiesen.

note: type: Content of: <book><chapter><section><para>
en: In the file names above, replace the <literal><replaceable>package</replaceable></literal> part with the <emphasis role="strong">package name</emphasis>, the <literal><replaceable>version</replaceable></literal> part with the <emphasis role="strong">upstream version</emphasis>, the <literal><replaceable>revision</replaceable></literal> part with the <emphasis role="strong">Debian revision</emphasis>, and the <literal><replaceable>arch</replaceable></literal> part with the <emphasis role="strong">package architecture</emphasis>, as defined in the Debian Policy Manual.  <placeholder type="footnote" id="0"/>
de: Im obigen Dateinamen wird der <literal><replaceable>Paket</replaceable></literal>-Teil durch den <emphasis role="strong">Paketnamen</emphasis>, der <literal><replaceable>Version</replaceable></literal>-Teil durch die <emphasis role="strong">Version der Originalautoren</emphasis>, der <literal><replaceable>Revision</replaceable></literal>-Teil durch die <emphasis role="strong">Debian-Revision</emphasis> und der <literal><replaceable>arch</replaceable></literal>-Teil durch die <emphasis role="strong">Paketarchitektur</emphasis>, wie im »Debian Policy Manual« festgelegt, ersetzt. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: Each step of this outline is explained with detailed examples in later sections.
de: Jeder Schritt dieser Übersicht wird in späteren Abschnitten mit detaillierten Beispielen erklärt.

note: type: Content of: <book><chapter><section><title>
en: Choose your program
de: Ihr Programm auswählen

note: type: Content of: <book><chapter><section><para>
en: You have probably chosen the package you want to create.  The first thing you need to do is check if the package is in the distribution archive already by using the following:
de: Sie haben sich wahrscheinlich schon ein Paket ausgesucht, das Sie erstellen wollen. Zuerst müssen Sie überprüfen, ob das Paket bereits in der Distribution existiert, indem Sie Folgendes benutzen:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: the <command>aptitude</command> command
de: den Befehl <command>aptitude</command>,

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: the <ulink url="&packages-do;">Debian packages</ulink> web page
de: die Webseite <ulink url="&packages-do;">Debian-Pakete</ulink>,

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: the <ulink url="&debtrack;">Debian Package Tracker</ulink> web page
de: die Webseite <ulink url="&debtrack;">Debian Package Tracker</ulink>.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&devref-adopt;">Debian Developer's Reference 5.9.5 "Adopting a package"</ulink>.
de: Lesen Sie die <ulink url="&devref-adopt;">Debian-Entwicklerreferenz 5.9.5 »Adoption eines Pakets«</ulink>.

note: type: Content of: <book><chapter><section><para>
en: If the package already exists, well, install it! :-) If it happens to be <emphasis role="strong">orphaned</emphasis> (that is, if its maintainer is set to <ulink url="&qa-do;">Debian QA Group</ulink>), you may be able to pick it up if it's still available.  You may also adopt a package whose maintainer has filed a Request for Adoption (<emphasis role="strong">RFA</emphasis>).<placeholder type="footnote" id="0"/>
de: Wenn es das Paket schon gibt, na, dann installieren Sie es! :-) Falls es <emphasis role="strong">verwaist (»orphaned«)</emphasis> wurde (wenn als Betreuer »<ulink url="&qa-do;">Debian QA Group</ulink>« eingetragen ist), dann können Sie es übernehmen, wenn es noch verfügbar ist. Sie können auch ein Paket adoptieren, dessen Betreuer einen »Request for Adoption« (<emphasis role="strong">RFA</emphasis>) geschrieben hat. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: There are several package ownership status resources:
de: Es gibt mehrere Ressourcen zur Paketeigentümerschaft:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The <command>wnpp-alert</command> command from the <systemitem role="package">devscripts</systemitem> package
de: den Befehl <command>wnpp-alert</command> aus dem Paket <systemitem role="package ">devscripts</systemitem>;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&wnpp-do;">Work-Needing and Prospective Packages</ulink>
de: <ulink url="&wnpp-do;">arbeit-bedürfende und voraussichtliche Pakete</ulink>;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&wnpp-bts;">Debian Bug report logs: Bugs in pseudo-package <systemitem role="package">wnpp</systemitem> in <literal>unstable</literal></ulink>
de: <ulink url="&wnpp-bts;">Debian-Fehlerdatenbank-Protokolle: Fehler im Pseudo-Paket <systemitem role="package">wnpp</systemitem> in <literal>unstable</literal></ulink>;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&wnpp-dn;">Debian Packages that Need Lovin'</ulink>
de: <ulink url="&wnpp-dn;">Debian-Pakete, die Aufmerksamkeit benötigen</ulink>;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&wnpp-debtags;">Browse <systemitem role="package">wnpp</systemitem> bugs based on debtags</ulink>
de: <ulink url="&wnpp-debtags;">Durchsuchen Sie basierend auf Debtags die <systemitem role="package">wnpp</systemitem>-Fehler</ulink>.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Having said that, there will of course always be new programs that are worth packaging.
de: Trotzdem gibt es natürlich immer neue Programme, die es wert sind, für Debian paketiert zu werden.

note: type: Content of: <book><chapter><section><para>
en: As a side note, it's important to point out that Debian already has packages for most kinds of programs, and the number of packages already in the Debian archive is much larger than that of contributors with upload rights.  Thus, contributions to packages already in the archive are far more appreciated (and more likely to receive sponsorship) by other developers <placeholder type="footnote" id="0"/>.  You can contribute in various ways:
de: Als wichtige Randbemerkung sei darauf hingewiesen, dass Debian bereits für fast alle Arten von Programmen Pakete enthält und die Anzahl der Pakete im Debian-Archiv wesentlich größer ist als die der Mitwirkenden mit Berechtigung zum Hochladen. Daher werden Beiträge zu Paketen, die bereits im Archiv enthalten sind, von anderen Entwicklern wesentlich mehr gewürdigt (und haben bessere Chancen, gesponsert zu werden) <placeholder type="footnote" id="0"/>. Sie können auf verschiedene Arten beitragen:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: taking over orphaned, yet actively used, packages
de: Pakete übernehmen, die verwaist wurden, aber aktiv benutzt werden;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: joining <ulink url="&teams;">packaging teams</ulink>
de: Mitglied in einem <ulink url="&teams;">Paketierungs-Team</ulink> werden;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: triaging bugs of very popular packages
de: Fehler von sehr beliebten Paketen sortieren und bewerten;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: preparing <ulink url="&devref-nmu;">QA or NMU uploads</ulink>
de: Vorbereiten von <ulink url="&devref-nmu;">QA- oder NMU-Uploads</ulink>.

note: type: Content of: <book><chapter><section><para>
en: If you are able to adopt the package, get the sources (with something like <literal>apt-get source <replaceable>packagename</replaceable></literal>) and examine them.  This document unfortunately doesn't include comprehensive information about adopting packages.  Thankfully you shouldn't have a hard time figuring out how the package works since someone has already done the initial setup for you.  Keep reading, though; a lot of the advice below will still be applicable to your case.
de: Wenn Sie ein Paket übernehmen möchten, laden Sie sich das Quell-Paket herunter (z. B. mit »<literal>apt-get source <replaceable>Paketname</replaceable></literal>«) und nehmen Sie es unter die Lupe. Leider enthält dieses Dokument keine umfassende Anleitung zum Übernehmen von Paketen. Der Vorteil ist, dass schon jemand das Paket für Sie vorbereitet hat und Sie keine Schwierigkeiten haben sollten, herauszufinden, wie das Paket funktioniert. Doch lesen Sie weiter, denn viele der folgenden Ratschläge werden auch für Sie nützlich sein.

note: type: Content of: <book><chapter><section><para>
en: If the package is new, and you decide you'd like to see it in Debian, proceed as follows:
de: Falls das Paket neu ist und Sie es gern in Debian integrieren möchten, gehen Sie wie folgt vor:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: First, you must know that the program works, and have tried it for some time to confirm its usefulness.
de: Zuerst sollten Sie sicher sein, dass das Programm funktioniert und es bereits einige Zeit ausprobiert haben, damit Sie die Nützlichkeit bestätigen können.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: You must check that no one else is already working on the package on the <ulink url="&wnpp-do;">Work-Needing and Prospective Packages</ulink> site.  If no one else is working on it, file an ITP (Intent To Package) bug report to the <systemitem role="package">wnpp</systemitem> pseudo-package using <command>reportbug</command>.  If someone's already on it, contact them if you feel you need to.  If not &#x2014; find another interesting program that nobody is maintaining.
de: Überprüfen Sie auf der Site »<ulink url="&wnpp-do;">Arbeit-bedürfende und voraussichtliche Pakete</ulink>«, dass niemand bereits an diesem Paket arbeitet. Falls noch niemand daran arbeitet, schreiben Sie mit <command>reportbug</command> einen ITP-Fehlerbericht (»Intent To Package«; Absicht, das Paket zu erstellen) an das <systemitem role="package">wnpp</systemitem>-Pseudopaket. Wenn schon jemand an dem Paket arbeitet, nehmen Sie mit ihm Verbindung auf, falls nötig. Andernfalls finden Sie bestimmt ein anderes interessantes Paket, das von niemandem betreut wird.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The software <emphasis role="strong">must have a license</emphasis>.
de: Die Software <emphasis role="strong">muss eine Lizenz haben</emphasis>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: For the <literal>main</literal> section, Debian Policy requires it <emphasis role="strong">to be fully compliant with the Debian Free Software Guidelines</emphasis> (<ulink url="&dfsg;">DFSG</ulink>)  and <emphasis role="strong">not to require a package outside of <literal>main</literal></emphasis> for compilation or execution.  This is the desired case.
de: Für den Bereich <literal>main</literal> verlangen die Debian-Richtlinien, dass es <emphasis role="strong">die Debian-Richtlinien für Freie Software komplett erfüllt</emphasis> (<ulink url="&dfsg;">DFSG</ulink>) und <emphasis>kein Paket außerhalb von <literal>main</literal> benötigt</emphasis>, um zu kompilieren oder ausgeführt zu werden. Dies ist der erwünschte Fall.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: For the <literal>contrib</literal> section, it must comply with the DFSG but it may require a package outside of <literal>main</literal> for compilation or execution.
de: Für den Bereich <literal>contrib</literal> muss es zu den DFSG konform sein, darf aber ein Paket außerhalb von <literal>main</literal> für die Kompilierung oder Ausführung erfordern.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: For the <literal>non-free</literal> section, it may be non-compliant with the DFSG but it <emphasis role="strong">must be distributable</emphasis>.
de: Für den Bereich <literal>non-free</literal> darf es gegen Punkte der DFSG verstoßen, es <emphasis role="strong">muss aber verteilbar sein</emphasis>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: If you are unsure about where it should go, post the license text on <ulink url="&debian-legal-ldo;">debian-legal@lists.debian.org</ulink> and ask for advice.
de: Sind Sie sich unsicher, in welchen Bereich das Paket gehört, schicken Sie den Lizenztext an <ulink url="&debian-legal-ldo;">debian-legal@lists.debian.org</ulink> und bitten um Rat.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The program should <emphasis role="strong">not</emphasis> introduce security and maintenance concerns into the Debian system.
de: Das Programm sollte <emphasis role="strong">keine</emphasis> Sicherheitsprobleme und Betreuungssorgen zum Debian-System hinzufügen.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: The program should be well documented and its code needs to be understandable (i.e., not obfuscated).
de: Das Programm sollte gut dokumentiert und der Quellcode verständlich (d.h. nicht verschleiert) sein.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You should contact the program's author(s) to check if they agree with packaging it and are amicable to Debian.  It is important to be able to consult with the author(s)  in case of any problems with the program, so don't try to package unmaintained software.
de: Sie sollten den oder die Autoren des Programms kontaktieren und sicherstellen, dass sie mit dem Paketieren einverstanden und Debian wohlgesonnen sind. Es ist wichtig, dass die Autoren auch später im Fall von Problemen über das Programm befragt werden können. Versuchen Sie also nicht, aufgegebene Programme zu paketieren.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: The program certainly should <emphasis role="strong">not</emphasis> run setuid root, or even better, it shouldn't need to be setuid or setgid to anything.
de: Das Programm sollte sicherlich <emphasis role="strong">nicht</emphasis> als »setuid root« laufen, oder noch besser, es sollte für die Ausführung überhaupt keine setuid- oder setgid-Rechte brauchen.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: The program should not be a daemon, or go in an <filename>*/sbin</filename> directory, or open a port as root.
de: Das Programm sollte kein Daemon sein oder in ein <filename>*/sbin</filename>-Verzeichnis installiert werden und auch keinen Port als Root öffnen.

note: type: Content of: <book><chapter><section><para>
en: Of course, the last one is just a safety measure, and is intended to save you from enraging users if you do something wrong in some setuid daemon&#x2026; When you gain more experience in packaging, you'll be able to package such software.
de: Natürlich ist der zuletzt aufgeführt Punkte eher eine Sicherheitsmaßnahme und sollte Sie vor tobenden Benutzern schützen, falls Ihr setuid-Daemon irgendetwas Schlimmes anstellt &#x2026; wenn Sie mehr Erfahrungen im Erstellen von Paketen gesammelt haben, können Sie auch solche Software paketieren.

note: type: Content of: <book><chapter><section><para>
en: As a new maintainer, you are encouraged to get some experience in packaging with easier packages and discouraged from creating complicated packages.
de: Als neuer Betreuer wird Ihnen empfohlen, Erfahrung im Paketieren einfacher Pakete zu sammeln und Ihnen abgeraten, komplizierte Pakete zu erstellen.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Simple packages
de: Einfache Pakete

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: single binary package, arch = all (collection of data such as wallpaper graphics)
de: einfaches Binärpaket, arch=all (Sammlung von Daten, wie Hintergrundgraphiken)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: single binary package, arch = all (executables written in an interpreted language such as POSIX shell)
de: einfaches Binärpaket, arch=all (in interpretierten Sprachen wie POSIX-Shell geschriebene Programme)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Intermediate complexity packages
de: Mittel-komplexe Pakete

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: single binary package, arch = any (ELF binary executables compiled from languages such as C and C++)
de: einfaches Binärpaket, arch=any (ELF-Binärprogramme, kompiliert aus Sprachen wie C und C++)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: multiple binary packages, arch = any + all (packages for ELF binary executables + documentation)
de: mehrere Binärpakete, arch=any+all (Pakete für ELF-Binärprogramme + Dokumentation)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: upstream source in a format other than <filename>tar.gz</filename> or <filename>tar.bz2</filename>
de: Quelle der Originalautoren ist weder im Format <filename>tar.gz</filename> noch im Format <filename>tar.bz2</filename>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: upstream source containing undistributable contents
de: die Quellen der Originalautoren enthalten Inhalte, die nicht verteilt werden dürfen

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: High complexity packages
de: Hochkomplexe Pakete

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: interpreter module package used by other packages
de: Interpretermodulpakete, die von anderen Paketen verwandt werden

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: generic ELF library package used by other packages
de: generische ELF-Bibliothekspakete, die von anderen Paketen verwandt werden

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: multiple binary packages including an ELF library package
de: mehrere Binärpakete, darunter ein ELF-Bibliothekspaket

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: source package with multiple upstream sources
de: Quellpakete mit mehreren Quellen von Originalautoren

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: kernel module packages
de: Kernel-Modul-Pakete

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: kernel patch packages
de: Kernel-Patch-Pakete

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: any package with non-trivial maintainer scripts
de: jedes Paket mit nicht trivialen Betreuerskripten

note: type: Content of: <book><chapter><section><para>
en: Packaging high complexity packages is not too hard, but it requires a bit more knowledge. You should seek specific guidance for every complex feature. For example, some languages have their own sub-policy documents:
de: Paketieren von hochkomplexen Paketen ist nicht zu schwer, erfordert aber ein bisschen mehr Wissen. Sie sollten spezielle Hilfestellungen für jede komplexe Funktionalität erbitten. Beispielsweise haben einige Sprachen ihre eigenen Unter-Richtliniendokumente:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&policy-perl;">Perl policy</ulink>
de: <ulink url="&policy-perl;">Perl-Richtlinien</ulink>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&policy-python;">Python policy</ulink>
de: <ulink url="&policy-python;">Python-Richtlinien</ulink>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&policy-java;">Java policy</ulink>
de: <ulink url="&policy-java;">Java-Richtlinien</ulink>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Do not worry about the missing <filename>Makefile</filename>.  You can install the <command>hello</command> command by simply using <command>debhelper</command> as in <xref linkend="install"/>, or by modifying the upstream source to add a new <filename>Makefile</filename> with the <literal>install</literal> target as in <xref linkend="modify"/>.
de: Machen Sie sich keine Sorge um das fehlende <filename>Makefile</filename>. Sie können den Befehl <command>hello</command> einfach mittels <command>debhelper</command> wie in <xref linkend="install"/> oder durch Veränderung der Quellen der Originalautoren installieren, indem Sie ein neues <filename>Makefile</filename> mit dem Ziel <literal>install</literal> wie in <xref linkend="modify"/> hinzufügen.

note: type: Content of: <book><chapter><section><para>
en: There is another old Latin saying: <emphasis>fabricando fit faber</emphasis> (practice makes perfect).  It is <emphasis>highly</emphasis> recommended to practice and experiment with all the steps of Debian packaging with simple packages while reading this tutorial.  A trivial upstream tarball, <filename>hello-sh-1.0.tar.gz</filename>, created as follows may offer a good starting point:<placeholder type="footnote" id="0"/>
de: Es gibt einen alten lateinischen Spruch: <emphasis>fabricando fit faber</emphasis> (Übung macht den Meister). Es wird <emphasis>nachdrücklich</emphasis> empfohlen, zu üben und mit allen Schritten der Debian-Paketierung mit einfachen Paketen zu spielen, während diese Anleitung gelesen wird. Ein trivialer Tarball der Originalautoren ist <filename>hello-sh-1.0.tar.gz</filename>, der einen guten Startpunkt darstellt. Er wird wie folgt erstellt:<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><title>
en: Get the program, and try it out
de: Besorgen Sie sich das Programm und probieren Sie es aus

note: type: Content of: <book><chapter><section><para>
en: So the first thing to do is to find and download the original source code.  Presumably you already have the source file that you picked up at the author's homepage.  Sources for free Unix programs usually come in <command>tar</command>+<command>gzip</command> format with the extension <filename>.tar.gz</filename>, <command>tar</command>+<command>bzip2</command> format with the extension <filename>.tar.bz2</filename>, or <command>tar</command>+<command>xz</command> format with the extension <filename>.tar.xz</filename>.  These usually contain a directory called <filename><replaceable>package</replaceable>-<replaceable>version</replaceable></filename> with all the sources inside.
de: Als Erstes müssen Sie die Originalquellen des Programms finden und herunterladen. Wahrscheinlich haben Sie bereits die Quellcode-Datei von der Homepage des Autors. Quellen freier Unix-Programme sind üblicherweise im Format <command>tar</command>+<command>gzip</command> mit der Erweiterung <filename>.tar.gz</filename>, im Format <command>tar</command>+<command>bzip2</command> mit der Erweiterung <filename>.tar.bz2</filename> oder im Format <command>tar</command>+<command>xz</command> mit der Erweiterung <filename>.tar.xz</filename>. Sie enthalten üblicherweise ein Verzeichnis, das <filename><replaceable>Paket</replaceable>-<replaceable>Version</replaceable></filename> heißt, sowie darin alle Quellcode-Dateien.

note: type: Content of: <book><chapter><section><para>
en: If the latest version of the source is available through a Version Control System (VCS) such as Git, Subversion, or CVS, you need to get it with <literal>git clone</literal>, <literal>svn co</literal>, or <literal>cvs co</literal> and repack it into <command>tar</command>+<command>gzip</command> format yourself by using the <literal>--exclude-vcs</literal> option.
de: Falls die neueste Version der Quellen über Versionskontrollsysteme (VCS) wie Git, Subversion oder CVS verfügbar ist, müssen Sie sie mit »<literal>git clone</literal>«, »<literal>svn co</literal>« oder »<literal>cvs co</literal>« herunterladen und dann selbst einen Tarball im Format <command>tar</command>+<command>gzip</command> erstellen, indem Sie die Option »<literal>--exclude-vcs</literal>« verwenden.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: You can identify the archive format using the <command>file</command> command when the file extension is not enough.
de: Sie können das Archivformat herausfinden, indem Sie den Befehl <command>file</command> verwenden, wenn die Dateierweiterung nicht ausreicht.

note: type: Content of: <book><chapter><section><para>
en: If your program's source comes as some other sort of archive (for instance, the filename ends in <filename>.Z</filename> or <filename>.zip</filename><placeholder type="footnote" id="0"/>), you should also unpack it with the appropriate tools and repack it.
de: Kommt der Quellcode in einem anderen Archivtyp daher (beispielsweise wenn der Dateiname auf <filename>.Z</filename> oder <filename>.zip</filename> endet <placeholder type="footnote" id="0"/>), sollten Sie ihn auch mit den geeigneten Werkzeugen entpacken und neu packen.

note: type: Content of: <book><chapter><section><para>
en: If your program's source comes with some contents which do not comply with DFSG, you should also unpack it to remove such contents and repack it with a modified upstream version containing <literal>dfsg</literal>.
de: Falls die Quellen Ihres Programms Inhalte enthalten, die nicht den DFSG genügen, sollten Sie sie auch entpacken, um solche Inhalte zu entfernen, und mit einer geänderten Version der Originalautoren, die <literal>dfsg</literal> enhält, neu packen.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: This program is already packaged. The <ulink url="&gentoo-package;">current version</ulink> uses Autotools as its build structure and is substantially different from the following examples, which were based on version 0.9.12.
de: Das Programm ist bereits paketiert worden. Die <ulink url="&gentoo-package;">aktuelle Version</ulink> verwendet die Autotools als Baustruktur und unterscheidet sich signifikant von den folgenden Beispielen, die auf Version 0.9.12 basieren.

note: type: Content of: <book><chapter><section><para>
en: As an example, I'll use a program called <command>gentoo</command>, a GTK+ file manager.  <placeholder type="footnote" id="0"/>
de: Als Beispiel verwende ich hier ein Programm namens <command>gentoo</command>, einen GTK+-Dateimanager. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: Create a subdirectory under your home directory named <filename>debian</filename> or <filename>deb</filename> or anything you find appropriate (e.g.  just <filename>~/gentoo</filename> would do fine in this case).  Place the downloaded archive in it, and extract it (with <literal>tar xzf gentoo-0.9.12.tar.gz</literal>).  Make sure there are no warning messages, even <emphasis>irrelevant</emphasis> ones, because other people's unpacking tools may or may not ignore these anomalies, so they may have problems unpacking them.  Your shell command line may look something like this:
de: Erstellen Sie ein Unterverzeichnis in Ihrem Home-Verzeichnis namens <filename>debian</filename> oder <filename>deb</filename> oder irgendetwas, das Sie passend finden (beispielsweise wäre in diesem Fall einfach <filename>~/gentoo</filename> völlig in Ordnung). Kopieren Sie das heruntergeladene Archiv dorthin und entpacken Sie es (mit »<literal>tar xzf gentoo-0.9.12.tar.gz</literal>«). Vergewissern Sie sich, dass es keine Warnmeldungen beim Entpacken gab, nicht mal so genannte <emphasis>irrelevante</emphasis>, da die Entpackwerkzeuge anderer Leute diese Anomalien ignorieren oder auch nicht ignorieren könnten und sie daher beim Entpacken Probleme bekommen könnten. Ihre Shell-Befehlszeile könnte dann wie folgt aussehen:

note: type: Content of: <book><chapter><section><para>
en: Now you have another subdirectory, called <filename>gentoo-0.9.12</filename>.  Change to that directory and <emphasis>thoroughly</emphasis> read the provided documentation.  Usually there are files named <filename>README*</filename>, <filename>INSTALL*</filename>, <filename>*.lsm</filename> or <filename>*.html</filename>.  You must find instructions on how to compile and install the program (most probably they'll assume you want to install to the <filename>/usr/local/bin</filename> directory; you won't be doing that, but more on that later in <xref linkend="destdir"/>).
de: Jetzt haben Sie ein neues Unterverzeichnis namens <filename>gentoo-0.9.12</filename>. Wechseln Sie dorthin und lesen Sie die mitgelieferte Dokumentation <emphasis>aufmerksam</emphasis> durch. Meistens gibt es Dateien mit den Namen <filename>README*</filename>, <filename>INSTALL*</filename>, <filename>*.lsm</filename> oder <filename>*.html</filename>. Sie müssen eine Anleitung finden, wie man das Programm kompiliert und installiert (meistens wird von einer Installation in das Verzeichnis <filename>/usr/local/bin</filename> ausgegangen, aber das werden Sie nicht machen. Mehr dazu später in <xref linkend="destdir"/>).

note: type: Content of: <book><chapter><section><para>
en: You should start packaging with a completely clean (pristine) source directory, or simply with freshly unpacked sources.
de: Sie sollten das Paketieren mit einem komplett aufgeräumten (»pristine«, makellosen) Quellcode-Verzeichnis anfangen oder die Quellen einfach frisch entpacken.

note: type: Content of: <book><chapter><section><title>
en: Simple build systems
de: Einfache Bausysteme

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Many modern programs come with a script named <filename>configure</filename>, which when executed creates a <filename>Makefile</filename> customized for your system.
de: Viele moderne Programme kommen mit einem Skript <filename>configure</filename>, das bei der Ausführung ein für Ihr System angepasstes <filename>Makefile</filename> erstellt.

note: type: Content of: <book><chapter><section><para>
en: Simple programs usually come with a <filename>Makefile</filename> and can be compiled just by invoking <literal>make</literal>.<placeholder type="footnote" id="0"/> Some of them support <literal>make check</literal>, which runs included self-tests.  Installation to the destination directories is usually done with <literal>make install</literal>.
de: Einfache Programme enthalten normalerweise eine <filename>Makefile</filename>-Datei und können rein durch den Aufruf von »<literal>make</literal>« kompiliert werden. <placeholder type="footnote" id="0"/> Einige von ihnen unterstützen »<literal>make check</literal>«, wodurch die mitgelieferten Selbsttests gestartet werden. Die Installation in das Zielverzeichnis wird üblicherweise mittels »<literal>make install</literal>« durchgeführt.

note: type: Content of: <book><chapter><section><para>
en: Now try to compile and run your program, to make sure it works properly and doesn't break something else while it's installing or running.
de: Versuchen Sie nun, das Programm zu kompilieren und auszuführen. Stellen Sie sicher, dass es einwandfrei funktioniert und nichts anderes während der Installation oder der Ausführung beschädigt.

note: type: Content of: <book><chapter><section><para>
en: Also, you can usually run <literal>make clean</literal> (or better <literal>make distclean</literal>) to clean up the build directory.  Sometimes there's even a <literal>make uninstall</literal> which can be used to remove all the installed files.
de: Meistens können Sie außerdem »<literal>make clean</literal>« (oder besser »<literal>make distclean</literal>«) ausführen, um im Build-Verzeichnis aufzuräumen. Manchmal gibt es sogar ein »<literal>make uninstall</literal>«, womit alle installierten Dateien gelöscht werden können.

note: type: Content of: <book><chapter><section><title>
en: Popular portable build systems
de: Beliebte portable Bausysteme

note: type: Content of: <book><chapter><section><para>
en: A lot of free software programs are written in the <ulink url="&c-program;">C</ulink> and <ulink url="&cxx;">C++</ulink> languages.  Many of these use Autotools or CMake to make them portable across different platforms.  These build tools need to be used to generate the <filename>Makefile</filename> and other required source files first.  Then, such programs are built using the usual <literal>make; make install</literal>.
de: Viele freie Software-Programme sind in den Sprachen <ulink url="http://de.wikipedia.org/wiki/C_(Programmiersprache)">C</ulink> oder <ulink url="http://de.wikipedia.org/wiki/C++">C++</ulink> geschrieben. Die meisten von ihnen verwenden Autotools oder CMake, um auf verschiedene Plattformen portierbar zu sein. Diese Bauwerkzeuge müssen zuerst benutzt werden, um das <filename>Makefile</filename> und andere benötigte Quelldateien zu erzeugen. Anschließend werden solche Programme mit dem üblichen »<literal>make; make install</literal>« gebaut.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Autotools is too big to deal with in this small tutorial. This section is meant to provide keywords and references only.  Please make sure to read the <ulink url="&autotools-tutorial;">Autotools Tutorial</ulink> and the local copy of <filename>&autotools-readme;</filename>, if you need to use it.
de: Autotools ist zu umfangreich, um in dieser Anleitung berücksichtigt zu werden. Dieser Abschnitt dient nur der Bereitstellung von Schlüsselwörtern und Referenzen. Falls Sie sie benötigen, stellen Sie sicher, dass Sie das <ulink url="&autotools-tutorial;">Autotools Tutorial</ulink> und die lokale Kopie der <filename>&autotools-readme;</filename> lesen.

note: type: Content of: <book><chapter><section><para>
en: <ulink url="&gnu-build-system;">Autotools</ulink> is the GNU build system comprising <ulink url="&autoconf;">Autoconf</ulink>, <ulink url="&automake;">Automake</ulink>, <ulink url="&libtool;">Libtool</ulink>, and <ulink url="&gettext;">gettext</ulink>.  You can recognize such sources by the <filename>configure.ac</filename>, <filename>Makefile.am</filename>, and <filename>Makefile.in</filename> files.  <placeholder type="footnote" id="0"/>
de: <ulink url="http://de.wikipedia.org/wiki/GNU_Build_System">Autotools</ulink> ist das GNU-Buildsystem, das aus <ulink url="&autoconf;">Autoconf</ulink>, <ulink url="&automake;">Automake</ulink>, <ulink url="&libtool;">Libtool</ulink> und <ulink url="http://de.wikipedia.org/wiki/GNU_gettext">gettext</ulink> besteht. Sie erkennen solche Quellen an den Dateien <filename>configure.ac</filename>, <filename>Makefile.am</filename> und <filename>Makefile.in</filename>. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: The first step of the Autotools workflow is usually that upstream runs <literal>autoreconf -i -f</literal> in the source directory and distributes the generated files along with the source.
de: Der erste Schritt im Arbeitsablauf der Autotools ist üblicherweise, dass der ursprüngliche Autor »<literal>autoreconf -i -f</literal>« im Quellenverzeichnis aufruft und die Quellen dann mit den erzeugten Dateien verteilt.

note: type: Content of: <book><chapter><section><para>
en: Editing <filename>configure.ac</filename> and <filename>Makefile.am</filename> files requires some knowledge of <command>autoconf</command> and <command>automake</command>.  See <literal>info autoconf</literal> and <literal>info automake</literal>.
de: Das Bearbeiten der Dateien <filename>configure.ac</filename> und <filename>Makefile.am</filename> erfordert etwas Wissen über <command>autoconf</command> und <command>automake</command>. Siehe »<literal>info autoconf</literal>« und »<literal>info automake</literal>«.

note: type: Content of: <book><chapter><section><para>
en: The second step of the Autotools workflow is usually that the user obtains this distributed source and runs <literal>./configure &amp;&amp; make</literal> in the source directory to compile the program into an executable command <command><replaceable>binary</replaceable></command>.
de: Der zweite Schritt im Arbeitsablauf der Autotools ist üblicherweise, dass der Benutzer diese verteilten Quellen erhält und »<literal>./configure &amp;&amp; make</literal>« in den Quellen aufruft, um das Programm zu einem ausführbaren <command><replaceable>Binärdatei</replaceable></command>-Befehl zu kompilieren.

note: type: Content of: <book><chapter><section><para>
en: You can change many things in the <filename>Makefile</filename>; for instance you can change the default location for file installation using the option <literal>./configure --prefix=/usr</literal>.
de: Sie können in der Datei <filename>Makefile</filename> viele Dinge ändern, beispielsweise können Sie den voreingestellten Installationsort für Dateien ändern, idem Sie die Befehlszeilenoption »<command>./configure --prefix=/usr</command>« benutzen.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: You can automate this by using <systemitem role="package">dh-autoreconf</systemitem> package.  See <xref linkend="customrules"/>.
de: Sie können dies automatisieren, indem Sie das Paket <systemitem role="package">dh-autoreconf</systemitem> installieren. Lesen Sie <xref linkend="customrules"/>.

note: type: Content of: <book><chapter><section><para>
en: Although it is not required, updating the <filename>configure</filename> and other files with <literal>autoreconf -i -f</literal> may improve the compatibility of the source.  <placeholder type="footnote" id="0"/>
de: Obwohl es nicht erforderlich ist, kann die Aktualisierung der Datei <filename>configure</filename> und anderer Dateien mittels »<literal>autoreconf -i -f</literal>« die Kompatibilität der Quellen verbessern. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: <ulink url="&cmake;">CMake</ulink> is an alternative build system.  You can recognize such sources by the <filename>CMakeLists.txt</filename> file.
de: <ulink url="http://de.wikipedia.org/wiki/CMake">CMake</ulink> ist ein alternatives Build-System. Sie erkennen solche Quellen an der Datei <filename>CMakeLists.txt</filename>.

note: type: Content of: <book><chapter><section><title>
en: Package name and version
de: Name und Version des Pakets

note: type: Content of: <book><chapter><section><para>
en: If the upstream source comes as <filename>gentoo-0.9.12.tar.gz</filename>, you can take <literal>gentoo</literal> as the (source) <emphasis role="strong">package name</emphasis> and <literal>0.9.12</literal> as the <emphasis role="strong">upstream version</emphasis>.  These are used in the <filename>debian/changelog</filename> file described later in <xref linkend="changelog"/>, too.
de: Falls die Quellen der Originalautoren als <filename>gentoo-0.9.12.tar.gz</filename> existieren, können Sie <literal>gentoo</literal> als (Quell-)<emphasis role="strong">Paketnamen</emphasis> und <literal>0.9.12</literal> als die <emphasis role="strong">Versionsnummer der Originalautoren</emphasis> verwenden. Diese werden in der Datei <filename>debian/changelog</filename> verwandt, die auch später in <xref linkend="changelog"/> beschrieben wird.

note: type: Content of: <book><chapter><section><para>
en: Although this simple approach works most of the time, you may need to adjust <emphasis role="strong">package name</emphasis> and <emphasis role="strong">upstream version</emphasis> by renaming the upstream source to follow Debian Policy and existing convention.
de: Obwohl dieser einfache Ansatz meistens funktioniert, könnte es sein, dass Sie den <emphasis role="strong">Paketnamen</emphasis> und die <emphasis role="strong">Versionsnummer der Originalautoren</emphasis> durch Umbenennen der Originalquellen anpassen müssen, damit diese den Debian-Richtlinien und bestehenden Konventionen genügen.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: The default package name field length of <command>aptitude</command> is 30.  For more than 90% of packages, the package name is less than 24 characters.
de: Die Standardfeldlänge für den Paketnamen beträgt bei <command>aptitude</command> 30. Für mehr als 90% der Pakete ist die Länge des Namens weniger als 24 Zeichen.

note: type: Content of: <book><chapter><section><para>
en: You must choose the <emphasis role="strong">package name</emphasis> to consist only of lower case letters (<literal>a-z</literal>), digits (<literal>0-9</literal>), plus (<literal>+</literal>) and minus (<literal>-</literal>) signs, and periods (<literal>.</literal>). It must be at least two characters long, must start with an alphanumeric character, and must not be the same as existing packages.  It is a good idea to keep its length within 30 characters.  <placeholder type="footnote" id="0"/>
de: Sie müssen den <emphasis role="strong">Paketnamen</emphasis> so wählen, dass er nur aus Kleinbuchstaben (<literal>a-z</literal>), Ziffern (<literal>0-9</literal>), Plus- (<literal>+</literal>) und Minus- (<literal>-</literal>) Zeichen und Punkten (<literal>.</literal>) besteht. Er muss mindestens zwei Zeichen lang sein, mit einem alphanumerischen Zeichen beginnen und darf mit keinem existierenden Paket übereinstimmen. Es empfiehlt sich, die Länge unter 31 Zeichen zu halten. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: If you follow the <ulink url="&devref-newpackage;">Debian Developer's Reference 5.1. "New packages"</ulink>, the ITP process will usually catch this kind of issue.
de: Falls Sie <ulink url="&devref-newpackage;">Debian-Entwicklerreferenz 5.1. »Neue Pakete«</ulink> folgen, wird der ITP-Prozess normalerweise solche Dinge abfangen.

note: type: Content of: <book><chapter><section><para>
en: If upstream uses some generic term such as <literal>test-suite</literal> for its name, it is a good idea to rename it to identify its contents explicitly and avoid namespace pollution.  <placeholder type="footnote" id="0"/>
de: Falls die Originalautoren einen generischen Ausdruck wie <literal>test-suite</literal> für den Namen verwenden, ist es eine gute Idee, ihn umzubenennen, um den Inhalt explizit zu identifizieren und den Namensraum sauber zu halten. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: This stricter rule should help you avoid confusing file names.
de: Diese strengere Regel sollte Ihnen helfen, verwirrende Namen zu vermeiden.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: The default version field length of <command>aptitude</command> is 10.  The Debian revision with preceding hyphen usually consumes 2.  For more than 80% of packages, the upstream version is less than 8 characters and the Debian revision is less than 2 characters.  For more than 90% of packages, the upstream version is less than 10 characters and the Debian revision is less than 3 characters.
de: Die Standardfeldlänge für die Version beträgt bei <command>aptitude</command> 10. Die Debian-Revision mit einleitendem Bindestrich verwendet typischerweise 2 Zeichen. Für mehr als 80% der Pakete ist die Versionsnummer der Originalautoren weniger als 8 Zeichen lang und die Debian-Revision weniger als 2 Zeichen. Für mehr als 90% der Pakete ist die Versionsnummer der Originalautoren weniger als 10 Zeichen lang und die Debian-Revision weniger als 3 Zeichen.

note: type: Content of: <book><chapter><section><para>
en: You should choose the <emphasis role="strong">upstream version</emphasis> to consist only of alphanumerics (<literal>0-9A-Za-z</literal>), plus signs (<literal>+</literal>), tildes (<literal>~</literal>), and periods (<literal>.</literal>). It must start with a digit (<literal>0-9</literal>).  <placeholder type="footnote" id="0"/> It is good idea to keep its length within 8 characters if possible.  <placeholder type="footnote" id="1"/>
de: Sie sollten die <emphasis role="strong">Versionsnummer der Originalautoren</emphasis> so wählen, dass sie nur aus alphanumerischen Zeichen (<literal>0-9A-Za-z</literal>), Pluszeichen (<literal>+</literal>), Tilden (<literal>~</literal>) und Satzpunkten (<literal>.</literal>) besteht. Sie muss mit einer Ziffer (<literal>0-9</literal>) beginnen. <placeholder type="footnote" id="0"/> Es ist eine gute Idee, die Länge falls möglich innerhalb von 8 Zeichen zu halten. <placeholder type="footnote" id="1"/>

note: type: Content of: <book><chapter><section><para>
en: If upstream does not use a normal versioning scheme such as <literal>2.30.32</literal> but uses some kind of date such as <literal>11Apr29</literal>, a random codename string, or a VCS hash value as part of the version, make sure to remove them from the <emphasis role="strong">upstream version</emphasis>.  Such information can be recorded in the <filename>debian/changelog</filename> file.  If you need to invent a version string, use the <literal>YYYYMMDD</literal> format such as <literal>20110429</literal> as upstream version.  This ensures that <command>dpkg</command> interprets later versions correctly as upgrades.  If you need to ensure smooth transition to the normal version scheme such as <literal>0.1</literal> in the future, use the <literal>0~YYMMDD</literal> format such as <literal>0~110429</literal> as the upstream version.
de: Falls die Originalautoren kein normales Versionierungsschema wie <literal>2.30.32</literal> sondern eine Art von Datum wie <literal>11Apr29</literal>, einen zufälligen Kodenamen oder einen VCS-Hashwert als Teil der Version verwenden, stellen Sie sicher, dass sie das von der <emphasis role="strong">Version der Originalautoren</emphasis> entfernen. Diese Informationen können in der Datei <filename>debian/changelog</filename> festgehalten werden. Falls Sie eine Versionsnummer erfinden müssen, verwenden Sie das Format <literal>YYYYMMDD</literal>, wie <literal>20110429</literal>, als Versionsnummer der Originalautoren. Das stellt sicher, dass <command>dpkg</command> neuere Versionen korrekt als Upgrades interpretiert. Falls Sie in der Zukunft reibungslose Übergänge zu dem normalen Versionsschemata wie <literal>0.1</literal> sicherstellen müssen, verwenden Sie das Format <literal>0~YYMMDD</literal>, wie <literal>0~110429</literal>, als Versionsnummer der Originalautoren.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Version strings may be <emphasis role="strong">upstream version</emphasis> (<literal><replaceable>version</replaceable></literal>), <emphasis role="strong">Debian revision</emphasis> (<literal><replaceable>revision</replaceable></literal>), or <emphasis role="strong">version</emphasis> (<literal><replaceable>version</replaceable>-<replaceable>revision</replaceable></literal>).  See <xref linkend="newrevision"/> for how the <emphasis role="strong">Debian revision</emphasis> is incremented.
de: Versionsnummern können die <emphasis role="strong">Versionsnummer der Originalautoren</emphasis> (<literal><replaceable>Version</replaceable></literal>), die <emphasis role="strong">Debian-Revision</emphasis> (<literal><replaceable>Revision</replaceable></literal>) oder die <emphasis role="strong">Version</emphasis> (<literal><replaceable>Version</replaceable>-<replaceable>Revision</replaceable></literal>) sein. Lesen Sie <xref linkend="newrevision"/>, um zu erfahren, wie die <emphasis role="strong">Debian-Revision</emphasis> erhöht wird.

note: type: Content of: <book><chapter><section><para>
en: Version strings <placeholder type="footnote" id="0"/> can be compared using <citerefentry> <refentrytitle>dpkg</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> as follows:
de: Versionsnummern <placeholder type="footnote" id="0"/> können mit <citerefentry> <refentrytitle>dpkg</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> wie folgt verglichen werden:

note: type: Content of: <book><chapter><section><screen>
en: $ dpkg --compare-versions <replaceable>ver1</replaceable> <replaceable>op</replaceable> <replaceable>ver2</replaceable>
de: $ dpkg --compare-versions <replaceable>Ver1</replaceable> <replaceable>Op</replaceable> <replaceable>Ver2</replaceable>

note: type: Content of: <book><chapter><section><para>
en: The version comparison rule can be summarized as:
de: Die Versionsvergleichsregeln können wie folgt zusammengefasst werden:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Strings are compared from the head to the tail.
de: Zeichenketten werden von Anfang bis Ende verglichen.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Letters are larger than digits.
de: Buchstaben sind größer als Ziffern.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Numbers are compared as integers.
de: Zahlen werden als Ganzzahlen verglichen.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Letters are compared in ASCII code order.
de: Buchstaben werden in ASCII-Sortierreihenfolge verglichen.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: There are special rules for period (<literal>.</literal>), plus (<literal>+</literal>), and tilde (<literal>~</literal>) characters, as follows:
de: Es gibt besondere Regeln für Punkt (<literal>.</literal>), Plus- (<literal>+</literal>) und Tilde- (<literal>~</literal>) Zeichen, wie folgt:

note: type: Content of: <book><chapter><section><para>
en: One tricky case occurs when upstream releases <filename>gentoo-0.9.12-ReleaseCandidate-99.tar.gz</filename> as the pre-release of <filename>gentoo-0.9.12.tar.gz</filename>.  You need to make sure that the upgrade works properly by renaming the upstream source to <filename>gentoo-0.9.12~rc99.tar.gz</filename>.
de: Ein schwieriger Fall tritt auf, wenn die Originalautoren <filename>gentoo-0.9.12-ReleaseCandidate-99.tar.gz</filename> als Vorabveröffentlichung von <filename>gentoo-0.9.12.tar.gz</filename> veröffentlichen. Sie müssen sicherstellen, dass das Upgrade korrekt funktioniert, indem Sie die Quellen der Originalautoren in <filename>gentoo-0.9.12~rc99.tar.gz</filename> umbenennen.

note: type: Content of: <book><chapter><section><title>
en: Setting up <command>dh_make</command>
de: Einrichten von <command>dh_make</command>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: The following text assumes you are using Bash as your login shell.  If you use some other login shell such as Z shell, use their corresponding configuration files instead of <filename>~/.bashrc</filename>.
de: Der folgende Text setzt voraus, dass Sie Bash als Login-Shell benutzen. Falls Sie eine andere Login-Shell wie beispielsweise die Z-Shell verwenden, benutzen Sie die entsprechenden Konfigurationsdateien statt <filename>~/.bashrc</filename>.

note: type: Content of: <book><chapter><section><para>
en: Set up the shell environment variables <literal>$DEBEMAIL</literal> and <literal>$DEBFULLNAME</literal> so that various Debian maintenance tools recognize your email address and name to use for packages. <placeholder type="footnote" id="0"/>
de: Richten Sie die Umgebungsvariablen <literal>$DEBEMAIL</literal> und <literal>$DEBFULLNAME</literal> in der Shell ein, damit verschiedene Debian-Wartungswerkzeuge Ihre E-Mail-Adresse und Ihren Namen für Pakete verwenden können. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><screen>
en: $ cat &gt;&gt;~/.bashrc &lt;&lt;EOF
    DEBEMAIL="your.email.address@example.org"
    DEBFULLNAME="Firstname Lastname"
    export DEBEMAIL DEBFULLNAME
    EOF
    $ . ~/.bashrc
de: $ cat &gt;&gt;~/.bashrc &lt;&lt;EOF
    DEBEMAIL="Ihre.E-Mail.Adresse@example.org"
    DEBFULLNAME="Vorname Nachname"
    export DEBEMAIL DEBFULLNAME
    EOF
    $ . ~/.bashrc

note: type: Content of: <book><chapter><section><title>
en: Initial non-native Debian package
de: Das erste nicht native Debian-Paket

note: type: Content of: <book><chapter><section><para>
en: Normal Debian packages are non-native Debian packages made from upstream programs.  If you wish to create a non-native Debian package of an upstream source <filename>gentoo-0.9.12.tar.gz</filename>, you can create an initial non-native Debian package for it by issuing the <command>dh_make</command> command as follows:
de: Normale Debian-Pakete sind nicht native Debian-Pakete, die aus Quellen von Originalautoren erzeugt werden. Falls Sie ein nicht natives Debian-Paket aus den Quellen der Originalautoren <filename>gentoo-0.9.12.tar.gz</filename> erstellen wollen, können sie ein erstes nicht natives Debian-Paket dafür mittels des Befehl <command>dh_make</command> wie folgt erstellen:

note: type: Content of: <book><chapter><section><para><footnote><para>
en: If the upstream source provides the <filename>debian</filename> directory and its contents, run the <command>dh_make</command> command with the extra option <literal>--addmissing</literal>.  The new source <literal>3.0 (quilt)</literal> format is robust enough not to break even for these packages.  You may need to update the contents provided by the upstream version for your Debian package.
de: Wenn die originalen Quellen das Verzeichnis <filename>debian</filename> und seinen Inhalt enthalten, rufen Sie den Befehl <command>dh_make</command> mit der zusätzlichen Option <literal>--addmissing</literal> auf. Das neue Quellformat <literal>3.0 (quilt)</literal> ist robust genug, selbst mit solchen Paketen umzugehen. Sie müssen wahrscheinlich die von der Originalversion bereitgestellten Inhalte für Ihr Debian-Paket aktualisieren.

note: type: Content of: <book><chapter><section><para>
en: Of course, replace the filename with the name of your original source archive.  <placeholder type="footnote" id="0"/> See <citerefentry> <refentrytitle>dh_make</refentrytitle> <manvolnum>8</manvolnum> </citerefentry> for details.
de: Natürlich ersetzen Sie den Dateinamen mit dem Namen Ihres ursprünglichen Quellcode-Archivs. <placeholder type="footnote" id="0"/> Siehe <citerefentry> <refentrytitle>dh_make</refentrytitle> <manvolnum>8</manvolnum> </citerefentry> für Details.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: There are several choices here: <literal>s</literal> for Single binary package, <literal>i</literal> for arch-Independent package, <literal>m</literal> for Multiple binary packages, <literal>l</literal> for Library package, <literal>k</literal> for Kernel module package, <literal>n</literal> for kernel patch package, and <literal>b</literal> for <systemitem role="package">cdbs</systemitem> package.  This document focuses on the use of the <command>dh</command> command (from the package <systemitem role="package">debhelper</systemitem>) to create a single binary package, but also touches on how to use it for arch-independent or multiple binary packages.  The package <systemitem role="package">cdbs</systemitem> offers an alternative packaging script infrastructure to the <command>dh</command> command and is outside the scope of this document.
de: Es gibt hier mehrere Auswahlmöglichkeiten: »<literal>s</literal>« für »Single binary package« (einzelnes Binärpaket), »<literal>i</literal>« für »Arch-Independent package« (Architektur-unabhängiges Paket), »<literal>m</literal>« für »Multiple binary packages« (mehrere Binärpakete), »<literal>l</literal>« für »Library package« (Bibliothekspaket), »<literal>k</literal>« für »Kernel module package« (Kernel-Modul-Paket), »<literal>n</literal>« für »Kernel patch package« (Kernel-Patch-Paket) und »<literal>b</literal>« für »<systemitem role="package">cdbs</systemitem>«-Pakete. Dieses Dokument konzentriert sich auf den Befehl <command>dh</command> (aus dem Paket <systemitem role="package">debhelper</systemitem>), um ein einzelnes Binärpaket zu erstellen, aber zeigt auch auf, wie es für architekturunabhängige Pakete oder mehrere Binärpakete verwandt werden kann. Das Paket <systemitem role="package">cdbs</systemitem> bietet eine alternative Paketierungs-Skriptinfrastruktur zum Befehl <command>dh</command> und wird in diesem Dokument nicht behandelt.

note: type: Content of: <book><chapter><section><para>
en: You should see some output asking you what sort of package you want to create.  Gentoo is a single binary package &#x2014; it creates only one binary package, i.e., one <filename>.deb</filename> file &#x2014; so we will select the first option (with the <literal>s</literal> key), check the information on the screen, and confirm by pressing <literal><replaceable>ENTER</replaceable></literal>.  <placeholder type="footnote" id="0"/>
de: Sie sollten irgendeine Ausgabe sehen, die Sie fragt, welche Art Paket Sie erstellen wollen. Gentoo ist ein »single binary package« &#x2014; es wird nur ein Binärpaket, d.h. eine <filename>.deb</filename>-Datei erstellt, also wählen Sie die erste Option (mit der »<literal>s</literal>«-Taste), überprüfen nochmal die Informationen auf dem Bildschirm und bestätigen mit »<literal><replaceable>EINGABE</replaceable></literal>«. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: This execution of <command>dh_make</command> creates a copy of the upstream tarball as <filename>gentoo_0.9.12.orig.tar.gz</filename> in the parent directory to accommodate the creation of the non-native Debian source package with the name <filename>debian.tar.gz</filename> later:
de: Dieser Aufruf von <command>dh_make</command> erstellt eine Kopie des ursprünglichen Tarballs als <filename>gentoo_0.9.12.orig.tar.gz</filename> im übergeordneten Verzeichnis, um später die Erstellung eines nicht nativen Debian-Quellpakets mit dem Namen <filename>debian.tar.gz</filename> zu ermöglichen:

note: type: Content of: <book><chapter><section><para>
en: Please note two key features of this filename <filename>gentoo_0.9.12.orig.tar.gz</filename>:
de: Bitte beachten Sie zwei entscheidende Merkmale in dem Dateinamen <filename>gentoo_0.9.12.orig.tar.gz</filename>:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Package name and version are separated by the character <literal>_</literal> (underscore).
de: Paketname und Version sind durch das Zeichen »<literal>_</literal>« (Unterstrich) getrennt.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The string <filename>.orig</filename> is inserted before the <filename>.tar.gz</filename>.
de: Die Zeichenkette <filename>.orig</filename> wurde vor dem <filename>.tar.gz</filename> eingefügt.

note: type: Content of: <book><chapter><section><para>
en: You should also notice that many template files are created in the source under the <filename>debian</filename> directory.  These will be explained in <xref linkend="dreq"/> and <xref linkend="dother"/>.  You should also understand that packaging cannot be a fully automated process.  You will need to modify the upstream source for Debian (see <xref linkend="modify"/>).  After this, you need to use the proper methods for building Debian packages (<xref linkend="build"/>), testing them (<xref linkend="checkit"/>), and uploading them (<xref linkend="upload"/>).  All the steps will be explained.
de: Beachten Sie außerdem, dass viele Schablonendateien im Quellverzeichnis im Unterverzeichnis <filename>debian</filename> erstellt werden. Diese werden in <xref linkend="dreq"/> und <xref linkend="dother"/> erklärt. Weiterhin sollte Ihnen klar sein, dass das Paketieren kein vollautomatischer Prozess sein kann. Sie müssen die ursprünglichen Quellen für Debian verändern (siehe <xref linkend="modify"/>). Danach müssen Sie die geeigneten Methoden für den Bau des Debian-Paketes verwenden (<xref linkend="build"/>), sie testen (<xref linkend="checkit"/>) und hochladen (<xref linkend="upload"/>). Alle diese Schritte werden erläutert.

note: type: Content of: <book><chapter><section><para>
en: If you accidentally erased some template files while working on them, you can recover them by running <command>dh_make</command> with the <literal>--addmissing</literal> option again in a Debian package source tree.
de: Wenn Sie versehentlich einige der Schablonendateien gelöscht haben, während Sie sie bearbeitet haben, können Sie diese wiederherstellen, indem Sie erneut <command>dh_make</command> mit der Option <literal>--addmissing</literal> in einem Debian-Quellverzeichnis aufrufen.

note: type: Content of: <book><chapter><section><para>
en: Updating an existing package may get complicated since it may be using older techniques.  While learning the basics, please stick to creating a fresh package; further explanations are given in <xref linkend="update"/>.
de: Das Aktualisieren eines existierenden Pakets kann kompliziert werden, weil es eventuell ältere Techniken verwendet. Während Sie die Grundlagen lernen, bleiben Sie bei der Erstellung eines neuen Pakets; weitere Erklärungen werden in <xref linkend="update"/> gegeben.

note: type: Content of: <book><chapter><section><para>
en: Please note that the source file does not need to contain any build system discussed in <xref linkend="simplemake"/> and <xref linkend="portable"/>.  It could be just a collection of graphical data, etc.  Installation of files may be carried out using only <systemitem role="package">debhelper</systemitem> configuration files such as <filename>debian/install</filename> (see <xref linkend="install"/>).
de: Bitte beachten Sie, dass die Quellen kein in <xref linkend="simplemake"/> und <xref linkend="portable"/> beschriebenes Bausystem enthalten müssen. Es könnte eine reine Sammlung von graphischen Daten usw. sein. Die Installation der Dateien könnte rein mit <systemitem role="package">debhelper</systemitem>-Konfigurationsdateien wie <filename>debian/install</filename> (siehe <xref linkend="install"/>) erfolgen.

note: type: Content of: <book><chapter><title>
en: Modifying the source
de: Den Quellcode verändern

note: type: Content of: <book><chapter><para>
en: Please note that there isn't space here to go into <emphasis>all</emphasis> the details of fixing upstream sources, but here are some basic steps and problems people often run across.
de: Bitte beachten Sie, dass an dieser Stelle nicht auf <emphasis>alle</emphasis> Details eingegangen wird, wie die ursprünglichen Quellen korrigiert werden können, aber hier sind ein paar grundlegende Schritte und Probleme, auf die man häufig stößt.

note: type: Content of: <book><chapter><section><title>
en: Setting up <command>quilt</command>
de: Einrichten von <command>quilt</command>

note: type: Content of: <book><chapter><section><para>
en: The program <command>quilt</command> offers a basic method for recording modifications to the upstream source for Debian packaging.  It's useful to have a slightly customized default, so let's create an alias <command>dquilt</command> for Debian packaging by adding the following lines to <filename>~/.bashrc</filename>.  The second line provides the same shell completion feature of the <command>quilt</command> command to the <command>dquilt</command> command:
de: Das Programm <command>quilt</command> bietet eine grundlegende Methode, um Änderungen an den ursprünglichen Quellen für das Debian-Paket aufzuzeichnen. Es ist sinnvoll, eine leicht geänderte Voreinstellung zu verwenden, daher sollte ein Alias <command>dquilt</command> für die Debian-Paketierung erstellt werden, indem folgendes zur <filename>~/.bashrc</filename> hinzugefügt wird; dabei stellt die zweite Zeile die gleiche Shell-Vervollständigungsfunktionalität wie der Befehl <command>quilt</command> für den Befehl <command>dquilt</command> bereit:

note: type: Content of: <book><chapter><section><para>
en: Then let's create <filename>~/.quiltrc-dpkg</filename> as follows:
de: Dann erstellen Sie die <filename>~/.quiltrc-dpkg</filename> wie folgt:

note: type: Content of: <book><chapter><section><screen>
en: d=. ; while [ ! -d $d/debian -a $(readlink -e $d) != / ]; do d=$d/..; done
    if [ -d $d/debian ] &amp;&amp; [ -z $QUILT_PATCHES ]; then
        # if in Debian packaging tree with unset $QUILT_PATCHES
        QUILT_PATCHES="debian/patches"
        QUILT_PATCH_OPTS="--reject-format=unified"
        QUILT_DIFF_ARGS="-p ab --no-timestamps --no-index --color=auto"
        QUILT_REFRESH_ARGS="-p ab --no-timestamps --no-index"
        QUILT_COLORS="diff_hdr=1;32:diff_add=1;34:diff_rem=1;31:diff_hunk=1;33:diff_ctx=35:diff_cctx=33"
        if ! [ -d $d/debian/patches ]; then mkdir $d/debian/patches; fi
    fi
de: d=. ; while [ ! -d $d/debian -a $(readlink -e $d) != / ]; do d=$d/..; done
    if [ -d $d/debian ] &amp;&amp; [ -z $QUILT_PATCHES ]; then
        # falls in Debian-Paketbaum mit ungesetztem $QUILT_PATCHES
        QUILT_PATCHES="debian/patches"
        QUILT_PATCH_OPTS="--reject-format=unified"
        QUILT_DIFF_ARGS="-p ab --no-timestamps --no-index --color=auto"
        QUILT_REFRESH_ARGS="-p ab --no-timestamps --no-index"
        QUILT_COLORS="diff_hdr=1;32:diff_add=1;34:diff_rem=1;31:diff_hunk=1;33:diff_ctx=35:diff_cctx=33"
        if ! [ -d $d/debian/patches ]; then mkdir $d/debian/patches; fi
    fi

note: type: Content of: <book><chapter><section><para>
en: See <citerefentry> <refentrytitle>quilt</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> and <filename>&quilt-pdf;</filename> on how to use <command>quilt</command>.
de: Siehe <citerefentry> <refentrytitle>quilt</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> und <filename>&quilt-pdf;</filename> für eine Anleitung, wie <command>quilt</command> benutzt wird.

note: type: Content of: <book><chapter><section><title>
en: Fixing upstream bugs
de: Fehler in den ursprünglichen Quellen korrigieren

note: type: Content of: <book><chapter><section><para>
en: Let's assume you find an error in the upstream <filename>Makefile</filename> as follows, where <literal>install: gentoo</literal> should have been <literal>install: gentoo-target</literal>.
de: Nehmen wir an, Sie finden den folgenden Fehler in dem ursprünglichen <filename>Makefile</filename>, wo statt »<literal>install: gentoo</literal>« besser »<literal>install: gentoo-target</literal>« stehen sollte.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: The <filename>debian/patches</filename> directory should exist now if you ran <command>dh_make</command> as described before.  This example operation creates it just in case you are updating an existing package.
de: Das Verzeichnis <filename>debian/patches</filename> sollte inzwischen existieren, wenn Sie <command>dh_make</command> wie vorher beschrieben ausgeführt haben. In diesem Beispiel wird es sicherheitshalber erstellt, nur für den Fall, dass Sie ein existierendes Paket aktualisieren.

note: type: Content of: <book><chapter><section><para>
en: Let's fix this and record it with the <command>dquilt</command> command as <filename>fix-gentoo-target.patch</filename>: <placeholder type="footnote" id="0"/>
de: Wir beheben dies und speichern es mit dem Befehl <command>quilt</command> wie folgt als <filename>fix-gentoo-target.patch</filename>: <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: You change the <filename>Makefile</filename> file as follows:
de: Sie können die Datei <filename>Makefile</filename> wie folgt ändern:

note: type: Content of: <book><chapter><section><para>
en: Ask <command>dquilt</command> to generate the patch to create <filename>debian/patches/fix-gentoo-target.patch</filename> and add its description following <ulink url="&dep3;">DEP-3: Patch Tagging Guidelines</ulink>:
de: Jetzt muss <command>dquilt</command> noch mitgeteilt werden, dass der Patch erzeugt werden soll, so dass die Datei <filename>debian/patches/fix-gentoo-target.patch</filename> erstellt wird. Außerdem sollten Sie eine Beschreibung gemäß <ulink url="&dep3;">DEP-3: Patch Tagging Guidelines</ulink> hinzufügen:

note: type: Content of: <book><chapter><section><screen>
en: $ dquilt refresh
    $ dquilt header -e
    ... describe patch
de: $ dquilt refresh
    $ dquilt header -e
    ... Patch beschreiben

note: type: Content of: <book><chapter><section><title>
en: Installation of files to their destination
de: Installation von Dateien in ihr Zielverzeichnis

note: type: Content of: <book><chapter><section><para>
en: Most third-party software installs itself in the <filename>/usr/local</filename> directory hierarchy.  On Debian this is reserved for private use by the system administrator, so packages must not use directories such as <filename>/usr/local/bin</filename> but should instead use system directories such as <filename>/usr/bin</filename>, obeying the <ulink url="&fhs;">Filesystem Hierarchy Standard</ulink> (FHS).
de: Die meisten Programme Dritter installieren sich in die Verzeichnishierachie <filename>/usr/local</filename>. Unter Debian ist diese für die private Benutzung durch den Systemadministrator reserviert, daher dürfen Pakete Verzeichnisse wie <filename>/usr/local/bin</filename> nicht verwenden, sondern sollten stattdessen Systemverzeichnisse wie <filename>/usr/bin</filename> verwenden und dem <ulink url="&fhs;">Filesystem Hierarchy Standard</ulink> (FHS) folgen.

note: type: Content of: <book><chapter><section><para>
en: Normally, <citerefentry> <refentrytitle>make</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> is used to automate building the program, and executing <literal>make install</literal> installs programs directly to the desired destination (following the <literal>install</literal> target in the <filename>Makefile</filename>).  In order for Debian to provide pre-built installable packages, it modifies the build system to install programs into a file tree image created under a temporary directory instead of the actual destination.
de: Normalerweise wird <citerefentry> <refentrytitle>make</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> benutzt, um das Programm automatisch zu bauen. Der Aufruf von »<literal>make install</literal>« installiert das Programm dann direkt in das Ziel (gemäß dem <literal>install</literal>-Ziel des <filename>Makefile</filename>s). Damit Debian vorab erstellte installierbare Pakete bereitstellen kann, verändert es das Bausystem, um Programme in ein Dateisystem-Abbild, welches unter einem temporären Verzeichnis erstellt wurde, anstatt in das tatsächliche Ziel zu installieren.

note: type: Content of: <book><chapter><section><para>
en: These two differences between normal program installation on one hand and the Debian packaging system on the other can be transparently addressed by the <systemitem role="package">debhelper</systemitem> package through the <command>dh_auto_configure</command> and <command>dh_auto_install</command> commands if the following conditions are met:
de: Diese beiden Unterschiede zwischen einerseits der normalen Programminstallation und andererseits dem Paketieren für Debian können vom Paket <systemitem role="package">Debhelper</systemitem> transparent adressiert werden. Es benutzt dazu die Befehle <command>dh_auto_configure</command> und <command>dh_auto_install</command>, sofern die folgenden Bedingungen erfüllt sind:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para><footnote><para>
en: See <ulink url="&gnu-destdir;">GNU Coding Standards: 7.2.4 DESTDIR: Support for Staged Installs</ulink>.
de: Lesen Sie <ulink url="&gnu-destdir;">GNU Coding Standards: 7.2.4 DESTDIR: Support for Staged Installs</ulink>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The <filename>Makefile</filename> must follow GNU conventions and support the <literal>$(DESTDIR)</literal> variable.  <placeholder type="footnote" id="0"/>
de: Das <filename>Makefile</filename> muss den GNU-Konventionen folgen und die Variable <literal>$(DESTDIR)</literal> unterstützen. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The source must follow the Filesystem Hierarchy Standard (FHS).
de: Die Quelle muss dem »Filesystem Hierarchy Standard« (FHS) folgen.

note: type: Content of: <book><chapter><section><para>
en: Programs that use GNU <command>autoconf</command> follow the GNU conventions automatically, so they can be trivial to package.  On the basis of this and other heuristics, it is estimated that the <systemitem role="package">debhelper</systemitem> package will work for about 90% of packages without making any intrusive changes to their build system.  So packaging is not as complicated as it may seem.
de: Programme, die GNU <command>autoconf</command> einsetzen, folgen automatisch den GNU-Konventionen, so dass sie trivial zu paketieren sind. Aufgrund dieser Tatsache und weiterer Heuristik wird geschätzt, dass das Paket <systemitem role="package">debhelper</systemitem> für ungefähr 90% aller Pakete richtig funktionieren wird, ohne dass irgendwelche tiefgreifenden Änderungen an deren Build-Systemen vorgenommen werden müssen. Daher ist das Paketieren nicht so kompliziert, wie es zunächst aussieht.

note: type: Content of: <book><chapter><section><para>
en: If you need to make changes in the <filename>Makefile</filename>, you should be careful to support the <literal>$(DESTDIR)</literal> variable.  Although it is unset by default, the <literal>$(DESTDIR)</literal> variable is prepended to each file path used for the program installation.  The packaging script will set <literal>$(DESTDIR)</literal> to the temporary directory.
de: Falls Sie Änderungen an dem <filename>Makefile</filename> vornehmen müssen, sollten Sie vorsichtig sein, dass die Variable <literal>$(DESTDIR)</literal> unterstützt wird. Obwohl sie standardmäßig nicht gesetzt ist, wird die Variable <literal>$(DESTDIR)</literal> jedem Dateipfad vorangestellt, der für die Programminstallation verwendet wird. Das Skript für das Paketieren setzt <literal>$(DESTDIR)</literal> auf das temporäre Verzeichnis.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: For a source package generating multiple binary packages, the <command>dh_auto_install</command> command uses <filename>debian/tmp</filename> as the temporary directory while the <command>dh_install</command> command with the help of <filename>debian/<replaceable>package-1</replaceable>.install</filename> and <filename>debian/<replaceable>package-2</replaceable>.install</filename> files will split the contents of <filename>debian/tmp</filename> into <filename>debian/<replaceable>package-1</replaceable></filename> and <filename>debian/<replaceable>package-2</replaceable></filename> temporary directories, to create <filename><replaceable>package-1</replaceable>_*.deb</filename> and <filename><replaceable>package-2</replaceable>_*.deb</filename> binary packages.
de: Bei einem Quellpaket, das mehrere Binärpakete erstellt, verwendet der Befehl <command>dh_auto_install</command> das temporäre Verzeichnis <filename>debian/tmp</filename>. Der Befehl <command>dh_install</command> teilt dann den Inhalt von <filename>debian/tmp</filename> mit Hilfe von <filename>debian/<replaceable>Paket-1</replaceable>.install</filename> und <filename>debian/<replaceable>Paket-2</replaceable>.install</filename> in die temporären Verzeichnisse <filename>debian/<replaceable>Paket-1</replaceable></filename> und <filename>debian/<replaceable>Paket-2</replaceable></filename> auf, um daraus die Binärpakete <filename><replaceable>Paket-1</replaceable>_*.deb</filename> und <filename><replaceable>Paket-2</replaceable>_*.deb</filename> zu erstellen.

note: type: Content of: <book><chapter><section><para>
en: For a source package generating a single binary package, the temporary directory used by the <command>dh_auto_install</command> command will be set to <filename>debian/<replaceable>package</replaceable></filename>.  <placeholder type="footnote" id="0"/> Everything that is contained in the temporary directory will be installed on users' systems when they install your package; the only difference is that <command>dpkg</command> will be installing the files to paths relative to the root directory rather than your working directory.
de: Bei einem Quellpaket, das ein einzelnes Binärpaket erstellt, wird das temporäre Verzeichnis, das vom Befehl <command>dh_auto_install</command> benutzt wird, auf <filename>debian/<replaceable>Paket</replaceable></filename> gesetzt. <placeholder type="footnote" id="0"/> Alles, was im temporären Verzeichnis enthalten ist, wird auf dem System eines Benutzers installiert, wenn dieser Ihr Paket installiert. Der einzige Unterschied ist, dass <command>dpkg</command> die Dateien relativ zum Wurzelverzeichnis statt zu Ihrem Arbeitsverzeichnis installieren wird.

note: type: Content of: <book><chapter><section><para>
en: Bear in mind that even though your program installs in <filename>debian/<replaceable>package</replaceable></filename>, it still needs to behave correctly when installed from the <filename>.deb</filename> package under the root directory.  So you must not allow the build system to hardcode strings like <literal>/home/me/deb/<replaceable>package</replaceable>-<replaceable>version</replaceable>/usr/share/<replaceable>package</replaceable></literal> into files in the package.
de: Vergessen Sie nicht, dass Ihr Programm zwar unter <filename>debian/<replaceable>Paket</replaceable></filename> installiert wird, es sich aber trotzdem korrekt verhalten muss, wenn es aus dem <filename>.deb</filename>-Paket unter dem Wurzelverzeichnis installiert wird. Daher dürfen durch das Build-System keine fest eingestellten Zeichenketten wie <literal>/home/ich/deb/<replaceable>Paket</replaceable>-<replaceable>Version</replaceable>/usr/share/<replaceable>Paket</replaceable></literal> für Dateien im Paket festgeschrieben werden.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: This is just an example to show what a <filename>Makefile</filename> should look like.  If the <filename>Makefile</filename> is created by the <command>./configure</command> command, the correct way to fix this kind of <filename>Makefile</filename> is to execute <command>./configure</command> from the <command>dh_auto_configure</command> command with default options including <literal>--prefix=/usr</literal>.
de: Dies ist nur ein Beispiel, wie ein <filename>Makefile</filename> aussehen sollte. Falls die <filename>Makefile</filename>-Datei durch den Befehl <command>./configure</command> erstellt wird, ist die richtige Vorgehensweise, um diese Art <filename>Makefile</filename> zu korrigieren, <command>./configure</command> durch den Befehl <command>dh_auto_configure</command> aufrufen zu lassen. Dabei kommen die voreingestellten Optionen zum Tragen, einschließlich der Option <literal>--prefix=/usr</literal>.

note: type: Content of: <book><chapter><section><para>
en: Here's the relevant part of <systemitem role="package">gentoo</systemitem>'s <filename>Makefile</filename><placeholder type="footnote" id="0"/>:
de: Dies ist der relevante Abschnitt aus dem <filename>Makefile</filename><placeholder type="footnote" id="0"/> von <systemitem role="package">gentoo</systemitem>:

note: type: Content of: <book><chapter><section><para>
en: We see that the files are set to install under <filename>/usr/local</filename>.  As explained above, that directory hierarchy is reserved for local use on Debian, so change those paths as follows:
de: Sie sehen, dass die Dateien unter <filename>/usr/local</filename> installiert werden sollen. Wie oben erklärt ist diese Verzeichnis-Hierarchie unter Debian für lokale Benutzung reserviert, ändern Sie daher diese Pfade wie folgt:

note: type: Content of: <book><chapter><section><para>
en: The exact locations that should be used for binaries, icons, documentation, etc. are specified in the Filesystem Hierarchy Standard (FHS).  You should browse through it and read the sections relevant to your package.
de: Der genaue Ort, der für Programme, Icons, Dokumentation usw. verwandt werden sollte, ist im »Filesystem Hierarchy Standard« (FHS) spezifiziert. Sie sollten ihn durchblättern und die für Ihr Paket relevanten Abschnitte lesen.

note: type: Content of: <book><chapter><section><para>
en: So, we should install executable commands in <filename>/usr/bin</filename> instead of <filename>/usr/local/bin</filename>, the manual page in <filename>/usr/share/man/man1</filename> instead of <filename>/usr/local/man/man1</filename>, and so on.  Notice how there's no manual page mentioned in <systemitem role="package">gentoo</systemitem>'s <filename>Makefile</filename>, but since Debian Policy requires that every program has one, we'll make one later and install it in <filename>/usr/share/man/man1</filename>.
de: Sie sollten also ausführbare Befehle in <filename>/usr/bin/</filename> statt <filename>/usr/local/bin/</filename> installieren, die Handbuchseiten in <filename>/usr/share/man/man1/</filename> statt <filename>/usr/local/man/man1/</filename> usw. Beachten Sie, dass im <filename>Makefile</filename> von <systemitem role="package">gentoo</systemitem> keine Handbuchseite auftaucht. Da die Debian-Richtlinien aber verlangen, dass jedes Programm eine hat, schreiben Sie später eine und installieren sie unter <filename>/usr/share/man/man1/</filename>.

note: type: Content of: <book><chapter><section><para>
en: Some programs don't use <filename>Makefile</filename> variables to define paths such as these.  This means you might have to edit some real C sources in order to fix them to use the right locations.  But where to search, and exactly what for? You can find this out by issuing:
de: Manche Programme nutzen die <filename>Makefile</filename>-Variablen nicht, um solche Pfade zu definieren. Das bedeutet, dass Sie wahrscheinlich die C-Quelltexte direkt bearbeiten müssen, damit diese dann die richtigen Pfade benutzen. Aber wo soll man suchen, und wonach eigentlich genau? Sie können dies herausfinden, indem Sie folgendes eingeben:

note: type: Content of: <book><chapter><section><para>
en: <command>grep</command> will run recursively through the source tree and tell you the filename and the line number for all matches.
de: <command>Grep</command> durchsucht das Quellverzeichnis rekursiv und gibt Ihnen den Dateinamen und die Zeilennummer für alle Treffer aus.

note: type: Content of: <book><chapter><section><para>
en: Edit those files and in those lines replace <literal>usr/local/lib</literal> with <literal>usr/lib</literal>.  This can be done automatically as follows:
de: Sie müssen diese Dateien nun bearbeiten und in den entsprechenden Zeilen <literal>usr/local/lib</literal> durch <literal>usr/lib</literal> ersetzen. Dies kann wie folgt automatisch erledigt werden:

note: type: Content of: <book><chapter><section><para>
en: If you want to confirm each substitution instead, this can be done interactively as follows:
de: Falls Sie stattdessen jede Ersetzung bestätigen möchten, kann dies wie folgt interaktiv durchgeführt werden:

note: type: Content of: <book><chapter><section><para>
en: Next you should find the <literal>install</literal> target (searching for the line that starts with <literal>install:</literal> will usually work) and rename all references to directories other than ones defined at the top of the <filename>Makefile</filename>.
de: Als nächstes sollten Sie das »install«-Ziel suchen (suchen Sie nach der Zeile, die mit <literal>install:</literal> beginnt, das funktioniert üblicherweise) und alle Verweise auf Verzeichnisse umbenennen, die nicht denen entsprechen, die Sie am Anfang des <filename>Makefile</filename>s definiert haben.

note: type: Content of: <book><chapter><section><para>
en: Originally, <systemitem role="package">gentoo</systemitem>'s <literal>install</literal> target said:
de: Ursprünglich sah das <literal>install</literal>-Ziel von <systemitem role="package">gentoo</systemitem> wie folgt aus:

note: type: Content of: <book><chapter><section><para>
en: Let's fix this upstream bug and record it with the <command>dquilt</command> command as <filename>debian/patches/install.patch</filename>.
de: Wir beheben diesen Fehler der Originalautoren und speichern es mit dem Befehl <command>dquilt</command> als <filename>debian/patches/install.patch</filename>.

note: type: Content of: <book><chapter><section><para>
en: In your editor, change this for the Debian package as follows:
de: Wir ändern dies für das Debian-Paket im Editor wie folgt:

note: type: Content of: <book><chapter><section><para>
en: You'll have noticed that there's now an <literal>install -d</literal> command before the other commands in the rule.  The original <filename>Makefile</filename> didn't have it because usually <literal>/usr/local/bin</literal> and other directories already exist on the system where you are running <literal>make install</literal>.  However, since we will be installing into a newly created private directory tree, we will have to create each and every one of those directories.
de: Sie haben bemerkt, dass jetzt der Befehl »<literal>install -d</literal>« vor den anderen Befehlen in dieser Regel steht. Das ursprüngliche <filename>Makefile</filename> hatte das nicht, weil normalerweise <literal>/usr/local/bin/</literal> und andere Verzeichnisse schon auf dem System vorhanden sind, wenn Sie »<literal>make install</literal>« aufrufen. Weil wir aber in unseren frisch erstellten Verzeichnisbaum installieren, müssen wir jedes einzelne dieser Verzeichnisse anlegen.

note: type: Content of: <book><chapter><section><para>
en: We can also add in other things at the end of the rule, like the installation of additional documentation that the upstream authors sometimes omit:
de: Wir können am Ende der Regel noch weitere Dinge einfügen, wie beispielsweise die Installation zusätzlicher Dokumentation, die die Originalautoren manchmal weglassen:

note: type: Content of: <book><chapter><section><para>
en: Check carefully, and if everything is okay, ask <command>dquilt</command> to generate the patch to create <filename>debian/patches/install.patch</filename> and add its description:
de: Überprüfen Sie alles sorgfältig und falls es in Ordnung ist, bitten Sie <command>dquilt</command>, den Patch zu erstellen und die Datei <filename>debian/patches/install.patch</filename> neu zu erstellen. Fügen Sie außerdem noch eine Beschreibung hinzu:

note: type: Content of: <book><chapter><section><para>
en: Now you have a series of patches.
de: Jetzt haben Sie eine Reihenfolge von Patches.

note: type: Content of: <book><chapter><section><orderedlist><listitem><para>
en: Upstream bug fix: <filename>debian/patches/fix-gentoo-target.patch</filename>
de: Die Fehlerkorrektur der originalen Quellen: <filename>debian/patches/fix-gentoo-target.patch</filename>

note: type: Content of: <book><chapter><section><orderedlist><listitem><para>
en: Debian specific packaging modification: <filename>debian/patches/install.patch</filename>
de: Die Debian-spezifische Änderung für's Paketieren: <filename>debian/patches/install.patch</filename>

note: type: Content of: <book><chapter><section><para>
en: Whenever you make changes that are not specific to the Debian package such as <filename>debian/patches/fix-gentoo-target.patch</filename>, be sure to send them to the upstream maintainer so they can be included in the next version of the program and be useful to everyone else.  Also remember to avoid making your fixes specific to Debian or Linux &#x2014; or even Unix! Make them portable.  This will make your fixes much easier to apply.
de: Wann immer Sie Änderungen machen, die nicht spezifisch für das Debian-Paket sind (so wie <filename>debian/patches/fix-gentoo-target.patch</filename>), sollten Sie diese dem Betreuer des Originalprogramms zukommen lassen, damit er sie in der nächsten Programmversion verwenden kann und sie für andere auch nützlich sind. Denken Sie auch daran, Ihre Patches nicht spezifisch für Debian oder Linux (oder sogar Unix!) zu gestalten, sondern sie portierbar zu erstellen. Dadurch können Ihre Änderungen wesentlich leichter übernommen werden.

note: type: Content of: <book><chapter><section><para>
en: Note that you don't have to send the <filename>debian/*</filename> files upstream.
de: Beachten Sie, dass Sie dem Originalautor die <filename>debian/*</filename>-Dateien nicht schicken müssen.

note: type: Content of: <book><chapter><section><title>
en: Differing libraries
de: Unterschiedliche Bibliotheken

note: type: Content of: <book><chapter><section><para>
en: There is one other common problem: libraries are often different from platform to platform.  For example, a <filename>Makefile</filename> can contain a reference to a library that doesn't exist on the Debian system.  In that case, we need to change it to a library that does exist in Debian, and serves the same purpose.
de: Es gibt ein anderes typisches Problem: Bibliotheken variieren oft von Plattform zu Plattform. Beispielsweise kann ein <filename>Makefile</filename> eine Referenz auf eine Bibliothek enthalten, die auf Debian-Systemen nicht existiert. In diesem Fall müssen wir sie auf eine Bibliothek ändern, die unter Debian existiert und den gleichen Zweck erfüllt.

note: type: Content of: <book><chapter><section><para>
en: Let's assume a line in your program's <filename>Makefile</filename> (or <filename>Makefile.in</filename>) as the following.
de: Nehmen wir an, eine Datei in dem <filename>Makefile</filename> (oder <filename>Makefile.in</filename>) Ihres Programms lautet wie folgt:

note: type: Content of: <book><chapter><section><para><footnote><para>
en: If there are API changes from the <literal>foo</literal> library to the <literal>foo2</literal> library, required changes to the source code need to be made to match the new API.
de: Falls es API-Änderungen von der Bibliothek <literal>foo</literal> zu der Bibliothek <literal>foo2</literal> gibt, müssen die Quellen entsprechend angepasst werden, um zur neuen API zu passen.

note: type: Content of: <book><chapter><section><para>
en: If your program doesn't compile since the <literal>foo</literal> library doesn't exist and its equivalent is provided by the <literal>foo2</literal> library on the Debian system, you can fix this build problem as <filename>debian/patches/foo2.patch</filename> by changing <literal>foo</literal> into <literal>foo2</literal>:<placeholder type="footnote" id="0"/>
de: Falls Ihr Programm nicht übersetzt, da die Bibliothek <literal>foo</literal> nicht existiert und auf Debian-Systemen ihr Äquivalent von der Bibliothek <literal>foo2</literal> bereitgestellt wird, können Sie dieses Bauproblem mittels <filename>debian/patches/foo2.patch</filename> beheben, indem Sie <literal>foo</literal> in <literal>foo2</literal> ändern: <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><screen>
en: $ dquilt new foo2.patch
    $ dquilt add Makefile
    $ sed -i -e 's/-lfoo/-lfoo2/g' Makefile
    $ dquilt refresh
    $ dquilt header -e
    ... describe patch
de: $ dquilt new foo2.patch
    $ dquilt add Makefile
    $ sed -i -e 's/-lfoo/-lfoo2/g' Makefile
    $ dquilt refresh
    $ dquilt header -e
    … Patch beschreiben

note: type: Content of: <book><chapter><title>
en: Required files under the <filename>debian</filename> directory
de: Benötigte Dateien im Verzeichnis <filename>debian</filename>

note: type: Content of: <book><chapter><para>
en: In this chapter, files in the <filename>debian</filename> directory are referred to without the leading <filename>debian/</filename> for simplicity whenever the meaning is obvious.
de: In diesem Kapitel werden zur Vereinfachung Dateien im Verzeichnis <filename>debian</filename> ohne das einleitende <filename>debian/</filename> referenziert, wann immer die Bedeutung eindeutig ist.

note: type: Content of: <book><chapter><para>
en: There is a new subdirectory under the program's source directory, called <filename>debian</filename>.  There are a number of files in this directory that we should edit in order to customize the behavior of the package.  The most important of them are <filename>control</filename>, <filename>changelog</filename>, <filename>copyright</filename>, and <filename>rules</filename>, which are required for all packages.  <placeholder type="footnote" id="0"/>
de: Im Quellverzeichnis des Programms gibt es ein neues Unterverzeichnis, das <filename>debian</filename> heißt. In diesem Verzeichnis sind einige Dateien, die wir ändern müssen, um die Eigenschaften des Pakets anzupassen. Die wichtigsten davon sind <filename>control</filename>, <filename>changelog</filename>, <filename>copyright</filename> und <filename>rules</filename>, die für jedes Paket benötigt werden. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: This file contains various values which <command>dpkg</command>, <command>dselect</command>, <command>apt-get</command>, <command>apt-cache</command>, <command>aptitude</command>, and other package management tools will use to manage the package.  It is defined by the <ulink url="&policy-control;">Debian Policy Manual, 5 "Control files and their fields"</ulink>.
de: Diese Datei enthält verschiedene Werte, die <command>dpkg</command>, <command>dselect</command>, <command>apt-get</command>, <command>apt-cache</command>, <command>aptitude</command> und andere Paketverwaltungswerkzeuge verwenden, um das Paket zu verwalten. Sie ist im <ulink url="&policy-control;">Debian Policy Manual, Kapitel 5 »Control files and their fields«</ulink> definiert.

note: type: Content of: <book><chapter><section><para>
en: Here is the <filename>control</filename> file <command>dh_make</command> created for us:
de: Dies ist die Datei <filename>control</filename>, die <command>dh_make</command> für uns erstellt hat:

note: type: Content of: <book><chapter><section><screen>
en:  1 Source: gentoo
     2 Section: unknown
     3 Priority: optional
     4 Maintainer: Josip Rodin &lt;joy-mg@debian.org&gt;
     5 Build-Depends: debhelper (&gt;=10)
     6 Standards-Version: 4.0.0
     7 Homepage: &lt;insert the upstream URL, if relevant&gt;
     8
     9 Package: gentoo
    10 Architecture: any
    11 Depends: ${shlibs:Depends}, ${misc:Depends}
    12 Description: &lt;insert up to 60 chars description&gt;
    13  &lt;insert long description, indented with spaces&gt;
de:  1 Source: gentoo
     2 Section: unknown
     3 Priority: optional
     4 Maintainer: Josip Rodin &lt;joy-mg@debian.org&gt;
     5 Build-Depends: debhelper (&gt;=10)
     6 Standards-Version: 4.0.0
     7 Homepage: &lt;URL der Originalautoren einfügen, falls relevant&gt;
     8
     9 Package: gentoo
    10 Architecture: any
    11 Depends: ${shlibs:Depends}, ${misc:Depends}
    12 Description: &lt; bis zu 60 Zeichen Beschreibung einfügen&gt;
    13  &lt;lange Beschreibung einfügen, mit Leerzeichen eingerückt&gt;

note: type: Content of: <book><chapter><section><para>
en: (I've added the line numbers.)
de: (Die Zeilennummerierung habe ich hinzugefügt.)

note: type: Content of: <book><chapter><section><para>
en: Lines 1&#x2013;7 are the control information for the source package.  Lines 9&#x2013;13 are the control information for the binary package.
de: Die Zeilen 1-7 sind die Steuerinformationen für das Quellcode-Paket. Zeilen 9-13 sind die Steuerinformationen für das Binärpaket.

note: type: Content of: <book><chapter><section><para>
en: Line 1 is the name of the source package.
de: Zeile 1 ist der Name des Quellcode-Pakets.

note: type: Content of: <book><chapter><section><para>
en: Line 2 is the section of the distribution the source package goes into.
de: Zeile 2 bestimmt den Bereich (Section) der Distribution, in die das Quellcode-Paket gehört.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&policy-subsections;">Debian Policy Manual, 2.4 "Sections"</ulink> and <ulink url="&sections-unstable;">List of sections in <literal>sid</literal></ulink>.
de: Lesen Sie das <ulink url="&policy-subsections;">Debian Policy Manual, Kapitel 2.4 »Sections«</ulink> und <ulink url="&sections-unstable;">Liste der Abschnitte in <literal>sid</literal></ulink>.

note: type: Content of: <book><chapter><section><para>
en: As you may have noticed, the Debian archive is divided into multiple areas: <literal>main</literal> (the free software), <literal>non-free</literal> (the not really free software) and <literal>contrib</literal> (free software that depends on non-free software).  Each of these is divided into sections that classify packages into rough categories.  So we have <literal>admin</literal> for administrator-only programs, <literal>devel</literal> for programmer tools, <literal>doc</literal> for documentation, <literal>libs</literal> for libraries, <literal>mail</literal> for email readers and daemons, <literal>net</literal> for network apps and daemons, <literal>x11</literal> for X11 programs that don't fit anywhere else, and many more.  <placeholder type="footnote" id="0"/>
de: Sie haben bestimmt schon gemerkt, dass das Debian-Archiv in mehrere Bereiche aufgeteilt ist: <literal>main</literal> (freie Software), <literal>non-free</literal> (nicht wirklich freie Software) und <literal>contrib</literal> (freie Software, die von non-free-Software abhängt). Jeder davon ist in Abschnitte eingeteilt, die die Pakete in grobe Kategorien sortieren. Dementsprechend gibt es <literal>admin</literal> für Programme für Administratoren, <literal>devel</literal> für Programmierwerkzeuge, <literal>doc</literal> für Dokumentation, <literal>libs</literal> für Programmbibliotheken, <literal>mail</literal> für E-Mail-Leseprogramme und -Daemons, <literal>net</literal> für Netzwerk-Anwendungen und Daemons, <literal>x11</literal> für X11-Programme, die nirgendwo anders unterkommen, und viele mehr. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: Let's change it then to x11.  (A <literal>main/</literal> prefix is implied so we can omit it.)
de: Ändern Sie den Bereich also in x11 (das Präfix <literal>main/</literal> wird impliziert, also können wir es weglassen).

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&policy-priorities;">Debian Policy Manual, 2.5 "Priorities"</ulink>.
de: Lesen Sie das <ulink url="&policy-priorities;">Debian Policy Manual, Kapitel 2.5 »Priorities«</ulink>.

note: type: Content of: <book><chapter><section><para>
en: Line 3 describes how important it is that the user installs this package.  <placeholder type="footnote" id="0"/>
de: Zeile 3 beschreibt, wie wichtig es ist, dass der Benutzer das Paket installiert. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The <literal>optional</literal> priority will usually work for new packages that do not conflict with others claiming <literal>required</literal>, <literal>important</literal>, or <literal>standard</literal> priority.
de: Die Priorität <literal>optional</literal> ist normalerweise für neue Pakete sinnvoll, die nicht mit anderen Paketen der Prioritäten <literal>required</literal>, <literal>important</literal> oder <literal>standard</literal> kollidieren.

note: type: Content of: <book><chapter><section><para>
en: Section and priority are used by front-ends like <command>aptitude</command> when they sort packages and select defaults.  Once you upload the package to Debian, the value of these two fields can be overridden by the archive maintainers, in which case you will be notified by email.
de: Bereich und Priorität werden von Oberflächen wie <command>aptitude</command> benutzt, um Pakete zu sortieren und Standardparameter auszuwählen. Wenn Sie das Paket für Debian hochladen, können die Werte dieser beiden Felder von den Archivbetreuern überschrieben werden. Sie erhalten dann eine Nachricht darüber per E-Mail.

note: type: Content of: <book><chapter><section><para>
en: As this is a normal priority package and doesn't conflict with anything else, we will change the priority to <literal>optional</literal>.
de: Da es sich um ein Paket mit normaler Priorität handelt und es nichts anderes stört, ändern wir die Priorität auf »<literal>optional</literal>«.

note: type: Content of: <book><chapter><section><para>
en: Line 4 is the name and email address of the maintainer.  Make sure that this field includes a valid <literal>To</literal> header for email, because after you upload it, the bug tracking system will use it to deliver bug emails to you.  Avoid using commas, ampersands, or parentheses.
de: Zeile 4 ist der Name und die E-Mail-Adresse des Betreuers. Sie müssen sicherstellen, dass dieses Feld eine gültige »<literal>To</literal>«-Kopfzeile für eine E-Mail enthält, weil nach dem Hochladen die Fehlerdatenbank diesen Eintrag nutzt, um die Fehler-E-Mails an Sie zuzustellen. Benutzen Sie keine Kommata, kaufmännische Und-Zeichen (&amp;) oder Klammern.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&policy-relationships;#s-sourcebinarydeps">Debian Policy Manual, 7.7 "Relationships between source and binary packages - Build-Depends, Build-Depends-Indep, Build-Conflicts, Build-Conflicts-Indep"</ulink>.
de: Lesen Sie das <ulink url="&policy-relationships;#s-sourcebinarydeps">Debian Policy Manual, Kapitel 7.7 »Relationships between source and binary packages - Build-Depends, Build-Depends-Indep, Build-Conflicts, Build-Conflicts-Indep«</ulink>

note: type: Content of: <book><chapter><section><para>
en: Line 5 includes the list of packages required to build your package as the <literal>Build-Depends</literal> field.  You can also have the <literal>Build-Depends-Indep</literal> field as an additional line here.  <placeholder type="footnote" id="0"/> Some packages like <systemitem role="package">gcc</systemitem> and <systemitem role="package">make</systemitem> which are required by the <systemitem role="package">build-essential</systemitem> package are implied.  If you need to have other tools to build your package, you should add them to these fields.  Multiple entries are separated with commas; read on for the explanation of binary package dependencies to find out more about the syntax of these lines.
de: Zeile 5 enthält die Liste der Pakete, die zum Bauen des Pakets benötigt werden, im Feld <literal>Build-Depends</literal>. Sie können hier ebenso das Feld <literal>Build-Depends-Indep</literal> in einer zusätzlichen Zeile benutzen <placeholder type="footnote" id="0"/>. Einige Pakete wie <systemitem role="package">gcc</systemitem> und <systemitem role="package">make</systemitem> werden impliziert, weil sie vom Paket <systemitem role="package">build-essential</systemitem> benötigt werden. Falls Sie andere Werkzeuge zum Bauen Ihres Pakets brauchen, müssen Sie sie zu diesen Feldern hinzufügen. Mehrere Einträge werden durch Kommata getrennt; mehr über die Syntax dieser Zeilen finden Sie in den Erläuterungen der binären Paketabhängigkeiten.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: For all packages packaged with the <command>dh</command> command in the <filename>debian/rules</filename> file, you must have <literal>debhelper (&gt;=9)</literal> in the <literal>Build-Depends</literal> field to satisfy the Debian Policy requirement for the <literal>clean</literal> target.
de: Bei allen Paketen, die auf den Befehl <command>dh</command> in der Datei <filename>debian/rules</filename> zugreifen, müssen Sie »<literal>debhelper (&gt;=9)</literal>« in das Feld <literal>Build-Depends</literal> eintragen, um die Debian-Richtlinien für das Ziel <literal>clean</literal> zu erfüllen.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Source packages which have binary packages with <literal>Architecture: any</literal> are rebuilt by the autobuilder.  Since this autobuilder procedure installs only the packages listed in the <literal>Build-Depends</literal> field before running <literal>debian/rules build</literal> (see <xref linkend="autobuilder"/>), the <literal>Build-Depends</literal> field needs to list practically all the required packages, and <literal>Build-Depends-Indep</literal> is rarely used.
de: Quellpakete, die binäre Pakete mit »<literal>Architecture: any</literal>« erstellen, werden vom automatischen Bausystem (»Autobuilder«) neu gebaut. Da während dieser Autobuilder-Prozedur nur die in <literal>Build-Depends</literal> aufgeführten Pakete vor der Ausführung von <literal>debian/rules build</literal> installiert werden (siehe <xref linkend="autobuilder"/>), muss das Feld <literal>Build-Depends</literal> praktisch alle erforderlichen Pakete auflisten. Das Feld <literal>Build-Depends-Indep</literal> wird daher selten benutzt.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: For source packages with binary packages all of which are <literal>Architecture: all</literal>, the <literal>Build-Depends-Indep</literal> field may list all the required packages unless they are already listed in the <literal>Build-Depends</literal> field to satisfy the Debian Policy requirement for the <literal>clean</literal> target.
de: Quellpakete, die nur binäre Pakete mit »<literal>Architecture: all</literal>« erstellen, können im Feld <literal>Build-Depends-Indep</literal> alle erforderlichen Pakete auflisten, es sei denn, diese sind bereits im Feld <literal>Build-Depends</literal> aufgeführt, um die Debian-Richtlinie für das Ziel <literal>clean</literal> zu erfüllen.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: This somewhat strange situation is a feature well documented in the <ulink url="&policy-build-depends-indep;">Debian Policy Manual, Footnotes 55</ulink>.  This is not due to the use of the <command>dh</command> command in the <filename>debian/rules</filename> file but due to how the <command>dpkg-buildpackage</command> works.  The same situation applies to the <ulink url="https://bugs.launchpad.net/launchpad-buildd/+bug/238141">auto build system for Ubuntu</ulink>.
de: Diese etwas merkwürdige Situation ist eine Besonderheit, die in dem <ulink url="&policy-build-depends-indep;">Debian Policy Manual, Fußnote 55</ulink> sehr gut dokumentiert ist. Es liegt nicht an der Verwendung des Befehls <command>dh</command> in der Datei <filename>debian/rules</filename>, sondern daran, wie das Programm <command>dpkg-buildpackage</command> arbeitet. Dieselbe Situation gilt auch für das <ulink url="https://bugs.launchpad.net/launchpad-buildd/+bug/238141">»auto build system« von Ubuntu</ulink>.

note: type: Content of: <book><chapter><section><para>
en: If you are not sure which one should be used, use the <literal>Build-Depends</literal> field to be on the safe side.  <placeholder type="footnote" id="0"/>
de: Wenn Sie sich nicht sicher sind, welches von beiden Sie benutzen sollten, verwenden Sie das Feld <literal>Build-Depends</literal>, um auf der sicheren Seite zu sein. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: To find out what packages your package needs to be built run the command:
de: Um herauszufinden, welche Pakete Ihr Paket zum Bauen benötigt, führen Sie diesen Befehl aus:

note: type: Content of: <book><chapter><section><para>
en: To manually find exact build dependencies for <command><replaceable>/usr/bin/foo</replaceable></command>, execute
de: Um die genauen Build-Abhängigkeiten für <command><replaceable>/usr/bin/foo</replaceable></command> manuell herauszufinden, führen Sie

note: type: Content of: <book><chapter><section><para>
en: and for each library listed (e.g., <command>libfoo.so.6</command>), execute
de: aus. Rufen Sie dann für jede aufgelistete Bibliothek (beispielsweise <command>libfoo.so.6</command>) diesen Befehl auf:

note: type: Content of: <book><chapter><section><para>
en: Then just take the <literal>-dev</literal> version of every package as a <literal>Build-Depends</literal> entry.  If you use <command>ldd</command> for this purpose, it will report indirect lib dependencies as well, resulting in the problem of excessive build dependencies.
de: Dann nehmen Sie einfach die Entwicklerversion (<literal>-dev</literal>) jedes Pakets als einen <literal>Build-Depends</literal>-Eintrag. Falls Sie dafür <command>ldd</command> benutzen, werden auch indirekt abhängende Bibliotheken aufgelistet, die wiederum zu exzessiven Bauabhängigkeiten führen können.

note: type: Content of: <book><chapter><section><para>
en: <systemitem role="package">gentoo</systemitem> also happens to require <systemitem role="package">xlibs-dev</systemitem>, <systemitem role="package">libgtk1.2-dev</systemitem> and <systemitem role="package">libglib1.2-dev</systemitem> to build, so we'll add them here next to <systemitem role="package">debhelper</systemitem>.
de: <systemitem role="package">Gentoo</systemitem> benötigt noch <systemitem role="package">xlibs-dev</systemitem>, <systemitem role="package">libgtk1.2-dev</systemitem> und <systemitem role="package">libglib1.2-dev</systemitem>, um gebaut werden zu können, deshalb hängen wir diese direkt hinter <systemitem role="package">debhelper</systemitem> an.

note: type: Content of: <book><chapter><section><para>
en: Line 6 is the version of the <ulink url="&debian-policy;">Debian Policy Manual</ulink> standards this package follows, the one you read while making your package.
de: Zeile 6 enthält die Version des <ulink url="&debian-policy;">Debian Policy Manual</ulink>, dessen Standards dieses Paket entspricht, also die Version, die Sie gelesen haben, während Sie Ihr Paket erstellten.

note: type: Content of: <book><chapter><section><para>
en: On line 7 you can put the URL of the software's upstream homepage.
de: In Zeile 7 können Sie die URL der Homepage der Originalautoren der Software notieren.

note: type: Content of: <book><chapter><section><para>
en: Line 9 is the name of the binary package.  This is usually the same as the name of the source package, but it doesn't necessarily have to be that way.
de: Zeile 9 enthält den Namen des Binärpakets. Üblicherweise ist dies der gleiche Name wie der des Quellpakets, aber das muss nicht immer so sein.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&policy-architecture;">Debian Policy Manual, 5.6.8 "Architecture"</ulink> for exact details.
de: Lesen Sie <ulink url="&policy-architecture;">Debian Policy Manual, Kapitel 5.6.8 »Architecture«</ulink> für die genauen Details.

note: type: Content of: <book><chapter><section><para>
en: Line 10 describes the architectures the binary package can be compiled for.  This value is usually one of the following depending on the type of the binary package: <placeholder type="footnote" id="0"/>
de: Zeile 10 beschreibt die Architekturen, für die das binäre Paket kompiliert werden kann. Dieser Wert ist normalerweise einer der folgenden, abhängig von der Art des binären Pakets: <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: The generated binary package is an architecture dependent one usually in a compiled language.
de: Das erstellte Binärpaket ist architekturabhängig, typischerweise in einer kompilierten Sprache.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: The generated binary package is an architecture independent one usually consisting of text, images, or scripts in an interpreted language.
de: Das erstellte Binärpaket ist architekturunabhängig, besteht typischerweise aus Text, Bilder oder Skripten in einer interpretierten Sprache.

note: type: Content of: <book><chapter><section><para>
en: We leave line 10 as is since this is written in C.  <citerefentry><refentrytitle>dpkg-gencontrol</refentrytitle><manvolnum>1</manvolnum></citerefentry> will fill in the appropriate architecture value for any machine this source package gets compiled on.
de: Wir lassen Zeile 10 unverändert, da das Programm in C geschrieben ist. <citerefentry><refentrytitle>dpkg-gencontrol</refentrytitle><manvolnum>1</manvolnum></citerefentry> wird den geeigneten Architekturwert für jede Maschine, auf der diese Quellen gebaut werden, einfügen.

note: type: Content of: <book><chapter><section><para>
en: If your package is architecture independent (for example, a shell or Perl script, or a document), change this to <literal>all</literal>, and read later in <xref linkend="rules"/> about using the <literal>binary-indep</literal> rule instead of <literal>binary-arch</literal> for building the package.
de: Falls Ihr Paket unabhängig von der Architektur funktioniert (beispielsweise ein Shell- oder Perl-Skript oder Dokumentation), ändern Sie dies in »<literal>all</literal>« und lesen Sie später unter <xref linkend="rules"/> über die Benutzung der Regel <literal>binary-indep</literal> statt <literal>binary-arch</literal> für den Bau des Pakets.

note: type: Content of: <book><chapter><section><para>
en: Line 11 shows one of the most powerful features of the Debian packaging system.  Packages can relate to each other in various ways.  Apart from <literal>Depends</literal>, other relationship fields are <literal>Recommends</literal>, <literal>Suggests</literal>, <literal>Pre-Depends</literal>, <literal>Breaks</literal>, <literal>Conflicts</literal>, <literal>Provides</literal>, and <literal>Replaces</literal>.
de: Zeile 11 zeigt eine der mächtigsten Eigenschaften des Paketsystems von Debian. Pakete können auf verschiedene Arten miteinander in Beziehung stehen. Neben <literal>Depends</literal> (hängt ab von) gibt es noch die Beziehungsfelder <literal>Recommends</literal> (empfiehlt), <literal>Suggests</literal> (schlägt vor), <literal>Pre-Depends</literal> (setzt voraus), <literal>Breaks</literal> (beschädigt), <literal>Conflicts</literal> (kollidiert mit), <literal>Provides</literal> (enthält) und <literal>Replaces</literal> (ersetzt).

note: type: Content of: <book><chapter><section><para>
en: The package management tools usually behave the same way when dealing with these relations; if not, it will be explained.  (See <citerefentry> <refentrytitle>dpkg</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>dselect</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>apt</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>aptitude</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, etc.)
de: Die verschiedenen Paketverwaltungswerkzeuge verhalten sich normalerweise bei der Behandlung dieser Beziehungen gleich; wenn nicht, wird dies erklärt (siehe <citerefentry> <refentrytitle>dpkg</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>dselect</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>apt</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>aptitude</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> usw.).

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&policy-relationships;">Debian Policy Manual, 7 "Declaring relationships between packages"</ulink>.
de: Lesen Sie <ulink url="&policy-relationships;">Debian Policy Manual, Kapitel 7 »Declaring relationships between packages«</ulink>.

note: type: Content of: <book><chapter><section><para>
en: Here is a simplified description of package relationships: <placeholder type="footnote" id="0"/>
de: Es folgt eine vereinfachte Beschreibung der Paketbeziehungen: <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The package will not be installed unless the packages it depends on are installed.  Use this if your program absolutely will not run (or will cause severe breakage) unless a particular package is present.
de: Das Paket wird erst installiert, wenn die hier aufgelisteten Pakete ebenfalls installiert sind. Benutzen Sie dies, falls ihr Programm ohne ein bestimmtes Paket überhaupt nicht läuft (oder schwere Schäden verursacht).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Use this for packages that are not strictly necessary but are typically used with your program.  When a user installs your program, all front-ends will probably prompt them to install the recommended packages.  <command>aptitude</command> and <command>apt-get</command> install recommended packages along with your package by default (but the user can disable this behavior).  <command>dpkg</command> will ignore this field.
de: Benutzen Sie dies für Pakete, die nicht absolut notwendig sind, die aber typischerweise mit Ihrem Programm verwendet werden. Wenn ein Benutzer Ihr Programm installiert, fragen wahrscheinlich alle Oberflächen nach, ob die empfohlenen Pakete auch installiert werden sollen. <command>aptitude</command> und <command>apt-get</command> installieren alle empfohlenen Pakete zusammen mit Ihrem Paket (aber der Benutzer kann diese Voreinstellung deaktivieren). <command>dpkg</command> ignoriert dieses Feld.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Use this for packages which will work nicely with your program but are not at all necessary.  When a user installs your program, they will probably not be prompted to install suggested packages.  <command>aptitude</command> can be configured to install suggested packages along with your package but this is not its default.  <command>dpkg</command> and <command>apt-get</command> will ignore this field.
de: Benutzen Sie dies für Pakete, die mit Ihrem Programm gut zusammenarbeiten, aber absolut nicht notwendig sind. Wenn ein Benutzer Ihr Programm installiert, werden sie wahrscheinlich nicht gefragt, ob die vorgeschlagenen Pakete auch installiert werden sollen. <command>aptitude</command> kann so konfiguriert werden, dass es vorgeschlagene Pakete zusammen mit Ihrem Paket installiert, aber dies ist nicht die Voreinstellung. <command>dpkg</command> und <command>apt-get</command> ignorieren dieses Feld.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: This is stronger than <literal>Depends</literal>.  The package will not be installed unless the packages it pre-depends on are installed and <emphasis>correctly configured</emphasis>.  Use this <emphasis>very</emphasis> sparingly and only after discussing it on the <ulink url="&debian-devel-ldo;">debian-devel@lists.debian.org</ulink> mailing list.  Read: don't use it at all.  :-)
de: Dies ist stärker als <literal>Depends</literal>. Das Paket wird erst installiert, wenn die hier aufgelisteten Pakete fertig installiert <emphasis>und richtig konfiguriert</emphasis> sind. Benutzen Sie dies <emphasis>sehr</emphasis> sparsam und nur, nachdem auf der Mailingliste <ulink url="&debian-devel-ldo;">debian-devel@lists.debian.org</ulink> darüber diskutiert wurde. Lies: Verwenden Sie es überhaupt nicht. :-)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The package will not be installed until all the packages it conflicts with have been removed.  Use this if your program absolutely will not run or will cause severe problems if a particular package is present.
de: Das Paket wird erst installiert, wenn alle Pakete, mit denen es kollidiert, entfernt wurden. Benutzen Sie dies, wenn ihr Programm überhaupt nicht läuft oder schwere Probleme verursacht, solange ein bestimmtes Paket installiert ist.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: When installed the package will break all the listed packages.  Normally a <literal>Breaks</literal> entry specifies that it applies to versions earlier than a certain value.  The resolution is generally to use higher-level package management tools to upgrade the listed packages.
de: Wenn dieses Paket installiert ist, werden alle aufgeführten Pakete als beschädigt markiert. Normalerweise gibt ein Eintrag unter <literal>Breaks</literal> an, dass er auf Versionen älter als einen bestimmten Wert zutrifft. Die Lösung besteht üblicherweise darin, höherwertige Paketverwaltungswerkzeuge zu verwenden, um ein Upgrade der aufgeführten Pakete durchzuführen.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: For some types of packages where there are multiple alternatives, virtual names have been defined.  You can get the full list in the <ulink url="&virtual-package;">virtual-package-names-list.txt.gz</ulink> file.  Use this if your program provides a function of an existing virtual package.
de: Für einige Paketarten mit mehreren Alternativen wurden virtuelle Namen definiert. Die vollständige Liste dieser virtuellen Pakete finden Sie in der Datei <ulink url="&virtual-package;">virtual-package-names-list.txt.gz</ulink>. Benutzen Sie dies, wenn Ihr Paket die Funktionalität eines existierenden virtuellen Pakets bietet.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Use this when your program replaces files from another package, or completely replaces another package (used in conjunction with <literal>Conflicts</literal>).  Files from the named packages will be overwritten with the files from your package.
de: Benutzen Sie dies, wenn Ihr Paket Dateien eines anderen Pakets überschreibt oder ein anderes Paket vollständig ersetzt (wird zusammen mit <literal>Conflicts</literal> benutzt). Dateien der genannten Pakete werden mit den Dateien aus Ihrem Paket überschrieben.

note: type: Content of: <book><chapter><section><para>
en: All these fields have uniform syntax.  They are a list of package names separated by commas.  These package names may also be lists of alternative package names, separated by vertical bar symbols <literal>|</literal> (pipe symbols).
de: All diese Felder haben eine einheitliche Syntax. Es ist jeweils eine durch Kommata getrennte Liste der Paketnamen. Diese Paketnamen können auch aus einer Liste von alternativen Paketnamen bestehen, die durch senkrechte Striche »<literal>|</literal>« (»pipe«-Zeichen) getrennt werden.

note: type: Content of: <book><chapter><section><para>
en: The fields may restrict their applicability to particular versions of each named package.  The restriction of each individual package is listed in parentheses after its name, and should contain a relation from the list below followed by a version number value.  The relations allowed are: <literal>&lt;&lt;</literal>, <literal>&lt;=</literal>, <literal>=</literal>, <literal>&gt;=</literal>, and <literal>&gt;&gt;</literal> for strictly lower, lower or equal, exactly equal, greater or equal, and strictly greater, respectively.  For example,
de: Die Anwendung der Felder kann auf bestimmte Versionen eines genannten Pakets beschränkt werden. Die Einschränkung jedes einzelnen Pakets wird in Klammern nach seinem Namen aufgeführt und sollte einen Vergleichsoperator aus der folgenden Liste enthalten, gefolgt von einem Versionsnummernwert. Die erlaubten Vergleiche sind <literal>&lt;&lt;</literal>, <literal>&lt;=</literal>, <literal>=</literal>, <literal>&gt;=</literal> und <literal>&gt;&gt;</literal> für strikt niedriger, niedriger oder gleich, genau gleich, höher oder gleich und strikt höher. Ein Beispiel:

note: type: Content of: <book><chapter><section><para>
en: The last feature you need to know about is <literal>${shlibs:Depends}</literal>, <literal>${perl:Depends}</literal>, <literal>${misc:Depends}</literal>, etc.
de: Die letzte Funktionalität, über die Sie Bescheid wissen müssen, ist <literal>${shlibs:Depends}</literal>, <literal>${perl:Depends}</literal>, <literal>${misc:Depends}</literal>, usw.

note: type: Content of: <book><chapter><section><para>
en: <citerefentry> <refentrytitle>dh_shlibdeps</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> calculates shared library dependencies for binary packages.  It generates a list of <ulink url="&elf;">ELF</ulink> executables and shared libraries it has found for each binary package.  This list is used for substituting <literal>${shlibs:Depends}</literal>.
de: <citerefentry> <refentrytitle>dh_shlibdeps</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> berechnet die Abhängigkeiten von gemeinsam benutzten Bibliotheken für Binärpakete. Es erstellt eine Liste von <ulink url="&elf;">ELF</ulink>-Programmen und gemeinsam benutzten Bibliotheken, die es für jedes Binärpaket gefunden hat. Diese Liste wird zur Ersetzung von <literal>${shlibs:Depends}</literal> verwandt.

note: type: Content of: <book><chapter><section><para>
en: <citerefentry> <refentrytitle>dh_perl</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> calculates Perl dependencies.  It generates a list of a dependencies on <literal>perl</literal> or <literal>perlapi</literal> for each binary package.  This list is used for substituting <literal>${perl:Depends}</literal>.
de: <citerefentry> <refentrytitle>dh_perl</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> berechnet Perl-Abhängigkeiten. Es erstellt für jedes Binärpaket eine Liste von Abhängigkeiten von <literal>perl</literal> oder <literal>perlapi</literal>. Diese Liste wird zur Ersetzung von <literal>${perl:Depends}</literal> verwandt.

note: type: Content of: <book><chapter><section><para>
en: Some <systemitem role="package">debhelper</systemitem> commands may cause the generated package to depend on some additional packages.  All such commands generate a list of required packages for each binary package.  This list is used for substituting <literal>${misc:Depends}</literal>.
de: Einige <systemitem role="package">debhelper</systemitem>-Befehle können dazu führen, dass das erstellte Paket von einigen zusätzlichen Paketen abhängt. Alle diese Befehle erstellen eine Liste von benötigten Paketen für jedes Binärpaket. Diese Liste wird zur Ersetzung von <literal>${misc:Depends}</literal> verwandt.

note: type: Content of: <book><chapter><section><para>
en: <citerefentry> <refentrytitle>dh_gencontrol</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> generates <filename>DEBIAN/control</filename> for each binary package while substituting <literal>${shlibs:Depends}</literal>, <literal>${perl:Depends}</literal>, <literal>${misc:Depends}</literal>, etc.
de: <citerefentry> <refentrytitle>dh_gencontrol</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> erstellt die Datei <filename>DEBIAN/control</filename> für jedes Binärpaket und ersetzt dabei <literal>${shlibs:Depends}</literal>, <literal>${perl:Depends}</literal>, <literal>${misc:Depends}</literal>, usw.

note: type: Content of: <book><chapter><section><para>
en: Having said all that, we can leave the <literal>Depends</literal> field exactly as it is now, and insert another line after it saying <literal>Suggests: file</literal>, because <systemitem role="package">gentoo</systemitem> can use some features provided by the <systemitem role="package">file</systemitem> package.
de: Nach all diesen Erklärungen können wir das Feld <literal>Depends</literal> aber exakt so belassen, wie es jetzt ist und eine weitere Zeile dahinter einfügen, in der »<literal>Suggests: file</literal>« steht, weil <systemitem role="package">gentoo</systemitem> einige Funktionen des Pakets <systemitem role="package">file</systemitem> nutzen kann.

note: type: Content of: <book><chapter><section><para>
en: Line 9 is the Homepage URL.  Let's assume this to be at <ulink url="&gentoo;"/>.
de: Zeile 9 ist die Homepage-URL. Nehmen wir an, diese sei <ulink url="&gentoo;"/>.

note: type: Content of: <book><chapter><section><para>
en: Line 12 is the short description.  Terminals are conventionally 80 columns wide so this shouldn't be longer than about 60 characters.  I'll change it to <literal>fully GUI-configurable, two-pane X file manager</literal>.
de: Zeile 12 enthält eine Kurzbeschreibung. Terminals sind typischerweise 80 Zeichen breit, also sollte die Kurzbeschreibung nicht länger als etwa 60 Zeichen sein. Ich ändere es in <literal>fully GUI-configurable, two-pane X file manager</literal>.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: These descriptions are in English.  Translations of these descriptions are provided by <ulink url="&ddtp;">The Debian Description Translation Project - DDTP</ulink>.
de: Diese Beschreibungen sind auf Englisch. Übersetzungen dieser Beschreibungen werden durch das <ulink url="&ddtp;">Debian Description Translation Project - DDTP</ulink> bereitgestellt.

note: type: Content of: <book><chapter><section><para>
en: Line 13 is where the long description goes.  This should be a paragraph which gives more details about the package.  Column 1 of each line should be empty.  There must be no blank lines, but you can put a single <literal>.</literal> (dot) in a column to simulate that.  Also, there must be no more than one blank line after the long description. <placeholder type="footnote" id="0"/>
de: In die Zeile 13 kommt eine ausführliche Beschreibung. Sie sollte aus einem kleinen Text bestehen, der mehr über das Paket verrät. Die erste Spalte jeder Zeile muss leer sein. Es dürfen keine leeren Zeilen vorkommen, Sie können aber welche simulieren, indem Sie einen einzelnen »<literal>.</literal>« (Punkt) in die Zeile einsetzen. Es darf nach der ausführlichen Beschreibung auch nicht mehr als eine Leerzeile vorkommen. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&devref-bpp-vcs;">Debian Developer's Reference, 6.2.5. "Version Control System location"</ulink>.
de: Lesen Sie <ulink url="&devref-bpp-vcs;">Debian-Entwicklerreferenz, 6.2.5. »Ort des Versionsverwaltungssystems«</ulink>.

note: type: Content of: <book><chapter><section><para>
en: We can insert <literal>Vcs-*</literal> fields to document the Version Control System (VCS) location between lines 6 and 7.  <placeholder type="footnote" id="0"/> Let's assume that the <systemitem role="package">gentoo</systemitem> package has its VCS located in the Debian Alioth Git Service at <literal>git://git.debian.org/git/collab-maint/gentoo.git</literal>.
de: Wir können zwischen die Zeilen 6 und 7 die Felder <literal>Vcs-*</literal> einfügen, um das Versionskontrollsystem (VCS) zu dokumentieren. <placeholder type="footnote" id="0"/> Wir nehmen an, dass das Paket <systemitem role="package">gentoo</systemitem> sein VCS im Git-Service von Debian Alioth unter <literal>git://git.debian.org/git/collab-maint/gentoo.git</literal> hat.

note: type: Content of: <book><chapter><section><para>
en: Finally, here is the updated <filename>control</filename> file:
de: Zum Schluss ist dies die aktualisierte Datei <filename>control</filename>:

note: type: Content of: <book><chapter><section><para>
en: This file contains information about the copyright and license of the upstream sources.  <ulink url="&policy-copyright;">Debian Policy Manual, 12.5 "Copyright information"</ulink> dictates its content and <ulink url="&dep5;">DEP-5: Machine-parseable <filename>debian/copyright</filename></ulink> provides guidelines for its format.
de: Diese Datei enthält Informationen über das Copyright und die Lizenz der Quellen der Originalautoren. <ulink url="&policy-copyright;">Debian Policy Manual, Kapitel 12.5 »Copyright information«</ulink> gibt den Inhalt vor und <ulink url="&dep5;">DEP-5: Machine-parseable <filename>debian/copyright</filename></ulink> bietet Hilfestellungen für ihr Format.

note: type: Content of: <book><chapter><section><para>
en: <command>dh_make</command> can give you a template <filename>copyright</filename> file.  Let's use the <literal>--copyright gpl2</literal> option here to get a template file for the <systemitem role="package">gentoo</systemitem> package released under GPL-2.
de: <command>Dh_make</command> kann eine Vorlage für die Datei <filename>copyright</filename> erzeugen. Verwenden Sie hier die Option »<literal>--copyright gpl2</literal>«, um eine Vorlage für das Paket <systemitem role="package">gentoo</systemitem> zu erhalten, das unter GPL-2 veröffentlicht wurde.

note: type: Content of: <book><chapter><section><para>
en: You must fill in missing information to complete this file, such as the place you got the package from, the actual copyright notice, and the license.  For certain common free software licenses (GNU GPL-1, GNU GPL-2, GNU GPL-3, LGPL-2, LGPL-2.1, LGPL-3, GNU FDL-1.2, GNU FDL-1.3, Apache-2.0, 3-Clause BSD, CC0-1.0, MPL-1.1, MPL-2.0 or the Artistic license), you can just refer to the appropriate file in the <filename>/usr/share/common-licenses/</filename> directory that exists on every Debian system.  Otherwise, you must include the complete license.
de: Sie müssen hier fehlende Informationen eintragen, um die Datei zu vervollständigen, beispielsweise die Quelle, von der Sie das Paket bezogen haben, die tatsächlichen Copyright-Vermerke und die Lizenz. Bei den verbreiteten Lizenzen von freier Software (GNU GPL-1, GNU GPL-2, GNU GPL-3, LGPL-2, LGPL-2.1, LGPL-3, GNU FDL-1.2, GNU FDL-1.3, Apache-2.0, 3-Clause BSD, CC0-1.0, MPL-1.1, MPL-2.0 oder der Artistic license) können Sie auf die entsprechende Datei im Verzeichnis <filename>/usr/share/common-licenses/</filename> verweisen, das auf jedem Debian-System existiert. Anderenfalls müssen Sie die vollständige Lizenz einfügen.

note: type: Content of: <book><chapter><section><para>
en: In short, here's what <systemitem role="package">gentoo</systemitem>'s <filename>copyright</filename> file should look like:
de: Zusammengefasst sollte die Datei <filename>copyright</filename> von <systemitem role="package">gentoo</systemitem> so aussehen:

note: type: Content of: <book><chapter><section><para>
en: Please follow the HOWTO provided by the ftpmasters and sent to debian-devel-announce: <ulink url="&howto-copyright;"/>.
de: Bitte befolgen Sie das »HOWTO«, das von den FTP-Masters zur Verfügung gestellt wird und an debian-devel-announce geschickt wurde: <ulink url="&howto-copyright;"/>.

note: type: Content of: <book><chapter><section><para>
en: This is a required file, which has a special format described in <ulink url="&policy-dpkgchangelog;">Debian Policy Manual, 4.4 "debian/changelog"</ulink>.  This format is used by <command>dpkg</command> and other programs to obtain the version number, revision, distribution, and urgency of your package.
de: Dies ist eine zwingend vorgeschriebene Datei, deren Format im <ulink url="&policy-dpkgchangelog;">Debian Policy Manual, Kapitel 4.4 »debian/changelog«</ulink> beschrieben wird. Dieses Format benötigen <command>dpkg</command> und andere Programme, um die Versionsnummer, Revision, Distribution und die Dringlichkeit Ihres Pakets zu bestimmen.

note: type: Content of: <book><chapter><section><para>
en: For you, it is also important, since it is good to have documented all changes you have done.  It will help people downloading your package to see whether there are issues with the package that they should know about.  It will be saved as <filename>/usr/share/doc/gentoo/changelog.Debian.gz</filename> in the binary package.
de: Für Sie ist die Datei ebenfalls wichtig, weil es sinnvoll ist, alle von Ihnen vorgenommenen Änderungen zu dokumentieren. Damit können Leute, die Ihr Paket herunterladen, einfacher herausfinden, ob es Probleme mit dem Paket gibt, die sie kennen sollten. Diese Datei wird im Binärpaket als <filename>/usr/share/doc/gentoo/changelog.Debian.gz</filename> gespeichert.

note: type: Content of: <book><chapter><section><para>
en: <command>dh_make</command> created a default one, and this is what it looks like:
de: <command>dh_make</command> hat eine Standardvorlage erstellt, die so aussieht:

note: type: Content of: <book><chapter><section><screen>
en: 1  gentoo (0.9.12-1) unstable; urgency=medium
    2
    3   * Initial release. (Closes: #<replaceable>nnnn</replaceable>)  &lt;<replaceable>nnnn</replaceable> is the bug number of your ITP&gt;
    4
    5  -- Josip Rodin &lt;joy-mg@debian.org&gt;  Mon, 22 Mar 2010 00:37:31 +0100
    6
de: 1  gentoo (0.9.12-1) unstable; urgency=medium
    2
    3   * Initial release. (Closes: #<replaceable>nnnn</replaceable>)  &lt;<replaceable>nnnn</replaceable> ist die Fehlernummer Ihres ITP&gt;
    4
    5  -- Josip Rodin &lt;joy-mg@debian.org&gt;  Mon, 22 Mar 2010 00:37:31 +0100
    6

note: type: Content of: <book><chapter><section><para>
en: Line 1 is the package name, version, distribution, and urgency.  The name must match the source package name; distribution should be <literal>unstable</literal>, and urgency should be set to medium unless there is any particular reason for other values.
de: In der Zeile 1 stehen der Paketname, die Version, die Distribution und die Dringlichkeit. Der Name muss mit dem Namen des Quellpakets übereinstimmen, die Distribution sollte <literal>unstable</literal> sein und die Dringlichkeit sollte auf <literal>medium</literal> gesetzt werden, falls es keinen besonderen Grund für einen anderen Wert gibt.

note: type: Content of: <book><chapter><section><para>
en: Lines 3-5 are a log entry, where you document changes made in this package revision (not the upstream changes &#x2014; there is a special file for that purpose, created by the upstream authors, which you will later install as <filename>/usr/share/doc/gentoo/changelog.gz</filename>).  Let's assume your ITP (Intent To Package) bug report number was <literal>12345</literal>.  New lines must be inserted just below the uppermost line that begins with <literal>*</literal> (asterisk).  You can do it with <citerefentry> <refentrytitle>dch</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.  You can edit this manually with a text editor as long as you follow the formatting convention used by the <citerefentry> <refentrytitle>dch</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.
de: Zeilen 3-5 sind ein Protokolleintrag, in denen Sie die in dieser Paketrevision gemachten Änderungen dokumentieren können (hier kommen keine Änderungen des Originalautors hinein; für diese Zwecke gibt es eine spezielle Datei, die von den Originalautoren erstellt wurde und die Sie später als <filename>/usr/share/doc/gentoo/changelog.gz</filename> installieren werden). Wir nehmen an, dass die Nummer Ihres ITP-Fehlerberichts (»Intent To Package«; Absicht, ein Paket zu erstellen) »<literal>12345</literal>« lautet. Neue Zeilen werden direkt unter der obersten Zeile, die mit einem Stern (»<literal>*</literal>«) beginnt, eingefügt. Sie können das mit <citerefentry> <refentrytitle>dch</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> erledigen. Sie können dies per Hand mit einem Texteditor bearbeiten, solange Sie den von <citerefentry> <refentrytitle>dch</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> verwandten Formatierungskonventionen folgen.

note: type: Content of: <book><chapter><section><para>
en: In order to prevent a package being accidentally uploaded before completing the package, it is a good idea to change the distribution value to an invalid distribution value of <literal>UNRELEASED</literal>.
de: Um zu verhindern, dass ein Paket versehentlich hochgeladen wird, bevor es fertig ist, empfiehlt es sich, den Distributionswert auf einen ungültigen Ausdruck <literal>UNRELEASED</literal> zu setzen.

note: type: Content of: <book><chapter><section><para>
en: You will end up with something like this:
de: Schließlich kommen Sie zu einer Datei wie dieser hier:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para><footnote><para>
en: If you use the <literal>dch -r</literal> command to make this last change, please make sure to save the <filename>changelog</filename> file explicitly by the editor.
de: Falls Sie den Befehl <literal>dch -r</literal> zur Durchführung dieser letzten Änderung verwenden, stellen Sie sicher, dass Sie die Datei <filename>changelog</filename> explizit im Editor speichern.

note: type: Content of: <book><chapter><section><para>
en: Once you are satisfied with all the changes and documented them in <filename>changelog</filename>, you should change the distribution value from <literal>UNRELEASED</literal> to the target distribution value <literal>unstable</literal> (or even <literal>experimental</literal>).  <placeholder type="footnote" id="0"/>
de: Sobald Sie mit allen Änderungen zufrieden und sie im <filename>changelog</filename> dokumentiert haben, sollten Sie den Wert der Distribution von <literal>UNRELEASED</literal> auf den Ziel-Distributionswert <literal>unstable</literal> (oder sogar <literal>experimental</literal>) ändern. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: You can read more about updating the <filename>changelog</filename> file later in <xref linkend="update"/>.
de: Sie können später mehr über Aktualisierungen der Datei <filename>changelog</filename> in <xref linkend="update"/> lesen.

note: type: Content of: <book><chapter><section><para>
en: Now we need to take a look at the exact rules that <citerefentry> <refentrytitle>dpkg-buildpackage</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> will use to actually create the package.  This file is in fact another <filename>Makefile</filename>, but different from the one(s) in the upstream source.  Unlike other files in <filename>debian</filename>, this one is marked as executable.
de: Wir werfen nun einen Blick auf die genauen Regeln, die <citerefentry> <refentrytitle>dpkg-buildpackage</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> verwenden wird, um das Paket zu bauen. Diese Datei ist in Wirklichkeit ein weiteres <filename>Makefile</filename>, aber anders als das von den Originalautoren mitgelieferte. Im Unterschied zu den anderen Dateien im Verzeichnis <filename>debian</filename> ist diese Datei als ausführbar gekennzeichnet.

note: type: Content of: <book><chapter><section><section><title>
en: Targets of the <filename>rules</filename> file
de: Ziele der Datei <filename>rules</filename>

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: You can start learning how to write a <filename>Makefile</filename> from <ulink url="&debref-make;">Debian Reference, 12.2. "Make"</ulink>.  The full documentation is available as <ulink url="&gnu-make;"></ulink> or as the <systemitem role="package">make-doc</systemitem> package in the <literal>non-free</literal> archive area.
de: Sie können das Schreiben einer <filename>Makefile</filename> erlernen, indem Sie <ulink url="&debref-make;">Debian Reference, 12.2. "Make"</ulink> lesen. Die komplette Dokumentation ist als <ulink url="&gnu-make;"></ulink> oder als Paket <systemitem role="package">make-doc</systemitem> im Archivbereich <literal>non-free</literal> verfügbar.

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: <ulink url="&policy-debianrules;">Debian Policy Manual, 4.9 "Main building script: debian/rules"</ulink> explains the details.
de: <ulink url="&policy-debianrules;">Debian Policy Manual, Kapitel 4.9 »Main building script: debian/rules«</ulink> erklärt die Details.

note: type: Content of: <book><chapter><section><section><para>
en: Every <filename>rules</filename> file, like any other <filename>Makefile</filename>, consists of several rules, each of which defines a target and how it is carried out.  <placeholder type="footnote" id="0"/> A new rule begins with its target declaration in the first column.  The following lines beginning with the TAB code (ASCII 9) specify the recipe for carrying out that target.  Empty lines and lines beginning with <literal>#</literal> (hash) are treated as comments and ignored.  <placeholder type="footnote" id="1"/>
de: Jede <filename>rules</filename>-Datei, wie jedes andere <filename>Makefile</filename>, besteht aus mehreren Regeln, von der jede ein Ziel und eine Ausführung definiert.<placeholder type="footnote" id="0"/> Eine neue Regel beginnt mit der Ziel-Deklaration in der ersten Spalte. Die folgenden Zeilen beginnen mit einem Tabulator (ASCII 9), nach dem das Rezept zur Durchführung des Ziels angegeben wird. Leere Zeilen und Zeilen, die mit einem <literal>#</literal> (Hash) anfangen, werden als Kommentare behandelt und ignoriert. <placeholder type="footnote" id="1"/>

note: type: Content of: <book><chapter><section><section><para>
en: A rule that you want to execute is invoked by its target name as a command line argument.  For example, <literal>debian/rules <replaceable>build</replaceable></literal> and <literal>fakeroot make -f debian/rules <replaceable>binary</replaceable></literal> execute rules for <literal><replaceable>build</replaceable></literal> and <literal><replaceable>binary</replaceable></literal> targets, respectively.
de: Eine Regel, die Sie ausführen möchten, wird durch ihren Zielnamen als Befehlszeilenargument aufgerufen. Beispielsweise führen <literal>debian/rules <replaceable>build</replaceable></literal> und <literal>fakeroot make -f debian/rules <replaceable>binary</replaceable></literal> die Regeln für die Ziele <literal><replaceable>build</replaceable></literal> respektive <literal><replaceable>binary</replaceable></literal> aus.

note: type: Content of: <book><chapter><section><section><para>
en: Here is a simplified explanation of the targets:
de: Es folgt eine vereinfachte Erklärung der Ziele:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>clean</literal> target: to clean all compiled, generated, and useless files in the build-tree.  (Required)
de: <literal>clean</literal>-Ziel: Löschen aller kompilierten, erzeugten und nicht benötigten Dateien im Bauverzeichnis (erforderlich)

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>build</literal> target: to build the source into compiled programs and formatted documents in the build-tree.  (Required)
de: <literal>build</literal>-Ziel: Bauen der kompilierten Programme und formatierten Dokumente aus den Quellen im Bauverzeichnis (erforderlich)

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>build-arch</literal> target: to build the source into arch-dependent compiled programs in the build-tree.  (Required)
de: <literal>build-arch</literal>-Ziel: Bauen der kompilierten architekturabhängigen Programme aus den Quellen im Bauverzeichnis (erforderlich)

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>build-indep</literal> target: to build the source into arch-independent formatted documents in the build-tree.  (Required)
de: <literal>build-indep</literal>-Ziel: Bauen der architekturunabhängigen formatierten Dokumente aus den Quellen im Bauverzeichnis (erforderlich)

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>install</literal> target: to install files into a file tree for each binary package under the <filename>debian</filename> directory.  If defined, <literal>binary*</literal> targets effectively depend on this target.  (Optional)
de: <literal>install</literal>-Ziel: Installieren der Dateien in einen Verzeichnisbaum unterhalb des Verzeichnisses <filename>debian</filename> für jedes Binärpaket. Falls sie festgelegt wurden, hängen <literal>binary*</literal>-Ziele effektiv von diesem Ziel ab (optional)

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para><footnote><para>
en: This target is used by <literal>dpkg-buildpackage</literal> as in <xref linkend="completebuild"/>.
de: Dieses Ziel wird von »<literal>dpkg-buildpackage</literal>« wie in <xref linkend="completebuild"/> beschrieben benutzt.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>binary</literal> target: to create all binary packages (effectively a combination of <literal>binary-arch</literal> and <literal>binary-indep</literal> targets).  (Required)<placeholder type="footnote" id="0"/>
de: <literal>binary</literal>-Ziel: Erstellen aller Binärpakete (effektiv ist dies die Kombination der <literal>binary-arch</literal>- und <literal>binary-indep</literal>-Ziele) (erforderlich) <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para><footnote><para>
en: This target is used by <literal>dpkg-buildpackage -B</literal> as in <xref linkend="autobuilder"/>.
de: Dieses Ziel wird von »<literal>dpkg-buildpackage -B</literal>« wie in <xref linkend="autobuilder"/> beschrieben benutzt.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>binary-arch</literal> target: to create arch-dependent (<literal>Architecture: any</literal>) binary packages in the parent directory.  (Required)<placeholder type="footnote" id="0"/>
de: <literal>binary-arch</literal>-Ziel: Erstellen Architektur-abhängiger (<literal>Architecture: any</literal>) Binärpakete im übergeordneten Verzeichnis (erforderlich) <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para><footnote><para>
en: This target is used by <literal>dpkg-buildpackage -A</literal>.
de: Dieses Ziel wird von »<literal>dpkg-buildpackage -A</literal>« benutzt.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>binary-indep</literal> target: to create arch-independent (<literal>Architecture: all</literal>) binary packages in the parent directory.  (Required)<placeholder type="footnote" id="0"/>
de: <literal>binary-indep</literal>-Ziel: Erstellen Architektur-unabhängiger (<literal>Architecture: all</literal>) Binärpakete im übergeordneten Verzeichnis (erforderlich) <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>get-orig-source</literal> target: to obtain the most recent version of the original source package from an upstream archive.  (Optional)
de: <literal>get-orig-source</literal>-Ziel: Herunterladen der neuesten Version des Quellpakets von dem Archiv der Originalautoren (optional)

note: type: Content of: <book><chapter><section><section><para>
en: You are probably overwhelmed by now, but things are much simpler upon examination of the <filename>rules</filename> file that <command>dh_make</command> gives us as a default.
de: Sie sind jetzt wahrscheinlich überwältigt, aber nach der genaueren Betrachtung der Datei <filename>rules</filename>, die uns <command>dh_make</command> als Vorgabe erstellt hat, wird alles viel einfacher werden.

note: type: Content of: <book><chapter><section><section><title>
en: Default <filename>rules</filename> file
de: Die vorgegebene Datei <filename>rules</filename>

note: type: Content of: <book><chapter><section><section><para>
en: Newer <command>dh_make</command> generates a very simple but powerful default <filename>rules</filename> file using the <command>dh</command> command:
de: Neuere Versionen von <command>dh_make</command> erzeugen als Vorgabe eine sehr einfache, doch mächtige Datei <filename>rules</filename>, indem sie den Befehl <command>dh</command> verwenden:

note: type: Content of: <book><chapter><section><section><para>
en: (I've added the line numbers and trimmed some comments.  In the actual <filename>rules</filename> file, the leading spaces are a TAB code.)
de: (Die Zeilennummerierung habe ich hinzugefügt und auch einige Kommentare verkürzt. In der richtigen <filename>rules</filename>-Datei sind die führenden Leerzeichen Tabulatoren.)

note: type: Content of: <book><chapter><section><section><para>
en: You are probably familiar with lines like line 1 from shell and Perl scripts.  It tells the operating system that this file is to be processed with <filename>/usr/bin/make</filename>.
de: Sie sind wahrscheinlich mit ähnlichen Zeilen wie der Zeile 1 aus Shell- oder Perl-Skripten vertraut. Sie teilt dem Betriebssystem mit, dass das Skript mit <filename>/usr/bin/make</filename> verarbeitet werden soll.

note: type: Content of: <book><chapter><section><section><para>
en: Line 4 can be uncommented to set the <literal>DH_VERBOSE</literal> variable to 1, so that the <command>dh</command> command outputs which <command>dh_*</command> commands it is executing.  You can also add a line <literal>export DH_OPTIONS=-v</literal> here, so that each <command>dh_*</command> command outputs which commands it is executing.  This helps you to understand exactly what is going on behind this simple <filename>rules</filename> file and to debug its problems.  This new <command>dh</command> is designed to form a core part of the <systemitem role="package">debhelper</systemitem> tools, and not to hide anything from you.
de: In Zeile 4 kann das Kommentarzeichen entfernt werden, um die Variable <literal>DH_VERBOSE</literal> auf 1 zu setzen. Dann gibt der Befehl <command>dh</command> aus, welche <command>dh_*</command>-Befehle er ausführt. Sie können hier auch eine Zeile »<literal>export DH_OPTIONS=-v</literal>« hinzufügen. Dann gibt jeder <command>dh_*</command>-Befehl aus, welche Befehle von jedem <command>dh_*</command>-Befehl ausgeführt werden. Das hilft Ihnen dabei, zu verstehen, was genau hinter den Kulissen dieser einfachen <filename>rules</filename>-Datei passiert. So können Sie Probleme besser finden. Das neue <command>dh</command> ist als ein zentraler Bestandteil der <systemitem role="package">debhelper</systemitem>-Werkzeuge entwickelt worden und versteckt nichts vor Ihnen.

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: This uses the new <systemitem role="package">debhelper</systemitem> v7+ features.  Its design concepts are explained in <ulink url="&debhelper-slides;">Not Your Grandpa's Debhelper</ulink> presented at DebConf9 by the <systemitem role="package">debhelper</systemitem> upstream.  Under <literal>lenny</literal>, <command>dh_make</command> created a much more complicated <filename>rules</filename> file with explicit rules and many <command>dh_*</command> scripts listed for each one, most of which are now unnecessary (and show the package's age). The new <command>dh</command> command is simpler and frees us from doing the routine work "manually". You still have full power to customize the process with <literal>override_dh_*</literal> targets. See <xref linkend="customrules"/>.  It is based only on the <systemitem role="package">debhelper</systemitem> package and does not obfuscate the package building process as the <systemitem role="package">cdbs</systemitem> package tends to do.
de: Dies verwendet die neuen Möglichkeiten von <systemitem role="package">debhelper</systemitem> v7+. Dessen Designkonzepte werden in <ulink url="&debhelper-slides;">»Not Your Grandpa's Debhelper«</ulink> erklärt, das auf der DebConf9 vom <systemitem role="package">debhelper</systemitem>-Betreuer präsentiert wurde. Unter <literal>lenny</literal> erzeugte <command>dh_make</command> eine wesentlich kompliziertere Datei <filename>rules</filename> mit expliziten Regeln und vielen <command>dh_*</command>-Skripten für jede der Regeln, wobei die meisten jetzt unnötig sind (und das Alter des Pakets zeigen). Der neue <command>dh</command>-Befehl ist einfacher und befreit uns von der »manuellen« Durchführung dieser Routinearbeit. Sie haben mit den <literal>override_dh_*</literal>-Zielen weiterhin die vollständige Kontrolle über diesen Prozess mit den Zielen <literal>override_dh_*</literal>. Siehe <xref linkend="customrules"/>. Er basiert lediglich auf dem Paket <systemitem role="package">debhelper</systemitem> und verschleiert den Prozess des Paketbaus nicht, wie dies beim Paket <systemitem role="package">cdbs</systemitem> sein kann.

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: You can verify the actual sequences of <command>dh_*</command> programs invoked for a given <literal><replaceable>target</replaceable></literal> without really running them by invoking <literal>dh <replaceable>target</replaceable> --no-act</literal> or <literal>debian/rules -- '<replaceable>target</replaceable> --no-act'</literal>.
de: Sie können überprüfen, welche Sequenzen von <command>dh_*</command>-Programmen für ein bestimmtes <literal><replaceable>Ziel</replaceable></literal> tatsächlich aufgerufen werden, indem Sie »<literal>dh <replaceable>Ziel</replaceable> --no-act</literal>« oder »<literal>debian/rules -- '<replaceable>Ziel</replaceable> --no-act'</literal>« ausführen. Dadurch werden die Sequenzen nicht ausgeführt.

note: type: Content of: <book><chapter><section><section><para>
en: Lines 16 and 17 are where all the work is done with an implicit rule using the pattern rule.  The percent sign means "any targets", which then call a single program, <command>dh</command>, with the target name.  <placeholder type="footnote" id="0"/> The <command>dh</command> command is a wrapper script that runs appropriate sequences of <command>dh_*</command> programs depending on its argument.  <placeholder type="footnote" id="1"/>
de: In den Zeilen 16 und 17 wird die gesamte Arbeit mit einer impliziten Regel, die die Muster-Regel verwendet, erledigt. Das Prozentzeichen steht für ein »beliebiges Ziel«, das dann lediglich ein Programm aufruft, nämlich <command>dh</command> mit dem Namen des Ziels. <placeholder type="footnote" id="0"/> Der Befehl <command>dh</command> ist ein Skript, das abhängig vom übergebenen Argument die entsprechenden Sequenzen von <command>dh_*</command>-Programmen ausführt. <placeholder type="footnote" id="1"/>

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>debian/rules clean</literal> runs <literal>dh clean</literal>, which in turn runs the following:
de: »<literal>debian/rules clean</literal>« ruft »<literal>dh clean</literal>« auf, das wiederum folgendes ausführt:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>debian/rules build</literal> runs <literal>dh build</literal>, which in turn runs the following:
de: »<literal>debian/rules build</literal>« ruft »<literal>dh build</literal>« auf, das wiederum folgendes ausführt:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para><footnote><para>
en: The following example assumes your <filename>debian/compat</filename> has a value equal or more than 9 to avoid invoking any python support commands automatically.
de: Im folgenden Beispiel wird angenommen, dass <filename>debian/compat</filename> einen Wert gleich oder größer als 9 hat, um die Python-Unterstützungsbefehle automatisch aufzurufen.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>fakeroot debian/rules binary</literal> runs <literal>fakeroot dh binary</literal>, which in turn runs the following<placeholder type="footnote" id="0"/>:
de: »<literal>fakeroot debian/rules binary</literal>« ruft »<literal>fakeroot dh binary</literal>« auf, das wiederum folgendes ausführt <placeholder type="footnote" id="0"/>:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>fakeroot debian/rules binary-arch</literal> runs <literal>fakeroot dh binary-arch</literal>, which in turn runs the same sequence as <literal>fakeroot dh binary</literal> but with the <literal>-a</literal> option appended for each command.
de: »<literal>fakeroot debian/rules binary-arch</literal>« ruft »<literal>fakeroot dh binary-arch</literal>« auf, das wiederum dieselbe Sequenz ausführt wie »<literal>fakeroot dh binary</literal>«, allerdings wird an jeden Befehl die Option »<literal>-a</literal>« angehängt.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>fakeroot debian/rules binary-indep</literal> runs <literal>fakeroot dh binary-indep</literal>, which in turn runs almost the same sequence as <literal>fakeroot dh binary</literal> but excluding <command>dh_strip</command>, <command>dh_makeshlibs</command>, and <command>dh_shlibdeps</command> with the <literal>-i</literal> option appended for each remaining command.
de: »<literal>fakeroot debian/rules binary-indep</literal>« ruft »<literal>fakeroot dh binary-indep</literal>« auf, das wiederum fast dieselbe Sequenz ausführt wie »<literal>fakeroot dh binary</literal>«, allerdings wird an jeden Befehl die Option »<literal>-i</literal>« angehängt und die Befehle <command>dh_strip</command>, <command>dh_makeshlibs</command> und <command>dh_shlibdeps</command> werden weggelassen.

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: For complete information on what all these <command>dh_*</command> scripts do exactly, and what their other options are, please read their respective manual pages and the <systemitem role="package">debhelper</systemitem> documentation.
de: Für die komplette Information darüber, was die ganzen <command>dh_*</command>-Skripte genau durchführen und wie ihre Optionen lauten, lesen Sie bitte deren Handbuchseiten und die Dokumentation von <systemitem role="package">debhelper</systemitem>.

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: These commands support other build environments, such as <filename>setup.py</filename>, which can be listed by executing <literal>dh_auto_build --list</literal> in a package source directory.
de: Diese Befehle unterstützen andere Bauumgebungen wie <filename>setup.py</filename>, die durch Ausführen von <literal>dh_auto_build --list</literal> in einem Paketbauverzeichnis aufgelistet werden können.

note: type: Content of: <book><chapter><section><section><para>
en: The functions of <command>dh_*</command> commands are largely self-evident from their names.  <placeholder type="footnote" id="0"/> There are a few notable ones that are worth giving (over)simplified explanations here assuming a typical build environment based on a <filename>Makefile</filename>: <placeholder type="footnote" id="1"/>
de: Die Funktion der Befehle <command>dh_*</command> sind größtenteils aus ihren Namen selbsterklärend. <placeholder type="footnote" id="0"/> Es gibt einige bemerkenswerte, für die es Sinn ergibt, hier unter der Annahme einer typischen Bauumgebung, basierend auf einem <filename>Makefile</filename>, eine stark vereinfachte Erläuterung bereitzustellen: <placeholder type="footnote" id="1"/>

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para><footnote><para>
en: It actually looks for the first available target in the <filename>Makefile</filename> out of <literal>distclean</literal>, <literal>realclean</literal>, or <literal>clean</literal>, and executes that.
de: Tatsächlich wird nach dem ersten verfügbaren Ziel aus der Liste <literal>distclean</literal>, <literal>realclean</literal> oder <literal>clean</literal> in dem <filename>Makefile</filename> gesucht und dieses ausgeführt.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <command>dh_auto_clean</command> usually executes the following if a <filename>Makefile</filename> exists with the <literal>distclean</literal> target.  <placeholder type="footnote" id="0"/>
de: <command>dh_auto_clean</command> führt normalerweise folgendes aus, wenn ein <filename>Makefile</filename> existiert und das Ziel <literal>distclean</literal> enthält. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <command>dh_auto_configure</command> usually executes the following if <filename>./configure</filename> exists (arguments abbreviated for readability).
de: <command>dh_auto_configure</command> führt normalerweise folgendes aus, wenn die Datei <filename>configure</filename> existiert (Argumente zur besseren Lesbarkeit abgekürzt).

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <command>dh_auto_build</command> usually executes the following to execute the first target of <filename>Makefile</filename> if it exists.
de: <command>dh_auto_build</command> führt normalerweise folgendes aus, um das erste Ziel des <filename>Makefile</filename>s auszuführen, falls dieses existiert.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para><footnote><para>
en: It actually looks for the first available target in the <filename>Makefile</filename> out of <literal>test</literal> or <literal>check</literal>, and executes that.
de: Tatsächlich wird nach dem ersten verfügbaren Ziel aus der Liste <literal>test</literal> oder <literal>check</literal> in dem <filename>Makefile</filename> gesucht und dieses ausgeführt.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <command>dh_auto_test</command> usually executes the following if a <filename>Makefile</filename> exists with the <literal>test</literal> target.  <placeholder type="footnote" id="0"/>
de: <command>dh_auto_test</command> führt normalerweise folgendes aus, falls ein <filename>Makefile</filename> mit dem Ziel <literal>test</literal> existiert. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <command>dh_auto_install</command> usually executes the following if a <filename>Makefile</filename> exists with the <literal>install</literal> target (line folded for readability).
de: <command>dh_auto_install</command> führt normalerweise folgendes aus, falls ein <filename>Makefile</filename> mit dem Ziel <literal>install</literal> existiert (Zeile zur besseren Lesbarkeit umgebrochen).

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><screen>
en: make install \
      DESTDIR=<replaceable>/path/to</replaceable>/<replaceable>package</replaceable>_<replaceable>version</replaceable>-<replaceable>revision</replaceable>/debian/<replaceable>package</replaceable>
de: make install \
      DESTDIR=<replaceable>/Pfad/zum</replaceable>/<replaceable>Paket</replaceable>_<replaceable>Version</replaceable>-<replaceable>Revision</replaceable>/debian/<replaceable>Paket</replaceable>

note: type: Content of: <book><chapter><section><section><para>
en: All targets which require the <command>fakeroot</command> command will contain <command>dh_testroot</command>, which exits with an error if you are not using this command to pretend to be root.
de: Alle Ziele, die den Befehl <command>fakeroot</command> erfordern, werden <command>dh_testroot</command> enthalten. Falls Sie nicht diesen Befehl benutzen, um vorzugeben, »root« zu sein, wird er mit einer Fehlermeldung beendet.

note: type: Content of: <book><chapter><section><section><para>
en: The important part to know about the <filename>rules</filename> file created by <command>dh_make</command> is that it is just a suggestion.  It will work for most packages but for more complicated ones, don't be afraid to customize it to fit your needs.
de: Das Wichtigste, was Sie über die Datei <filename>rules</filename> wissen müssen, die von <command>dh_make</command> erzeugt wurde, ist, dass sie lediglich ein Vorschlag ist. Sie funktioniert für die meisten Pakete, aber für etwas kompliziertere Pakete sollten Sie sich nicht scheuen, sie für Ihre Zwecke anzupassen.

note: type: Content of: <book><chapter><section><section><para>
en: Although <literal>install</literal> is not a required target, it is supported.  <literal>fakeroot dh install</literal> behaves like <literal>fakeroot dh binary</literal> but stops after <command>dh_fixperms</command>.
de: Obwohl »<literal>install</literal>« kein erforderliches Ziel ist, wird es unterstützt. »<literal>fakeroot dh install</literal>« verhält sich wie »<literal>fakeroot dh binary</literal>«, stoppt aber nach <command>dh_fixperms</command>.

note: type: Content of: <book><chapter><section><section><title>
en: Customization of <filename>rules</filename> file
de: Anpassungen der Datei <filename>rules</filename>

note: type: Content of: <book><chapter><section><section><para>
en: There are many ways to customize the <filename>rules</filename> file created with the new <command>dh</command> command.
de: Es gibt viele Arten, die <filename>rules</filename>-Datei anzupassen, die den neuen Befehl <command>dh</command> verwendet.

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: If a package installs the <filename>/usr/share/perl5/Debian/Debhelper/Sequence/<replaceable>custom_name</replaceable>.pm</filename> file, you should activate its customization function by <literal>dh $@ --with <replaceable>custom-name</replaceable></literal>.
de: Falls ein Paket die Datei <filename>/usr/share/perl5/Debian/Debhelper/Sequence/<replaceable>Eigener_Name</replaceable>.pm</filename> installiert, können Sie dessen angepasste Funktion mittels »<literal>dh $@ --with <replaceable>Eigener-Name</replaceable></literal>« aktivieren.

note: type: Content of: <book><chapter><section><section><para>
en: The <literal>dh $@</literal> command can be customized as follows: <placeholder type="footnote" id="0"/>
de: Der Befehl »<literal>dh $@</literal>« kann wie folgt angepasst werden: <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para><footnote><para>
en: Use of the <command>dh_python2</command> command is preferred over use of <command>dh_pysupport</command> or <command>dh_pycentral</command> commands.  Do not use the <command>dh_python</command> command.
de: Die Benutzung des Befehls <command>dh_python2</command> wird gegenüber den Befehlen <command>dh_pysupport</command> oder <command>dh_pycentral</command> bevorzugt. Verwenden Sie nicht den Befehl <command>dh_python</command>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_python2</command> command.  (The best choice for Python.) <placeholder type="footnote" id="0"/>
de: Unterstützung des Befehls <command>dh_python2</command> hinzufügen (die beste Wahl für Python). <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">python</systemitem> package in <literal>Build-Depends</literal>.
de: Aufnahme des Pakets <systemitem role="package">python</systemitem> in »<literal>Build-Depends</literal>«.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with python2</literal>.
de: Verwenden Sie »<literal>dh $@ --with python2</literal>«.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This handles Python modules using the <systemitem role="package">python</systemitem> framework.
de: Hiermit werden Python-Module mit dem Rahmenwerk <systemitem role="package">python</systemitem> bearbeitet.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_pysupport</command> command. (deprecated)
de: Unterstützung für den Befehl <command>dh_pysupport</command> hinzufügen. (veraltet)

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">python-support</systemitem> package in <literal>Build-Depends</literal>.
de: Aufnahme des Pakets <systemitem role="package">python-support</systemitem> in »<literal>Build-Depends</literal>«.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with pysupport</literal>.
de: Verwenden Sie »<literal>dh $@ --with pysupport</literal>«.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This handles Python modules using the <systemitem role="package">python-support</systemitem> framework.
de: Hiermit werden Python-Module mit dem Rahmenwerk <systemitem role="package">python-support</systemitem> bearbeitet.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_pycentral</command> command. (deprecated)
de: Unterstützung für den Befehl <command>dh_pycentral</command> hinzufügen. (veraltet)

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">python-central</systemitem> package in <literal>Build-Depends</literal>.
de: Aufnahme des Pakets <systemitem role="package">python-central</systemitem> in »<literal>Build-Depends</literal>«.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with python-central</literal> instead.
de: Verwenden Sie stattdessen »<literal>dh $@ --with python-central</literal>«.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This also deactivates the <command>dh_pysupport</command> command.
de: Hierdurch wird auch der Befehl <command>dh_pysupport</command> deaktiviert.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This handles Python modules using the <systemitem role="package">python-central</systemitem> framework.
de: Hiermit werden Python-Module mit dem Rahmenwerk <systemitem role="package">python-central</systemitem> bearbeitet.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_installtex</command> command.
de: Unterstützung für den Befehl <command>dh_installtex</command> hinzufügen.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">tex-common</systemitem> package in <literal>Build-Depends</literal>.
de: Aufnahme des Pakets <systemitem role="package">tex-common</systemitem> in »<literal>Build-Depends</literal>«.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with tex</literal> instead.
de: Verwenden Sie stattdessen »<literal>dh $@ --with tex</literal>«.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This registers Type 1 fonts, hyphenation patterns, and formats with TeX.
de: Hiermit werden Type-1-Schriften, Muster für Silbentrennung und Formate für TeX registriert.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_quilt_patch</command> and <command>dh_quilt_unpatch</command> commands.
de: Unterstützung für die Befehle <command>dh_quilt_patch</command> und <command>dh_quilt_unpatch</command> hinzufügen.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">quilt</systemitem> package in <literal>Build-Depends</literal>.
de: Aufnahme des Pakets <systemitem role="package">quilt</systemitem> in »<literal>Build-Depends</literal>«.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with quilt</literal> instead.
de: Verwenden Sie stattdessen »<literal>dh $@ --with quilt</literal>«.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This applies and un-applies patches to the upstream source from files in the <filename>debian/patches</filename> directory for a source package in the <literal>1.0</literal> format.
de: Hiermit werden für ein Quellpaket im Format <literal>1.0</literal> aus Dateien im Verzeichnis <filename>debian/patches</filename> Patches auf die ursprünglichen Quellen angewendet und auch wieder rückgängig gemacht.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This is not needed if you use the new <literal>3.0 (quilt)</literal> source package format.
de: Dies wird nicht benötigt, falls Sie das neue Quellpaketformat <literal>3.0 (quilt)</literal> benutzen.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_dkms</command> command.
de: Unterstützung für den Befehl <command>dh_dkms</command> hinzufügen.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">dkms</systemitem> package in <literal>Build-Depends</literal>.
de: Aufnahme des Pakets <systemitem role="package">dkms</systemitem> in »<literal>Build-Depends</literal>«.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with dkms</literal> instead.
de: Verwenden Sie stattdessen »<literal>dh $@ --with dkms</literal>«.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This correctly handles DKMS usage by kernel module packages.
de: Hiermit wird die korrekte Verwendung von DKMS durch die Kernel-Modul-Pakete sichergestellt.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_autotools-dev_updateconfig</command> and <command>dh_autotools-dev_restoreconfig</command> commands.
de: Unterstützung für die Befehle <command>dh_autotools-dev_updateconfig</command> und <command>dh_autotools-dev_restoreconfig</command> hinzufügen.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">autotools-dev</systemitem> package in <literal>Build-Depends</literal>.
de: Aufnahme des Pakets <systemitem role="package">autotools-dev</systemitem> in »<literal>Build-Depends</literal>«.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with autotools-dev</literal> instead.
de: Verwenden Sie stattdessen »<literal>dh $@ --with autotools-dev</literal>«.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This updates and restores <filename>config.sub</filename> and <filename>config.guess</filename>.
de: Hiermit werden die Dateien <filename>config.sub</filename> und <filename>config.guess</filename> aktualisiert und wiederhergestellt.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_autoreconf</command> and <command>dh_autoreconf_clean</command> commands.
de: Unterstützung für den Befehle <command>dh_autoreconf</command> und <command>dh_autoreconf_clean</command> hinzufügen.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">dh-autoreconf</systemitem> package in <literal>Build-Depends</literal>.
de: Aufnahme des Pakets <systemitem role="package">dh-autoreconf</systemitem> in »<literal>Build-Depends</literal>«.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with autoreconf</literal> instead.
de: Verwenden Sie stattdessen »<literal>dh $@ --with autoreconf</literal>«.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This updates the GNU Build System files and restores them after the build.
de: Hiermit werden die Dateien des GNU-Bausystems aktualisiert und nach dem Bau wiederhergestellt.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_girepository</command> command.
de: Unterstützung für den Befehl <command>dh_girepository</command> hinzufügen.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Includes the <systemitem role="package">gobject-introspection</systemitem> package in <literal>Build-Depends</literal>.
de: Aufnahme des Pakets <systemitem role="package">gobject-introspection</systemitem> in »<literal>Build-Depends</literal>«.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with gir</literal> instead.
de: Verwenden Sie stattdessen »<literal>dh $@ --with gir</literal>«.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This computes dependencies for packages shipping GObject introspection data and generates the <literal>${gir:Depends}</literal> substitution variable for the package dependency.
de: Das berechnet Abhängigkeiten für Pakete, die GObject-Introspektionsdaten ausliefern und erstellt die Ersetzungsvariable <literal>${gir:Depends}</literal> für die Paketabhängigkeiten.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>bash</command> completion feature.
de: Unterstützung für die Vervollständigung in der <command>bash</command> hinzufügen.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Includes the <systemitem role="package">bash-completion</systemitem> package in <literal>Build-Depends</literal>.
de: Aufnahme des Pakets <systemitem role="package">bash-completion</systemitem> in »<literal>Build-Depends</literal>«.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with bash-completion</literal> instead.
de: Verwenden Sie stattdessen »<literal>dh $@ --with bash-completion</literal>«.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This installs <command>bash</command> completions using a configuration file at <filename>debian/<replaceable>package</replaceable>.bash-completion</filename>.
de: Hiermit wird die Vervollständigung durch <command>bash</command> unter Verwendung einer Konfigurationsdatei in <filename>debian/<replaceable>Paket</replaceable>.bash-completion</filename> installiert.

note: type: Content of: <book><chapter><section><section><para>
en: Many <command>dh_*</command> commands invoked by the new <command>dh</command> command can be customized by the corresponding configuration files in the <filename>debian</filename> directory.  See <xref linkend="dother"/> and the manpage of each command for the customization of such features.
de: Viele <command>dh_*</command>-Befehle, die vom neuen <command>dh</command>-Befehl aufgerufen werden, können durch entsprechende Konfigurationsdateien im <filename>debian</filename>-Verzeichnis angepasst werden. Siehe <xref linkend="dother"/> sowie die Handbuchseite jedes Befehls für Anpassungen dieser Funktionalitäten.

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: Under <literal>lenny</literal>, if you wanted to change the behavior of a <command>dh_*</command> script you found the relevant line in the <filename>rules</filename> file and adjusted it.
de: Falls Sie unter <literal>Lenny</literal> das Verhalten eines <command>dh_*</command>-Skripts ändern wollten, mussten Sie die entsprechende Zeile in der Datei <filename>rules</filename> aufsuchen und dort anpassen.

note: type: Content of: <book><chapter><section><section><para>
en: You may need to run <command>dh_*</command> commands invoked via the new <command>dh</command> with added arguments, or to run additional commands with them, or to skip them.  For such cases, you create an <literal>override_dh_<replaceable>foo</replaceable></literal> target with its rule in the <filename>rules</filename> file defining an <literal>override_dh_<replaceable>foo</replaceable></literal> target for the <command>dh_<replaceable>foo</replaceable></command> command you want to change.  It basically says <emphasis>run me instead</emphasis>.  <placeholder type="footnote" id="0"/>
de: Es kann nötig sein, über <command>dh</command> aufgerufene <command>dh_*</command>-Befehle mit zusätzlichen Argumenten oder zusätzliche Befehle mit ihnen auszuführen oder sie ganz auszulassen. In solchen Fällen können Sie ein <literal>override_dh_<replaceable>foo</replaceable></literal>-Ziel mit der entsprechenden Regel in der Datei <filename>rules</filename> erstellen, das ein <literal>override_dh_<replaceable>foo</replaceable></literal>-Ziel für den Befehl <command>dh_<replaceable>foo</replaceable></command> definiert, den Sie ändern wollen. Im Grunde bedeutet das nur »<emphasis>führe stattdessen mich aus</emphasis>«. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><section><para>
en: Please note that the <command>dh_auto_*</command> commands tend to do more than what has been discussed in this (over)simplified explanation to take care of all the corner cases.  It is a bad idea to use <literal>override_dh_*</literal> targets to substitute simplified equivalent commands (except for the <literal>override_dh_auto_clean</literal> target) since it may bypass such smart <systemitem role="package">debhelper</systemitem> features.
de: Bitte beachten Sie, dass die <command>dh_auto_*</command>-Befehle dazu neigen, mehr als die in dieser stark vereinfachten Erklärung dargestellten Tätigkeiten zu erledigen, um Randfälle zu berücksichtigen. Es ist keine gute Idee, <literal>override_dh_*</literal>-Ziele zu verwenden, um die vereinfachten äquivalenten Befehle als Ersatz zu verwenden (außer beim Ziel <literal>override_dh_auto_clean</literal>), da damit solche pfiffigen <systemitem role="package">debhelper</systemitem>-Funktionalitäten umgangen werden.

note: type: Content of: <book><chapter><section><section><para>
en: So, for instance, if you want to store system configuration data in the <filename>/etc/gentoo</filename> directory instead of the usual <filename>/etc</filename> directory for the recent <systemitem role="package">gentoo</systemitem> package using Autotools, you can override the default <literal>--sysconfig=/etc</literal> argument given by the <command>dh_auto_configure</command> command to the <command>./configure</command> command by the following:
de: Falls Sie beispielsweise mittels der Autotools Systemkonfigurationsdaten des aktuellen <systemitem role="package">gentoo</systemitem>-Pakets im Verzeichnis <filename>/etc/gentoo</filename> statt im normalen Verzeichnis <filename>/etc</filename> speichern wollen, können Sie das Vorgabeargument <literal>--sysconfig=/etc</literal> für <command>./configure</command> im Befehl <command>dh_auto_configure</command> durch folgendes außer Kraft setzen:

note: type: Content of: <book><chapter><section><section><para>
en: The arguments given after <literal>--</literal> are appended to the default arguments of the auto-executed program to override them.  Using the <command>dh_auto_configure</command> command is better than directly invoking the <command>./configure</command> command here since it will only override the <literal>--sysconfig</literal> argument and retain any other, benign arguments to the <command>./configure</command> command.
de: Die nach dem <literal>--</literal> übergebenen Argumente werden zu den vorgegebenen Argumenten des automatisch ausgeführten Programms hinzugefügt, um sie zu überschreiben. Die Benutzung des Befehls <command>dh_auto_configure</command> ist besser als der direkte Aufruf von <command>./configure</command>, weil in diesem Fall lediglich das Argument <literal>--sysconfig</literal> überschrieben wird und andere, sehr wohl beabsichtigte, Argumente für den Befehl <command>./configure</command> erhalten bleiben.

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: <command>dh_auto_build</command> without any arguments will execute the first target in the <filename>Makefile</filename>.
de: <command>dh_auto_build</command> ohne Argumente führt das erste Ziel in dem <filename>Makefile</filename> aus.

note: type: Content of: <book><chapter><section><section><para>
en: If the <filename>Makefile</filename> in the source for <systemitem role="package">gentoo</systemitem> requires you to specify <literal>build</literal> as its target to build it <placeholder type="footnote" id="0"/>, you create an <literal>override_dh_auto_build</literal> target to enable this.
de: Falls das <filename>Makefile</filename> in den Quellen von <systemitem role="package">gentoo</systemitem> zum Bauen explizit das Ziel <literal>build</literal> benötigt, <placeholder type="footnote" id="0"/>, können Sie ein Ziel namens <literal>override_dh_auto_build</literal> erstellen, um dies zu ermöglichen.

note: type: Content of: <book><chapter><section><section><para>
en: This ensures <literal>$(MAKE)</literal> is run with all the default arguments given by the <command>dh_auto_build</command> command plus the <literal>build</literal> argument.
de: Hiermit wird sichergestellt, dass <literal>$(MAKE)</literal> mit allen voreingestellten Argumenten des Befehls <command>dh_auto_build</command> plus dem Argument <literal>build</literal> ausgeführt wird.

note: type: Content of: <book><chapter><section><section><para>
en: If the <filename>Makefile</filename> in the source for <systemitem role="package">gentoo</systemitem> requires you to specify the <literal>packageclean</literal> target to clean it for the Debian package instead of using <literal>distclean</literal> or <literal>clean</literal> targets, you can create an <literal>override_dh_auto_clean</literal> target to enable it.
de: Falls das <filename>Makefile</filename> in den Quellen von <systemitem role="package">gentoo</systemitem> zum Aufräumen für das Debianpaket explizit das Ziel <literal>packageclean</literal> benötigt statt der Ziele <literal>distclean</literal> oder <literal>clean</literal>, können Sie ein Ziel namens <literal>override_dh_auto_clean</literal> erstellen, um dies zu nutzen.

note: type: Content of: <book><chapter><section><section><para>
en: If the <filename>Makefile</filename> in the source for <systemitem role="package">gentoo</systemitem> contains a <literal>test</literal> target which you do not want to run for the Debian package building process, you can use an empty <literal>override_dh_auto_test</literal> target to skip it.
de: Falls das <filename>Makefile</filename> in den Quellen von <systemitem role="package">gentoo</systemitem> das Ziel <literal>test</literal> enthält, das Sie im Paketbau-Prozess für Debian nicht ausführen wollen, können Sie ein leeres Ziel namens <literal>override_dh_auto_test</literal> erstellen, um dies zu übergehen.

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: The <filename>debian/changelog</filename> and <filename>debian/NEWS</filename> files are always automatically installed.  The upstream changelog is found by converting filenames to lower case and matching them against <filename>changelog</filename>, <filename>changes</filename>, <filename>changelog.txt</filename>, and <filename>changes.txt</filename>.
de: Die Dateien <filename>debian/changelog</filename> und <filename>debian/NEWS</filename> werden immer automatisch installiert. Das Changelog der Originalautoren wird gefunden, indem die Dateinamen in Kleinbuchstaben umgewandelt werden und mit <filename>changelog</filename>, <filename>changes</filename>, <filename>changelog.txt</filename> und <filename>changes.txt</filename> verglichen werden.

note: type: Content of: <book><chapter><section><section><para>
en: If <systemitem role="package">gentoo</systemitem> has an unusual upstream changelog file called <filename>FIXES</filename>, <command>dh_installchangelogs</command> will not install that file by default.  The <command>dh_installchangelogs</command> command requires <filename>FIXES</filename> as its argument to install it.  <placeholder type="footnote" id="0"/>
de: Wenn <systemitem role="package">gentoo</systemitem> eine unübliche ursprüngliche Changelog-Datei namens <filename>FIXES</filename> enthält, wird diese standardmäßig von <command>dh_installchangelogs</command> nicht installiert. Der Befehl <command>dh_installchangelogs</command> braucht den Namen <filename>FIXES</filename> als Argument, um die Datei zu installieren. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><section><para>
en: When you use the new <command>dh</command> command, use of explicit targets such as the ones listed in <xref linkend="targets"/>, other than the <literal>get-orig-source</literal> target, may make it difficult to understand their exact effects.  Please limit explicit targets to <literal>override_dh_*</literal> targets and completely independent ones, if possible.
de: Wenn Sie den neuen <command>dh</command>-Befehl benutzen, wird es schwierig, die genauen Effekte von expliziten Zielen wie den in <xref linkend="targets"/> aufgelisteten zu verstehen. Eine Ausnahme stellt <literal>get-orig-source</literal> dar. Bitte beschränken Sie daher - soweit möglich - explizite Ziele auf solche mit den Namen <literal>override_dh_*</literal> sowie vollständig davon unabhängige.

note: type: Content of: <book><chapter><title>
en: Other files under the <filename>debian</filename> directory
de: Andere Dateien im Verzeichnis <filename>debian</filename>

note: type: Content of: <book><chapter><para>
en: The <command>dh_make</command> command had major updates since this old document was written.  So some parts of this document aren't applicable any more.
de: Der Befehl <command>dh_make</command> wurde umfangreich aktualisiert, seitdem dieses alte Dokument geschrieben wurde. Daher treffen einige Teile dieses Dokuments nicht mehr zu.

note: type: Content of: <book><chapter><para>
en: The <command>debmake</command> command is used in place of the <command>dh_make</command> command in my new <ulink url="&guidedeb;">Guide for Debian Maintainers</ulink>.
de: Der Befehl <command>debmake</command> wird anstelle des Befehls <command>dh_make</command> in meinem neuen <ulink url="&guidedeb;">Guide for Debian Maintainers</ulink> verwandt.

note: type: Content of: <book><chapter><para>
en: To control most of what <systemitem role="package">debhelper</systemitem> does while building the package, you put optional configuration files under the <filename>debian</filename> directory.  This chapter will provide an overview of what each of these does and its format.  Please read the <ulink url="&debian-policy;">Debian Policy Manual</ulink> and <ulink url="&developers-reference;">Debian Developer's Reference</ulink> for guidelines for packaging.
de: Um kontrollieren zu können, was genau <systemitem role="package">debhelper</systemitem> während des Paketbauens durchführt, erstellen Sie optionale Konfigurationsdateien im Verzeichnis <filename>debian</filename>. In diesem Kapitel finden Sie einen Überblick darüber, wofür die einzelnen Dateien benötigt werden und wie ihr jeweiliges Format aussieht. Im <ulink url="&debian-policy;">Debian Policy Manual</ulink> und in der <ulink url="&developers-reference;">Debian-Entwicklerreferenz</ulink> finden Sie Anleitungen zum Thema Paketierung.

note: type: Content of: <book><chapter><para>
en: The <command>dh_make</command> command will create some template configuration files under the <filename>debian</filename> directory.  Take a look at all of them.
de: Der Befehl <command>dh_make</command> wird einige Vorlagenkonfigurationsdateien unter dem Verzeichnis <filename>debian</filename> erstellen. Schauen Sie sich alle an.

note: type: Content of: <book><chapter><para>
en: Some template configuration files for <systemitem role="package">debhelper</systemitem> may not be created by the <command>dh_make</command> command.  In such cases, you need to create them with an editor.
de: Der Befehl <command>dh_make</command> erstellt für <systemitem role="package">debhelper</systemitem> nicht alle Konfigurationsdateien. Falls Sie diese benötigen, müssen Sie sie mit einem Editor erstellen.

note: type: Content of: <book><chapter><para>
en: If you wish or need to activate any of these, please do the following:
de: Falls Sie eine dieser Dateien verwenden möchten oder müssen, machen Sie bitte folgendes:

note: type: Content of: <book><chapter><itemizedlist><listitem><para>
en: rename the configuration files to use the actual binary package name in place of <literal><replaceable>package</replaceable></literal>;
de: Benennen Sie die Konfigurationsdateien um, so dass sie den tatsächlichen Paketnamen anstatt <literal><replaceable>Paket</replaceable></literal> verwenden.

note: type: Content of: <book><chapter><itemizedlist><listitem><para>
en: modify template file contents to suit your needs;
de: Passen Sie die Inhalte der Vorlagedateien Ihren Bedürfnissen an.

note: type: Content of: <book><chapter><itemizedlist><listitem><para>
en: remove template files which you do not need;
de: Löschen Sie Vorlagedateien, die Sie nicht benötigen.

note: type: Content of: <book><chapter><itemizedlist><listitem><para>
en: modify the <filename>control</filename> file (see <xref linkend="control"/>), if necessary;
de: Passen Sie die Datei <filename>control</filename> an, falls notwendig (siehe <xref linkend="control"/>).

note: type: Content of: <book><chapter><itemizedlist><listitem><para>
en: modify the <filename>rules</filename> file (see <xref linkend="rules"/>), if necessary.
de: Passen Sie die Datei <filename>rules</filename> an, falls notwendig (siehe <xref linkend="rules"/>).

note: type: Content of: <book><chapter><para>
en: Any <systemitem role="package">debhelper</systemitem> configuration files without a <filename><replaceable>package</replaceable></filename> prefix, such as <filename>install</filename>, apply to the first binary package.  When there are many binary packages, their configurations can be specified by prefixing their name to their configuration filenames such as <filename><replaceable>package-1</replaceable>.install</filename>, <filename><replaceable>package-2</replaceable>.install</filename>, etc.
de: Alle <systemitem role="package">debhelper</systemitem>-Konfigurationsdateien ohne ein <filename><replaceable>Paket</replaceable></filename>-Präfix, wie beispielsweise die Datei <filename>install</filename>, beziehen sich auf das erste Binärpaket. Wenn es mehrere Binärpakete gibt, können die jeweiligen Konfigurationen dadurch zugeordnet werden, dass der Name des Pakets als Präfix vor den Namen der Konfigurationsdatei gestellt wird. Beispiele sind <filename><replaceable>Paket-1</replaceable>.install</filename>, <filename><replaceable>Paket-2</replaceable>.install</filename> usw.

note: type: Content of: <book><chapter><section><para>
en: Any extra details or discrepancies between the original package and your Debian version should be documented here.
de: Alle zusätzlichen Details oder Unterschiede zwischen dem ursprünglichen Paket und Ihrer Debian-Version sollten hier dokumentiert werden.

note: type: Content of: <book><chapter><section><para>
en: <command>dh_make</command> created a default one; this is what it looks like:
de: <command>dh_make</command> erstellt eine Standardvorlage, die so aussieht:

note: type: Content of: <book><chapter><section><para>
en: If you have nothing to be documented, remove this file.  See <citerefentry> <refentrytitle>dh_installdocs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.
de: Falls Sie nichts zu dokumentieren haben, löschen Sie diese Datei. Siehe <citerefentry> <refentrytitle>dh_installdocs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><para>
en: The <filename>compat</filename> file defines the <systemitem role="package">debhelper</systemitem> compatibility level.  Currently, you should set it to the <systemitem role="package">debhelper</systemitem> v10 as follows:
de: Die Datei <filename>compat</filename> legt die <systemitem role="package">debhelper</systemitem>-Kompatibilitätsstufe fest. Derzeit sollten Sie <systemitem role="package">debhelper</systemitem> V10 verwenden, indem Sie folgendes ausführen:

note: type: Content of: <book><chapter><section><para>
en: You may use compat level v9 in certain circumstances for compatibility with older systems. However, using any level below v9 is not recommended and should be avoided for new packages.
de: Unter bestimmten Umständen können Sie die Kompatibilitätsstufe V9 für die Kompatibilität mit älteren Systemen verwenden. Es wird aber empfohlen, unter keinen Umständen eine Stufe unterhalb von V9 zu verwenden; deren Verwendung in neuen Paketen sollte vermieden werden.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <citerefentry> <refentrytitle>dpkg</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> and <ulink url="&policy-conffiles;">Debian Policy Manual, "D.2.5 Conffiles"</ulink>.
de: Lesen Sie <citerefentry> <refentrytitle>dpkg</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> und das <ulink url="&policy-conffiles;">Debian Policy Manual, »D.2.5 Conffiles«</ulink>.

note: type: Content of: <book><chapter><section><para>
en: One of the most annoying things about software is when you spend a great deal of time and effort customizing a program, only to have an upgrade stomp all over your changes.  Debian solves this problem by marking such configuration files as conffiles.  <placeholder type="footnote" id="0"/> When you upgrade a package, you'll be asked whether you want to keep your old configuration files or not.
de: Eine der ärgerlichsten Sachen bei Software ist es, wenn Sie richtig viel Zeit und Mühe in die Konfiguration eines Programms investieren und schon das nächste Upgrade alle Ihre Änderungen zunichte macht. Debian löst dieses Problem, indem diese Konfigurationsdateien als Conffiles markiert werden. <placeholder type="footnote" id="0"/>. Wenn Sie ein Upgrade eines Pakets durchführen, werden Sie gefragt, ob Sie Ihre alte Konfigurationsdateien behalten wollen oder nicht.

note: type: Content of: <book><chapter><section><para>
en: <citerefentry><refentrytitle>dh_installdeb</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> <emphasis>automatically</emphasis> flags any files under the <filename>/etc</filename> directory as conffiles, so if your program only has conffiles there you do not need to specify them in this file.  For most package types, the only place conffiles should ever be is under <filename>/etc</filename>, and so this file doesn't need to exist.
de: <citerefentry> <refentrytitle>dh_installdeb</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> markiert <emphasis>automatisch</emphasis> alle Dateien im Verzeichnis <filename>/etc</filename> als »conffiles«. Wenn Ihr Programm also nur dort Konfigurationsdateien besitzt, müssen Sie sie nicht in dieser Datei auflisten. Bei den meisten Paketarten sollte der einzige Ort, an dem sich jemals Conffiles befinden, <filename>/etc</filename> sein und daher muss diese Datei nicht existieren.

note: type: Content of: <book><chapter><section><para>
en: If your program uses configuration files but also rewrites them on its own, it's best not to make them conffiles because <command>dpkg</command> will then prompt users to verify the changes all the time.
de: Falls Ihr Programm Konfigurationsdateien nutzt, diese aber auch selbst bearbeitet, ist es das Beste, diese nicht als Conffiles zu kennzeichnen, weil sonst <command>dpkg</command> den Benutzer jedes Mal auffordert, Änderungen zu bestätigen.

note: type: Content of: <book><chapter><section><para>
en: If the program you're packaging requires every user to modify the configuration files in the <filename>/etc</filename> directory, there are two popular ways to arrange for them to not be conffiles, keeping <command>dpkg</command> quiet:
de: Falls es für das Programm, das Sie paketieren, erforderlich ist, dass jeder Benutzer die Konfigurationsdateien im Verzeichnis <filename>/etc</filename> anpassen muss, gibt es zwei populäre Arten, es so einzurichten, dass sie keine Conffiles sind, um <command>dpkg</command> ruhig zu stellen:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Create a symlink under the <filename>/etc</filename> directory pointing to a file under the <filename>/var</filename> directory generated by the maintainer scripts.
de: Erstellen Sie einen symbolischen Link im Verzeichnis <filename>/etc</filename>, der auf eine Datei im Verzeichnis <filename>/var</filename> zeigt. Dieser kann von den Betreuerskripten erzeugt werden.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Create a file generated by the maintainer scripts under the <filename>/etc</filename> directory.
de: Erstellen Sie eine Datei, die von den Betreuerskripten im Verzeichnis <filename>/etc</filename> erzeugt wird.

note: type: Content of: <book><chapter><section><para>
en: For information on maintainer scripts, see <xref linkend="maintscripts"/>.
de: Für weitere Informationen über die Betreuerskripte lesen Sie <xref linkend="maintscripts"/>.

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.cron.*</filename>
de: <filename><replaceable>Paket</replaceable>.cron.*</filename>

note: type: Content of: <book><chapter><section><para>
en: If your package requires regularly scheduled tasks to operate properly, you can use these files to set that up.  You can set up regular tasks that either happen hourly, daily, weekly, or monthly, or alternatively happen at any other time that you wish.  The filenames are:
de: Falls Ihr Paket immer wiederkehrende Aufgaben erledigen muss, um korrekt zu arbeiten, können Sie diese Dateien benutzen, um das einzurichten. Sie können regelmäßige Aufgaben erstellen, die stündlich, täglich, wöchentlich oder monatlich ausgeführt werden. Alternativ kann dies auch zu jedem anderen von Ihnen gewünschten Zeitpunkt stattfinden. Die Dateinamen lauten:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <filename><replaceable>package</replaceable>.cron.hourly</filename> - Installed as <filename>/etc/cron.hourly/<replaceable>package</replaceable></filename>; run once an hour.
de: <filename><replaceable>Paket</replaceable>.cron.hourly</filename> - wird als <filename>/etc/cron.hourly/<replaceable>Paket</replaceable></filename> installiert: Ausführung einmal pro Stunde.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <filename><replaceable>package</replaceable>.cron.daily</filename> - Installed as <filename>/etc/cron.daily/<replaceable>package</replaceable></filename>; run once a day.
de: <filename><replaceable>Paket</replaceable>.cron.daily</filename> - wird als <filename>/etc/cron.daily/<replaceable>Paket</replaceable></filename> installiert: Ausführung einmal pro Tag.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <filename><replaceable>package</replaceable>.cron.weekly</filename> - Installed as <filename>/etc/cron.weekly/<replaceable>package</replaceable></filename>; run once a week.
de: <filename><replaceable>Paket</replaceable>.cron.weekly</filename> - wird als <filename>/etc/cron.weekly/<replaceable>Paket</replaceable></filename> installiert: Ausführung einmal pro Woche.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <filename><replaceable>package</replaceable>.cron.monthly</filename> - Installed as <filename>/etc/cron.monthly/<replaceable>package</replaceable></filename>: run once a month.
de: <filename><replaceable>Paket</replaceable>.cron.monthly</filename> - wird als <filename>/etc/cron.monthly/<replaceable>Paket</replaceable></filename> installiert: Ausführung einmal pro Monat.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <filename><replaceable>package</replaceable>.cron.d</filename> - Installed as <filename>/etc/cron.d/<replaceable>package</replaceable></filename>: for any other time.
de: <filename><replaceable>Paket</replaceable>.cron.d</filename> - wird als <filename>/etc/cron.d/<replaceable>Paket</replaceable></filename> installiert: Ausführung zu anderen Zeiten.

note: type: Content of: <book><chapter><section><para>
en: Most of these files are shell scripts, with the exception of <filename><replaceable>package</replaceable>.cron.d</filename> which follows the format of <citerefentry> <refentrytitle>crontab</refentrytitle> <manvolnum>5</manvolnum> </citerefentry>.
de: Die meisten dieser Dateien sind Shellskripte. Die einzige Ausnahme stellt <filename><replaceable>Paket</replaceable>.cron.d</filename> dar, das im Format einer <citerefentry> <refentrytitle>crontab</refentrytitle> <manvolnum>5</manvolnum> </citerefentry> vorliegen muss.

note: type: Content of: <book><chapter><section><para>
en: No explicit <filename>cron.*</filename> file is needed to set up log rotation; for that, see <citerefentry><refentrytitle>dh_installlogrotate</refentrytitle> <manvolnum>1</manvolnum></citerefentry> and <citerefentry><refentrytitle>logrotate</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
de: Es wird keine dedizierte <filename>cron.*</filename>-Datei für das Rotieren der Protokolldateien benötigt. Lesen Sie dazu bitte <citerefentry><refentrytitle>dh_installlogrotate</refentrytitle> <manvolnum>1</manvolnum></citerefentry> und <citerefentry><refentrytitle>logrotate</refentrytitle> <manvolnum>8</manvolnum></citerefentry>.

note: type: Content of: <book><chapter><section><para>
en: This file specifies any directories which we need but which are not created by the normal installation procedure (<literal>make install DESTDIR=...</literal> invoked by <literal>dh_auto_install</literal>).  This generally means there is a problem with the <filename>Makefile</filename>.
de: In dieser Datei werden alle Verzeichnisse festgelegt, die wir brauchen, die aber von der normalen Installationsprozedur (»<literal>make install DESTDIR=...</literal>«, aufgerufen von »<literal>dh_auto_install</literal>«) aus irgendwelchen Gründen nicht erstellt werden. Dies bedeutet fast immer, dass es ein Problem mit dem <filename>Makefile</filename> gibt.

note: type: Content of: <book><chapter><section><para>
en: Files listed in an <filename>install</filename> file don't need their directories created first.  See <xref linkend="install"/>.
de: Für Dateien, die in der Datei <filename>install</filename> aufgelistet sind, müssen die Verzeichnisse nicht zuerst erstellt werden. Siehe <xref linkend="install"/>.

note: type: Content of: <book><chapter><section><para>
en: It is best to try to run the installation first and only use this if you run into trouble.  There is no preceding slash on the directory names listed in the <filename>dirs</filename> file.
de: Am besten ist es, wenn Sie zunächst die Installation ausprobieren und diesen Mechanismus nur dann benutzen, wenn es dabei Probleme gibt. Es gibt keinen einleitenden Schrägstrich bei den Verzeichnisnamen, die in der Datei <filename>dirs</filename> aufgeführt sind.

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.doc-base</filename>
de: <filename><replaceable>Paket</replaceable>.doc-base</filename>

note: type: Content of: <book><chapter><section><para>
en: If your package has documentation other than manual and info pages, you should use the <systemitem role="package">doc-base</systemitem> file to register it, so the user can find it with e.g.  <citerefentry> <refentrytitle>dhelp</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>dwww</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, or <citerefentry> <refentrytitle>doccentral</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.
de: Hat Ihr Programm außer Handbuch- und Info-Seiten noch andere Dokumentation, sollten Sie die Datei <systemitem role="package">doc-base</systemitem> benutzen, um diese zu registrieren, damit der Benutzer sie mit Programmen wie <citerefentry> <refentrytitle>dhelp</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>dwww</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> oder <citerefentry> <refentrytitle>doccentral</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> finden kann.

note: type: Content of: <book><chapter><section><para>
en: This usually includes HTML, PS and PDF files, shipped in <filename>/usr/share/doc/<replaceable>packagename</replaceable>/</filename>.
de: Das schließt normalerweise HTML-, PS- und PDF-Dateien ein, die sich in <filename>/usr/share/doc/<replaceable>Paketname</replaceable>/</filename> befinden.

note: type: Content of: <book><chapter><section><para>
en: This is what <systemitem role="package">gentoo</systemitem>'s doc-base file <filename>gentoo.doc-base</filename> looks like:
de: So sieht die doc-base-Datei <filename>gentoo.doc-base</filename> für das Paket <systemitem role="package">gentoo</systemitem> aus:

note: type: Content of: <book><chapter><section><para>
en: For information on the file format, see <citerefentry> <refentrytitle>install-docs</refentrytitle> <manvolnum>8</manvolnum> </citerefentry> and the Debian <systemitem role="package">doc-base</systemitem> manual at the local copy <filename>&doc-base;</filename> provided by the <systemitem role="package">doc-base</systemitem> package.
de: Informationen über das Format dieser Datei finden Sie in <citerefentry> <refentrytitle>install-docs</refentrytitle> <manvolnum>8</manvolnum> </citerefentry> und der Debian-Anleitung von <systemitem role="package">doc-base</systemitem> in  der lokalen Kopie <filename>&doc-base;</filename>, die vom Paket <systemitem role="package">doc-base</systemitem> bereitgestellt wird.

note: type: Content of: <book><chapter><section><para>
en: For more details on installing additional documentation, look in <xref linkend="destdir"/>.
de: Für weitere Details über das Installieren von zusätzlicher Dokumentation sehen Sie bitte in <xref linkend="destdir"/> nach.

note: type: Content of: <book><chapter><section><para>
en: This file specifies the file names of documentation files we can have <citerefentry> <refentrytitle>dh_installdocs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> install into the temporary directory for us.
de: Diese Datei enthält die Dateinamen der Dokumentationsdateien, die <citerefentry> <refentrytitle>dh_installdocs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> für uns in das temporäre Verzeichnis installiert.

note: type: Content of: <book><chapter><section><para>
en: By default, it will include all existing files in the top-level source directory that are called <filename>BUGS</filename>, <filename>README*</filename>, <filename>TODO</filename> etc.
de: Standardmäßig schließt das alle Dateien im obersten Verzeichnis des Quellcodes ein, die da heißen »<filename>BUGS</filename>«, »<filename>README*</filename>«, »<filename>TODO</filename>« usw.

note: type: Content of: <book><chapter><section><para>
en: For <systemitem role="package">gentoo</systemitem>, some other files are also included:
de: Für <systemitem role="package">gentoo</systemitem> werden noch weitere Dateien hinzugefügt:

note: type: Content of: <book><chapter><section><para>
en: If your package supplies Emacs files that can be bytecompiled at package installation time, you can use these files to set it up.
de: Falls Ihr Paket Emacs-Dateien bereitstellt, die während der Installation des Pakets kompiliert werden, können Sie diese Dateien dafür nutzen.

note: type: Content of: <book><chapter><section><para>
en: They are installed into the temporary directory by <citerefentry> <refentrytitle>dh_installemacsen</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.
de: Sie werden durch <citerefentry> <refentrytitle>dh_installemacsen</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> ins temporäre Verzeichnis installiert.

note: type: Content of: <book><chapter><section><para>
en: If you don't need these, remove them.
de: Falls Sie dies nicht benötigen, löschen Sie die Dateien.

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.examples</filename>
de: <filename><replaceable>Paket</replaceable>.examples</filename>

note: type: Content of: <book><chapter><section><para>
en: The <citerefentry> <refentrytitle>dh_installexamples</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command installs files and directories listed in this file as example files.
de: Der Befehl <citerefentry> <refentrytitle>dh_installexamples</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> installiert die in dieser Datei aufgelisteten Dateien und Verzeichnisse als Beispieldateien.

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.init</filename> and <filename><replaceable>package</replaceable>.default</filename>
de: <filename><replaceable>Paket</replaceable>.init</filename> und <filename><replaceable>Paket</replaceable>.default</filename>

note: type: Content of: <book><chapter><section><para>
en: If your package is a daemon that needs to be run at system start-up, you've obviously disregarded my initial recommendation, haven't you? :-)
de: Falls Ihr Paket einen Daemon enthält, der beim Hochfahren des Systems gestartet werden muss, haben Sie offensichtlich meine anfängliche Empfehlung missachtet, stimmt's? :-)

note: type: Content of: <book><chapter><section><para>
en: Please read <citerefentry> <refentrytitle>dh_installinit</refentrytitle><manvolnum>1</manvolnum> </citerefentry> <citerefentry> <refentrytitle>dh_installsystemd</refentrytitle><manvolnum>1</manvolnum> </citerefentry> to provide startup script.
de: Bitte lesen Sie <citerefentry> <refentrytitle>dh_installinit</refentrytitle><manvolnum>1</manvolnum> </citerefentry> <citerefentry> <refentrytitle>dh_installsystemd</refentrytitle><manvolnum>1</manvolnum> </citerefentry>, um ein Hochfahr-Skript bereitzustellen.

note: type: Content of: <book><chapter><section><para>
en: The <filename><replaceable>package</replaceable>.default</filename> file will be installed as <filename>/etc/default/<replaceable>package</replaceable></filename>.  This file sets defaults that are sourced by the init script.  This <filename><replaceable>package</replaceable>.default</filename> file is most often used to set some default flags or timeouts.  If your init script has certain configurable features, you can set them in the <filename><replaceable>package</replaceable>.default</filename> file, instead of in the init script itself.
de: Die Datei <filename><replaceable>Paket</replaceable>.default</filename> wird als <filename>/etc/default/<replaceable>Paket</replaceable></filename> installiert. Diese Datei legt Voreinstellungen fest, die vom Init-Skript eingelesen werden. Diese Datei <filename><replaceable>package</replaceable>.default</filename> wird meistens zum Setzen einiger Vorgabewerte für Schalter oder Zeitüberschreitungen verwandt. Falls in Ihrem init-Skript bestimmte einstellbare Funktionen sind, können Sie diese in der Datei <filename><replaceable>package</replaceable>.default</filename> statt im init-Skript selbst einstellen.

note: type: Content of: <book><chapter><section><para>
en: If your upstream program provides a file for the init script, you can either use it or not.  If you don't use their init script then create a new one in <filename><replaceable>package</replaceable>.init</filename>.  However if the upstream init script looks fine and installs in the right place you still need to set up the <filename>rc*</filename> symlinks.  To do this you will need to override <command>dh_installinit</command> in the <filename>rules</filename> file with the following lines:
de: Falls Ihr Programm der Originalautoren eine Datei für ein Init-Skript bereitstellt, können Sie dies entweder benutzten oder ein eigenes erstellen. Falls Sie das mitgelieferte init-Skript nicht verwenden, erstellen Sie ein neues in <filename><replaceable>Paket</replaceable>.init</filename>. Falls das von den Originalautoren mitgelieferte Init-Skript aber gut aussieht und an der richtigen Stelle installiert wird, müssen Sie trotzdem die symbolischen Links für <filename>rc*</filename> erzeugen. Dafür müssen Sie <command>dh_installinit</command> in der Datei <filename>rules</filename> mit den folgenden Zeilen überschreiben:

note: type: Content of: <book><chapter><section><para>
en: If you don't need this, remove the files.
de: Falls Sie das nicht benötigen, löschen Sie die Dateien.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: This replaces the deprecated <citerefentry> <refentrytitle>dh_movefiles</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command which is configured by the <filename>files</filename> file.
de: Dies ersetzt den veralteten Befehl <citerefentry> <refentrytitle>dh_movefiles</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, der durch die Datei <filename>files</filename> konfiguriert wurde.

note: type: Content of: <book><chapter><section><para>
en: If there are files that need to be installed into your package but your standard <literal>make install</literal> won't do it, put the filenames and destinations into this <filename>install</filename> file.  They are installed by <citerefentry> <refentrytitle>dh_install</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.<placeholder type="footnote" id="0"/> You should first check that there is not a more specific tool to use.  For example, documents should be in the <filename>docs</filename> file and not in this one.
de: Falls es Dateien gibt, die in Ihr Paket installiert werden müssen, die aber vom Standardaufruf »<literal>make install</literal>« nicht erfasst werden, schreiben Sie diese Dateinamen und Ziele in die Datei <filename>install</filename>. Sie werden dann von <citerefentry> <refentrytitle>dh_install</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> installiert. <placeholder type="footnote" id="0"/> Sie sollten zunächst überprüfen, ob es nicht ein spezielleres Werkzeug gibt, das verwendet werden kann. Beispielsweise sollten Dokumente in der Datei <filename>docs</filename> stehen und nicht in dieser hier.

note: type: Content of: <book><chapter><section><para>
en: This <filename>install</filename> file has one line per file installed, with the name of the file (relative to the top build directory) then a space then the installation directory (relative to the install directory).  One example of where this is used is if a binary <filename>src/<replaceable>bar</replaceable></filename> is left uninstalled; the <filename>install</filename> file might look like:
de: Diese Datei <filename>install</filename> enthält pro Zeile eine zu installierende Datei, zunächst den Namen der Datei (relativ zum obersten Verzeichnis des Paketbaus), dann ein Leerzeichen und zuletzt das Installationsverzeichnis (relativ zum Install-Verzeichnis). Ein Beispiel, wo dies benutzt werden kann, ist eine Binärdatei <filename>src/<replaceable>bar</replaceable></filename>, die nicht installiert wurde. Die Datei <filename>install</filename> könnte so aussehen:

note: type: Content of: <book><chapter><section><para>
en: This means when this package is installed, there will be an executable command <filename>/usr/bin/<replaceable>bar</replaceable></filename>.
de: Wenn dieses Paket installiert ist, bedeutet dies, dass es einen ausführbaren Befehl <filename>/usr/bin/<replaceable>bar</replaceable></filename> geben wird.

note: type: Content of: <book><chapter><section><para>
en: Alternatively, this <filename>install</filename> can have the name of the file only without the installation directory when the relative directory path does not change.  This format is usually used for a large package that splits the output of its build into multiple binary packages using <filename><replaceable>package-1</replaceable>.install</filename>, <filename><replaceable>package-2</replaceable>.install</filename>, etc.
de: Alternativ kann die Datei <filename>install</filename> nur den Dateinamen ohne Installationsverzeichnis enthalten, wenn sich der relative Verzeichnispfad nicht ändert. Dieses Format wird üblicherweise für große Pakete benutzt, die das Ergebnis des Baus auf mehrere Binärpakete verteilen. Dafür verwenden diese <filename><replaceable>Paket-1</replaceable>.install</filename>, <filename><replaceable>Paket-2</replaceable>.install</filename> usw.

note: type: Content of: <book><chapter><section><para>
en: The <command>dh_install</command> command will fall back to looking in <filename>debian/tmp</filename> for files, if it doesn't find them in the current directory (or wherever you've told it to look using <literal>--sourcedir</literal>).
de: Der Befehl <command>dh_install</command> fällt darauf zurück, im Verzeichnis <filename>debian/tmp</filename> nach Dateien zu suchen, wenn er sie im aktuellen Verzeichnis nicht findet (oder wo auch immer Sie das Programm mit <literal>--sourcedir</literal> angewiesen haben, zu suchen).

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.info</filename>
de: <filename><replaceable>Paket</replaceable>.info</filename>

note: type: Content of: <book><chapter><section><para>
en: If your package has info pages, you should install them using <citerefentry> <refentrytitle>dh_installinfo</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> by listing them in a <filename><replaceable>package</replaceable>.info</filename> file.
de: Falls Ihr Paket »info«-Seiten hat, sollten Sie diese mit <citerefentry> <refentrytitle>dh_installinfo</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> installieren, indem Sie sie in einer Datei <filename><replaceable>Paket</replaceable>.info</filename> auflisten.

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.links</filename>
de: <filename><replaceable>Paket</replaceable>.links</filename>

note: type: Content of: <book><chapter><section><para>
en: If you need to create additional symlinks in package build directories as package maintainer, you should install them using <citerefentry> <refentrytitle>dh_link</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> by listing their full paths of source and destination files in a <filename><replaceable>package</replaceable>.links</filename> file.
de: Falls Sie zusätzliche symbolische Links in den Paketbauverzeichnissen als Paketbetreuer erstellen müssen, sollten Sie diese mit <citerefentry> <refentrytitle>dh_link</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> installieren, indem Sie deren komplette Pfade der Quell- und Zieldateien in einer Datei <filename><replaceable>Paket</replaceable>.links</filename> aufführen.

note: type: Content of: <book><chapter><section><title>
en: <filename>{<replaceable>package</replaceable>.,source/}lintian-overrides</filename>
de: <filename>{<replaceable>Paket</replaceable>.|source/}lintian-overrides</filename>

note: type: Content of: <book><chapter><section><para>
en: If <systemitem role="package">lintian</systemitem> reports an erroneous diagnostic for a case where Debian policy allows exceptions to some rule, you can use <filename><replaceable>package</replaceable>.lintian-overrides</filename> or <filename>source/lintian-overrides</filename> to quieten it.  Please read the Lintian User's Manual (<filename>&lintian-doc;</filename>) and refrain from abusing this.
de: Falls die Debian-Richtlinien eine Ausnahme von einer Regel erlauben, erzeugt <systemitem role="package">lintian</systemitem> eventuell eine falsche Meldung. Wenn dies der Fall ist, können Sie <filename><replaceable>Paket</replaceable>.lintian-overrides</filename> oder <filename>source/lintian-overrides</filename> benutzen, um die Meldung zu unterdrücken. Bitte lesen Sie das Benutzerhandbuch von Lintian (<filename>&lintian-doc;</filename>) und missbrauchen Sie diesen Mechanismus nicht.

note: type: Content of: <book><chapter><section><para>
en: <filename><replaceable>package</replaceable>.lintian-overrides</filename> is for the binary package named <systemitem role="package"><replaceable>package</replaceable></systemitem> and is installed into <filename>usr/share/lintian/overrides/<replaceable>package</replaceable></filename> by the <command>dh_lintian</command> command.
de: <filename><replaceable>Paket</replaceable>.lintian-overrides</filename> ist für das Binärpaket <systemitem role="package"><replaceable>Paket</replaceable></systemitem> und wird als <filename>usr/share/lintian/overrides/<replaceable>Paket</replaceable></filename> vom Befehl <command>dh_lintian</command> installiert.

note: type: Content of: <book><chapter><section><para>
en: <filename>source/lintian-overrides</filename> is for the source package.  This is not installed.
de: <filename>source/lintian-overrides</filename> ist für das Quellpaket. Diese Datei wird nicht installiert.

note: type: Content of: <book><chapter><section><para>
en: Your program(s) should have a manual page.  If they don't, you should create them.  The <command>dh_make</command> command creates some template files for manual pages.  These need to be copied and edited for each command missing its manual page.  Please make sure to remove unused templates.
de: Ihr(e) Programm(e) sollte(n) eine Handbuchseite haben. Ist keine vorhanden, sollten Sie sie erstellen. Der Befehl <command>dh_make</command> erzeugt einige Vorlagendateien für Handbuchseiten. Diese müssen für jeden Befehl kopiert und bearbeitet werden, dem eine Handbuchseite fehlt. Bitte löschen Sie alle nicht benutzten Vorlagen.

note: type: Content of: <book><chapter><section><section><para>
en: Manual pages are normally written in <citerefentry> <refentrytitle>nroff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.  The <filename>manpage.1.ex</filename> template is written in <command>nroff</command>, too.  See the <citerefentry> <refentrytitle>man</refentrytitle> <manvolnum>7</manvolnum> </citerefentry> manual page for a brief description of how to edit such a file.
de: Handbuchseiten werden üblicherweise in <citerefentry> <refentrytitle>nroff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> geschrieben. Das Beispiel <filename>manpage.1.ex</filename> ist auch in <command>nroff</command> geschrieben. In der Handbuchseite von <citerefentry> <refentrytitle>man</refentrytitle> <manvolnum>7</manvolnum> </citerefentry> finden Sie eine kurze Erklärung, wie solche Dateien bearbeitet werden können.

note: type: Content of: <book><chapter><section><section><para>
en: The final manual page file name should give the name of the program it is documenting, so we will rename it from <literal>manpage</literal> to <literal>gentoo</literal>.  The file name also includes <literal>.1</literal> as the first suffix, which means it's a manual page for a user command.  Be sure to verify that this section is indeed the correct one.  Here's a short list of manual page sections:
de: Der endgültige Name der Handbuchseite sollte den Namen des Programms, das dokumentiert wird, angeben. Deshalb ändern wir den Namen von »<literal>manpage</literal>« nach »<literal>gentoo</literal>«. Der Dateiname muss auch eine »<literal>.1</literal>« als erstes Suffix erhalten, was bedeutet, dass es sich um eine Handbuchseite für einen Benutzerbefehl handelt. Vergewissern Sie sich, dass dieser Abschnitt tatsächlich richtig ist. Hier ist eine kurze Liste der Abschnitte für Handbuchseiten:

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><thead><row><entry>
en: Section
de: Abschnitt

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><thead><row><entry>
en: Description
de: Beschreibung

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><thead><row><entry>
en: Notes
de: Hinweise

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: User commands
de: Dienstprogramme für Benutzer

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Executable commands or scripts
de: Ausführbare Befehle oder Skripte

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: System calls
de: Systemaufrufe

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Functions provided by the kernel
de: Vom Kernel bereitgestellte Funktionen

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Library calls
de: Bibliotheksfunktionen

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Functions within system libraries
de: Funktionen innerhalb Systembibliotheken

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Special files
de: Besondere Dateien

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Usually found in <filename>/dev</filename>
de: Normalerweise innerhalb von <filename>/dev</filename>

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: File formats
de: Dateiformate

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: E.g. <filename>/etc/passwd</filename>'s format
de: Z.B. Format von <filename>/etc/passwd</filename>

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Games
de: Spiele

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Games or other frivolous programs
de: Spiele oder andere belanglose Programme

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Macro packages
de: Makropakete

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Such as <command>man</command> macros
de: Wie <command>man</command>-Makros

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: System administration
de: Systemadministration

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Programs typically only run by root
de: Programme, die typischerweise nur von Root ausgeführt werden

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Kernel routines
de: Kernelroutinen

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Non-standard calls and internals
de: Nicht standardisierte Aufrufe und Interna

note: type: Content of: <book><chapter><section><section><para>
en: So <systemitem role="package">gentoo</systemitem>'s man page should be called <filename>gentoo.1</filename>.  If there was no <filename>gentoo.1</filename> man page in the original source, you should create it by renaming the <filename>manpage.1.ex</filename> template to <filename>gentoo.1</filename> and editing it using information from the example and from the upstream docs.
de: Also bekommt <systemitem role="package">gentoo</systemitem>s Handbuchseite den Namen <filename>gentoo.1</filename>. Falls es in den ursprünglichen Quellen keine Handbuchseite namens <filename>gentoo.1</filename> gibt, müssen Sie diese erstellen, indem Sie die Vorlage <filename>manpage.1.ex</filename> in <filename>gentoo.1</filename> umbenennen und sie bearbeiten. Dabei verwenden Sie die Informationen aus dem Beispiel und die Dokumentation des Originalautors.

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: Note that <command>help2man</command>'s placeholder man page will claim that more detailed documentation is available in the info system. If the command is missing an <command>info</command> page, you should manually edit the man page created by the <command>help2man</command> command.
de: Beachten Sie, dass die Platzhalter-Handbuchseite von <command>help2man</command> behaupten wird, dass detailliertere Informationen im <command>info</command>-System vorhanden seien. Falls dem Befehl eine Info-Seite fehlt, sollten Sie die von <command>help2man</command> erstellte Handbuchseite manuell bearbeiten.

note: type: Content of: <book><chapter><section><section><para>
en: You can use the <command>help2man</command> command to generate a man page out of the <literal>--help</literal> and <literal>--version</literal> output of each program, too.  <placeholder type="footnote" id="0"/>
de: Sie können auch den Befehl <command>help2man</command> benutzen, um eine Handbuchseite aus der Ausgabe des Programms mit den Optionen »<literal>--help</literal>« und »<literal>--version</literal>« zu erzeugen. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><section><para>
en: If on the other hand you prefer writing SGML instead of <command>nroff</command>, you can use the <filename>manpage.sgml.ex</filename> template.  If you do this, you have to:
de: Falls Sie es andererseits bevorzugen, in SGML anstatt <command>nroff</command> zu schreiben, können Sie die Vorlage <filename>manpage.sgml.ex</filename> benutzen. Dann müssen Sie Folgendes tun:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: rename the file to something like <filename>gentoo.sgml</filename>.
de: Benennen Sie die Datei um, beispielsweise in <filename>gentoo.sgml</filename>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: install the <systemitem role="package">docbook-to-man</systemitem> package
de: Installieren Sie das Paket <systemitem role="package">docbook-to-man</systemitem>

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: add <literal>docbook-to-man</literal> to the <literal>Build-Depends</literal> line in the <filename>control</filename> file
de: Fügen Sie <literal>docbook-to-man</literal> der Zeile <literal>Build-Depends</literal> in der Datei <filename>control</filename> hinzu.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: add an <literal>override_dh_auto_build</literal> target to your <filename>rules</filename> file:
de: Fügen Sie das Target <literal>override_dh_auto_build</literal> in Ihrer Datei <filename>rules</filename> hinzu:

note: type: Content of: <book><chapter><section><section><para>
en: If you prefer XML over SGML, you can use the <literal>manpage.xml.ex</literal> template.  If you do this, you have to:
de: Falls Sie XML gegenüber SGML bevorzugen, können Sie die Vorlage <literal>manpage.xml.ex</literal> benutzen. Dann müssen Sie Folgendes tun:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: rename the source file to something like <literal>gentoo.1.xml</literal>
de: Umbenennen der Quelldatei in etwas wie <literal>gentoo.1.xml</literal>

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: install the <systemitem role="package">docbook-xsl</systemitem> package and an XSLT processor like <systemitem role="package">xsltproc</systemitem> (recommended)
de: Installieren Sie das Paket <systemitem role="package">docbook-xsl</systemitem> und einen XSLT-Prozessor wie <systemitem role="package">xsltproc</systemitem> (empfohlen).

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: add the <literal>docbook-xsl</literal>, <literal>docbook-xml</literal>, and <literal>xsltproc</literal> packages to the <literal>Build-Depends</literal> line in the <literal>control</literal> file
de: Fügen Sie <literal>docbook-xsl</literal>, <literal>docbook-xml</literal> und <literal>xsltproc</literal> der Zeile <literal>Build-Depends</literal> in der Datei <filename>control</filename> hinzu

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.manpages</filename>
de: <filename><replaceable>Paket</replaceable>.manpages</filename>

note: type: Content of: <book><chapter><section><para>
en: If your package has manual pages, you should install them using <citerefentry> <refentrytitle>dh_installman</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> by listing them in a <filename><replaceable>package</replaceable>.manpages</filename> file.
de: Falls Ihr Paket Handbuchseiten hat, sollten Sie sie mit <citerefentry> <refentrytitle>dh_installman</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> installieren, indem Sie sie in einer Dateie <filename><replaceable>Paket</replaceable>.manpages</filename> auflisten.

note: type: Content of: <book><chapter><section><para>
en: To install <filename>docs/gentoo.1</filename> as a manpage for the <systemitem role="package">gentoo</systemitem> package, create a <filename>gentoo.manpages</filename> file as follows:
de: Um <filename>docs/gentoo.1</filename> als Handbuchseite für das Paket <systemitem role="package">gentoo</systemitem> zu installieren, erstellen Sie folgendermaßen eine Datei <filename>gentoo.manpages</filename>:

note: type: Content of: <book><chapter><section><para>
en: The <citerefentry> <refentrytitle>dh_installchangelogs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command installs this.
de: Der Befehl <citerefentry> <refentrytitle>dh_installchangelogs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> installiert diese Datei.

note: type: Content of: <book><chapter><section><title>
en: <filename>{pre,post}{inst,rm}</filename>
de: <filename>{post|pre}{inst|rm}</filename>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Despite this use of the <command>bash</command> shorthand expression <filename>{pre,post}{inst,rm}</filename> to indicate these filenames, you should use pure POSIX syntax for these maintainer scripts for compatibility with <command>dash</command> as the system shell.
de: Trotz der hier verwendeten Abkürzungssyntax <filename>{pre,post}{inst,rm}</filename> von <command>bash</command>, um die Dateinamen zu bezeichnen, sollten Sie reine POSIX-Syntax für diese Betreuerskripte verwenden, um kompatibel zu der Verwendung von <command>dash</command> als System-Shell zu bleiben.

note: type: Content of: <book><chapter><section><para>
en: These <filename>postinst</filename>, <filename>preinst</filename>, <filename>postrm</filename>, and <filename>prerm</filename> files <placeholder type="footnote" id="0"/> are called <emphasis>maintainer scripts</emphasis>.  They are scripts which are put in the control area of the package and run by <command>dpkg</command> when your package is installed, upgraded, or removed.
de: Die Dateien <filename>postinst</filename>, <filename>preinst</filename>, <filename>postrm</filename> und <filename>prerm</filename> <placeholder type="footnote" id="0"/> werden <emphasis>Betreuerskripte</emphasis> (engl. »maintainer scripts«) genannt. Diese Skripte werden für die Steuerung des Pakets verwendet und von <command>dpkg</command> aufgerufen, wenn Ihr Paket installiert, aktualisiert oder entfernt wird.

note: type: Content of: <book><chapter><section><para>
en: As a novice maintainer, you should avoid any manual editing of maintainer scripts because they are problematic.  For more information refer to the <ulink url="&policy-mantainerscripts;">Debian Policy Manual, 6 "Package maintainer scripts and installation procedure"</ulink>, and take a look at the example files provided by <command>dh_make</command>.
de: Als neuer Betreuer sollten Sie das manuelle Bearbeiten dieser Betreuerskripte vermeiden, da sie problematisch sind. Für weitere Informationen lesen Sie in dem <ulink url="&policy-mantainerscripts;">Debian Policy Manual, Kapitel 6 »Package maintainer scripts and installation procedure«</ulink> und sehen Sie sich die Beispieldateien an, die von <command>dh_make</command> erstellt wurden.

note: type: Content of: <book><chapter><section><para>
en: If you did not listen to me and have created custom maintainer scripts for a package, you should make sure to test them not only for <emphasis role="strong">install</emphasis> and <emphasis role="strong">upgrade</emphasis> but also for <emphasis role="strong">remove</emphasis> and <emphasis role="strong">purge</emphasis>.
de: Falls Sie nicht auf mich gehört haben und eigene Betreuerskripte für ein Paket erstellt haben, müssen Sie sicherstellen, dass Sie sie nicht nur für den Aufruf mit <emphasis role="strong">install</emphasis> und <emphasis role="strong">upgrade</emphasis> getestet haben, sondern auch für <emphasis role="strong">remove</emphasis> und <emphasis role="strong">purge</emphasis>.

note: type: Content of: <book><chapter><section><para>
en: Upgrades to the new version should be silent and non-intrusive (existing users should not notice the upgrade except by discovering that old bugs have been fixed and perhaps that there are new features).
de: Upgrades auf die neue Version sollen ohne Rückfragen geschehen und keine Störungen oder Unterbrechungen zur Folge haben (Benutzer, die das Paket verwenden, sollen nicht bemerken, dass ein Upgrade durchgeführt wurde. Sie sollen nur feststellen, dass alte Fehler behoben wurden und das Paket eventuell neue Fähigkeiten hat).

note: type: Content of: <book><chapter><section><para>
en: When the upgrade is necessarily intrusive (eg., config files scattered through various home directories with totally different structure), you may consider as the last resort switching the package to a safe fallback state (e.g., disabling a service) and providing the proper documentation required by policy (<filename>README.Debian</filename> and <filename>NEWS.Debian</filename>).  Don't bother the user with <command>debconf</command> notes invoked from these maintainer scripts for upgrades.
de: Wenn das Upgrade nicht ohne Störung ablaufen kann (beispielsweise weil Konfigurationsdateien über verschiedene Home-Verzeichnisse verteilt sind, die einen vollkommen anderen Aufbau haben), können Sie als letzte Möglichkeit für das Paket eine sichere Voreinstellung wählen (beispielsweise den Service deaktivieren) und die von den Richtlinien verlangte ausführliche Information (<filename>README.Debian</filename> und <filename>NEWS.Debian</filename>) bereitstellen. Belästigen Sie den Benutzer nicht mit <command>debconf</command>-Hinweisen, die von den Betreuerskripten bei Upgrades angezeigt werden.

note: type: Content of: <book><chapter><section><para>
en: The <systemitem role="package">ucf</systemitem> package provides a <emphasis>conffile-like</emphasis> handling infrastructure to preserve user changes for files that may not be labeled as <emphasis>conffiles</emphasis> such as those managed by the maintainer scripts.  This should minimize issues associated with them.
de: Das Paket <systemitem role="package">ucf</systemitem> stellt eine ähnliche Infrastruktur wie für Dateien zur Verfügung, die als <emphasis>Conffile</emphasis> gekennzeichnet wurden. Damit bleiben von Benutzern durchgeführte Änderungen an Dateien erhalten, auch wenn diese Dateien nicht als <emphasis>Conffiles</emphasis> gekennzeichnet werden können. Beispiele hierfür sind Dateien, die von den Betreuerskripten verwaltet werden. Hierdurch sollen Probleme in der Behandlung dieser Dateien minimiert werden.

note: type: Content of: <book><chapter><section><para>
en: These maintainer scripts are among the Debian enhancements that explain <emphasis role="strong">why people choose Debian</emphasis>.  You must be very careful not to turn them into a source of annoyance.
de: Diese Betreuerskripte gehören zu den Errungenschaften von Debian, die erklären, <emphasis role="strong">warum jemand Debian verwendet</emphasis>. Sie müssen sehr darauf achten, diese Skripte nicht zu einem Grund für Ärger werden zu lassen.

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.symbols</filename>
de: <filename><replaceable>Paket</replaceable>.symbols</filename>

note: type: Content of: <book><chapter><section><para>
en: Packaging of a library is not easy for a novice maintainer and should be avoided.  Having said it, if your package has libraries, you should have <filename>debian/<replaceable>package</replaceable>.symbols</filename> files. See <xref linkend="librarysymbols"/>.
de: Die Paketierung einer Bibliothek ist für einen neuen Betreuer nicht leicht und sollte vermieden werden. Hat Ihr Paket allerdings Bibliotheken, dann sollten Sie eine Datei <filename>debian/<replaceable>Paket</replaceable>.symbols</filename> haben. Lesen Sie <xref linkend="librarysymbols"/>.

note: type: Content of: <book><chapter><section><para>
en: The <citerefentry> <refentrytitle>dh_installdocs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command installs this.
de: Der Befehl <citerefentry> <refentrytitle>dh_installdocs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> installiert diese Datei.

note: type: Content of: <book><chapter><section><para>
en: The <filename>watch</filename> file format is documented in the <citerefentry> <refentrytitle>uscan</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> manpage.  The <filename>watch</filename> file configures the <command>uscan</command> program (in the <systemitem role="package">devscripts</systemitem> package) to watch the site where you originally got the source.  This is also used by the <ulink url="&debtrack;">Debian Package Tracker</ulink> service.
de: Das Format der Datei <filename>watch</filename> ist in der Handbuchseite von <citerefentry> <refentrytitle>uscan</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> dokumentiert. Die Datei <filename>watch</filename> konfiguriert das Programm <command>uscan</command> (aus dem Paket <systemitem role="package">devscripts</systemitem>), um die Site zu überwachen, von der Sie die Originalquellen bezogen haben. Dies wird außerdem von dem Dienst <ulink url="&debtrack;">Debian Package Tracker</ulink> benutzt.

note: type: Content of: <book><chapter><section><para>
en: Here are its contents:
de: Hier sind seine Inhalte:

note: type: Content of: <book><chapter><section><para>
en: Normally with a <filename>watch</filename> file, the URL at <literal>&sf-net;/gentoo</literal> is downloaded and searched for links of the form <literal>&lt;a href=...&gt;</literal>.  The basename (just the part after the final <literal>/</literal>) of each linked URL is compared against the Perl regular expression pattern (see <citerefentry> <refentrytitle>perlre</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>)  <literal>gentoo-(.+)\.tar\.gz</literal>.  Out of the files that match, the one with the greatest version number is downloaded and the <command>uupdate</command> program is run to create an updated source tree.
de: Normalerweise würde mit einer <filename>watch</filename>-Datei die URL unter »<literal>&sf-net;/gentoo</literal>« heruntergeladen und nach Links im Format »<literal>&lt;a href=...&gt;</literal>« durchsucht. Der Basisname (nur der Teil nach dem letzten »<literal>/</literal>«) jeder verlinkten URL wird mit dem regulären Perl-Ausdruck (siehe <citerefentry> <refentrytitle>perlre</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>) »<literal>gentoo-(.+)\.tar\.gz</literal>« verglichen. Von allen Dateien, auf die der Ausdruck passt, wird die Datei mit der höchsten Versionsnummer heruntergeladen. Das Programm <command>uupdate</command> wird dann ausgeführt, um daraus den aktualisierten Quelltextbaum zu erzeugen.

note: type: Content of: <book><chapter><section><para>
en: Although this is true for other sites, the SourceForge download service at <ulink url="&sf-net;"/> is an exception.  When the <filename>watch</filename> file has a URL matching the Perl regexp <literal>^http://sf\.net/</literal>, the <command>uscan</command> program replaces it with <literal>&qa-do;watch/sf.php/</literal> and then applies this rule.  The URL redirector service at <ulink url="&qa-do;"/> is designed to offer a stable redirect service to the desired file for any <filename>watch</filename> pattern of the form <literal>&sf-net;/<replaceable>project</replaceable>/<replaceable>tar-name</replaceable>-(.+)\.tar\.gz</literal>.  This solves issues related to periodically changing SourceForge URLs.
de: Dies stimmt zwar für andere Websites, doch das Herunterladen von SourceForge unter <ulink url="&sf-net;"/> ist eine Ausnahme. Wenn die Datei <filename>watch</filename> eine URL enthält, auf die der reguläre Perl-Ausdruck »<literal>^http://sf\.net/</literal>« passt, wird diese vom Programm <command>uscan</command> durch »<literal>&qa-do;watch/sf.php/</literal>« ersetzt und erst dann die nachfolgenden Regeln angewendet. Die URL-Umleitungsfunktion unter <ulink url="&qa-do;"/> ist entwickelt worden, um einen stabilen Umleitungsservice für jedes <filename>watch</filename>-Muster der Form »<literal>&sf-net;/<replaceable>Projekt</replaceable>/<replaceable>tar-Name</replaceable>-(.+)\.tar\.gz</literal>« in der Datei <filename>watch</filename> bereitzustellen. Hierdurch wird das Problem gelöst, dass SourceForge-URLs regelmäßig geändert werden.

note: type: Content of: <book><chapter><section><para>
en: If the upstream offers the cryptographic signature of the tarball, it is recommended to verify its authenticity using the <literal>pgpsigurlmangle</literal> option as described in <citerefentry> <refentrytitle>uscan</refentrytitle><manvolnum>1</manvolnum> </citerefentry>.
de: Falls die Originalautoren eine kryptographische Signatur des Tarballs bereitstellen, wird empfohlen, seine Authentizität mittels der Option <literal>pgpsigurlmangle</literal> zu prüfen, wie dies in <citerefentry> <refentrytitle>uscan</refentrytitle><manvolnum>1</manvolnum> </citerefentry> beschrieben ist.

note: type: Content of: <book><chapter><section><para>
en: In the <filename>debian/source/format</filename> file, there should be a single line indicating the desired format for the source package (check <citerefentry> <refentrytitle>dpkg-source</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> for an exhaustive list).  After <literal>squeeze</literal>, it should say either:
de: In der Datei <filename>debian/source/format</filename> soll eine einzelne Zeile stehen, in der das gewünschte Format für das Quellpaket angegeben wird (lesen Sie <citerefentry> <refentrytitle>dpkg-source</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> für eine ausführliche Liste). Nach <literal>Squeeze</literal> sollte dort entweder:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>3.0 (native)</literal> for native Debian packages or
de: <literal>3.0 (native)</literal> für native Debian-Pakete oder

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>3.0 (quilt)</literal> for everything else.
de: <literal>3.0 (quilt)</literal> für alles andere stehen.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&debsrc3;">DebSrc3.0</ulink> for a summary on the switch to the new <literal>3.0 (quilt)</literal> and <literal>3.0 (native)</literal> source formats.
de: Siehe <ulink url="&debsrc3;">DebSrc3.0</ulink> für eine Zusammenfassung zum Wechsel auf die neuen Quellformate <literal>3.0 (quilt)</literal> und <literal>3.0 (native)</literal>.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Actually, this new format also supports multiple upstream tarballs and more compression methods.  These are beyond the scope of this document.
de: Tatsächlich unterstützt dieses neue Format sogar mehrere ursprüngliche Tarbälle und mehr Kompressionsmethoden. Dies würde in diesem Dokument aber zu weit führen.

note: type: Content of: <book><chapter><section><para>
en: The newer <literal>3.0 (quilt)</literal> source format records modifications in a <command>quilt</command> patch series within <filename>debian/patches</filename>.  Those changes are then automatically applied during extraction of the source package.  <placeholder type="footnote" id="0"/> The Debian modifications are simply stored in a <filename>debian.tar.gz</filename> archive containing all files under the <filename>debian</filename> directory.  This new format supports inclusion of binary files such as PNG icons by the package maintainer without requiring tricks.  <placeholder type="footnote" id="1"/>
de: Das neuere Quellformat <literal>3.0 (quilt)</literal> zeichnet Änderungen in einer Patchserie im Verzeichnis <filename>debian/patches</filename> für <command>quilt</command> auf. Diese Änderungen werden dann während des Entpackens des Quellpakets automatisch angewendet. <placeholder type="footnote" id="0"/> Die Debian-spezifischen Änderungen werden einfach in einem Archiv namens <filename>debian.tar.gz</filename> gespeichert, das alle Dateien im Verzeichnis <filename>debian</filename> enthält. Mit diesem neuen Format können binäre Dateien wie PNG-Icons vom Paketbetreuer eingebunden werden, ohne Tricks anwenden zu müssen. <placeholder type="footnote" id="1"/>

note: type: Content of: <book><chapter><section><para>
en: When <command>dpkg-source</command> extracts a source package in <literal>3.0 (quilt)</literal> source format, it automatically applies all patches listed in <filename>debian/patches/series</filename>.  You can avoid applying patches at the end of the extraction with the <literal>--skip-patches</literal> option.
de: Wenn <command>dpkg-source</command> ein Quellpaket im Quellformat <literal>3.0 (quilt)</literal> entpackt, werden automatisch alle Patches angewendet, die in <filename>debian/patches/series</filename> aufgeführt sind. Sie können das Anwenden der Patches nach dem Entpacken verhindern, indem Sie die Option <literal>--skip-patches</literal> benutzen.

note: type: Content of: <book><chapter><section><para>
en: When you want to manage Debian packaging activities under a VCS, you typically create one branch (e.g., <literal>upstream</literal>) tracking the upstream source and another branch (e.g., typically <literal>master</literal> for Git)  tracking the Debian package.  For the latter, you usually want to have unpatched upstream source with your <filename>debian/*</filename> files for the Debian packaging to ease merging of the new upstream source.
de: Wenn Sie die Paketierungsarbeiten für Debian in einem Versionskontrollsystem verwalten wollen, erstellen Sie üblicherweise einen Zweig (z. B. <literal>upstream</literal>), in dem Sie die Quellen des Originalautors verfolgen und einen weiteren Zweig (z. B. üblicherweise <literal>master</literal> für Git), in dem Sie das Debian-Paket verfolgen. Für letzteres wollen Sie sicherlich die unveränderten Ursprungsquellen zusammen mit Ihren <filename>debian/*</filename>-Dateien für das Paketieren haben, um das Zusammenführen von neuen Ursprungsquellen zu vereinfachen.

note: type: Content of: <book><chapter><section><para>
en: After you build a package, the source is normally left patched.  You need to unpatch it manually by running <literal>dquilt pop -a</literal> before committing to the <literal>master</literal> branch.  You can automate this by adding the optional <filename>debian/source/local-options</filename> file containing <literal>unapply-patches</literal>.  This file is not included in the generated source package and changes the local build behavior only.  This file may contain <literal>abort-on-upstream-changes</literal>, too (see <citerefentry> <refentrytitle>dpkg-source</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>).
de: Nachdem Sie ein Paket gebaut haben, bleiben die Patches im Quelltext normalerweise erhalten. Sie müssen sie manuell entfernen, indem Sie »<literal>dquilt pop -a</literal>« aufrufen, bevor Sie in den <literal>master</literal>-Zweig einchecken können. Sie können dies automatisieren, indem Sie die optionale Datei <filename>debian/source/local-options</filename> hinzufügen und dort »<literal>unapply-patches</literal>« hineinschreiben. Diese Datei wird nicht in das erzeugte Quellpaket aufgenommen und verändert nur das lokale Bauverhalten. Diese Datei kann auch »<literal>abort-on-upstream-changes</literal>« enthalten (siehe <citerefentry> <refentrytitle>dpkg-source</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>).

note: type: Content of: <book><chapter><section><title>
en: <filename>source/options</filename>
de: <filename>source/local-options</filename>

note: type: Content of: <book><chapter><section><para>
en: The autogenerated files in the source tree can be quite annoying for packaging since they generate meaningless large patch files.  There are custom modules such as <command>dh_autoreconf</command> to ease this problem as described in <xref linkend="customrules"/>.
de: Die automatisch erstellten Dateien im Quellbaum können für das Paketieren recht störend wirken, da sie unbedeutende große Patch-Dateien hervorrufen. Es gibt angepasste Module wie <command>dh_autoreconf</command>, um dieses Problem zu vereinfachen. Dies wird in <xref linkend="customrules"/> beschrieben.

note: type: Content of: <book><chapter><section><para>
en: You can provide a Perl regular expression to the <literal>--extend-diff-ignore</literal> option argument of <citerefentry> <refentrytitle>dpkg-source</refentrytitle><manvolnum>1</manvolnum> </citerefentry> to ignore changes made to the autogenerated files while creating the source package.
de: Sie können dem Optionsargument <literal>--extend-diff-ignore</literal> von <citerefentry> <refentrytitle>dpkg-source</refentrytitle><manvolnum>1</manvolnum> </citerefentry> einen regulären Perl-Ausdruck übergeben, um Änderungen, die an den automatisch erstellten Dateien beim Erstellen des Quellpakets vorgenommen wurden, zu ignorieren.

note: type: Content of: <book><chapter><section><para>
en: As a general solution to address this problem of the autogenerated files, you can store such a <command>dpkg-source</command> option argument in the <filename>source/options</filename> file of the source package.  The following will skip creating patch files for <filename>config.sub</filename>, <filename>config.guess</filename>, and <filename>Makefile</filename>.
de: Als allgemeine Lösung, um dieses Problem der automatisch erstellten Dateien zu adressieren, können Sie so ein Optionsargument an <command>dpkg-source</command> in der Datei <filename>source/options</filename> des Quellpakets speichern. Folgendes wird die Erstellung von Patch-Dateien für <filename>config.sub</filename>, <filename>config.guess</filename> und <filename>Makefile</filename> überspringen:

note: type: Content of: <book><chapter><section><para>
en: The old <literal>1.0</literal> source format created a single large <filename>diff.gz</filename> file containing package maintenance files in <filename>debian</filename> and patch files for the source.  Such a package is a bit cumbersome to inspect and understand for each source tree modification later.  This is not so nice.
de: Das alte Quellformat <literal>1.0</literal> erzeugte eine einzelne große <filename>diff.gz</filename>-Datei, in der sowohl die Paketbetreuungsdateien unter <filename>debian</filename> als auch Patches für den Quelltext enthalten waren. So ein Paket ist etwas schwierig zu untersuchen und zu verstehen, wenn später der Quelltext geändert werden soll. Das ist nicht so schön.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Several methods of patch set maintenance have been proposed and are in use for Debian packages.  The <command>quilt</command> system is the preferred maintenance system in use.  Others include <command>dpatch</command>, <command>dbs</command>, and <command>cdbs</command>.  Many of these keep such patches as <filename>debian/patches/*</filename> files.
de: Es wurden verschiedene Methoden für die Organisation der Patches in Debian-Paketen vorgeschlagen und auch angewendet. Das <command>quilt</command>-System ist das bevorzugteste Organisationssystem. Weitere Systeme sind u.A. <command>dpatch</command>, <command>dbs</command> und <command>cdbs</command>. Viele von diesen Systemen speichern solche Patches in <filename>debian/patches/*</filename>-Dateien ab.

note: type: Content of: <book><chapter><section><para>
en: The newer <literal>3.0 (quilt)</literal> source format stores patches in <filename>debian/patches/*</filename> files using the <command>quilt</command> command.  These patches and other package data which are all contained under the <filename>debian</filename> directory are packaged as the <filename>debian.tar.gz</filename> file.  Since the <command>dpkg-source</command> command can handle <command>quilt</command> formatted patch data in the <literal>3.0 (quilt)</literal> source without the <systemitem role="package">quilt</systemitem> package, it does not need a <literal>Build-Depends</literal> on <systemitem role="package">quilt</systemitem>.  <placeholder type="footnote" id="0"/>
de: Das neuere Quellformat <literal>3.0 (quilt)</literal> speichert Patches in <filename>debian/patches/*</filename>-Dateien unter Verwendung des Befehls <command>quilt</command> ab. Diese Patches sowie andere Paketdaten bleiben alle innerhalb des Verzeichnisses <filename>debian</filename> und werden als <filename>debian.tar.gz</filename>-Datei gepackt. Da der Befehl <command>dpkg-source</command> in <literal>3.0 (quilt)</literal>-Quellen die Patch-Daten im <command>quilt</command>-Format verarbeiten kann, ohne auf das Paket <systemitem role="package">quilt</systemitem> zurückzugreifen, wird keine <literal>Build-Depends</literal> für <systemitem role="package">quilt</systemitem> benötigt. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: If you are asking a sponsor to upload your package, this kind of clear separation and documentation of your changes is very important to expedite the package review by your sponsor.
de: Falls Sie einen Sponsor darum bitten, Ihr Paket hochzuladen, ist diese Art der klaren Aufteilung und Dokumentation Ihrer Änderungen sehr wichtig, um die Durchsicht Ihres Pakets durch den Sponsor zu beschleunigen.

note: type: Content of: <book><chapter><section><para>
en: The <command>quilt</command> command is explained in <citerefentry> <refentrytitle>quilt</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.  It records modifications to the source as a stack of <literal>-p1</literal> patch files in the <filename>debian/patches</filename> directory and the source tree is untouched outside of the <filename>debian</filename> directory.  The order of these patches is recorded in the <filename>debian/patches/series</filename> file.  You can apply (=push), un-apply (=pop), and refresh patches easily.  <placeholder type="footnote" id="0"/>
de: Der Befehl <command>quilt</command> wird in der Handbuchseite von <citerefentry> <refentrytitle>quilt</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> erklärt. Er zeichnet Änderungen an den Quellen als Stapel von <literal>-p1</literal>-Patch-Dateien im Verzeichnis <filename>debian/patches</filename> auf, dadurch bleibt der Quelltextbaum außerhalb des <filename>debian</filename>-Verzeichnisses unangetastet. Die Reihenfolge der Patches wird in der Datei <filename>debian/patches/series</filename> gespeichert. Sie können die Patches leicht anwenden (=push), entfernen (=pop) und aktualisieren. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: For <xref linkend="modify"/>, we created three patches in <filename>debian/patches</filename>.
de: Für den Abschnitt <xref linkend="modify"/> haben wir drei Patches in <filename>debian/patches</filename> erstellt.

note: type: Content of: <book><chapter><section><para>
en: Since Debian patches are located in <filename>debian/patches</filename>, please make sure to set up the <command>dquilt</command> command properly as described in <xref linkend="quiltrc"/>.
de: Da die Debian-Patches in <filename>debian/patches</filename> enthalten sind, stellen Sie bitte sicher, dass der Befehl <command>dquilt</command> korrekt eingerichtet ist, so wie in <xref linkend="quiltrc"/> beschrieben.

note: type: Content of: <book><chapter><section><para>
en: When anyone (including yourself) provides a patch <filename><replaceable>foo</replaceable>.patch</filename> to the source later, modifying a <literal>3.0 (quilt)</literal> source package is quite simple:
de: Wenn später jemand (Sie selbst eingeschlossen) einen Patch namens <filename><replaceable>foo</replaceable>.patch</filename> für die Quellen erstellt, ist die Veränderung eines <literal>3.0 (quilt)</literal>-Quellpakets recht einfach:

note: type: Content of: <book><chapter><section><screen>
en: $ dpkg-source -x gentoo_0.9.12.dsc
    $ cd gentoo-0.9.12
    $ dquilt import ../<replaceable>foo</replaceable>.patch
    $ dquilt push
    $ dquilt refresh
    $ dquilt header -e
    ... describe patch
de: $ dpkg-source -x gentoo_0.9.12.dsc
    $ cd gentoo-0.9.12
    $ dquilt import ../<replaceable>foo</replaceable>.patch
    $ dquilt push
    $ dquilt refresh
    $ dquilt header -e
    ... Patch beschreiben

note: type: Content of: <book><chapter><section><para>
en: The patches stored in the newer <literal>3.0 (quilt)</literal> source format must be <emphasis>fuzz</emphasis> free.  You can ensure this with <literal>dquilt pop -a; while dquilt push; do dquilt refresh; done</literal>.
de: Die Patches, die in dem neuen Quellformat <literal>3.0 (quilt)</literal> gespeichert werden, müssen frei von Ungenauigkeiten (<emphasis>fuzz</emphasis>) sein. Sie können dies mit »<literal>dquilt pop -a; while dquilt push; do dquilt refresh; done</literal>« sicherstellen.

note: type: Content of: <book><chapter><title>
en: Building the package
de: Bau des Pakets

note: type: Content of: <book><chapter><para>
en: We should now be ready to build the package.
de: Nun sollten wir soweit sein, das Paket zu bauen.

note: type: Content of: <book><chapter><section><title>
en: Complete (re)build
de: Kompletter (Neu-)Bau

note: type: Content of: <book><chapter><section><para>
en: In order to perform a complete (re)build of a package properly, you need to make sure you have installed
de: Um ein Paket ordnungsgemäß komplett (neu) zu bauen, müssen Sie Folgendes installiert haben:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: the <systemitem role="package">build-essential</systemitem> package,
de: Das Paket <systemitem role="package">build-essential</systemitem>,

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: packages listed in the <literal>Build-Depends</literal> field (see <xref linkend="control"/>), and
de: die im Feld <literal>Build-Depends</literal> aufgelisteten Pakete (siehe <xref linkend="control"/>) und

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: packages listed in the <literal>Build-Depends-indep</literal> field (see <xref linkend="control"/>).
de: die im Feld <literal>Build-Depends-Indep</literal> aufgelisteten Pakete (siehe <xref linkend="control"/>).

note: type: Content of: <book><chapter><section><para>
en: Then you issue the following command in the source directory:
de: Dann führen Sie den folgenden Befehl im Quellverzeichnis des Programms aus:

note: type: Content of: <book><chapter><section><para>
en: This will do everything to make full binary and source packages for you.  It will:
de: Hiermit wird alles für Sie erledigt, um vollständige Binärpakete und Quellpakete zu erstellen. Im Einzelnen:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: clean the source tree (<literal>debian/rules clean</literal>)
de: Aufräumen des Quellverzeichnisbaums (»<literal>debian/rules clean</literal>«),

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: build the source package (<literal>dpkg-source -b</literal>)
de: Bauen des Quellpakets (»<literal>dpkg-source -b</literal>«),

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: build the program (<literal>debian/rules build</literal>)
de: Bauen des Programms (»<literal>debian/rules build</literal>«),

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: build binary packages (<literal>fakeroot debian/rules binary</literal>)
de: Bauen der Binärpakete (»<literal>fakeroot debian/rules binary</literal>«),

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: make the <filename>.dsc</filename> file
de: Erstellen der Datei <filename>.dsc</filename>,

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: make the <filename>.changes</filename> file, using <command>dpkg-genchanges</command>
de: Erstellen der Datei <filename>.changes</filename>, mittels <command>dpkg-genchanges</command>.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: This GPG key must be signed by a Debian developer to get connected to the web of trust and must be registered to <ulink url="&keyring;">the Debian keyring</ulink>.  This enables your uploaded packages to be accepted to the Debian archives.  See <ulink url="&keycreate;">Creating a new GPG key</ulink> and <ulink url="&keysigning; ">Debian Wiki on Keysigning</ulink>.
de: Dieser GPG-Schlüssel muss von einem Debian-Entwickler signiert worden sein, um mit dem Vertrauensnetz verbunden zu sein, und muss <ulink url="&keyring;">im Debian-Schlüsselring</ulink> registriert sein. Dies ermöglicht es, dass Ihre hochgeladenen Pakete im Debian-Archiv akzeptiert werden. Lesen Sie <ulink url="&keycreate;">Creating a new GPG key</ulink> und <ulink url="&keysigning; ">Debian Wiki on Keysigning</ulink>.

note: type: Content of: <book><chapter><section><para>
en: If the build result is satisfactory, sign the <filename>.dsc</filename> and <filename>.changes</filename> files with your private GPG key using the <command>debsign</command> command.  You need to enter your secret pass phrase, twice.  <placeholder type="footnote" id="0"/>
de: Falls das Ergebnis des Baus den Erwartungen entspricht, signieren Sie die Dateien <filename>.dsc</filename> und <filename>.changes</filename> mit Ihrem privaten GPG-Schlüssel mit dem Befehl <command>debsign</command>. Sie müssen Ihre geheime Passphrase zweimal eingeben. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: For a non-native Debian package, e.g., <systemitem role="package">gentoo</systemitem>, you will see the following files in the parent directory (<filename>~/gentoo</filename>) after building packages:
de: Für nicht native Debian-Pakete, z.B. <systemitem role="package">gentoo</systemitem>, werden Sie die folgenden Dateien im übergeordneten Verzeichnis (<filename>~/gentoo</filename>) nach dem Paketbau sehen:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: This is the original upstream source code tarball, merely renamed to the above so that it adheres to the Debian standard.  Note that this was created initially by the command <literal>dh_make -f ../gentoo-0.9.12.tar.gz</literal>.
de: Dies ist der ursprüngliche Quelltext-Tarball der Originalautoren, lediglich umbenannt, um dem Debian-Standard zu genügen. Beachten Sie, dass diese Umbenennung beim initialen Aufruf von »<literal>dh_make -f ../gentoo-0.9.12.tar.gz</literal>« erfolgt ist.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: This is a summary of the contents of the source code.  The file is generated from your <filename>control</filename> file, and is used when unpacking the source with <citerefentry> <refentrytitle>dpkg-source</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.
de: Dies ist eine Zusammenfassung des Inhalts des Quellcode-Pakets. Diese Datei wird aus Ihrer Datei <filename>control</filename> erzeugt und für das Entpacken des Quellcodes mittels <citerefentry> <refentrytitle>dpkg-source</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> benötigt.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: This compressed tarball contains your <filename>debian</filename> directory contents.  Each and every addition you made to the original source code is stored as a <command>quilt</command> patch in <filename>debian/patches</filename>.
de: Dieser komprimierte Tarball enthält die Dateien aus Ihrem <filename>debian</filename>-Verzeichnis. Jede einzelne Änderung, die Sie am ursprünglichen Code vorgenommen haben, wird als <command>quilt</command>-Patch in <filename>debian/patches</filename> gespeichert.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para><footnote><para>
en: You can avoid applying <command>quilt</command> patches in the <literal>3.0 (quilt)</literal> source format at the end of the extraction with the <literal>--skip-patches</literal> option.  Alternatively, you can run <literal>dquilt pop -a</literal> after normal operation.
de: Sie können das Anwenden der <command>quilt</command>-Patches im <literal>3.0 (quilt)</literal>-Quellformat am Ende des Auspackens verhindern, indem Sie die Option <literal>--skip-patches</literal> benutzen. Alternativ können Sie »<literal>dquilt pop -a</literal>« nach dem normalen Auspacken aufrufen.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If someone else wants to re-create your package from scratch, they can easily do so using the above three files.  The extraction procedure is trivial: just copy the three files somewhere else and run <literal>dpkg-source -x gentoo_0.9.12-1.dsc</literal>.  <placeholder type="footnote" id="0"/>
de: Wenn jemand Ihr Paket von Grund auf neu bauen will, kann er dafür einfach die drei oben genannten Dateien verwenden. Das Verfahren des Auspackens ist trivial: Kopieren Sie einfach die drei Dateien in ein Verzeichnis und führen Sie »<literal>dpkg-source -x gentoo_0.9.12-1.dsc</literal>« aus. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: This is your completed binary package.  You can use <command>dpkg</command> to install and remove this just like any other package.
de: Das ist Ihr fertiges Binärpaket. Sie können es mit <command>dpkg</command> installieren und wieder entfernen wie jedes andere Paket auch.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: This file describes all the changes made in the current package revision; it is used by the Debian FTP archive maintenance programs to install the binary and source packages.  It is partly generated from the <filename>changelog</filename> file and the <filename>.dsc</filename> file.
de: Diese Datei beschreibt alle Änderungen in dieser Paket-Revision. Die Verwaltungsprogramme für Debians FTP-Archive benötigen diese Datei zur Installation der Binär- und Quellcodepakete im FTP-Archiv. Sie wird zum Teil aus den Dateien <filename>changelog</filename> und <filename>.dsc</filename> erzeugt.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: As you keep working on the package, its behavior will change and new features will be added.  People downloading your package can look at this file and quickly see what has changed.  Debian archive maintenance programs will also post the contents of this file to the <ulink url="&debian-devel-changes-ldo;">debian-devel-changes@lists.debian.org</ulink> mailing list.
de: Wenn Sie weiter an dem Paket arbeiten, wird sich sein Verhalten ändern und neue Funktionen werden hinzugefügt. Leute, die Ihr Paket herunterladen, können sich diese Datei ansehen und feststellen, was sich geändert hat. Die Verwaltungsprogramme für das Debian-Archiv werden den Inhalt dieser Datei auch an die Mailingliste <ulink url="&debian-devel-changes-ldo;">debian-devel-changes@lists.debian.org</ulink> schicken.

note: type: Content of: <book><chapter><section><para>
en: The <filename>gentoo_0.9.12-1.dsc</filename> and <filename>gentoo_0.9.12-1_i386.changes</filename> files must be signed using the <command>debsign</command> command with your private GPG key in the <filename>~/.gnupg/</filename> directory, before uploading them to the Debian FTP archive. The GPG signature provides the proof that these files are really yours, using your public GPG key.
de: Die Dateien <filename>gentoo_0.9.12-1.dsc</filename> und <filename>gentoo_0.9.12-1_i386.changes</filename> müssen unter Verwendung des Befehls <command>debsign</command> mit Ihrem privaten GPG-Schlüssel, der sich im Verzeichnis <filename>~/.gnupg/</filename> befindet, signiert werden, bevor sie zum Debian-FTP-Archiv hochgeladen werden. Die GPG-Signatur stellt unter Verwendung Ihres öffentlichen GPG-Schlüssels den Nachweis bereit, dass diese Dateien tatsächlich von Ihnen sind.

note: type: Content of: <book><chapter><section><para>
en: The <command>debsign</command> command can be made to sign with your specified secret GPG key ID (good for sponsoring packages) with the following in the <filename>~/.devscripts</filename> file:
de: Mit dem folgenden Eintrag in die Datei <filename>~/.devscripts</filename> kann der Befehl <command>debsign</command> dazu veranlasst werden, mit Ihrer angegebenen geheimen Schlüsselkennung zu signieren (was gut fürs Sponsern ist):

note: type: Content of: <book><chapter><section><screen>
en: DEBSIGN_KEYID=Your_GPG_keyID
de: DEBSIGN_KEYID=Ihre_GPG-Schlüsselkennung

note: type: Content of: <book><chapter><section><para>
en: The long strings of numbers in the <filename>.dsc</filename> and <filename>.changes</filename> files are SHA1/SHA256 checksums for the files mentioned.  Anyone downloading your files can test them with <citerefentry> <refentrytitle>sha1sum</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> or <citerefentry> <refentrytitle>sha256sum</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> and if the numbers don't match, they'll know the file is corrupt or has been tampered with.
de: Die langen Zahlenreihen in den Dateien <filename>.dsc</filename> und <filename>.changes</filename> sind SHA1/SHA256-Prüfsummen der aufgelisteten Dateien. Jeder, der Ihr Paket herunterlädt, kann die enthaltenen Dateien mit <citerefentry> <refentrytitle>sha1sum</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> oder <citerefentry> <refentrytitle>sha256sum</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> testen. Wenn die Zahlen nicht übereinstimmen, weiß er, die geprüfte Datei ist beschädigt oder manipuliert.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: The actual autobuilder system involves much more complicated schemes than the one documented here.  Such details are beyond the scope of this document.
de: Das tatsächliche Autobuilder-System besteht aus einem wesentlich komplizierteren Schema als dem hier dargestellten. Diese Details führen aber hier zu weit.

note: type: Content of: <book><chapter><section><para>
en: Debian supports many <ulink url="&ports;">ports</ulink> with the <ulink url="&buildd;">autobuilder network</ulink> running <command>buildd</command> daemons on computers of many different architectures.  Although you do not need to do this yourself, you should be aware of what will happen to your packages.  Let's look into roughly how they rebuild your packages for multiple architectures.  <placeholder type="footnote" id="0"/>
de: Debian unterstützt viele <ulink url="&ports;">Portierungen</ulink> mit dem <ulink url="&buildd;">Autobuilder-Netz</ulink>, das <command>buildd</command>-Daemons auf vielen verschiedenen Rechnerarchitekturen ausführt. Obwohl Sie dies nicht selbst durchführen müssen, sollte Ihnen bewusst sein, was mit Ihren Paketen passiert. Lassen Sie uns einen kurzen Blick darauf werfen, wie Ihre Pakete vom Autobuilder-Netz für verschiedene Architekturen neu gebaut werden. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: For <literal>Architecture: any</literal> packages, the autobuilder system performs a rebuild.  It ensures the installation of
de: Für Pakete mit »<literal>Architecture: any</literal>« führt das Autobuilder-System eine Neuübersetzung durch. Es stellt folgende Installationen sicher:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: the <systemitem role="package">build-essential</systemitem> package, and
de: des Pakets <systemitem role="package">build-essential</systemitem> und

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: packages listed in the <literal>Build-Depends</literal> field (see <xref linkend="control"/>).
de: der Pakete, die im Feld <literal>Build-Depends</literal> (siehe <xref linkend="control"/>) aufgeführt sind.

note: type: Content of: <book><chapter><section><para>
en: Then it issues the following command in the source directory:
de: Dann führt es den folgenden Befehl im Quellverzeichnis aus:

note: type: Content of: <book><chapter><section><para>
en: This will do everything to make architecture dependent binary packages on another architecture.  It will:
de: Hiermit wird alles erledigt, um ein architekturabhängiges Binärpaket für eine andere Architektur zu erstellen. Im Einzelnen:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: build architecture dependent binary packages (<literal>fakeroot debian/rules binary-arch</literal>)
de: Bauen der architekturabhängigen Binärpakete (»<literal>fakeroot debian/rules binary-arch</literal>«),

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: sign the source <filename>.dsc</filename> file, using <command>gpg</command>
de: Signieren der <filename>.dsc</filename>-Quelldatei mit <command>gpg</command>,

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: create and sign the upload <filename>.changes</filename> file, using <command>dpkg-genchanges</command> and <command>gpg</command>
de: Erstellen und Signieren der für das Hochladen notwendigen <filename>.changes</filename>-Datei mit <command>dpkg-genchanges</command> und <command>gpg</command>.

note: type: Content of: <book><chapter><section><para>
en: This is why you see your package for other architectures.
de: Das ist der Grund, weshalb Sie Ihr Paket auch für andere Architekturen sehen.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Unlike under the <systemitem role="package">pbuilder</systemitem> package, the <command>chroot</command> environment under the <systemitem role="package">sbuild</systemitem> package used by the autobuilder system does not enforce the use of a minimal system and may have many leftover packages installed.
de: Im Gegensatz zum <systemitem role="package">pbuilder</systemitem>-Paket erzwingt die <command>chroot</command>-Umgebung im Paket <systemitem role="package">sbuild</systemitem>, die vom Autobuilder-System verwendet wird, keine Verwendung einer Minimalumgebung. Daher können übriggebliebene Pakete installiert sein.

note: type: Content of: <book><chapter><section><para>
en: Although packages listed in the <literal>Build-Depends-Indep</literal> field are required to be installed for our normal packaging work (see <xref linkend="completebuild"/>), they are not required to be installed for the autobuilder system since it builds only architecture dependent binary packages.  <placeholder type="footnote" id="0"/> This distinction between normal packaging and autobuilding procedures is what dictates whether you should record such required packages in the <literal>Build-Depends</literal> or <literal>Build-Depends-Indep</literal> fields of the <filename>debian/control</filename> file (see <xref linkend="control"/>).
de: Obwohl Pakete, die im Feld <literal>Build-Depends-Indep</literal> aufgeführt sind, installiert sein müssen, wenn wir das Paket bauen (siehe <xref linkend="completebuild"/>), müssen diese auf dem Autobuilder-System nicht installiert sein, weil es nur architekturabhängige Binärpakete baut. <placeholder type="footnote" id="0"/> Diese Unterscheidung zwischen dem normalen Bau und der Situation bei dem Autobuilder-Ablauf entscheidet darüber, ob Sie solche erforderlichen Pakete im Feld <literal>Build-Depends</literal> oder <literal>Build-Depends-Indep</literal> der Datei <filename>debian/control</filename> auflisten (siehe <xref linkend="control"/>).

note: type: Content of: <book><chapter><section><title>
en: <command>debuild</command> command
de: Der Befehl <command>debuild</command>

note: type: Content of: <book><chapter><section><para>
en: You can automate the build activity around executing the <command>dpkg-buildpackage</command> command package further with the <command>debuild</command> command.  See <citerefentry> <refentrytitle>debuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.
de: Sie können den Prozess des Paketbauens rund um die Ausführung des Befehls <command>dpkg-buildpackage</command> weiter mit dem Befehl <command>debuild</command> automatisieren. Siehe <citerefentry> <refentrytitle>debuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><para>
en: The <command>debuild</command> command executes the <command>lintian</command> command to make a static check after building the Debian package.  The <command>lintian</command> command can be customized with the following in the <filename>~/.devscripts</filename> file:
de: Der Befehl <command>debuild</command> führt den Befehl <command>lintian</command> aus, um nach dem Bau des Debian-Pakets eine statische Prüfungen durchzuführen. Der Befehl <command>lintian</command> kann mit dem folgenden Eintrag in der Datei <filename>~/.devscripts</filename> angepasst werden:

note: type: Content of: <book><chapter><section><para>
en: Cleaning the source and rebuilding the package from your user account is as simple as:
de: Jetzt kann das Säubern des Quellverzeichnisses und Neubauen des Pakets unter Ihrem Benutzerkonto einfach so durchgeführt werden:

note: type: Content of: <book><chapter><section><para>
en: You can clean the source tree as simply as:
de: Sie können das Quellverzeichnis einfach so säubern:

note: type: Content of: <book><chapter><section><title>
en: <systemitem role="package">pbuilder</systemitem> package
de: Das Paket <systemitem role="package">pbuilder</systemitem>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Since the <systemitem role="package">pbuilder</systemitem> package is still evolving, you should check the actual configuration situation by consulting the latest official documentation.
de: Weil das Paket <systemitem role="package">pbuilder</systemitem> ständig weiterentwickelt wird, sollten Sie die tatsächliche Konfiguration herausfinden, indem Sie die aktuelle offizielle Dokumentation durchlesen.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&buildd-do;"/> for more on Debian package auto-building.
de: Lesen Sie <ulink url="&buildd-do;"/> für weitere Informationen über das automatische Bauen von Debian-Paketen.

note: type: Content of: <book><chapter><section><para>
en: For a clean room (<command>chroot</command>) build environment to verify the build dependencies, the <systemitem role="package">pbuilder</systemitem> package is very useful.  <placeholder type="footnote" id="0"/> This ensures a clean build from the source under the <literal>sid</literal> auto-builder for different architectures and avoids a severity serious FTBFS (Fails To Build From Source) bug which is always in the RC (release critical) category.  <placeholder type="footnote" id="1"/>
de: Um die Abhängigkeiten für den Bau in einer sauberen Umgebung (<command>chroot</command>) zu überprüfen, ist das Paket <systemitem role="package">pbuilder</systemitem> sehr gut geeignet. <placeholder type="footnote" id="0"/> Es stellt sicher, dass das Paket aus den Quellen auf einem <literal>Sid</literal>-Autobuilder für verschiedene Architekturen gebaut werden kann. Weiterhin wird hierdurch ein schwerwiegender FTBFS-Fehler (»Fails To Build From Source«, kann nicht aus den Quellen gebaut werden) verhindert, der immer als release-kritisch (RC) angesehen wird. <placeholder type="footnote" id="1"/>

note: type: Content of: <book><chapter><section><para>
en: Let's customize the <systemitem role="package">pbuilder</systemitem> package as follows:
de: Lassen Sie uns das Paket <systemitem role="package">pbuilder</systemitem> folgendermaßen anpassen:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: setting the <filename>/var/cache/pbuilder/result</filename> directory writable by your user account.
de: Machen Sie das Verzeichnis <filename>/var/cache/pbuilder/result</filename> für Ihr Benutzerkonto schreibbar.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: creating a directory, e.g.  <filename><replaceable>/var/cache/pbuilder/hooks</replaceable></filename>, writable by the user, to place hook scripts in.
de: Erstellen Sie ein Verzeichnis, z.B. <filename><replaceable>/var/cache/pbuilder/hooks</replaceable></filename>, das ebenfalls für den Benutzer schreibbar ist, so dass Hook-Skripts dort abgelegt werden können.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: configuring <filename>~/.pbuilderrc</filename> or <filename>/etc/pbuilderrc</filename> to include the following.
de: Konfigurieren Sie die Datei <filename>~/.pbuilderrc</filename> oder <filename>/etc/pbuilderrc</filename>, so dass sie folgendes enthält:

note: type: Content of: <book><chapter><section><para>
en: First let's initialize the local <systemitem role="package">pbuilder</systemitem> <command>chroot</command> system as follows:
de: Lassen Sie uns zuerst das lokale <systemitem role="package">pbuilder</systemitem>-<command>chroot</command>-System wie folgt initialisieren:

note: type: Content of: <book><chapter><section><para>
en: If you already have a completed source package, issue the following commands in the directory where the <filename><replaceable>foo</replaceable>.orig.tar.gz</filename>, <filename><replaceable>foo</replaceable>.debian.tar.gz</filename>, and <filename><replaceable>foo</replaceable>.dsc</filename> files exist to update the local <systemitem role="package">pbuilder</systemitem> <command>chroot</command> system and to build binary packages in it:
de: Falls Sie ein Quellpaket schon komplett fertiggestellt haben, führen Sie die folgenden Befehle in dem Verzeichnis aus, in dem die Dateien <filename><replaceable>foo</replaceable>.orig.tar.gz</filename>, <filename><replaceable>foo</replaceable>.debian.tar.gz</filename> und <filename><replaceable>foo</replaceable>.dsc</filename> liegen, um das lokale <systemitem role="package">pbuilder</systemitem>-<command>chroot</command>-System zu aktualisieren und Binärpakete darin zu bauen:

note: type: Content of: <book><chapter><section><screen>
en: $ sudo pbuilder --update
    $ sudo pbuilder --build <replaceable>foo_version</replaceable>.dsc
de: $ sudo pbuilder --update
    $ sudo pbuilder --build <replaceable>foo_Version</replaceable>.dsc

note: type: Content of: <book><chapter><section><para>
en: The newly built packages without the GPG signatures will be located in <filename>/var/cache/pbuilder/result/</filename> with non-root ownership.
de: Die neu erstellten Pakete ohne GPG-Signaturen werden unter <filename>/var/cache/pbuilder/result/</filename> mit einem nicht-root-Eigentümer abgelegt.

note: type: Content of: <book><chapter><section><para>
en: The GPG signatures on the <filename>.dsc</filename> file and the <filename>.changes</filename> file can be generated as:
de: Die GPG-Signaturen für die Dateien <filename>.dsc</filename> und <filename>.changes</filename> können wie folgt erstellt werden:

note: type: Content of: <book><chapter><section><screen>
en: $ cd /var/cache/pbuilder/result/
    $ debsign <replaceable>foo_version_arch</replaceable>.changes
de: $ cd /var/cache/pbuilder/result/
    $ debsign <replaceable>foo_Version_Arch</replaceable>.changes

note: type: Content of: <book><chapter><section><para>
en: If you have an updated source tree but have not generated the matching source package, issue the following commands in the source directory where the <filename>debian</filename> directory exists, instead:
de: Falls Sie bereits ein aktualisiertes Quellverzeichnis haben, jedoch das zugehörige Quellpaket nicht erstellt haben, führen Sie stattdessen die folgenden Befehle in dem Quellverzeichnis aus, in dem das Verzeichnis <filename>debian</filename> enthalten ist:

note: type: Content of: <book><chapter><section><para>
en: You can log into its <command>chroot</command> environment with the <literal>pbuilder --login --save-after-login</literal> command and configure it as you wish.  This environment can be saved by leaving its shell prompt with <literal>^D</literal> (Control-D).
de: Sie können sich in der erstellten <command>chroot</command>-Umgebung anmelden, indem Sie den Befehl »<literal>pbuilder --login --save-after-login</literal>« verwenden und diese dann so einrichten, wie Sie wollen. Diese Umgebung kann gespeichert werden, indem die Shell-Eingabeaufforderung mittels <literal>^D</literal> (Steuerung-D) verlassen wird.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: This assumes <literal>HOOKDIR=/var/cache/pbuilder/hooks</literal>.  You can find many examples of hook scripts in the <filename>/usr/share/doc/pbuilder/examples</filename> directory.
de: Dies setzt <literal>HOOKDIR=/var/cache/pbuilder/hooks</literal> voraus. Sie finden viele Beispiele für Hook-Skripte im Verzeichnis <filename>/usr/share/doc/pbuilder/examples</filename>.

note: type: Content of: <book><chapter><section><para>
en: The latest version of the <command>lintian</command> command can be executed in the <literal>chroot</literal> environment using the hook script <filename><replaceable>/var/cache/pbuilder/hooks</replaceable>/B90lintian</filename> configured as follows: <placeholder type="footnote" id="0"/>
de: Die aktuelle Version des Programms <command>lintian</command> kann in der <literal>chroot</literal>-Umgebung ausgeführt werden, indem das Hook-Skript <filename><replaceable>/var/cache/pbuilder/hooks</replaceable>/B90lintian</filename> wie folgt eingerichtet wird: <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><screen>
en: #!/bin/sh
    set -e
    install_packages() {
            apt-get -y --allow-downgrades install "$@"
            }
    install_packages lintian
    echo "+++ lintian output +++"
    su -c "lintian -i -I --show-overrides /tmp/buildd/*.changes" - pbuilder
    # use this version if you don't want lintian to fail the build
    #su -c "lintian -i -I --show-overrides /tmp/buildd/*.changes; :" - pbuilder
    echo "+++ end of lintian output +++"
de: #!/bin/sh
    set -e
    install_packages() {
            apt-get -y --allow-downgrades install "$@"
            }
    install_packages lintian
    echo "+++ Lintian-Ausgabe +++"
    su -c "lintian -i -I --show-overrides /tmp/buildd/*.changes" - pbuilder
    # Verwenden Sie diese Version, falls Lintian beim Bau nicht fehlschlagen soll
    #su -c "lintian -i -I --show-overrides /tmp/buildd/*.changes; :" - pbuilder
    echo "+++ Ende der Lintian-Ausgabe +++"

note: type: Content of: <book><chapter><section><para>
en: You need to have access to the latest <literal>sid</literal> environment to build packages properly for <literal>sid</literal>.  In practice, <literal>sid</literal> may be experiencing issues which makes it undesirable for you to migrate your whole system.  The <systemitem role="package">pbuilder</systemitem> package can help you to cope with this kind of situation.
de: Sie müssen Zugriff auf die neueste <literal>Sid</literal>-Umgebung haben, damit Sie Pakete korrekt für <literal>Sid</literal> bauen können. Allerdings kann es in <literal>Sid</literal> immer wieder mal Probleme geben, so dass Sie wahrscheinlich nicht Ihr gesamtes System umstellen wollen. Das Paket <systemitem role="package">pbuilder</systemitem> bietet einen Ausweg für diese Situation.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: There are some restrictions for such updates of your <literal>stable</literal> package.
de: Es gibt für Aktualisierungen Ihrer <literal>Stable</literal>-Pakete einige Einschränkungen.

note: type: Content of: <book><chapter><section><para>
en: You may need to update your <literal>stable</literal> packages after their release for <literal>stable-proposed-updates</literal>, <literal>stable/updates</literal>, etc.  <placeholder type="footnote" id="0"/> For such occasions, the fact that you may be running a <literal>sid</literal> system is not a good enough excuse for failing to update them promptly.  The <systemitem role="package">pbuilder</systemitem> package can help you to access environments of almost any Debian derivative distribution of the same architecture.
de: Es kann vorkommen, dass Sie Ihre Pakete für <literal>Stable</literal> aktualisieren müssen, nachdem sie veröffentlicht worden sind, beispielsweise über <literal>stable-proposed-updates</literal>, <literal>stable/updates</literal> usw. <placeholder type="footnote" id="0"/> In einem solchen Fall sollten Sie Ihre Pakete zügig aktualisieren, die Ausrede, dass Sie ein <literal>Sid</literal>-System verwenden, ist nicht akzeptabel. Das Paket <systemitem role="package">pbuilder</systemitem> kann Ihnen dabei helfen, auf nahezu jede Debian-basierte Distribution derselben Architektur zuzugreifen.

note: type: Content of: <book><chapter><section><para>
en: See <ulink url="&pbuilder;"/>, <citerefentry> <refentrytitle>pdebuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>pbuilderrc</refentrytitle> <manvolnum>5</manvolnum> </citerefentry>, and <citerefentry> <refentrytitle>pbuilder</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>.
de: Siehe <ulink url="&pbuilder;"/>, <citerefentry> <refentrytitle>pdebuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>pbuilderrc</refentrytitle> <manvolnum>5</manvolnum> </citerefentry> und <citerefentry> <refentrytitle>pbuilder</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><title>
en: <command>git-buildpackage</command> command and similar
de: Der Befehl <command>git-buildpackage</command> und ähnliche

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&debref-vcs;">Version control systems</ulink> for more.
de: Lesen Sie <ulink url="&debref-vcs;">Version control systems</ulink> für mehr Informationen.

note: type: Content of: <book><chapter><section><para>
en: If your upstream uses a source code management system (VCS)  <placeholder type="footnote" id="0"/> to maintain their code, you should consider using it as well.  This makes merging and cherry-picking upstream patches much easier.  There are several specialized wrapper script packages for Debian package building for each VCS.
de: Falls der Autor des ursprünglichen Programms ein Quelltext-Verwaltungsprogramm (VCS) <placeholder type="footnote" id="0"/> zur Betreuung des Codes einsetzt, sollten Sie darüber nachdenken, dies ebenfalls zu tun. Damit wird das Zusammenführen und Herauspicken von Patches des Originalautors wesentlich einfacher. Es gibt verschiedene Pakete, die spezialisierte Wrapper-Skripte enthalten, die das Bauen eines Debian-Pakets mit dem jeweiligen VCS erleichtern.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">git-buildpackage</systemitem>: a suite to help with Debian packages in Git repositories.
de: <systemitem role="package">git-buildpackage</systemitem>: Eine Suite zur Unterstützung von Debian-Paketen in Git-Depots.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">svn-buildpackage</systemitem>: helper programs to maintain Debian packages with Subversion.
de: <systemitem role="package">svn-buildpackage</systemitem>: Hilfsprogramme zur Betreuung von Debian-Paketen mit Subversion.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">cvs-buildpackage</systemitem>: a set of Debian package scripts for CVS source trees.
de: <systemitem role="package">cvs-buildpackage</systemitem>: Eine Sammlung von Skripten für Debian-Pakete in CVS-Quelltextbäumen.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: <ulink url="&debian-alioth-wiki;">Debian wiki Alioth</ulink> documents how to use the <ulink url="&debian-alioth;">alioth.debian.org</ulink> service.
de: Das Dokument <ulink url="&debian-alioth-wiki;">Debian wiki Alioth</ulink> dokumentiert, wie der Dienst <ulink url="&debian-alioth;">alioth.debian.org</ulink> verwandt wird.

note: type: Content of: <book><chapter><section><para>
en: Use of <systemitem role="package">git-buildpackage</systemitem> is becoming quite popular for Debian Developers to manage Debian packages with the Git server on <ulink url="&debian-alioth;">alioth.debian.org</ulink>. <placeholder type="footnote" id="0"/> This package offers many commands to <emphasis>automate</emphasis> packaging activities:
de: Die Verwendung von <systemitem role="package">git-buildpackage</systemitem> ist bei Debian-Entwicklern recht beliebt, um Debian-Pakete mit dem Git-Server auf <ulink url="&debian-alioth;">alioth.debian.org</ulink> zu verwalten. <placeholder type="footnote" id="0"/> Dieses Paket bietet viele Befehle, um Paketierungsaktivitäten zu <emphasis>automatisieren</emphasis>:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <citerefentry> <refentrytitle>gbp-import-dsc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>: import a previous Debian package to a Git repository.
de: <citerefentry> <refentrytitle>gbp-import-dsc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>: Import eines bestehenden Debian-Pakets in ein Git-Depot.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <citerefentry> <refentrytitle>gbp-import-orig</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>: import a new upstream tar to a Git repository.
de: <citerefentry> <refentrytitle>gbp-import-orig</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>: Import eines neuen Tars der Originalautoren in ein Git-Depot.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <citerefentry> <refentrytitle>gbp-dch</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>: generate the Debian changelog from Git commit messages.
de: <citerefentry> <refentrytitle>gbp-dch</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>: Erstellung des Debian-Changelogs aus Git-Commit-Nachrichten.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <citerefentry> <refentrytitle>git-buildpackage</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>: build Debian packages from a Git repository.
de: <citerefentry> <refentrytitle>git-buildpackage</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>: Bau von Debian-Paketen aus einem Git-Depot.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <citerefentry> <refentrytitle>git-pbuilder</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>: build Debian packages from a Git repository using <command>pbuilder</command>/<command>cowbuilder</command>.
de: <citerefentry> <refentrytitle>git-pbuilder</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>: Bau von Debian-Paketen aus einem Git-Depot mit <command>pbuilder</command>/<command>cowbuilder</command>.

note: type: Content of: <book><chapter><section><para>
en: These commands use 3 branches to track packaging activity:
de: Diese Befehle verwenden drei Zweige, um die Paktierungsaktivitäten nachzuverfolgen:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>main</literal> for Debian package source tree.
de: <literal>main</literal> für den Debian-Paketierungsquellbaum

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>upstream</literal> for upstream source tree.
de: <literal>upstream</literal> für den Quellbaum der Originalautoren

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para><footnote><para>
en: The <literal>--pristine-tar</literal> option invokes the <command>pristine-tar</command> command, which can regenerate an exact copy of a pristine upstream tarball using only a small binary delta file and the contents of the tarball that are typically kept in an <literal>upstream</literal> branch in the VCS.
de: Die Option <literal>--pristine-tar</literal> ruft den Befehl <command>pristine-tar</command> auf, der eine exakte Kopie des ursprünglichen Tarballs erneut erstellt und dabei nur eine kleine binäre Deltadatei und den Inhalt des Tarballs verwendet, der typischerweise im Zweig <literal>upstream</literal> des VCS gehalten wird.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>pristine-tar</literal> for upstream tarball generated by the <literal>--pristine-tar</literal> option.<placeholder type="footnote" id="0"/>
de: <literal>pristine-tar</literal> für Tarbälle der Originalautoren, die mit der Option <literal>--pristine-tar</literal> erstellt wurden.<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Here are some web resources available for advanced audiences.
de: Hier sind einige Quellen im Web für fortgeschrittene Anwender.

note: type: Content of: <book><chapter><section><para><footnote><itemizedlist><listitem><para>
en: Building Debian Packages with git-buildpackage (<filename>&git-buildpackage-doc;</filename>)
de: »Building Debian Packages with git-buildpackage« (<filename>&git-buildpackage-doc;</filename>)

note: type: Content of: <book><chapter><section><para><footnote><itemizedlist><listitem><para>
en: <ulink url="&debian-packages-git;">debian packages in git</ulink>
de: »<ulink url="&debian-packages-git;">debian packages in git</ulink>«

note: type: Content of: <book><chapter><section><para><footnote><itemizedlist><listitem><para>
en: <ulink url="&git-debian-packaging;">Using Git for Debian Packaging</ulink>
de: »<ulink url="&git-debian-packaging;">Using Git for Debian Packaging</ulink>«

note: type: Content of: <book><chapter><section><para><footnote><itemizedlist><listitem><para>
en: <ulink url="&git-dpm;">git-dpm: Debian packages in Git manager</ulink>
de: »<ulink url="&git-dpm;">git-dpm: Debian packages in Git manager</ulink>«

note: type: Content of: <book><chapter><section><para>
en: You can configure <systemitem role="package">git-buildpackage</systemitem> with <filename>~/.gbp.conf</filename>. See <citerefentry> <refentrytitle>gbp.conf</refentrytitle> <manvolnum>5</manvolnum> </citerefentry>.  <placeholder type="footnote" id="0"/>
de: Sie können <systemitem role="package">git-buildpackage</systemitem> mit <filename>~/.gbp.conf</filename> konfigurieren. Lesen Sie <citerefentry> <refentrytitle>gbp.conf</refentrytitle> <manvolnum>5</manvolnum> </citerefentry>. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><title>
en: Quick rebuild
de: Schneller Neubau

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Environment variables that are normally configured to proper values are not set by this method.  Never create real packages to be uploaded using this <emphasis role="strong">quick</emphasis> method.
de: Umgebungsvariablen, die normalerweise auf vernünftige Werte gesetzt sind, werden bei dieser Methode nicht eingerichtet. Erstellen Sie niemals echte Pakete, die hochgeladen werden sollen, mit dieser <emphasis role="strong">schnellen</emphasis> Methode.

note: type: Content of: <book><chapter><section><para>
en: With a large package, you may not want to rebuild from scratch every time while you're tuning details in <filename>debian/rules</filename>.  For testing purposes, you can make a <filename>.deb</filename> file without rebuilding the upstream sources like this<placeholder type="footnote" id="0"/>:
de: Bei einem großen Paket wollen Sie bestimmt nicht alles nach jeder kleiner Änderung in <filename>debian/rules</filename> neu kompilieren. Für Testzwecke können Sie folgendermaßen eine <filename>.deb</filename>-Datei erstellen, ohne alle Schritte durchzumachen<placeholder type="footnote" id="0"/>:

note: type: Content of: <book><chapter><section><para>
en: Or simply do the following to see if it builds or not:
de: Oder noch einfacher, falls Sie nur feststellen wollen, ob das Paket gebaut werden kann oder nicht:

note: type: Content of: <book><chapter><section><para>
en: Once you are finished with your tuning, remember to rebuild following the proper procedure.  You may not be able to upload correctly if you try to upload <filename>.deb</filename> files built this way.
de: Wenn Sie mit Ihren Anpassungen fertig sind, vergessen Sie nicht, das Paket gemäß der korrekten Prozedur neu zu bauen. Sie werden <filename>.deb</filename>-Dateien, die auf diese Weise gebaut wurden, nicht korrekt hochladen können.

note: type: Content of: <book><chapter><section><title>
en: Command hierarchy
de: Befehlshierarchie

note: type: Content of: <book><chapter><section><para>
en: Here is a quick summary of how many commands to build packages fit together in the command hierarchy. There are many ways to do the same thing.
de: Dies ist eine kurze Zusammenfassung, wie die vielen Befehle zum Paketbau in der Befehlshierarchie zusammenpassen. Es gibt viele Wege, das gleiche zu erledigen.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <filename>debian/rules</filename> = maintainer script for the package building
de: <filename>debian/rules</filename> = Betreuerskript für den Paketbau

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>dpkg-buildpackage</command> = core of the package building tool
de: <command>dpkg-buildpackage</command> = Kern des Paketbauwerkzeuges

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>debuild</command> = <command>dpkg-buildpackage</command> + <command>lintian</command> (build under the sanitized environment variables)
de: <command>debuild</command> = <command>dpkg-buildpackage</command> + <command>lintian</command> (unter bereinigten Umgebungsvariablen bauen)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>pbuilder</command> = core of the Debian chroot environment tool
de: <command>pbuilder</command> = Kern des Debian-Chroot-Umgebungswerkzeuges

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>pdebuild</command> = <command>pbuilder</command> + <command>dpkg-buildpackage</command> (build in the chroot)
de: <command>pdebuild</command> = <command>pbuilder</command> + <command>dpkg-buildpackage</command> (in der Chroot bauen)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>cowbuilder</command> = speed up the <command>pbuilder</command> execution
de: <command>cowbuilder</command> = Ausführung von <command>pbuilder</command> beschleunigen

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>git-pbuilder</command> = the easy-to-use commandline syntax for <command>pdebuild</command> (used by <command>gbp buildpackage</command>)
de: <command>git-pbuilder</command> = die einfach zu benutzende Syntax für <command>pdebuild</command> (von <command>gbp buildpackage</command> verwandt)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>gbp</command> = manage the Debian source under the git repo
de: <command>gbp</command> = Debian-Quellen in einem Git-Depot verwalten

note: type: Content of: <book><chapter><section><para>
en: Although use of higher level commands such as <command>gbp buildpackage</command> and <command>pbuilder</command> ensures the perfect package building environment, it is essential to understand how lower level commands such as <filename>debian/rules</filename> and <command>dpkg-buildpackage</command> are executed under them.
de: Obwohl die Verwendung von abstrakteren Befehlen wie <command>gbp buildpackage</command> und <command>pbuilder</command> eine perfekte Paketbauumgebung sicherstellen, ist es essenziell, zu verstehen, wie die systemnahen Befehle wie <filename>debian/rules</filename> und <command>dpkg-buildpackage</command> unter ihnen ausgeführt werden.

note: type: Content of: <book><chapter><title>
en: Checking the package for errors
de: Überprüfen des Pakets auf Fehler

note: type: Content of: <book><chapter><para>
en: There are some techniques you should know for checking a package for errors before uploading it to the public archives.
de: Es gibt einige Techniken, die Sie zum Überprüfen eines Pakets auf Fehler vor dem Upload in das öffentliche Archiv wissen sollten.

note: type: Content of: <book><chapter><para>
en: It's also a good idea to carry out testing on a machine other than your own.  You must watch closely for any warnings or errors for all the tests described here.
de: Es empfiehlt sich auch, das Testen auf einem von Ihrer Maschine verschiedenen Rechner durchzuführen. Sie müssen genau auf alle Warnungen und Fehler für alle hier beschriebenen Tests achten.

note: type: Content of: <book><chapter><section><title>
en: Suspicious changes
de: Merkwürdige Änderungen

note: type: Content of: <book><chapter><section><para>
en: If you find a new autogenerated patch file such as <filename>debian-changes-*</filename> in the <filename>debian/patches</filename> directory after building your non-native Debian package in <literal>3.0 (quilt)</literal> format, chances are you changed some files by accident or the build script modified the upstream source.  If it is your mistake, fix it.  If it is caused by the build script, fix the root cause with <command>dh-autoreconf</command> as in <xref linkend="customrules"/> or work around it with <filename>source/options</filename> as in <xref linkend="sourceopt"/>.
de: Falls Sie nach dem Bau Ihres nicht nativen Debian-Pakets im Format <literal>3.0 (quilt)</literal> einen neuen, automatisch erstellen Patch wie <filename>debian-changes-*</filename> im Verzeichnis <filename>debian/patches</filename> finden, besteht die Möglichkeit, dass Sie Dateien versehentlich geändert haben oder das Bauskript die Quellen der Originalautoren verändert hat. Falls es Ihr Fehler ist, korrigieren Sie ihn. Falls er vom Bauskript ausgelöst wurde, korrigieren Sie das dahinterliegende Problem mit <command>dh-autoreconf</command> wie in <xref linkend="customrules"/> oder umgehen Sie das Problem mit <filename>source/options</filename> wie in <xref linkend="sourceopt"/>.

note: type: Content of: <book><chapter><section><title>
en: Verifying a package's installation
de: Überprüfen einer Paketinstallation

note: type: Content of: <book><chapter><section><para>
en: You must test your package for whether it installs without problems.  The <citerefentry> <refentrytitle>debi</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command helps you to test installing all the generated binary packages.
de: Sie müssen überprüfen, ob Ihr Paket ohne Probleme installiert werden kann. Der Befehl <citerefentry> <refentrytitle>debi</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> hilft Ihnen bei der Testinstallation aller erstellten Binärpakete.

note: type: Content of: <book><chapter><section><para>
en: To prevent installation problems on different systems, you must make sure that there are no filenames conflicting with other existing packages, using the <filename>Contents-<replaceable>i386</replaceable></filename> file downloaded from the Debian archive.  The <command>apt-file</command> command may be handy for this task.  If there are collisions, please take action to avoid this real problem, whether by renaming the file, moving a common file to a separate package that multiple packages can depend on, using the alternatives mechanism (see <citerefentry><refentrytitle>update-alternatives</refentrytitle> <manvolnum>1</manvolnum></citerefentry>) in coordination with the maintainers of other affected packages, or declaring a <literal>Conflicts</literal> relationship in the <filename>debian/control</filename> file.
de: Um Installationsprobleme auf verschiedenen Systemen zu vermeiden, müssen Sie sicherstellen, dass es keine Dateinamenskonflikte mit anderen existierenden Paketen gibt, wobei Sie die vom Debian-Archiv heruntergeladene Datei <filename>Contents-<replaceable>i386</replaceable></filename> verwenden. Der Befehl <command>apt-file</command> kann für diese Aufgabe praktisch sein. Falls es Kollisionen gibt, kümmern Sie sich um dieses echte Problem, indem Sie die Datei umbenennen, eine gemeinsame Datei in ein separates Paket verschieben, von dem verschiedene Pakete abhängen können, in Absprache mit den Betreuern anderer betroffener Pakete den Alternatives-Mechanismus nutzen (siehe <citerefentry><refentrytitle>update-alternatives</refentrytitle> <manvolnum>1</manvolnum></citerefentry>) oder indem Sie eine <literal>Conflicts</literal>-Beziehung in der Datei <filename>debian/control</filename> festlegen.

note: type: Content of: <book><chapter><section><title>
en: Verifying a package's maintainer scripts
de: Überprüfen der Betreuerskripte eines Pakets

note: type: Content of: <book><chapter><section><para>
en: All maintainer scripts (that is, <filename>preinst</filename>, <filename>prerm</filename>, <filename>postinst</filename>, and <filename>postrm</filename> files) are hard to write correctly unless they are auto-generated by the <systemitem role="package">debhelper</systemitem> programs.  So do not use them if you are a novice maintainer (see <xref linkend="maintscripts"/>).
de: Alle Betreuerskripte (das heißt, die Dateien <filename>preinst</filename>, <filename>prerm</filename>, <filename>postinst</filename> und <filename>postrm</filename>) sind schwer korrekt zu schreiben, falls Sie nicht vom Programm <systemitem role="package">debhelper</systemitem> automatisch erstellt werden. Verwenden Sie sie daher als neuer Betreuer nicht (siehe <xref linkend="maintscripts"/>).

note: type: Content of: <book><chapter><section><para>
en: If the package makes use of these non-trivial maintainer scripts, be sure to test not only for install but also for remove, purge, and upgrade processes.  Many maintainer script bugs show up when packages are removed or purged.  Use the <command>dpkg</command> command as follows to test them:
de: Falls das Paket nicht triviale Betreuerskripte verwendet, testen Sie nicht nur die Installation, sondern auch das Entfernen, das vollständige Entfernen und den Upgrade-Prozess. Viele Betreuerskriptfehler zeigen sich, wenn Pakete entfernt oder endgültig entfernt werden. Verwenden Sie für die Tests den Befehl <command>dpkg</command> wie folgt:

note: type: Content of: <book><chapter><section><screen>
en: $ sudo dpkg -r gentoo
    $ sudo dpkg -P gentoo
    $ sudo dpkg -i gentoo_<replaceable>version</replaceable>-<replaceable>revision</replaceable>_<replaceable>i386</replaceable>.deb
de: $ sudo dpkg -r gentoo
    $ sudo dpkg -P gentoo
    $ sudo dpkg -i gentoo_<replaceable>Version</replaceable>-<replaceable>Revision</replaceable>_<replaceable>i386</replaceable>.deb

note: type: Content of: <book><chapter><section><para>
en: This should be done with sequences such as the following:
de: Dies sollte in einem Ablauf wie dem Folgenden passieren:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: install the previous version (if needed).
de: Installieren Sie die vorhergehende Version (falls notwendig)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: upgrade it from the previous version.
de: Führen Sie ein Upgrade von der vorhergehenden Version durch

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: downgrade it back to the previous version (optional).
de: Führen Sie ein Downgrade auf eine vorherige Version durch (optional)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: purge it.
de: Entfernen Sie es vollständig

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: install the new package.
de: Installieren Sie das neue Paket

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: remove it.
de: Entfernen Sie es

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: install it again.
de: Installieren Sie es wieder

note: type: Content of: <book><chapter><section><para>
en: If this is your first package, you should create dummy packages with different versions to test your package in advance to prevent future problems.
de: Falls dies Ihr erstes Paket ist, sollten Sie ein Pseudo-Paket mit einer anderen Version erstellen, um Ihr Paket vorab zu testen und zukünftige Probleme zu vermeiden.

note: type: Content of: <book><chapter><section><para>
en: Bear in mind that if your package has previously been released in Debian, people will often be upgrading to your package from the version that was in the last Debian release.  Remember to test upgrades from that version too.
de: Behalten Sie im Hinterkopf, dass die Benutzer ein Upgrade von der Version, die in der letzten Debian-Veröffentlichung enthalten war, durchführen werden, falls es schon mal veröffentlicht wurde. Denken Sie daran, auch Upgrades von dieser Version zu prüfen.

note: type: Content of: <book><chapter><section><para>
en: Although downgrading is not officially supported, supporting it is a friendly gesture.
de: Obwohl ein Downgrade offiziell nicht unterstützt wird, ist es eine nette Geste, dies dennoch zu unterstützen.

note: type: Content of: <book><chapter><section><title>
en: Using <systemitem role="package">lintian</systemitem>
de: <systemitem role="package">lintian</systemitem> verwenden

note: type: Content of: <book><chapter><section><para><footnote><para>
en: You do not need to provide the <command>lintian</command> option <literal>-i -I --show-overrides</literal> if you customized <filename>/etc/devscripts.conf</filename> or <filename>~/.devscripts</filename> as described in <xref linkend="debuild"/>.
de: Sie müssen die Option <literal>-i -I --show-overrides</literal> von <command>lintian</command> angeben, falls Sie <filename>/etc/devscripts.conf</filename> oder <filename>~/.devscripts</filename> wie in <xref linkend="debuild"/> beschrieben angepasst haben.

note: type: Content of: <book><chapter><section><para>
en: Run <citerefentry> <refentrytitle>lintian</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> on your <filename>.changes</filename> file.  The <command>lintian</command> command runs many test scripts to check for many common packaging errors.  <placeholder type="footnote" id="0"/>
de: Führen Sie <citerefentry> <refentrytitle>lintian</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> mit Ihrer Datei <filename>.changes</filename> aus. Der Befehl <command>lintian</command> führt viele Skripte aus, um auf typische Paketierungsfehler zu prüfen. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: Of course, replace the filename with the name of the <filename>.changes</filename> file generated for your package.  The output of the <command>lintian</command> command uses the following flags:
de: Selbstverständlich müssen Sie den Dateinamen mit dem Namen der Datei <filename>.changes</filename>, die für Ihr Paket erstellt wurde, ersetzen. Die Ausgabe des Befehls <command>lintian</command> verwendet die folgenden Schalter:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>E:</literal> for error; a sure policy violation or packaging error.
de: <literal>E:</literal> für Fehler; eine definitive Verletzung der Richtlinien oder ein Paketierungsfehler.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>W:</literal> for warning; a possible policy violation or packaging error.
de: <literal>W:</literal> für Warnungen; eine mögliche Verletzung der Richtlinien oder ein möglicher Paketierungsfehler.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>I:</literal> for info; information on certain aspects of packaging.
de: <literal>I:</literal> für Information; Informationen über bestimmte Aspekte der Paketierung.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>N:</literal> for note; a detailed message to help your debugging.
de: <literal>N:</literal> für Hinweis; eine detaillierte Meldung, um bei der Fehlersuche zu helfen.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>O:</literal> for overridden; a message overridden by the <filename>lintian-overrides</filename> files but displayed by the <literal>--show-overrides</literal> option.
de: <literal>O:</literal> für »außer Kraft gesetzt«; eine Meldung, die durch Dateien <filename>lintian-overrides</filename> außer Kraft gesetzt, von der Option <literal>--show-overrides</literal> aber angezeigt wurde.

note: type: Content of: <book><chapter><section><para>
en: When you see warnings, tune the package to avoid them or verify that the warnings are spurious.  If spurious, set up <filename>lintian-overrides</filename> files as described in <xref linkend="lintian"/>.
de: Wenn Sie Warnungen sehen, passen Sie Ihr Paket an, um diese zu vermeiden oder stellen Sie sicher, dass die Warnungen unberechtigt sind. Falls sie unberechtigt sind, legen Sie <filename>lintian-overrides</filename>-Dateien wie in <xref linkend="lintian"/> beschrieben an.

note: type: Content of: <book><chapter><section><para>
en: Note that you can build the package with <command>dpkg-buildpackage</command> and run <command>lintian</command> on it in one command, if you use <citerefentry> <refentrytitle>debuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> or <citerefentry> <refentrytitle>pdebuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.
de: Beachten Sie, dass Sie das Paket mit <command>dpkg-buildpackage</command> bauen und <command>lintian</command> in einem Befehl darauf anwenden können, falls Sie <citerefentry> <refentrytitle>debuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> oder <citerefentry> <refentrytitle>pdebuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> verwenden.

note: type: Content of: <book><chapter><section><title>
en: The <command>debc</command> command
de: Der Befehl <command>debc</command>

note: type: Content of: <book><chapter><section><para>
en: You can list files in the binary Debian package with the <citerefentry> <refentrytitle>debc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command.
de: Sie können Dateien im binären Debian-Paket mit dem Befehl <citerefentry> <refentrytitle>debc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> auflisten.

note: type: Content of: <book><chapter><section><title>
en: The <command>debdiff</command> command
de: Der Befehl <command>debdiff</command>

note: type: Content of: <book><chapter><section><para>
en: You can compare file contents in two source Debian packages with the <citerefentry> <refentrytitle>debdiff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command.
de: Sie können Dateiinhalte in zwei Debian-Quellpaketen mit dem Befehl <citerefentry> <refentrytitle>debdiff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> vergleichen.

note: type: Content of: <book><chapter><section><screen>
en: $ debdiff <replaceable>old-package</replaceable>.dsc <replaceable>new-package</replaceable>.dsc
de: $ debdiff <replaceable>altes-Paket</replaceable>.dsc <replaceable>neues-Paket</replaceable>.dsc

note: type: Content of: <book><chapter><section><para>
en: You can also compare file lists in two sets of binary Debian packages with the <citerefentry> <refentrytitle>debdiff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command.
de: Sie können Dateilisten in zwei Gruppen von binären Debian-Paketen mit dem Befehl <citerefentry> <refentrytitle>debdiff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> vergleichen.

note: type: Content of: <book><chapter><section><screen>
en: $ debdiff <replaceable>old-package</replaceable>.changes <replaceable>new-package</replaceable>.changes
de: $ debdiff <replaceable>altes-Paket</replaceable>.changes <replaceable>neues-Paket</replaceable>.changes

note: type: Content of: <book><chapter><section><para>
en: These are useful to identify what has been changed in the source packages and to check for inadvertent changes made when updating binary packages, such as unintentionally misplacing or removing files.
de: Sie sind nützlich, um zu identifizieren, wass in den Quellpaketen geändert wurde und auf unbeabsichtigte Änderungen beim Aktualisieren der Binärpakete zu prüfen, wie versehentlich fehlplatzierte oder entfernte Dateien.

note: type: Content of: <book><chapter><section><title>
en: The <command>interdiff</command> command
de: Der Befehl <command>interdiff</command>

note: type: Content of: <book><chapter><section><para>
en: You can compare two <filename>diff.gz</filename> files with the <citerefentry> <refentrytitle>interdiff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command.  This is useful for verifying that no inadvertent changes were made to the source by the maintainer when updating packages in the old <literal>1.0</literal> source format.
de: Sie können zwei <filename>diff.gz</filename>-Dateien mit dem Befehl <citerefentry> <refentrytitle>interdiff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> vergleichen. Dies ist zur Überprüfung, dass keine unbeabsichtigten Änderungen beim Aktualisieren von Paketen im alten <literal>1.0</literal>-Quellformat durch den Betreuer an den Quellen vorgenommen wurden, nützlich.

note: type: Content of: <book><chapter><section><screen>
en: $ interdiff -z <replaceable>old-package</replaceable>.diff.gz <replaceable>new-package</replaceable>.diff.gz
de: $ interdiff -z <replaceable>altes-Paket</replaceable>.diff.gz <replaceable>neues-Paket</replaceable>.diff.gz

note: type: Content of: <book><chapter><section><para>
en: The new <literal>3.0</literal> source format stores changes in multiple patch files as described in <xref linkend="patches"/>.  You can trace changes of each <filename>debian/patches/*</filename> file using <command>interdiff</command>, too.
de: Das neue Quellformat <literal>3.0</literal> speichert Änderungen in mehreren Patch-Dateien, wie in <xref linkend="patches"/> beschrieben. Sie können die Änderungen jeder <filename>debian/patches/*</filename>-Datei auch mit <command>interdiff</command> nachverfolgen.

note: type: Content of: <book><chapter><section><title>
en: The <command>mc</command> command
de: Der Befehl <command>mc</command>

note: type: Content of: <book><chapter><section><para>
en: Many of these file inspection operations can be made into an intuitive process by using a file manager like <citerefentry> <refentrytitle>mc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> which will let you browse not only the contents of <filename>*.deb</filename> package files but also <filename>*.udeb</filename>, <filename>*.debian.tar.gz</filename>, <filename>*.diff.gz</filename>, and <filename>*.orig.tar.gz</filename> files.
de: Viele dieser Dateiüberprüfungsoperationen können in einen intuitiven Prozess mit einem Dateimanager wie <citerefentry> <refentrytitle>mc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> verwandelt werden. Er ermöglicht es Ihnen, nicht nur die Inhalte eines <filename>*.deb</filename>-Pakets anzuschauen, sondern auch die von <filename>*.udeb</filename>, <filename>*.debian.tar.gz</filename>, <filename>*.diff.gz</filename> und <filename>*.orig.tar.gz</filename>-Dateien.

note: type: Content of: <book><chapter><section><para>
en: Be on the lookout for extra unneeded files or zero length files, both in the binary and source package.  Often cruft doesn't get cleaned up properly; adjust your <filename>rules</filename> file to compensate for this.
de: Schauen Sie nach zusätzlichen, nicht benötigten Dateien oder solchen der Länge 0, sowohl im binären als auch im Quellpaket. Oft werden (Programm-)Reste nicht korrekt bereinigt; passen Sie Ihre Datei <filename>rules</filename> an, um dies zu ermöglichen.

note: type: Content of: <book><chapter><title>
en: Updating the package
de: Aktualisieren des Pakets

note: type: Content of: <book><chapter><para>
en: After you release a package, you will soon need to update it.
de: Nachdem Sie ein Paket veröffentlichen, werden Sie es bald aktualisieren müssen.

note: type: Content of: <book><chapter><section><title>
en: New Debian revision
de: Neue Debian-Revision

note: type: Content of: <book><chapter><section><para>
en: Let's say that a bug report was filed against your package as <literal>#654321</literal>, and it describes a problem that you can solve.  Here's what you need to do to create a new Debian revision of the package:
de: Nehmen wir an, dass ein Fehlerbericht für Ihr Paket unter <literal>#654321</literal> eingereicht wurde und er ein Problem beschreibt, das Sie lösen können. Sie können wie folgt eine neue Debian-Revision des Pakets erstellen:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If this is to be recorded as a new patch, do the following:
de: Falls dies als neuer Patch aufgezeichnet werden soll, führen Sie Folgendes aus:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt new <replaceable>bugname.patch</replaceable></literal> to set the patch name;
de: <literal>dquilt new <replaceable>Fehlernummer.patch</replaceable></literal>, um den Patch-Namen zu setzen

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt add <replaceable>buggy-file</replaceable></literal> to declare the file to be modified;
de: <literal>dquilt add <replaceable>defekte_Datei</replaceable></literal>, um die zu korrigierende Datei anzugeben

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Correct the problem in the package source for the upstream bug;
de: Korrigieren Sie das Problem in den Paketquellen für den Fehler der Originalautoren

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt refresh</literal> to record it to <filename><replaceable>bugname.patch</replaceable></filename>;
de: <literal>dquilt refresh</literal>, um es in <filename><replaceable>Fehlernummer.patch</replaceable></filename> aufzuzeichnen

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt header -e</literal> to add its description;
de: <literal>dquilt header -e</literal>, um seine Beschreibung hinzuzufügen

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If this is to update an existing patch, do the following:
de: Falls hiermit ein existierender Patch aktualisiert wird, führen Sie Folgendes durch:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt pop <replaceable>foo.patch</replaceable></literal> to recall the existing <filename><replaceable>foo.patch</replaceable></filename>;
de: <literal>dquilt pop <replaceable>foo.patch</replaceable></literal>, um den existierenden <filename><replaceable>foo.patch</replaceable></filename> aufzurufen

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Correct the problem in the old <filename><replaceable>foo.patch</replaceable></filename>;
de: Korrektur des Problems in der alten <filename><replaceable>foo.patch</replaceable></filename>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt refresh</literal> to update <filename><replaceable>foo.patch</replaceable></filename>;
de: <literal>dquilt refresh</literal>, um <filename><replaceable>foo.patch</replaceable></filename> zu aktualisieren

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt header -e</literal> to update its description;
de: <literal>dquilt header -e</literal>, um seine Beschreibung zu aktualisieren

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>while dquilt push; do dquilt refresh; done</literal> to apply all patches while removing <emphasis>fuzz</emphasis>;
de: <literal>while dquilt push; do dquilt refresh; done</literal>, um alle Patches anzuwenden und dabei <emphasis>fuzz</emphasis> (Unschärfe) zu entfernen

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para><footnote><para>
en: To get the date in the required format, use <literal>LANG=C date -R</literal>.
de: Um das Datum in das benötigte Format zu bekommen, verwenden Sie <literal>LANG=C date -R</literal>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Add a new revision at the top of the Debian <filename>changelog</filename> file, for example with <literal>dch -i</literal>, or explicitly with <literal>dch -v <replaceable>version</replaceable>-<replaceable>revision</replaceable></literal> and then insert the comments using your preferred editor.  <placeholder type="footnote" id="0"/>
de: Fügen Sie eine neue Revision an den Anfang der Datei <filename>changelog</filename> hinzu, beispielsweise mit <literal>dch -i</literal> oder explizit mit <literal>dch -v <replaceable>Version</replaceable>-<replaceable>Revision</replaceable></literal> und fügen Sie dann die Kommentare mit ihrem Lieblingseditor ein. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Include a short description of the bug and the solution in the changelog entry, followed by <literal>Closes: #654321</literal>.  That way, the bug report will be <emphasis>automagically</emphasis> closed by the archive maintenance software the moment your package gets accepted into the Debian archive.
de: Fügen Sie eine kurze Beschreibung des Fehler und der Lösung in dem Changelog-Eintrag hinzu, gefolgt von <literal>Closes: #654321</literal>. Auf diese Art wird der Fehlerbericht <emphasis>automatisch</emphasis> geschlossen, sobald Ihre neue Paketversion im Archiv akzeptiert wird.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Repeat what you did in the above to fix more bugs while updating the Debian <filename>changelog</filename> file with <literal>dch</literal> as needed.
de: Wiederholen Sie die obigen Schritte, um weitere Fehler zu beheben, und aktualisieren Sie dabei die Debian-Datei <filename>changelog</filename> mit <literal>dch</literal>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Repeat what you did in <xref linkend="completebuild"/> and <xref linkend="checkit"/>.
de: Wiederholen Sie die Tätigkeiten aus <xref linkend="completebuild"/> und <xref linkend="checkit"/>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Once you are satisfied, you should change the distribution value in <filename>changelog</filename> from <literal>UNRELEASED</literal> to the target distribution value <literal>unstable</literal> (or even <literal>experimental</literal>).<placeholder type="footnote" id="0"/>
de: Sobald Sie zufrieden sind, sollten Sie den Wert für die Distribution im <filename>changelog</filename> von <literal>UNRELEASED</literal> auf den Ziel-Distributionswert <literal>unstable</literal> (oder ggf. <literal>experimental</literal>) setzen.<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Upload the package as in <xref linkend="upload"/>.  The difference is that this time, the original source archive won't be included, as it hasn't been changed and it already exists in the Debian archive.
de: Laden Sie Ihr Paket wie in <xref linkend="upload"/> beschrieben hoch. Der Unterschied besteht darin, dass Sie diesmal das ursprüngliche Quellarchiv nicht beifügen, da es sich nicht geändert hat und im Debian-Archiv bereits existiert.

note: type: Content of: <book><chapter><section><para>
en: One tricky case can occur when you make a local package, to experiment with the packaging before uploading the normal version to the official archive, e.g., <literal><replaceable>1.0.1</replaceable>-<replaceable>1</replaceable></literal>.  For smoother upgrades, it is a good idea to create a <filename>changelog</filename> entry with a version string such as <literal><replaceable>1.0.1</replaceable>-<replaceable>1~rc1</replaceable></literal>.  You may unclutter <filename>changelog</filename> by consolidating such local change entries into a single entry for the official package.  See <xref linkend="namever"/> for the order of version strings.
de: Ein schwieriger Fall kann auftreten, falls Sie ein lokales Paket erstellen, um mit dem Paketieren zu experimentieren, bevor Sie die normale Version in das offizielle Archiv hochladen, z.B. <literal><replaceable>1.0.1</replaceable>-<replaceable>1</replaceable></literal>. Für reibungslosere Upgrades ist es eine gute Idee, einen <filename>changelog</filename>-Eintrag mit einer Versionszeichenkette wie <literal><replaceable>1.0.1</replaceable>-<replaceable>1~rc1</replaceable></literal> zu erstellen. Sie können <filename>changelog</filename> bereinigen, indem Sie Ihre lokalen Änderungseinträge in einen einzigen Eintrag für das offizielle Paket zusammenfassen. Lesen Sie <xref linkend="namever"/> für die Reihenfolge von Versionszeichenketten.

note: type: Content of: <book><chapter><section><title>
en: Inspection of the new upstream release
de: Überprüfung einer neuen Version der Originalautoren

note: type: Content of: <book><chapter><section><para>
en: When preparing packages of a new upstream release for the Debian archive, you must check the new upstream release first.
de: Wenn Sie Pakete für eine neue Veröffentlichung der Originalautoren für das Debian-Archiv vorbereiten, müssen Sie zuerst die neue Veröffentlichung der Originalautoren prüfen.

note: type: Content of: <book><chapter><section><para>
en: Start by reading the upstream <filename>changelog</filename>, <filename>NEWS</filename>, and whatever other documentation they may have released with the new version.
de: Beginnen Sie damit, dass Sie <filename>changelog</filename>, <filename>NEWS</filename> und eventuell weitere mit der neuen Version veröffentlichte Dokumentation lesen.

note: type: Content of: <book><chapter><section><para>
en: You can then inspect changes between the old and new upstream sources as follows, watching out for anything suspicious:
de: Sie können dann Änderungen zwischen den alten und den neuen Quellen der Originalautoren wie folgt prüfen und dabei nach allem Verdächtigem Ausschau halten:

note: type: Content of: <book><chapter><section><screen>
en: $ diff -urN <replaceable>foo</replaceable>-<replaceable>oldversion</replaceable> <replaceable>foo</replaceable>-<replaceable>newversion</replaceable>
de: $ diff -urN <replaceable>foo</replaceable>-<replaceable>alteVersion</replaceable> <replaceable>foo</replaceable>-<replaceable>neueVersion</replaceable>

note: type: Content of: <book><chapter><section><para>
en: Changes to some auto-generated files by Autotools such as <filename>missing</filename>, <filename>aclocal.m4</filename>, <filename>config.guess</filename>, <filename>config.h.in</filename>, <filename>config.sub</filename>, <filename>configure</filename>, <filename>depcomp</filename>, <filename>install-sh</filename>, <filename>ltmain.sh</filename>, and <filename>Makefile.in</filename> may be ignored.  You may delete them before running <command>diff</command> on the source for inspection.
de: Änderungen durch Autotools an einigen automatisch erstellten Dateien wie <filename>missing</filename>, <filename>aclocal.m4</filename>, <filename>config.guess</filename>, <filename>config.h.in</filename>, <filename>config.sub</filename>, <filename>configure</filename>, <filename>depcomp</filename>, <filename>install-sh</filename>, <filename>ltmain.sh</filename> und <filename>Makefile.in</filename> können ignoriert werden. Sie können sie vor der Ausführung von <command>diff</command> in den Quellen für die Prüfung löschen.

note: type: Content of: <book><chapter><section><title>
en: New upstream release
de: Neue Version der Originalautoren

note: type: Content of: <book><chapter><section><para><footnote><para>
en: If a package <systemitem role="package"><replaceable>foo</replaceable></systemitem> is packaged in the old <literal>1.0</literal> format, this can be done by running <literal>zcat /<replaceable>path</replaceable>/<replaceable>to</replaceable>/<replaceable>foo</replaceable>_<replaceable>oldversion</replaceable>.diff.gz|patch -p1</literal> in the new extracted source, instead.
de: Falls ein Paket <systemitem role="package"><replaceable>foo</replaceable></systemitem> im alten Format <literal>1.0</literal> paketiert ist, kann dies stattdessen durch <literal>zcat /<replaceable>Pfad</replaceable>/<replaceable>nach</replaceable>/<replaceable>foo</replaceable>_<replaceable>alte_Version</replaceable>.diff.gz|patch -p1</literal> in der neuen entpackten Quelle durchgeführt werden.

note: type: Content of: <book><chapter><section><para>
en: If a package <systemitem role="package"><replaceable>foo</replaceable></systemitem> is properly packaged in the newer <literal>3.0 (native)</literal> or <literal>3.0 (quilt)</literal> formats, packaging a new upstream version is essentially moving the old <filename>debian</filename> directory to the new source.  This can be done by running <literal>tar xvzf /<replaceable>path</replaceable>/<replaceable>to</replaceable>/<replaceable>foo</replaceable>_<replaceable>oldversion</replaceable>.debian.tar.gz</literal> in the new extracted source.  <placeholder type="footnote" id="0"/> Of course, you need to do some obvious chores:
de: Falls ein Paket <systemitem role="package"><replaceable>foo</replaceable></systemitem> korrekt im neueren Format <literal>3.0 (native)</literal> oder <literal>3.0 (quilt)</literal> paketiert ist, besteht das Paketieren einer neuen Version der Originalautoren im wesentlichen im Verschieben des alten Verzeichnisses <filename>debian</filename> in die neuen Quellen. Dies kann durch Ausführung von <literal>tar xvzf /<replaceable>Pfad</replaceable>/<replaceable>zu</replaceable>/<replaceable>foo</replaceable>_<replaceable>alteVersion</replaceable>.debian.tar.gz</literal> in den entpackten Quellen passieren. <placeholder type="footnote" id="0"/> Natürlich müssen Sie einige offensichtliche Hausaufgaben machen:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Create a copy of the upstream source as the <filename>foo_<replaceable>newversion</replaceable>.orig.tar.gz</filename> file.
de: Erstellen Sie eine Kopie der Quellen der Originalautoren als <filename>foo_<replaceable>neueVersion</replaceable>.orig.tar.gz</filename>-Datei.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Update the Debian <filename>changelog</filename> file with <literal>dch -v <replaceable>newversion</replaceable>-<replaceable>1</replaceable></literal>.
de: Aktualisieren Sie die Debian-Datei <filename>changelog</filename> mit <literal>dch -v <replaceable>neueVersion</replaceable>-<replaceable>1</replaceable></literal>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Add an entry with <literal>New upstream release</literal>.
de: Fügen Sie einen Eintrag mit <literal>New upstream release</literal> hinzu.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Describe concisely the changes <emphasis>in the new upstream release</emphasis> that fix reported bugs and close those bugs by adding <literal>Closes: #<replaceable>bug_number</replaceable></literal>.
de: Beschreiben Sie genau die Änderungen <emphasis>in der neuen Veröffentlichung der Originalautoren</emphasis>, die berichtete Fehler schließen, und schließen Sie diese Fehler, indem Sie <literal>Closes: #<replaceable>Fehler_Nummer</replaceable></literal> hinzufügen.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Describe concisely the changes <emphasis>to the new upstream release</emphasis> by the maintainer that fix reported bugs and close those bugs by adding <literal>Closes: #<replaceable>bug_number</replaceable></literal>.
de: Beschreiben Sie genau die Änderungen <emphasis>an der neuen Veröffentlichung der Originalautoren</emphasis> durch den Betreuer, die berichtete Fehler schließen, und schließen Sie diese Fehler, indem Sie <literal>Closes: #<replaceable>Fehler_Nummer</replaceable></literal> hinzufügen.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>while dquilt push; do dquilt refresh; done</literal> to apply all patches while removing <emphasis>fuzz</emphasis>.
de: <literal>while dquilt push; do dquilt refresh; done</literal>, um alle Patches anzuwenden und gleichzeitig <emphasis>fuzz</emphasis> (Unschärfe) zu entfernen.

note: type: Content of: <book><chapter><section><para>
en: If the patch/merge did not apply cleanly, inspect the situation (clues are left in <filename>.rej</filename> files).
de: Falls das Patchen/Zusammenfügen nicht reibungsfrei lief, prüfen Sie die Situation (Hinweise verbleiben in <filename>.rej</filename>-Dateien).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If a patch you applied to the source was integrated into the upstream source,
de: Falls ein Patch, den Sie an den Quellen angewandt hatten, in die Quellen der Originalautoren integriert wurde,

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt delete</literal> to remove it.
de: führen Sie <literal>dquilt delete</literal> aus, um ihn zu entfernen.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If a patch you applied to the source conflicted with new changes in the upstream source,
de: Falls ein Patch, den Sie auf die Quellen anwandten, mit den neuen Änderungen in den Quellen der Originalautoren in Konflikt steht,

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt push -f</literal> to apply old patches while forcing rejects as <filename><replaceable>baz</replaceable>.rej</filename>.
de: wenden Sie <literal>dquilt push -f</literal> an, um die alten Patches anzuwenden und Rückweisungen als <filename><replaceable>baz</replaceable>.rej</filename> zu erzwingen.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Edit the <filename><replaceable>baz</replaceable></filename> file manually to bring about the intended effect of <filename><replaceable>baz</replaceable>.rej</filename>.
de: Bearbeiten Sie die Datei <filename><replaceable>baz</replaceable></filename> manuell, um den geplanten Effekt von <filename><replaceable>baz</replaceable>.rej</filename> zu erreichen.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt refresh</literal> to update the patch.
de: <literal>dquilt refresh</literal>, um den Patch zu aktualisieren

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Continue as usual with <literal>while dquilt push; do dquilt refresh; done</literal>.
de: Fahren Sie mit <literal>while dquilt push; do dquilt refresh; done</literal> wie gewohnt fort.

note: type: Content of: <book><chapter><section><para>
en: This process can be automated using the <citerefentry> <refentrytitle>uupdate</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command as follows:
de: Dieser Prozess kann mit dem Befehl <citerefentry> <refentrytitle>uupdate</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> wie folgt automatisiert werden:

note: type: Content of: <book><chapter><section><screen>
en: $ apt-get source <replaceable>foo</replaceable>
    ...
    dpkg-source: info: extracting <replaceable>foo</replaceable> in <replaceable>foo</replaceable>-<replaceable>oldversion</replaceable>
    dpkg-source: info: unpacking <replaceable>foo</replaceable>_<replaceable>oldversion</replaceable>.orig.tar.gz
    dpkg-source: info: applying <replaceable>foo</replaceable>_<replaceable>oldversion</replaceable>-1.debian.tar.gz
    $ ls -F
    <replaceable>foo</replaceable>-<replaceable>oldversion</replaceable>/
    <replaceable>foo</replaceable>_<replaceable>oldversion</replaceable>-1.debian.tar.gz
    <replaceable>foo</replaceable>_<replaceable>oldversion</replaceable>-1.dsc
    <replaceable>foo</replaceable>_<replaceable>oldversion</replaceable>.orig.tar.gz
    $ wget http://example.org/<replaceable>foo</replaceable>/<replaceable>foo</replaceable>-<replaceable>newversion</replaceable>.tar.gz
    $ cd <replaceable>foo</replaceable>-<replaceable>oldversion</replaceable>
    $ uupdate -v <replaceable>newversion</replaceable> ../<replaceable>foo</replaceable>-<replaceable>newversion</replaceable>.tar.gz
    $ cd ../<replaceable>foo</replaceable>-<replaceable>newversion</replaceable>
    $ while dquilt push; do dquilt refresh; done
    $ dch
    ... document changes made
de: $ apt-get source <replaceable>foo</replaceable>
    ...
    dpkg-source: info: <replaceable>foo</replaceable> wird nach <replaceable>foo</replaceable>-<replaceable>AlteVersion</replaceable> extrahiert
    dpkg-source: info: <replaceable>foo</replaceable>_<replaceable>AlteVersion</replaceable>.orig.tar.gz wird entpackt
    dpkg-source: info: <replaceable>foo</replaceable>_<replaceable>AlteVersion</replaceable>-1.debian.tar.gz wird angewandt
    $ ls -F
    <replaceable>foo</replaceable>-<replaceable>AlteVersion</replaceable>/
    <replaceable>foo</replaceable>_<replaceable>AlteVersion</replaceable>-1.debian.tar.gz
    <replaceable>foo</replaceable>_<replaceable>AlteVersion</replaceable>-1.dsc
    <replaceable>foo</replaceable>_<replaceable>AlteVersion</replaceable>.orig.tar.gz
    $ wget http://example.org/<replaceable>foo</replaceable>/<replaceable>foo</replaceable>-<replaceable>NeueVersion</replaceable>.tar.gz
    $ cd <replaceable>foo</replaceable>-<replaceable>AlteVersion</replaceable>
    $ uupdate -v <replaceable>NeueVersion</replaceable> ../<replaceable>foo</replaceable>-<replaceable>NeueVersion</replaceable>.tar.gz
    $ cd ../<replaceable>foo</replaceable>-<replaceable>NeueVersion</replaceable>
    $ while dquilt push; do dquilt refresh; done
    $ dch
    … Änderungen dokumentieren

note: type: Content of: <book><chapter><section><para><footnote><para>
en: If the <command>uscan</command> command downloads the updated source but it does not run the <command>uupdate</command> command, you should correct the <filename>debian/watch</filename> file to have <literal>debian uupdate</literal> at the end of the URL.
de: Falls der Befehl <command>uscan</command> die aktualisierten Quellen herunterlädt, aber nicht den Befehl <command>uupdate</command> ausführt, sollten Sie die Datei <filename>debian/watch</filename> korrigieren, um <literal>debian uupdate</literal> am Ende der URL zu haben.

note: type: Content of: <book><chapter><section><para>
en: If you set up a <filename>debian/watch</filename> file as described in <xref linkend="watch"/>, you can skip the <command>wget</command> command.  You simply run <citerefentry> <refentrytitle>uscan</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> in the <filename><replaceable>foo</replaceable>-<replaceable>oldversion</replaceable></filename> directory instead of the <command>uupdate</command> command.  This will <emphasis>automagically</emphasis> look for the updated source, download it, and run the <command>uupdate</command> command.  <placeholder type="footnote" id="0"/>
de: Falls Sie eine wie in <xref linkend="watch"/> beschriebene Datei <filename>debian/watch</filename> eingerichtet haben, könen Sie den Befehl <command>wget</command> überspringen. Sie führen einfach <citerefentry> <refentrytitle>uscan</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> in dem Verzeichnis <filename><replaceable>foo</replaceable>-<replaceable>alteVersion</replaceable></filename> statt des Befehls <command>uupdate</command> aus. Damit werden <emphasis>automatisch</emphasis> die aktualisierten Quellen gesucht, heruntergeladen und der Befehl <command>uupdate</command> ausgeführt. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: You can release this updated source by repeating what you did in <xref linkend="completebuild"/>, <xref linkend="checkit"/>, and <xref linkend="upload"/>.
de: Sie können diese aktualisierten Quellen veröffentlichen, indem Sie die Schritte aus <xref linkend="completebuild"/>, <xref linkend="checkit"/> und <xref linkend="upload"/> wiederholen.

note: type: Content of: <book><chapter><section><title>
en: Updating the packaging style
de: Den Paketstil aktualisieren

note: type: Content of: <book><chapter><section><para><footnote><para>
en: If your sponsor or other maintainers object to updating the existing packaging style, don't bother arguing.  There are more important things to do.
de: Falls Ihr Sponsor oder andere Betreuer dem Aktualisieren des Paketierungsstils widersprechen, argumentieren Sie nicht. Es gibt wichtigere Dinge zu erledigen.

note: type: Content of: <book><chapter><section><para>
en: Updating the package style is not a required activity for the update of a package.  However, doing so lets you use the full capabilities of the modern <systemitem role="package">debhelper</systemitem> system and the <literal>3.0</literal> source format.  <placeholder type="footnote" id="0"/>
de: Die Aktualisierung des Paketierungsstils ist keine notwendige Aktivität beim Aktualisieren eines Pakets. Allerdings erlaubt dies Ihnen, die gesamten Möglichkeiten des modernen <systemitem role="package">debhelper</systemitem>-Systems und des Quellformats <literal>3.0</literal> auszunutzen. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If you need to recreate deleted template files for any reason, you can run <command>dh_make</command> again in the same Debian package source tree with the <literal>--addmissing</literal> option.  Then edit them appropriately.
de: Falls Sie aus irgend einem Grund gelöschte Schablonendateien erneut erstellen müssen, können Sie <command>dh_make</command> mit der Option <literal>--addmissing</literal> in dem gleichen Debian-Quellverzeichnis aufrufen. Danach bearbeiten Sie diese entsprechend.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If the package has not been updated to use the <systemitem role="package">debhelper</systemitem> v7+ <command>dh</command> syntax for the <filename>debian/rules</filename> file, update it to use <command>dh</command>.  Update the <filename>debian/control</filename> file accordingly.
de: Falls das Paket noch nicht aktualisiert wurde, um die v7+-<command>dh</command>-Syntax von <systemitem role="package">debhelper</systemitem> für die Datei <filename>debian/rules</filename> zu verwenden, aktualisieren Sie es, um <command>dh</command> zu verwenden. Aktualisieren Sie die Datei <filename>debian/control</filename> entsprechend.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If you want to update the <filename>rules</filename> file created with the <filename>Makefile</filename> inclusion mechanism of the Common Debian Build System (<systemitem role="package">cdbs</systemitem>) to the <command>dh</command> syntax, see the following to understand its <literal>DEB_*</literal> configuration variables.
de: Falls Sie die mit dem <filename>Makefile</filename>-Einschlussmechanismus des Common Debian Build System (<systemitem role="package">cdbs</systemitem>) erzeugte Datei <filename>rules</filename> in die <command>dh</command>-Syntax umwandeln wollen, schauen Sie sich die folgenden Informationen an, um seine <literal>DEB_*</literal>-Konfigurationsvariablen zu verstehen:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: local copy of <filename>&cdbs-doc;</filename>
de: lokale Kopie von <filename>&cdbs-doc;</filename>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If you have a <literal>1.0</literal> source package without the <filename><replaceable>foo</replaceable>.diff.gz</filename> file, you can update it to the newer <literal>3.0 (native)</literal> source format by creating <filename>debian/source/format</filename> with <literal>3.0 (native)</literal>.  The rest of the <filename>debian/*</filename> files can just be copied.
de: Falls Sie ein <literal>1.0</literal>-Quellpaket ohne die Datei <filename><replaceable>foo</replaceable>.diff.gz</filename> haben, können Sie sie auf das neuere Quellformat <literal>3.0 (native)</literal> umstellen, indem Sie <filename>debian/source/format</filename> mit <literal>3.0 (native)</literal> erstellen. Der Rest der Dateien <filename>debian/*</filename> kann einfach so kopiert werden.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para><footnote><para>
en: You can split <filename>big.diff</filename> into many small incremental patches using the <command>splitdiff</command> command.
de: Mit dem Befehl <command>splitdiff</command> können Sie <filename>gross.diff</filename> in viele kleine, inkrementelle Patches zerteilen.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If you have a <literal>1.0</literal> source package with the <filename><replaceable>foo</replaceable>.diff.gz</filename> file, you can update it to the newer <literal>3.0 (quilt)</literal> source format by creating <filename>debian/source/format</filename> with <literal>3.0 (quilt)</literal>.  The rest of the <filename>debian/*</filename> files can just be copied.  Import the <filename>big.diff</filename> file generated by the command <literal>filterdiff -z -x '*/debian/*' <replaceable>foo</replaceable>.diff.gz &gt; big.diff</literal> to your <command>quilt</command> system, if needed.  <placeholder type="footnote" id="0"/>
de: Falls Sie ein <literal>1.0</literal>-Quellpaket mit der Datei <filename><replaceable>foo</replaceable>.diff.gz</filename> haben, können Sie es in das neuere Quellformat <literal>3.0 (quilt)</literal> umwandeln, indem Sie die Datei <filename>debian/source/format</filename> mit <literal>3.0 (quilt)</literal> erstellen. Der Rest der Dateien <filename>debian/*</filename> kann einfach so kopiert werden. Importieren Sie die Datei <filename>gross.diff</filename>, die vom Befehl <literal>filterdiff -z -x '*/debian/*' <replaceable>foo</replaceable>.diff.gz &gt; gross.diff</literal> erstellt wurde, in Ihr <command>quilt</command>-System, falls notwendig. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If it was packaged using another patch system such as <systemitem role="package">dpatch</systemitem>, <systemitem role="package">dbs</systemitem>, or <systemitem role="package">cdbs</systemitem> with <literal>-p0</literal>, <literal>-p1</literal>, or <literal>-p2</literal>, convert it to <systemitem role="package">quilt</systemitem> using <filename>deb3</filename> at <ulink url="&deb3;"/>.
de: Falls es mit einem anderen Patch-System wie <systemitem role="package">dpatch</systemitem>, <systemitem role="package">dbs</systemitem> oder <systemitem role="package">cdbs</systemitem> mit <literal>-p0</literal>, <literal>-p1</literal> oder <literal>-p2</literal> paketiert war, wandeln Sie es unter Verwendung des <filename>deb3</filename>-Skripts aus <ulink url="&deb3;"/> in das <systemitem role="package">quilt</systemitem>-Format um.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If it was packaged with the <command>dh</command> command with the <literal>--with quilt</literal> option or with the <command>dh_quilt_patch</command> and <command>dh_quilt_unpatch</command> commands, remove these and make it use the newer <literal>3.0 (quilt)</literal> source format.
de: Falls es mit dem Befehl <command>dh</command> mit der Option <literal>--with quilt</literal> oder mit den Befehlen <command>dh_quilt_patch</command> und <command>dh_quilt_unpatch</command> paketiert wurde, entfernen Sie diese und sorgen Sie dafür, dass das neuere Format <literal>3.0 (quilt)</literal> verwandt wird.

note: type: Content of: <book><chapter><section><para>
en: You should check <ulink url="&dep;">DEP - Debian Enhancement Proposals</ulink> and adopt ACCEPTED proposals.
de: Sie sollten die <ulink url="&dep;">DEP - Debian Enhancement Proposals</ulink> prüfen und akzeptierte (ACCEPTED) Vorschläge umsetzen.

note: type: Content of: <book><chapter><section><para>
en: You need to do the other tasks described in <xref linkend="newupstream"/>, too.
de: Sie müssen auch andere in <xref linkend="newupstream"/> beschriebene Aufgaben erledigen.

note: type: Content of: <book><chapter><section><title>
en: UTF-8 conversion
de: UTF-8-Umstellung

note: type: Content of: <book><chapter><section><para>
en: If upstream documents are encoded in old encoding schemes, converting them to <ulink url="&utf8;">UTF-8</ulink> is a good idea.
de: Falls die Dokumente der Originalautoren in alten Kodierungsschemata vorliegen, ist es eine gute Idee, sie in <ulink url="&utf8;">UTF-8</ulink> umzuwandeln.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Use <citerefentry> <refentrytitle>iconv</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> to convert encodings of plain text files.
de: Verwenden Sie <citerefentry> <refentrytitle>iconv</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> für die Konvertierung reiner Textdateien.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Use <citerefentry> <refentrytitle>w3m</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> to convert from HTML files to UTF-8 plain text files.  When you do this, make sure to execute it under UTF-8 locale.
de: Verwenden Sie <citerefentry> <refentrytitle>w3m</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> zur Umwandlung von HTML-Dateien in reine UTF-8-Textdateien. Stellen Sie dabei sicher, dass sie es unter einer UTF-8-Locale ausführen.

note: type: Content of: <book><chapter><section><title>
en: Reminders for updating packages
de: Erinnerungen für die Paketaktualisierung

note: type: Content of: <book><chapter><section><para>
en: Here are a few reminders for updating packages:
de: Es folgen ein paar Erinnerungen für die Aktualisierung von Paketen:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Preserve old <filename>changelog</filename> entries (sounds obvious, but there have been cases of people typing <literal>dch</literal> when they should have typed <literal>dch -i</literal>.)
de: Erhalten Sie alte Einträge im <filename>changelog</filename> (klingt offensichtlich, aber es gab Fälle, in denen <literal>dch</literal> eingegeben wurde, wenn <literal>dch -i</literal> hätte verwandt werden sollen).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Existing Debian changes need to be reevaluated; throw away stuff that upstream has incorporated (in one form or another) and remember to keep stuff that hasn't been incorporated by upstream, unless there is a compelling reason not to.
de: Existierende Debian-Änderungen müssen neu geprüft werden; entfernen Sie Dinge, die die Originalautoren integriert haben (in einer oder der anderen Form) und denken Sie daran, Dinge zu behalten, die noch nicht integriert wurden, falls es nicht doch überzeugende Gründe für die Entfernung gibt.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If any changes were made to the build system (hopefully you'd know from inspecting upstream changes) then update the <filename>debian/rules</filename> and <filename>debian/control</filename> build dependencies if necessary.
de: Falls Änderungen am Bausystem vorgenommen wurden (hoffentlich wissen Sie es bei der Prüfung der Änderungen der Originalautoren), aktualisieren Sie <filename>debian/rules</filename> und die Bauabhängigkeiten in <filename>debian/control</filename>, falls notwendig.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Check the <ulink url="&bts;">Debian Bug Tracking System (BTS)</ulink> to see if someone has provided patches to bugs that are currently open.
de: Prüfen Sie in der <ulink url="&bts;">Fehlerdatenbank (BTS)</ulink>, ob jemand Patches für derzeit offene Fehler bereitgestellt hat.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Check the contents of the <filename>.changes</filename> file to make sure you are uploading to the correct distribution, the proper bug closures are listed in the <literal>Closes</literal> field, the <literal>Maintainer</literal> and <literal>Changed-By</literal> fields match, the file is GPG-signed, etc.
de: Prüfen Sie den Inhalt der Datei <filename>.changes</filename>, um sicherzustellen, dass Sie in die korrekte Distribution hochladen, die richtigen Fehlerschließanweisungen im Feld <literal>Closes</literal> enthalten sind, die Felder <literal>Maintainer</literal> and <literal>Changed-By</literal> passen, die Datei GPG-signiert ist usw.

note: type: Content of: <book><chapter><title>
en: Uploading the package
de: Das Paket hochladen

note: type: Content of: <book><chapter><para>
en: Debian now requires source-only uploads for normal upload.  So this page is outdated.
de: Debian verlangt jetzt, dass normalerweise nur reine Quelltexte hochgeladen werden. Daher ist diese Seite veraltet.

note: type: Content of: <book><chapter><para>
en: Now that you have tested your new package thoroughly, you want to release it to a public archive to share it.
de: Nachdem Sie jetzt das neue Paket intensiv getestet haben, möchten Sie es zur gemeinsamen Benutzung in ein öffentliches Archiv hochladen.

note: type: Content of: <book><chapter><section><title>
en: Uploading to the Debian archive
de: In das Debian-Archiv hochladen

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <xref linkend="socialdynamics"/>.
de: Siehe <xref linkend="socialdynamics"/>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: There are publicly accessible archives such as <ulink url="&mentors-dn;"/> which work almost the same way as the Debian archive and provide an upload area for non-DDs.  You can set up an equivalent archive by yourself using the tools listed at <ulink url="&deb-archive;"/>.  So this section is useful for non-DDs, too.
de: Es gibt öffentlich erreichbare Archive wie <ulink url="&mentors-dn;"/>, die genauso wie das Debian-Archiv funktionieren und einen Upload-Bereich für Nicht-DDs bereitstellen. Sie können ein äquivalentes Archiv selbst erstellen, indem Sie die unter <ulink url="&deb-archive;"/> aufgeführten Werkzeuge verwenden. Daher ist dieser Abschnitt auch für Nicht-DDs nützlich.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: The <systemitem role="package">dput</systemitem> package seems to come with more features and to be becoming more popular than the <systemitem role="package">dupload</systemitem> package.  It uses the file <filename>/etc/dput</filename> for its global configuration and the file <filename>~/.dput.cf</filename> for per-user configuration.  It supports Ubuntu-related services out-of-the-box, too.
de: Das Paket <systemitem role="package">dput</systemitem> scheint mehr Funktionalitäten zu enthalten und beliebter als das Paket <systemitem role="package">dupload</systemitem> zu werden. Es verwendet die Datei <filename>/etc/dput</filename> für seine globale Konfiguration und die Datei <filename>~/.dput.cf</filename> für die benutzerspezifische Konfiguration. Es unterstützt auch standardmäßig Ubuntu-bezogene Dienste.

note: type: Content of: <book><chapter><section><para>
en: Once you become an official developer, <placeholder type="footnote" id="0"/> you can upload the package to the Debian archive.  <placeholder type="footnote" id="1"/> You can do this manually, but it's easier to use the existing automated tools, like <citerefentry> <refentrytitle>dupload</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> or <citerefentry> <refentrytitle>dput</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.  We'll describe how it's done with <command>dupload</command>.  <placeholder type="footnote" id="2"/>
de: Sobald Sie ein offizieller Entwickler sind, <placeholder type="footnote" id="0"/> können Sie das Paket in das Debian-Archiv hochladen. <placeholder type="footnote" id="1"/>. Sie können dies manuell erledigen, aber es ist leichter, eines der bestehenden automatischen Werkzeuge zu verwenden, wie <citerefentry> <refentrytitle>dupload</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> oder <citerefentry> <refentrytitle>dput</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>. Wir beschreiben, wie es mit dem Befehl <command>dupload</command> gemacht wird. <placeholder type="footnote" id="2"/>

note: type: Content of: <book><chapter><section><para>
en: First you have to set up <command>dupload</command>'s config file.  You can either edit the system-wide <filename>/etc/dupload.conf</filename> file, or have your own <filename>~/.dupload.conf</filename> file override the few things you want to change.
de: Zuerst müssen Sie die Konfigurationsdatei von <command>dupload</command> einrichten. Sie können entweder die systemweite Datei <filename>/etc/dupload.conf</filename> bearbeiten oder durch Ihre persönliche Datei <filename>~/.dupload.conf</filename> die wenigen Dinge, die Sie ändern möchten, überschreiben.

note: type: Content of: <book><chapter><section><para>
en: You can read the <citerefentry> <refentrytitle>dupload.conf</refentrytitle> <manvolnum>5</manvolnum> </citerefentry> manual page to understand what each of these options means.
de: Sie können die Handbuchseite <citerefentry> <refentrytitle>dupload.conf</refentrytitle> <manvolnum>5</manvolnum> </citerefentry> lesen, um zu verstehen, was jede dieser Optionen bedeutet.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&devref-upload;">Debian Developer's Reference 5.6, "Uploading a package"</ulink>.
de: Siehe <ulink url="&devref-upload;">Debian-Entwicklerreferenz 5.6, »Ein Paket hochladen«</ulink>.

note: type: Content of: <book><chapter><section><para>
en: The <literal>$default_host</literal> option determines which of the upload queues will be used by default.  <literal>anonymous-ftp-master</literal> is the primary one, but it's possible that you will want to use another one.  <placeholder type="footnote" id="0"/>
de: Die Option <literal>$default_host</literal> bestimmt, welche der Upload-Warteschlangen standardmäßig benutzt wird. <literal>anonymous-ftp-master</literal> ist die primäre, aber es ist möglich, dass Sie eine andere benutzen möchten. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: While connected to the Internet, you can upload your package as follows:
de: Während Sie mit dem Internet verbunden Sie, können Sie Ihr Paket wie folgt hochladen:

note: type: Content of: <book><chapter><section><para>
en: <command>dupload</command> checks that the SHA1/SHA256 file checksums match those listed in the <filename>.changes</filename> file.  If they do not match, it will warn you to rebuild it as described in <xref linkend="completebuild"/> so it can be properly uploaded.
de: <command>dupload</command> prüft, ob die SHA1/SHA256-Dateiprüfsummen zu den in der Datei <filename>.changes</filename> aufgeführten passen. Falls Sie nicht passen, wird es Sie warnen, dass sie wie in <xref linkend="completebuild"/> beschrieben erneut bauen müssen, so dass es korrekt hochgeladen werden kann.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&uploadqueue-readme;"/>.  Alternatively, you can use the <command>dcut</command> command from the <systemitem role="package">dput</systemitem> package.
de: Lesen Sie <ulink url="&uploadqueue-readme;"/>. Alternativ können Sie den Befehl <command>dcut</command> aus dem Paket <systemitem role="package">dput</systemitem> verwenden.

note: type: Content of: <book><chapter><section><para>
en: If you encounter an upload problem at <ulink url="&uploadqueue;"/>, you can fix this by manually uploading a GPG-signed <filename>*.commands</filename> file to there with <command>ftp</command>.  <placeholder type="footnote" id="0"/> For example, using <filename>hello.commands</filename>:
de: Falls Sie auf ein Problem beim Hochladen in <ulink url="&uploadqueue;"/> stoßen, können Sie dies durch manuelles Hochladen einer GPG-signierten Datei <filename>*.commands</filename> mit <command>ftp</command> korrigieren. <placeholder type="footnote" id="0"/> Beispielsweise mit der <filename>hello.commands</filename>:

note: type: Content of: <book><chapter><section><title>
en: Including <filename>orig.tar.gz</filename> for upload
de: Die Datei <filename>orig.tar.gz</filename> hochladen

note: type: Content of: <book><chapter><section><para>
en: When you first upload the package to the archive, you need to include the original <filename>orig.tar.gz</filename> source, too.  If the Debian revision number of this package is neither <literal>1</literal> nor <literal>0</literal>, you must provide the <command>dpkg-buildpackage</command> option <literal>-sa</literal>.
de: Wenn Sie das Paket zum ersten Mal ins Archiv hochladen, müssen Sie auch die ursprüngliche Quelldatei <filename>orig.tar.gz</filename> einschließen. Falls die Debian-Revisionsnummer dieses Pakets weder <literal>1</literal> noch <literal>0</literal> ist, müssen Sie die Option <literal>-sa</literal> von <command>dpkg-buildpackage</command> verwenden.

note: type: Content of: <book><chapter><section><para>
en: For the <command>dpkg-buildpackage</command> command:
de: Für den Befehl <command>dpkg-buildpackage</command>:

note: type: Content of: <book><chapter><section><para>
en: For the <command>debuild</command> command:
de: Für den Befehl <command>debuild</command>:

note: type: Content of: <book><chapter><section><para>
en: For the <command>pdebuild</command> command:
de: Für den Befehl <command>pdebuild</command>:

note: type: Content of: <book><chapter><section><para>
en: On the other hand, the <literal>-sd</literal> option will force the exclusion of the original <filename>orig.tar.gz</filename> source.
de: Andererseits wird die Option <literal>-sd</literal> den Ausschluss der ursprünglichen Quelle <filename>orig.tar.gz</filename> erzwingen.

note: type: Content of: <book><chapter><section><title>
en: Skipped uploads
de: Übersprungene Uploads

note: type: Content of: <book><chapter><section><para>
en: If you created multiple entries in <filename>debian/changelog</filename> by skipping uploads, you must create a proper <filename>*_.changes</filename> file that includes all changes since the last upload.  This can be done by specifying the <command>dpkg-buildpackage</command> option <literal>-v</literal> with the version, e.g., <literal><replaceable>1.2</replaceable></literal>.
de: Falls Sie durch Überspringen von Uploads mehrere Einträge in <filename>debian/changelog</filename> erzeugt haben, müssen Sie eine korrekte Datei <filename>*_.changes</filename> erzeugen, die sämtliche Änderungen seit dem letzten Upload enthält. Dies kann durch Angabe der Option <literal>-v</literal> von <command>dpkg-buildpackage</command> mit der Version, z.B. <literal><replaceable>1.2</replaceable></literal>, erfolgen.

note: type: Content of: <book><appendix><title>
en: Advanced packaging
de: Fortgeschrittene Paketierung

note: type: Content of: <book><appendix><para>
en: Here are some hints and pointers for advanced packaging topics that you are most likely to deal with.  You are strongly advised to read all the references suggested here.
de: Es folgen einige Tipps und Verweise für fortgeschrittene Paketierungsfragen, mit denen Sie wahrscheinlich zu tun bekommen werden. Es wird Ihnen nachdrücklich empfohlen, alle hier vorgeschlagenen Referenzen zu lesen.

note: type: Content of: <book><appendix><para>
en: You may need to manually edit the packaging template files generated by the <command>dh_make</command> command to address topics covered in this chapter.  The newer <command>debmake</command> command should address these topics better.
de: Es könnte sein, dass Sie die durch den Befehl <command>dh_make</command> erstellten Paketierungsvorlagedateien manuell bearbeiten müssen, um Punkte aus diesem Kapitel zu berücksichtigen. Der neuere Befehl <command>debmake</command> sollte diese Punkte besser berücksichtigen.

note: type: Content of: <book><appendix><section><title>
en: Shared libraries
de: Laufzeit-Bibliothek

note: type: Content of: <book><appendix><section><para>
en: Before packaging shared <ulink url="&library;">libraries</ulink>, you should read the following primary references in detail:
de: Bevor Sie <ulink url="&library;">Laufzeit-Bibliotheken</ulink> paketieren, sollten Sie die folgenden Referenzen im Detail lesen:

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <ulink url="&policy-sharedlibraries;">Debian Policy Manual, 8 "Shared libraries"</ulink>
de: <ulink url="&policy-sharedlibraries;">Debian Policy Manual, Kapitel 8 »Shared libraries«</ulink>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <ulink url="&policy-fhs;">Debian Policy Manual, 9.1.1 "File System Structure"</ulink>
de: <ulink url="&policy-fhs;">Debian Policy Manual, Kapitel 9.1.1 »File System Structure«</ulink>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <ulink url="&policy-libraries;">Debian Policy Manual, 10.2 "Libraries"</ulink>
de: <ulink url="&policy-libraries;">Debian Policy Manual, Kapitel 10.2 »Libraries«</ulink>

note: type: Content of: <book><appendix><section><para>
en: Here are some oversimplified hints for you to get started:
de: Es folgen einige stark vereinfachte Tipps für den Anfang:

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Shared libraries are <ulink url="&elf;">ELF</ulink> object files containing compiled code.
de: Laufzeitbibliotheken (engl. »shared libraries«) sind <ulink url="&elf;">ELF</ulink>-Objektdateien, die übersetzten Code enthalten.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Shared libraries are distributed as <filename>*.so</filename> files. (Neither <filename>*.a</filename> files nor <filename>*.la</filename> files)
de: Laufzeitbibliotheken werden als <filename>*.so</filename>-Dateien vertrieben, d.h. weder als <filename>*.a</filename>- noch als <filename>*.la</filename>-Dateien.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Shared libraries are mainly used to share common codes among multiple executables with the <command>ld</command> mechanism.
de: Laufzeitbibliotheken werden hauptsächlich benutzt, um gemeinsamen Programmcode aus mehreren Programmen mittels des <command>ld</command>-Mechanismus' gemeinsam zu nutzen.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Shared libraries are sometimes used to provide multiple plugins to an executable with the <command>dlopen</command> mechanism.
de: Laufzeitbibliotheken werden manchmal dazu benutzt, mehrere Erweiterungen eines Programms mittels des <command>dlopen</command>-Mechanismus' bereitzustellen.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Shared libraries export <ulink url="&symbol;">symbols</ulink>, which represent compiled objects such as variables, functions, and classes; and enable access to them from the linked executables.
de: Laufzeitbibliotheken exportieren <ulink url="&symbol;">Symbole</ulink>, die übersetzte Objekte wie Variablen, Funktionen und Klassen darstellen und darauf Zugriff von dem verlinkten Programm ermöglichen.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: Alternatively: <literal>readelf -d lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable> | grep SONAME</literal>
de: Alternativ: <literal>readelf -d lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable> | grep SONAME</literal>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: The <ulink url="&soname;">SONAME</ulink> of a shared library <filename>lib<replaceable>foo</replaceable>.so</filename>.<replaceable>1</replaceable>: <literal>objdump -p lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable> | grep SONAME</literal> <placeholder type="footnote" id="0"/>
de: Der <ulink url="&soname;">SONAME</ulink> einer Laufzeitbibliothek <filename>lib<replaceable>foo</replaceable>.so</filename>.<replaceable>1</replaceable>: <literal>objdump -p lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable> | grep SONAME</literal> <placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: The SONAME of a shared library usually matches the library file name (but not always).
de: Der SONAME einer Laufzeitbibliothek passt typischerweise (aber nicht immer) auf den Dateinamen der Bibliothek.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: Alternatively: <literal>readelf -d lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable> | grep NEEDED</literal>
de: Alternativ: <literal>readelf -d lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable> | grep NEEDED</literal>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: The SONAME of shared libraries linked to <filename><replaceable>/usr/bin/foo</replaceable></filename>: <literal>objdump -p <replaceable>/usr/bin/foo</replaceable> | grep NEEDED</literal> <placeholder type="footnote" id="0"/>
de: Der SONAME von Laufzeitbibliotheken, die nach <filename><replaceable>/usr/bin/foo</replaceable></filename> gelinkt sind: <literal>objdump -p <replaceable>/usr/bin/foo</replaceable> | grep NEEDED</literal> <placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: See <ulink url="&policy-runtime;">Debian Policy Manual, 8.1 "Run-time shared libraries"</ulink>.
de: Siehe <ulink url="&policy-runtime;">Debian Policy Manual, Kapitel 8.1 »Run-time shared libraries«</ulink>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <systemitem role="package">lib<replaceable>foo</replaceable><replaceable>1</replaceable></systemitem>: the library package for the shared library <filename>lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable></filename> with the SONAME ABI version <replaceable>1</replaceable>.<placeholder type="footnote" id="0"/>
de: <systemitem role="package">lib<replaceable>foo</replaceable><replaceable>1</replaceable></systemitem>: das Paket für die Laufzeitbibliothek <filename>lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable></filename> mit der SONAME-ABI-Version <replaceable>1</replaceable>.<placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: See <ulink url="&policy-ldconfig;">Debian Policy Manual, 8.1.1 "ldconfig"</ulink>.
de: Siehe <ulink url="&policy-ldconfig;">Debian Policy Manual, Kapitel 8.1.1 »ldconfig«</ulink>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: The package maintainer scripts of the library package must call <command>ldconfig</command> under the specific circumstances to create the necessary symbolic links for the SONAME.<placeholder type="footnote" id="0"/>
de: Die Paketbetreuerskripte des Bibliothekspakets müssen <command>ldconfig</command> unter den bestimmten Randbedingungen aufrufen, um die notwendigen symbolischen Links für den SONAME zu erzeugen.<placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <systemitem role="package">lib<replaceable>foo</replaceable><replaceable>1</replaceable>-dbg</systemitem>: the debugging symbols package that contains the debugging symbols for the shared library package <systemitem role="package">lib<replaceable>foo</replaceable><replaceable>1</replaceable></systemitem>.
de: <systemitem role="package">lib<replaceable>foo</replaceable><replaceable>1</replaceable>-dbg</systemitem>: das Fehlersuch-Symbol-Paket, das die Debugging-Symbole für das Laufzeitpaket <systemitem role="package">lib<replaceable>foo</replaceable><replaceable>1</replaceable></systemitem> enthält.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: See <ulink url="&policy-static;">Debian Policy Manual, 8.3 "Static libraries"</ulink> and <ulink url="&policy-dev;">Debian Policy Manual, 8.4 "Development files"</ulink>.
de: Siehe <ulink url="&policy-static;">Debian Policy Manual, Kapitel 8.3 »Static libraries«</ulink> und <ulink url="&policy-dev;">Debian Policy Manual, Kapitel 8.4 »Development files«</ulink>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <systemitem role="package">lib<replaceable>foo</replaceable>-dev</systemitem>: the development package that contains the header files etc. for the shared library <filename>lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable></filename>.<placeholder type="footnote" id="0"/>
de: <systemitem role="package">lib<replaceable>foo</replaceable>-dev</systemitem>: das Entwicklungspaket, das die Header-Dateien usw. für die Laufzeitbibliothek <filename>lib<replaceable>foo</replaceable>.so enthält.<replaceable>1</replaceable></filename>.<placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: See <ulink url="&removela;">Debian wiki ReleaseGoals/LAFileRemoval</ulink>.
de: Siehe <ulink url="&removela;">Debian wiki ReleaseGoals/LAFileRemoval</ulink>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Debian packages should not contain <filename>*.la</filename> Libtool archive files in general.<placeholder type="footnote" id="0"/>
de: Debian-Pakete sollten im Allgemeinen keine <filename>*.la</filename>-Libtool-Archive enthalten.<placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: See <ulink url="&rpathissues;">Debian wiki RpathIssue</ulink>.
de: Siehe <ulink url="&rpathissues;">Debian-Wiki RpathIssue</ulink>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Debian packages should not use RPATH in general.<placeholder type="footnote" id="0"/>
de: Debian-Pakete sollten im Allgemeinen keinen RPATH enthalten.<placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Although it is somewhat outdated and is only a secondary reference, <ulink url="&debianlibrarypackagingguide;">Debian Library Packaging Guide</ulink> may still be useful.
de: Obwohl er etwas veraltet und nur Sekundärliteratur ist, könnte der <ulink url="&debianlibrarypackagingguide;">Debian Library Packaging Guide</ulink> noch nützlich sein.

note: type: Content of: <book><appendix><section><title>
en: Managing <filename>debian/<replaceable>package</replaceable>.symbols</filename>
de: <filename>debian/<replaceable>Paket</replaceable>.symbols</filename> verwalten

note: type: Content of: <book><appendix><section><para><footnote><para>
en: Backward-incompatible ABI changes normally require you to update the SONAME of the library and the shared library package name to new ones.
de: Rückwärts-inkompatible ABI-Änderungen verlangen normalerweise von Ihnen, dass Sie den SONAME der Bibliothek und den Namen des Laufzeitbibliothekspakets in neue SONAMEN bzw. Namen ändern.

note: type: Content of: <book><appendix><section><para>
en: When you package a shared library, you should create a <filename>debian/<replaceable>package</replaceable>.symbols</filename> file to manage the minimal version associated with each symbol for backward-compatible ABI changes under the same SONAME of the library for the same shared library package name.<placeholder type="footnote" id="0"/> You should read the following primary references in detail:
de: Wenn Sie eine Laufzeitbibliothek paketieren, sollten Sie eine Datei <filename>debian/<replaceable>Paket</replaceable>.symbols</filename> erstellen, um die minimale Version zu verwalten, die jedem Symbol für rückwärts-kompatible ABI-Änderungen unter dem gleichen SONAME der Bibliothek für den gleichen Laufzeitbibliotheksnamen zugeordnet ist.<placeholder type="footnote" id="0"/> Sie sollten die folgenden primären Referenzen im Detail lesen:

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: For C++ libraries and other cases where tracking individual symbols is too difficult, follow <ulink url="&policy-library-shlibs;">Debian Policy Manual, 8.6.4 "The shlibs system"</ulink>, instead.
de: Für C++-Bibliotheken und andere Fälle, bei denen das Nachverfolgen individueller Symbole zu schwierig ist, folgen Sie stattdessen dem <ulink url="&policy-library-shlibs;">Debian Policy Manual, Kapitel 8.6.4 »The shlibs system«</ulink>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <ulink url="&policy-library-symbols;">Debian Policy Manual, 8.6.3 "The symbols system"</ulink><placeholder type="footnote" id="0"/>
de: <ulink url="&policy-library-symbols;">Debian Policy Manual, Kapitel 8.6.3 »The symbols system«</ulink><placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><para>
en: Here is a rough example of how to create the <systemitem role="package">libfoo1</systemitem> package from the upstream version <literal>1.3</literal> with the proper <filename>debian/libfoo1.symbols</filename> file:
de: Es folgt ein grobes Beispiel, wie das Paket <systemitem role="package">libfoo1</systemitem> aus der Version <literal>1.3</literal> der Originalautoren mit der korrekten Datei <filename>debian/libfoo1.symbols</filename> zu erstellen ist:

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Prepare the skeleton debianized source tree using the upstream <filename>libfoo-1.3.tar.gz</filename> file.
de: Bereiten Sie das Gerüst des debianisierten Quellbaums mit der Datei der Originalautoren <filename>libfoo-1.3.tar.gz</filename> vor.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: If this is the first packaging of the <systemitem role="package">libfoo1</systemitem> package, create the <filename>debian/libfoo1.symbols</filename> file with empty content.
de: Falls dies das erstmalige Paketieren des Pakets <systemitem role="package">libfoo1</systemitem> ist, erstellen Sie die Datei <filename>debian/libfoo1.symbols</filename> mit leerem Inhalt.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: If the previous upstream version <literal>1.2</literal> was packaged as the <systemitem role="package">libfoo1</systemitem> package with the proper <filename>debian/libfoo1.symbols</filename> in its source package, use it again.
de: Falls die vorherige Version <literal>1.2</literal> der Originalautoren im Paket <systemitem role="package">libfoo1</systemitem> mit der korrekten <filename>debian/libfoo1.symbols</filename> in seinem Quellpaket paketiert war, verwenden sie diese wieder.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para><footnote><para>
en: All previous versions of Debian packages are available at <ulink url="&snapshot;">http://snapshot.debian.org/</ulink>.  The Debian revision is dropped from the version to make it easier to backport the package: <literal>1.1</literal> &lt;&lt; <literal>1.1-1~bpo70+1</literal> &lt;&lt; <literal>1.1-1</literal> and <literal>1.2</literal> &lt;&lt; <literal>1.2-1~bpo70+1</literal> &lt;&lt; <literal>1.2-1</literal>
de: Alle vorhergehenden Versionen eines Pakets sind unter <ulink url="&snapshot;">http://snapshot.debian.org/</ulink> erhältlich. Die Debian-Revision wird von der Version entfernt, um das Rückportieren eines Paketes zu erleichtern: <literal>1.1</literal> &lt;&lt; <literal>1.1-1~bpo70+1</literal> &lt;&lt; <literal>1.1-1</literal> and <literal>1.2</literal> &lt;&lt; <literal>1.2-1~bpo70+1</literal> &lt;&lt; <literal>1.2-1</literal>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: If the previous upstream version <literal>1.2</literal> was not packaged with <filename>debian/libfoo1.symbols</filename>, create it as the <filename>symbols</filename> file from all available binary packages of the same shared library package name containing the same SONAME of the library, for example, versions <literal>1.1-1</literal> and <literal>1.2-1</literal>.  <placeholder type="footnote" id="0"/>
de: Falls die vorhergehende Version <literal>1.2</literal> der Originalautoren nicht mit <filename>debian/libfoo1.symbols</filename> paketiert worden war, erstellen Sie sie als Datei <filename>symbols</filename> von allen verfügbaren Binärpaketen des selben Laufzeitbibliotheksnamens, der den gleichen SONAME der Bibliothek enthält, beispielsweise Version <literal>1.1-1</literal> und <literal>1.2-1</literal>. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Make trial builds of the source tree with tools such as <command>debuild</command> and <command>pdebuild</command>.  (If this fails due to missing symbols etc., there were some backward-incompatible ABI changes that require you to bump the shared library package name to something like <systemitem role="package">libfoo1a</systemitem> and you should start over again.)
de: Bauen Sie mit Werkzeugen wie <command>debuild</command> und <command>pdebuild</command> versuchsweise den Quellbaum. (Falls das aufgrund fehlender Symbole usw. fehlschlägt, gibt es einige rückwärtsinkompatible ABI-Änderungen, die es notwendig machen, den Paketnamen der Laufzeitbibliothek auf etwas wie <systemitem role="package">libfoo1a</systemitem> zu erhöhen. Sie sollten dann wieder von vorne anfangen.)

note: type: Content of: <book><appendix><section><itemizedlist><listitem><screen>
en: $ cd libfoo-1.3
    $ debuild
    ...
    dpkg-gensymbols: warning: some new symbols appeared in the symbols file: ...
     see diff output below
    --- debian/libfoo1.symbols (libfoo1_1.3-1_amd64)
    +++ dpkg-gensymbolsFE5gzx        2012-11-11 02:24:53.609667389 +0900
    @@ -127,6 +127,7 @@
      foo_get_name@Base 1.1
      foo_get_longname@Base 1.2
      foo_get_type@Base 1.1
    + foo_get_longtype@Base 1.3-1
      foo_get_symbol@Base 1.1
      foo_get_rank@Base 1.1
      foo_new@Base 1.1
    ...
de: $ cd libfoo-1.3
    $ debuild
    ...
    dpkg-gensymbols: Warnung: einige neue Symbole sind in der Symboldatei aufgetaucht: …
     lesen Sie die folgende Diff-Ausgabe
    --- debian/libfoo1.symbols (libfoo1_1.3-1_amd64)
    +++ dpkg-gensymbolsFE5gzx        2012-11-11 02:24:53.609667389 +0900
    @@ -127,6 +127,7 @@
      foo_get_name@Base 1.1
      foo_get_longname@Base 1.2
      foo_get_type@Base 1.1
    + foo_get_longtype@Base 1.3-1
      foo_get_symbol@Base 1.1
      foo_get_rank@Base 1.1
      foo_new@Base 1.1
    ...

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: The Debian revision is dropped from the version to make it easier to backport the package: <literal>1.3</literal> &lt;&lt; <literal>1.3-1~bpo70+1</literal> &lt;&lt; <literal>1.3-1</literal>
de: Die Debian-Revision wird von der Version entfernt, um das Rückportieren eines Paketes zu erleichtern: <literal>1.3</literal> &lt;&lt; <literal>1.3-1~bpo70+1</literal> &lt;&lt; <literal>1.3-1</literal>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: If you see the diff printed by the <command>dpkg-gensymbols</command> as above, extract the proper updated <filename>symbols</filename> file from the generated binary package of the shared library.  <placeholder type="footnote" id="0"/>
de: Falls Sie wie oben den von <command>dpkg-gensymbols</command> ausgegebenen Diff sehen, extrahieren Sie die korrekt aktualisierte <filename>symbols</filename>-Datei aus dem erstellten Binärpaket der Laufzeitbibliothek. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Build release packages with tools such as <command>debuild</command> and <command>pdebuild</command>.
de: Bauen Sie mit Werkzeugen wie <command>debuild</command> und <command>pdebuild</command> die Veröffentlichungspakete.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><screen>
en: $ cd libfoo-1.3
    $ debuild -- clean
    $ debuild
    ...
de: $ cd libfoo-1.3
    $ debuild -- clean
    $ debuild
    …

note: type: Content of: <book><appendix><section><para><footnote><para>
en: See <ulink url="&policy-library-abi;">Debian Policy Manual, 8.6.2 "Shared library ABI changes"</ulink>.
de: Siehe <ulink url="&policy-library-abi;">Debian Policy Manual, Kapitel 8.6.2 »Shared library ABI changes«</ulink>.

note: type: Content of: <book><appendix><section><para>
en: In addition to the above examples, we need to check the ABI compatibility further and bump versions for some symbols manually as needed.  <placeholder type="footnote" id="0"/>
de: Zusätzlich zu den obigen Beispielen müssen wir die ABI-Kompatibilität weiter prüfen und die Versionen für einige Symbole wo notwendig erhöhen. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><para>
en: Although it is only a secondary reference, <ulink url="&usingsymbolsfiles;">Debian wiki UsingSymbolsFiles</ulink> and its linked web pages may be useful.
de: Obwohl es nur eine nachrangige Referenz ist, könnte <ulink url="&usingsymbolsfiles;">UsingSymbolsFiles</ulink> im Debian Wiki sowie die darin verlinkten Webseiten hilfreich sein.

note: type: Content of: <book><appendix><section><para>
en: The multiarch feature introduced to Debian wheezy integrates support for cross-architecture installation of binary packages (particularly <literal>i386</literal>&lt;-&gt;<literal>amd64</literal>, but also other combinations) in <systemitem role="package">dpkg</systemitem> and <systemitem role="package">apt</systemitem>. You should read the following references in detail:
de: Die Multiarch-Funktionalität, die mit Debian Wheezy eingeführt wurde, unterstützt die architekturübergreifende Installation von Binärpaketen (insbesondere <literal>i386</literal>&lt;-&gt;<literal>amd64</literal>, aber auch andere Kombinationen) in <systemitem role="package">dpkg</systemitem> und <systemitem role="package">apt</systemitem>. Sie sollten die folgenden Referenzen im Detail lesen:

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <ulink url="&multiarchspec;">Ubuntu wiki MultiarchSpec</ulink> (upstream)
de: <ulink url="&multiarchspec;">MultiarchSpec</ulink> im Ubuntu Wiki (Originalautoren)

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <ulink url="&multiarchimplementation;">Debian wiki Multiarch/Implementation</ulink> (Debian situation)
de: <ulink url="&multiarchimplementation;">Multiarch/Implementation</ulink> im Debian Wiki (Debian-Situation)

note: type: Content of: <book><appendix><section><para><footnote><para>
en: Old special purpose library paths such as <filename>/lib32/</filename> and <filename>/lib64/</filename> are not used anymore.
de: Alte Spezialbibliothekspfade wie <filename>/lib32/</filename> und <filename>/lib64/</filename> werden nicht mehr benutzt.

note: type: Content of: <book><appendix><section><para>
en: It uses the triplet such as <literal>i386-linux-gnu</literal> and <literal>x86_64-linux-gnu</literal> for the install path of shared libraries. The actual triplet path is dynamically set into the <literal>$(DEB_HOST_MULTIARCH)</literal> variable using the <citerefentry> <refentrytitle>dpkg-architecture</refentrytitle><manvolnum>1</manvolnum></citerefentry> command for each binary package build. For example, the path to install multiarch libraries are changed as follows:<placeholder type="footnote" id="0"/>
de: Es verwendet ein Triplet wie <literal>i386-linux-gnu</literal> und <literal>x86_64-linux-gnu</literal> für den Installationspfad der Laufzeitbibliotheken. Der tatsächliche Triplett-Pfad wird durch <citerefentry> <refentrytitle>dpkg-architecture</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> für jeden Bau dynamisch in <literal>$(DEB_HOST_MULTIARCH)</literal> gesetzt. Beispielsweise werden die Pfade zu Multiarch-Bibliotheken wie folgt geändert:<placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: Old path
de: Alter Pfad

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: i386 multiarch path
de: I386-Multiarch-Pfad

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: amd64 multiarch path
de: Amd64-Multiarch-Pfad

note: type: Content of: <book><appendix><section><para>
en: Here are some typical multiarch package split scenario examples for the following:
de: Es gibt einige typische Beispiele für Multiarch-Paketaufteilungsszenarien:

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: a library source <filename>lib<replaceable>foo</replaceable>-1.tar.gz</filename>
de: eine Bibliotheksquelle <filename>lib<replaceable>foo</replaceable>-1.tar.gz</filename>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: a tool source <filename><replaceable>bar</replaceable>-1.tar.gz</filename> written in a compiled language
de: eine in einer übersetzten Sprache geschriebene Werkzeugquelle <filename><replaceable>bar</replaceable>-1.tar.gz</filename>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: a tool source <filename><replaceable>baz</replaceable>-1.tar.gz</filename> written in an interpreted language
de: eine in einer interpretierten Sprache geschriebene Werkzeugquelle <filename><replaceable>baz</replaceable>-1.tar.gz</filename>

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: Package
de: Paket

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: Package content
de: Paketinhalt

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the shared library, co-installable
de: die Laufzeitbibliothek, koinstallierbar

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the shared library debug symbols, co-installable
de: die Debug-Symbole der Laufzeitbibliothek, koinstallierbar

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the shared library header files etc., co-installable
de: die Laufzeitbibliothek-Header-Dateien usw., koinstallierbar

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the run-time support programs, not co-installable
de: die Laufzeitunterstützungsprogramme, nicht koinstallierbar

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the shared library documentation files
de: die Dokumentationsdateien der Laufzeitbibliothek

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the compiled program files, not co-installable
de: die übersetzten Programmdateien, nicht koinstallierbar

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the documentation files for the program
de: die Dokumentationsdateien für das Programm

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the interpreted program files
de: die interpretierten Programmdateien

note: type: Content of: <book><appendix><section><para>
en: Please note that the development package should contain a symlink for the associated shared library <emphasis role="strong">without a version number</emphasis>.  E.g.: <filename>/usr/lib/x86_64-linux-gnu/libfoo.so</filename> -&gt; <filename>libfoo.so.1</filename>
de: Beachten Sie, dass die Entwicklungspakete einen Symlink für die zugehörige Laufzeitbibliothek <emphasis role="strong">ohne eine Versionsnummer </emphasis> enthalten sollten, z.B. <filename>/usr/lib/x86_64-linux-gnu/libfoo.so</filename> -&gt; <filename>libfoo.so.1</filename>

note: type: Content of: <book><appendix><section><title>
en: Building a shared library package
de: Erstellen eines Laufzeitbibliothekspakets

note: type: Content of: <book><appendix><section><para>
en: You can build a Debian library package enabling multiarch support using <citerefentry> <refentrytitle>dh</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> as follows:
de: Sie können ein Debian-Laufzeitbibliothekspaket mit Unterstützung von Multiarch mit <citerefentry> <refentrytitle>dh</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> wie folgt bauen:

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Update <filename>debian/control</filename>.
de: <filename>debian/control</filename> aktualisieren

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Add <literal>Build-Depends: debhelper (>=10)</literal> for the source package section.
de: <literal>Build-Depends: debhelper (>=10)</literal> zum Quellpaketabschnitt hinzufügen

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Add <literal>Pre-Depends: ${misc:Pre-Depends}</literal> for each shared library binary package.
de: <literal>Pre-Depends: ${misc:Pre-Depends}</literal> für jedes Laufzeitbibliothekspaket hinzufügen

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Add <literal>Multi-Arch:</literal> stanza for each binary package section.
de: Fügen Sie den <literal>Multi-Arch:</literal>-Absatz zu jedem Binärpaketabschnitt hinzu.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Set <filename>debian/compat</filename> to "10".
de: <filename>debian/compat</filename> auf »10« setzen

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Adjust the path from the normal <literal>/usr/lib/</literal> to the multiarch <literal>/usr/lib/$(DEB_HOST_MULTIARCH)/</literal> for all packaging scripts.
de: Passen Sie für alle Paketierungsskripte die Pfade vom normalen <literal>/usr/lib/</literal> auf die Multiarch-Variante <literal>/usr/lib/$(DEB_HOST_MULTIARCH)/</literal> an.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Call <literal>DEB_HOST_MULTIARCH ?= $(shell dpkg-architecture -qDEB_HOST_MULTIARCH)</literal> in <filename>debian/rules</filename> to set the <literal>DEB_HOST_MULTIARCH</literal> variable first.
de: Zuerst <literal>DEB_HOST_MULTIARCH ?= $(shell dpkg-architecture -qDEB_HOST_MULTIARCH)</literal> in <filename>debian/rules</filename> aufrufen, um die Variable <literal>DEB_HOST_MULTIARCH</literal> zu setzen.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Replace <literal>/usr/lib/</literal> with <literal>/usr/lib/$(DEB_HOST_MULTIARCH)/</literal> in <filename>debian/rules</filename>.
de: Ersetzen Sie in <filename>debian/rules</filename> <literal>/usr/lib/</literal> durch <literal>/usr/lib/$(DEB_HOST_MULTIARCH)/</literal>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para><footnote><para>
en: Alternatively, you can add <literal>--libdir=\$${prefix}/lib/$(DEB_HOST_MULTIARCH)</literal> and <literal>--libexecdir=\$${prefix}/lib/$(DEB_HOST_MULTIARCH)</literal> arguments to <literal>./configure</literal>.  Please note that <literal>--libexecdir</literal> specifies the default path to install executable programs run by other programs rather than by users.  Its Autotools default is <filename>/usr/libexec/</filename> but its Debian default is <filename>/usr/lib/</filename>.
de: Alternativ können Sie die Argumente <literal>--libdir=\$${prefix}/lib/$(DEB_HOST_MULTIARCH)</literal> und <literal>--libexecdir=\$${prefix}/lib/$(DEB_HOST_MULTIARCH)</literal> zu <literal>./configure</literal> hinzufügen. Beachten Sie, dass <literal>--libexecdir</literal> den Standardpfad angibt, in den ausführbare Programme installiert werden, die von anderen Programmen (nicht von Benutzern) ausgeführt werden. Die Vorgabe von Autotools ist <filename>/usr/libexec/</filename>, die Debian-Vorgabe ist allerdings <filename>/usr/lib/</filename>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: If <literal>./configure</literal> is used in part of the <literal>override_dh_auto_configure</literal> target in <filename>debian/rules</filename>, make sure to replace it with <literal>dh_auto_configure -- </literal>.  <placeholder type="footnote" id="0"/>
de: Falls <literal>./configure</literal> als Teil des Ziels <literal>override_dh_auto_configure</literal> in <filename>debian/rules</filename> verwandt wird, stellen Sie sicher, dass Sie es durch <literal>dh_auto_configure -- </literal> ersetzen.  <placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Replace all occurrences of <literal>/usr/lib/</literal> with <literal>/usr/lib/*/</literal> in <filename>debian/<replaceable>foo</replaceable>.install</filename> files.
de: Ersetzen Sie in <filename>debian/<replaceable>foo</replaceable>.install</filename>-Dateien alle Vorkommen von <literal>/usr/lib/</literal> durch <literal>/usr/lib/*/</literal>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Generate files like <filename>debian/<replaceable>foo</replaceable>.links</filename> from <filename>debian/<replaceable>foo</replaceable>.links.in</filename> dynamically by adding a script to the <literal>override_dh_auto_configure</literal> target in <filename>debian/rules</filename>.
de: Erstellen Sie dynamisch durch Hinzufügen eines Skripts im Ziel <literal>override_dh_auto_configure</literal> in <filename>debian/rules</filename> Dateien wie <filename>debian/<replaceable>foo</replaceable>.links</filename> aus <filename>debian/<replaceable>foo</replaceable>.links.in</filename>.

note: type: Content of: <book><appendix><section><para>
en: Please make sure to verify that the shared library package contains only the expected files, and that your -dev package still works.
de: Bitte stellen Sie sicher, dass das Laufzeitbibliothekspaket nur die erwarteten Dateien enthält und dass Ihr -dev-Paket noch funktioniert.

note: type: Content of: <book><appendix><section><para>
en: All files installed simultaneously as the multiarch package to the same file path should have exactly the same file content.  You must be careful of differences generated by the data byte order and by the compression algorithm.
de: Alle Dateien, die simultan aus dem Multiarch-Paket in den gleichen Dateipfad installiert werden, sollten exakt den gleichen Inhalt haben. Sie müssen vorsichtig mit Unterschieden sein, die durch die Byte-Reihenfolge und den Kompressionsalgorithmus entstehen.

note: type: Content of: <book><appendix><section><title>
en: Native Debian package
de: Natives Debian-Paket

note: type: Content of: <book><appendix><section><para>
en: If a package is maintained only for Debian or possibly only for local use, its source may contain all the <filename>debian/*</filename> files in it.  There are 2 ways to package it.
de: Falls ein Paket nur für Debian oder möglicherweise nur für lokale Benutzung betreut wird, können seine Quellen alle Dateien aus <filename>debian/*</filename> enthalten. Es gibt zwei Möglichkeiten, dies zu paketieren:

note: type: Content of: <book><appendix><section><para>
en: You can make the upstream tarball by excluding the <filename>debian/*</filename> files and package it as a non-native Debian package as in <xref linkend="workflow"/>.  This is the normal way, which some people encourage using.
de: Sie können einen Tarball der Originalautoren erstellen, bei dem Sie die <filename>debian/*</filename>-Dateien ausschließen und es als nicht natives Debian-Paket wie in <xref linkend="workflow"/> paketieren. Dies ist die normale Art, zu der einige Leute raten.

note: type: Content of: <book><appendix><section><para>
en: The alternative is the workflow of the native Debian package.
de: Die Alternative wäre der Arbeitsablauf für ein natives Debian-Paket:

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Create a native Debian source package in the <literal>3.0 (native)</literal> format using a single compressed tar file in which all files are included.
de: Erstellen Sie ein natives Debian-Quellpaket im Format <literal>3.0 (native)</literal> mit einer einzelnen komprimierten Tar-Datei, in der alle Dateien enthalten sind.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>_<replaceable>version</replaceable>.tar.gz
de: <replaceable>Paket</replaceable>_<replaceable>Version</replaceable>.tar.gz

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>_<replaceable>version</replaceable>.dsc
de: <replaceable>Paket</replaceable>_<replaceable>Version</replaceable>.dsc

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Build Debian binary packages from the native Debian source package.
de: Bauen Sie Debian-Binärpakete aus den nativen Debian-Quellpaketen.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>_<replaceable>version</replaceable>_<replaceable>arch</replaceable>.deb
de: <replaceable>Paket</replaceable>_<replaceable>Version</replaceable>_<replaceable>Arch</replaceable>.deb

note: type: Content of: <book><appendix><section><para>
en: For example, if you have source files in <filename>~/mypackage-1.0</filename> without the <filename>debian/*</filename> files, you can create a native Debian package by issuing the <command>dh_make</command> command as follows:
de: Falls Sie beispielsweise Quelldateien in <filename>~/mypackage-1.0</filename> ohne die <filename>debian/*</filename>-Dateien haben, können Sie ein natives Debian-Paket mittels des Befehls <command>dh_make</command> wie folgt erstellen:

note: type: Content of: <book><appendix><section><screen>
en: $ cd ~/mypackage-1.0
    $ dh_make --native
de: $ cd ~/MeinPaket-1.0
    $ dh_make --native

note: type: Content of: <book><appendix><section><para>
en: Then the <filename>debian</filename> directory and its contents are created just like in <xref linkend="non-native-dh-make"/>.  This does not create a tarball, since this is a native Debian package.  But that is the only difference.  The rest of the packaging activities are practically the same.
de: Dann werden das Verzeichnis <filename>debian</filename> und seine Inhalte genau wie in <xref linkend="non-native-dh-make"/> erstellt. Dies erstellt keinen Tarball, da dies ein natives Debian-Paket ist. Das ist aber auch der einzige Unterschied. Der Rest der Paketierungsaktivitäten ist praktisch identisch.

note: type: Content of: <book><appendix><section><para>
en: After execution of the <command>dpkg-buildpackage</command> command, you will see the following files in the parent directory:
de: Nach der Ausführung des Befehls <command>dpkg-buildpackage</command> werden Sie die folgenden Dateien im übergeordneten Verzeichnis finden:

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <filename>mypackage_1.0.tar.gz</filename>
de: <filename>meinpaket_1.0.tar.gz</filename>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: This is the source code tarball created from the <filename>mypackage-1.0</filename> directory by the <command>dpkg-source</command> command.  (Its suffix is not <filename>orig.tar.gz</filename>.)
de: Dies ist der Quellcode-Tarball, der aus dem Verzeichnis <filename>MeinPaket-1.0</filename> durch den Befehl <command>dpkg-source</command> erstellt wurde. (Seine Endung ist nicht <filename>orig.tar.gz</filename>.)

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <filename>mypackage_1.0.dsc</filename>
de: <filename>meinpaket_1.0.dsc</filename>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: This is a summary of the contents of the source code, as in the non-native Debian package. (There is no Debian revision.)
de: Dies ist eine Zusammenfassung der Inhalte des Quellcodes, wie in dem nicht nativen Debian-Paket. (Es gibt keine Debian-Revision.)

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <filename>mypackage_1.0_i386.deb</filename>
de: <filename>meinpaket_1.0_i386.deb</filename>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: This is your completed binary package, as in the non-native Debian package.  (There is no Debian revision.)
de: Dies ist Ihr komplettes Binärpaket wie in dem nicht nativen Debian-Paket. (Es gibt keine Debian-Revision.)

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <filename>mypackage_1.0_i386.changes</filename>
de: <filename>meinpaket_1.0_i386.changes</filename>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: This file describes all the changes made in the current package version as in the non-native Debian package. (There is no Debian revision.)
de: Diese Datei beschreibt wie in dem nicht nativen Debian-Paket alle Änderungen, die in der aktuellen Paketversion erfolgten. (Es gibt keine Debian-Revision.)
