[developers-reference.git] / po4a / de / best-pkging-practices.po

# German translation of developers-reference: best-pkging-practices.
# This file is distributed under the same license as the
# developers-reference package.
# Chris Leick <c.leick@vollbio.de>, 2011.
#
msgid ""
msgstr ""
"Project-Id-Version: developers-reference 3.4.4\n"
"POT-Creation-Date: 2010-06-20 09:23-0400\n"
"PO-Revision-Date: 2011-03-28 18:54+0100\n"
"Last-Translator: Chris Leick <c.leick@vollbio.de>\n"
"Language-Team: German <debian-l10n-german@lists.debian.org>\n"
"Language: de\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#. type: Content of: <chapter><title>
#: best-pkging-practices.dbk:7
msgid "Best Packaging Practices"
msgstr "Optimale Vorgehensweise beim Paketieren"

#. type: Content of: <chapter><para>
#: best-pkging-practices.dbk:9
msgid ""
"Debian's quality is largely due to the <ulink "
"url=\"&url-debian-policy;\">Debian Policy</ulink>, which defines explicit "
"baseline requirements which all Debian packages must fulfill.  Yet there is "
"also a shared history of experience which goes beyond the Debian Policy, an "
"accumulation of years of experience in packaging.  Many very talented people "
"have created great tools, tools which help you, the Debian maintainer, "
"create and maintain excellent packages."
msgstr ""
"Debians Qualität ist größtenteils den <ulink "
"url=\"&url-debian-policy;\">Debian-Richtlinien</ulink> zu verdanken, die "
"explizit grundlegende Anforderungen definieren, die alle Debian-Pakete "
"erfüllen müssen. Bisher gibt es außerdem eine gemeinsame Geschichte der "
"Erfahrung, die hinter den Debian-Richtlinien steckt, einer Ansammlung "
"jahrelanger Erfahrung im Paketieren. Viele sehr talentierte Leute haben "
"großartige Werkzeuge geschaffen, Werkzeuge, die Ihnen als Debian-Betreuer "
"helfen, ausgezeichnete Pakete zu erstellen und zu pflegen."

#. type: Content of: <chapter><para>
#: best-pkging-practices.dbk:18
msgid ""
"This chapter provides some best practices for Debian developers.  All "
"recommendations are merely that, and are not requirements or policy.  These "
"are just some subjective hints, advice and pointers collected from Debian "
"developers.  Feel free to pick and choose whatever works best for you."
msgstr ""
"Dieses Kapitel stellt einige optimale Vorgehensweisen für Debian-Entwickler "
"vor. Das alles sind lediglich Empfehlungen und keine Anforderungen oder "
"Richtlinien. Dies sind nur einige subjektive Hinweise, Ratschläge und "
"Fingerzeige, die von Debian-Entwicklern gesammelt wurden. Suchen Sie sich "
"einfach das heraus, was Ihnen am meisten zusagt."

#. type: Content of: <chapter><section><title>
#: best-pkging-practices.dbk:24
msgid "Best practices for <filename>debian/rules</filename>"
msgstr "Optimale Vorgehensweisen für <filename>debian/rules</filename>"

#. type: Content of: <chapter><section><para>
#: best-pkging-practices.dbk:26
msgid ""
"The following recommendations apply to the <filename>debian/rules</filename> "
"file.  Since <filename>debian/rules</filename> controls the build process "
"and selects the files which go into the package (directly or indirectly), "
"it's usually the file maintainers spend the most time on."
msgstr ""
"Die folgenden Empfehlungen gelten für die Datei "
"<filename>debian/rules</filename>. Da <filename>debian/rules</filename> den "
"Build-Prozess steuert und die Dateien auswählt, die in das Paket gelangen "
"(direkt oder indirekt), ist es normerweise die Datei, der die Betreuer die "
"meiste Zeit widmen."

#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:32
msgid "Helper scripts"
msgstr "Helfer-Skripte"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:34
msgid ""
"The rationale for using helper scripts in <filename>debian/rules</filename> "
"is that they let maintainers use and share common logic among many "
"packages.  Take for instance the question of installing menu entries: you "
"need to put the file into <filename>/usr/share/menu</filename> (or "
"<filename>/usr/lib/menu</filename> for executable binary menufiles, if this "
"is needed), and add commands to the maintainer scripts to register and "
"unregister the menu entries.  Since this is a very common thing for packages "
"to do, why should each maintainer rewrite all this on their own, sometimes "
"with bugs? Also, supposing the menu directory changed, every package would "
"have to be changed."
msgstr ""
"Der Grund für die Benutzung von Helfer-Skripten in "
"<filename>debian/rules</filename> ist, dass sie den Betreuern eine geteilte "
"gemeinsame Logik inmitten vieler Pakete einräumen. Nehmen Sie zum Beispiel "
"die Frage, wie Menü-Einträge installiert werden: Sie müssen die Datei in "
"<filename>/usr/share/menu</filename> (oder <filename>/usr/lib/menu</filename> "
"für ausführbare binäre Menü-Dateien, wenn nötig) ablegen und den "
"Betreuerskripten Befehle hinzufügen, um Menü-Einträge zu registrieren bzw. "
"ihre Registrierung zu entfernen. Dies ist eine sehr häufige Tätigkeit für "
"Pakete. Warum sollte daher jeder Betreuer all dies für sich selbst neu "
"schreiben und dabei möglicherweise Fehler verursachen? Außerdem, den Fall "
"gesetzt, das Menü-Verzeichnis würde sich ändern, dann müsste jedes Paket "
"geändert werden."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:45
msgid ""
"Helper scripts take care of these issues.  Assuming you comply with the "
"conventions expected by the helper script, the helper takes care of all the "
"details.  Changes in policy can be made in the helper script; then packages "
"just need to be rebuilt with the new version of the helper and no other "
"changes."
msgstr ""
"Helfer-Skripte kümmern sich um diese Probleme. Angenommen, Sie erfüllen alle "
"Gepflogenheiten, die das Helfer-Skript erwartet, dann kümmert sich das "
"Helfer-Skript um alle Einzelheiten. Änderungen an den Richtlinien können im "
"Helfer-Skript erledigt werden. Dann müssen Pakete nur mit der neuen Version "
"des Helfer-Skripts erstellt und sonst nicht geändert werden."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:52
msgid ""
"<xref linkend=\"tools\"/> contains a couple of different helpers.  The most "
"common and best (in our opinion) helper system is <systemitem "
"role=\"package\">debhelper</systemitem>.  Previous helper systems, such as "
"<systemitem role=\"package\">debmake</systemitem>, were monolithic: you "
"couldn't pick and choose which part of the helper you found useful, but had "
"to use the helper to do everything.  <systemitem "
"role=\"package\">debhelper</systemitem>, however, is a number of separate "
"little <command>dh_*</command> programs.  For instance, "
"<command>dh_installman</command> installs and compresses man pages, "
"<command>dh_installmenu</command> installs menu files, and so on.  Thus, it "
"offers enough flexibility to be able to use the little helper scripts, where "
"useful, in conjunction with hand-crafted commands in "
"<filename>debian/rules</filename>."
msgstr ""
"<xref linkend=\"tools\"/> enthält ein paar verschiedene Helfer-Skripte. Das "
"gängigste und beste (nach Meinung von Debian) Helfersystem ist <systemitem "
"role=\"package\">debhelper</systemitem>. Verhergehende Helfersysteme, wie "
"<systemitem role=\"package\">debmake</systemitem> waren monolithisch. Sie "
"konnten nicht den Teil des Helfers herausgreifen und auswählen, den Sie "
"nützlich fanden, mussten aber den Helfer für alles benutzen. <systemitem "
"role=\"package\">debhelper</systemitem> besteht jedoch aus mehreren "
"getrennten kleinen <command>dh_*</command>-Programmen. "
"<command>dh_installman</command> installiert und komprimiert zum Beispiel "
"Handbuchseiten, <command>dh_installmenu</command> installiert Menü-Dateien "
"und so weiter. Daher bietet es eine ausreichende Flexibilität, die kleinen "
"Helfer-Skripte dort zu benutzen, wo sie nützlich sind in Verbindung mit "
"handgemachten Befehlen in <filename>debian/rules</filename>."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:66
msgid ""
"You can get started with <systemitem role=\"package\">debhelper</systemitem> "
"by reading <citerefentry> <refentrytitle>debhelper</refentrytitle> "
"<manvolnum>1</manvolnum> </citerefentry>, and looking at the examples that "
"come with the package.  <command>dh_make</command>, from the <systemitem "
"role=\"package\">dh-make</systemitem> package (see <xref "
"linkend=\"dh-make\"/>), can be used to convert a vanilla source package to a "
"<systemitem role=\"package\">debhelper</systemitem>ized package.  This "
"shortcut, though, should not convince you that you do not need to bother "
"understanding the individual <command>dh_*</command> helpers.  If you are "
"going to use a helper, you do need to take the time to learn to use that "
"helper, to learn its expectations and behavior."
msgstr ""
"Sie können mit <systemitem role=\"package\">debhelper</systemitem> anfangen, "
"indem Sie <citerefentry> <refentrytitle>debhelper</refentrytitle> "
"<manvolnum>1</manvolnum> </citerefentry> lesen und sich die Beispiele "
"ansehen, die dem Paket beigefügt sind. <command>dh_make</command> aus dem "
"Paket <systemitem role=\"package\">dh-make</systemitem> (siehe <xref "
"linkend=\"dh-make\"/>) kann benutzt werden, um ein einfaches Quellpaket in "
"ein mit <systemitem role=\"package\">debhelper</systemitem> bearbeitetes "
"Paket umzuwandeln. Gleichwohl sollte diese Kurzform Sie jedoch nicht davon "
"überzeugen, dass Sie sich nicht plagen müssen, um die einzelnen "
"<command>dh_*</command>-Helfer zu verstehen. Falls Sie einen Helfer benutzen "
"möchten, müssen Sie sich die Zeit nehmen zu lernen, wie dieser Helfer "
"benutzt wird, um zu verstehen was er erwartet und wie er sich verhält."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:79
msgid ""
"Some people feel that vanilla <filename>debian/rules</filename> files are "
"better, since you don't have to learn the intricacies of any helper system.  "
"This decision is completely up to you.  Use what works for you.  Many "
"examples of vanilla <filename>debian/rules</filename> files are available at "
"<ulink url=\"&url-rules-files;\"></ulink>."
msgstr ""
"Einige Personen sind der Ansicht, dass einfache "
"<filename>debian/rules</filename>-Dateien besser sind, da Sie nicht die "
"Feinheiten eines Helfer-Systems erlernen müssen. Diese Entscheidung liegt "
"allein bei Ihnen. Benutzen Sie das, was für Sie am besten klappt. Unter "
"<ulink url=\"&url-rules-files;\"></ulink> sind viele Beispiele für einfache "
"<filename>debian/rules</filename>-Dateien verfügbar."

#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:88
msgid "Separating your patches into multiple files"
msgstr "Unterteilen Sie Ihre Patches in mehrere Dateien"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:90
msgid ""
"Big, complex packages may have many bugs that you need to deal with.  If you "
"correct a number of bugs directly in the source, and you're not careful, it "
"can get hard to differentiate the various patches that you applied.  It can "
"get quite messy when you have to update the package to a new upstream "
"version which integrates some of the fixes (but not all).  You can't take "
"the total set of diffs (e.g., from <filename>.diff.gz</filename>) and work "
"out which patch sets to back out as a unit as bugs are fixed upstream."
msgstr ""
"Große, komplexe Pakete könnten mehrere Fehler haben, die Sie bewältigen "
"müssen. Falls Sie mehrere Fehler direkt in der Quelle beheben und nicht "
"sorgfältig vorgehen, kann es schwierig werden, die verschiedenen Patche, die "
"Sie bereitgestellt haben, zu unterscheiden. Es kann ziemlich chaotisch "
"werden, wenn Sie das Paket auf eine neue Originalversion aktualisieren "
"müssen, die einige (aber nicht alle) Reparaturen enthält. Sie können nicht "
"die komplette Zusammenstellung der Diffs nehmen (z.B. aus "
"<filename>.diff.gz</filename>) und austüfteln, welcher Patch es als Einheit "
"zurücksetzt, da Fehler im Original repariert wurden."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:99
msgid ""
"Fortunately, with the source format “3.0 (quilt)” it is now possible to keep "
"patches separate without having to modify <filename>debian/rules</filename> "
"to setup a patch system. Patches are stored in "
"<filename>debian/patches/</filename> and when the source package is unpacked "
"patches listed in <filename>debian/patches/series</filename> are "
"automatically applied.  As the name implies, patches can be managed with "
"<command>quilt</command>."
msgstr ""
"Glücklicherweise ist es nun mit dem Quellformat »3.0 (quilt)« möglich, die "
"Patche getrennt zu halten ohne <filename>debian/rules</filename> zur "
"Einrichtung eines Patch-Systems ändern zu müssen. Patche werden in "
"<filename>debian/patches/</filename> gespeichert und wenn das Quellpaket "
"entpackt wird, werden automatisch die Patches angewandt, die in "
"<filename>debian/patches/series</filename> aufgeführt sind. Wie der Name "
"schon sagt, können Patches mit <command>quilt</command> verwaltet werden."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:107
msgid ""
"When using the older source “1.0”, it's also possible to separate patches "
"but a dedicated patch system must be used: the patch files are shipped "
"within the Debian patch file (<filename>.diff.gz</filename>), usually within "
"the <filename>debian/</filename> directory. The only difference is that they "
"aren't applied immediately by <command>dpkg-source</command>, but by the "
"<literal>build</literal> rule of <filename>debian/rules</filename>, through "
"a dependency on the <literal>patch</literal> rule.  Conversely, they are "
"reverted in the <literal>clean</literal> rule, through a dependency on the "
"<literal>unpatch</literal> rule."
msgstr ""
"Wenn Sie die ältere Quelle »1.0« verwenden, ist es auch möglich, Patche zu "
"trennen, aber es muss ein zugehöriges Patch-System verwandt werden: Die "
"Patch-Dateien werden innerhalb der Debian-Patch-Datei "
"(<filename>.diff.gz</filename>) mitgeliefert, normalerweise im Verzeichnis "
"<filename>debian/</filename>. Der einzige Unterschied ist, dass sie nicht "
"unmittelbar von <command>dpkg-source</command> angewandt werden, sondern "
"von der <literal>build</literal>-Regel der Datei "
"<filename>debian/rules</filename> durch eine Abhängigkeit in der "
"<literal>patch</literal>-Regel. Im Gegenzug werden sie von der Regel "
"<literal>clean</literal> durch eine Abhängigkeit zur Regel "
"<literal>unpatch</literal> umgekehrt."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:119
msgid ""
"<command>quilt</command> is the recommended tool for this.  It does all of "
"the above, and also allows to manage patch series.  See the <systemitem "
"role=\"package\">quilt</systemitem> package for more information."
msgstr ""
"<command>quilt</command> ist das dafür empfohlene Werkzeug. Es erledigt alles "
"oben beschriebene und ermöglicht außerdem die Verwaltung von Patch-Serien. "
"Weitere Informationen finden Sie im Paket <systemitem "
"role=\"package\">quilt</systemitem>."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:125
msgid ""
"There are other tools to manage patches, like <command>dpatch</command>, and "
"the patch system integrated with <systemitem "
"role=\"package\">cdbs</systemitem>."
msgstr ""
"Es gibt noch andere Werkzeuge, um Patches zu verwalten, wie "
"<command>dpatch</command> und das in <systemitem "
"role=\"package\">cdbs</systemitem> eingebaute Patch-System."

#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:132
msgid "Multiple binary packages"
msgstr "Pakete mit mehreren Binärdateien"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:134
msgid ""
"A single source package will often build several binary packages, either to "
"provide several flavors of the same software (e.g., the <systemitem "
"role=\"package\">vim</systemitem> source package) or to make several small "
"packages instead of a big one (e.g., so the user can install only the subset "
"needed, and thus save some disk space)."
msgstr ""
"Ein einzelnes Quellpaket wird oft mehrere Binärpakete erstellen, entweder um "
"mehrere Geschmacksrichtungen der gleichen Software bereitzustellen (z.B. das "
"<systemitem role=\"package\">vim</systemitem>-Quellpaket) oder um mehrere "
"kleine Pakete anstelle eines einzelnen großen zu erzeugen (z,B. damit der "
"Benutzer nur die benötigte Untermenge installieren kann und dadurch "
"Plattenplatz spart)."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:141
msgid ""
"The second case can be easily managed in <filename>debian/rules</filename>.  "
"You just need to move the appropriate files from the build directory into "
"the package's temporary trees.  You can do this using "
"<command>install</command> or <command>dh_install</command> from <systemitem "
"role=\"package\">debhelper</systemitem>.  Be sure to check the different "
"permutations of the various packages, ensuring that you have the "
"inter-package dependencies set right in <filename>debian/control</filename>."
msgstr ""
"Der zweite Fall kann einfach in <filename>debian/rules</filename> verwaltet "
"werden. Sie müssen nur die entsprechenden Dateien aus dem Build-Verzeichnis "
"in die entsprechenden temporären Baumstrukturen des Pakets verschieben. Dies "
"können Sie mit <command>install</command> oder <command>dh_install</command> "
"aus <systemitem role=\"package\">debhelper</systemitem> erledigen. Sorgen Sie "
"dafür, dass Sie die unterschiedlichen Umsetzungen der verschiedenen Pakete "
"prüfen, um sicherzustellen, dass Sie die wechselseitigen Abhängigkeiten "
"in <filename>debian/control</filename> richtig gesetzt haben."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:150
msgid ""
"The first case is a bit more difficult since it involves multiple recompiles "
"of the same software but with different configuration options.  The "
"<systemitem role=\"package\">vim</systemitem> source package is an example "
"of how to manage this using an hand-crafted "
"<filename>debian/rules</filename> file."
msgstr ""
"Der erste Fall ist etwas schwieriger, da er mehrmaliges Neukompilieren der "
"selben Software einschließt, aber mit unterschiedlichen "
"Konfigurationsoptionen. Das <systemitem "
"role=\"package\">vim</systemitem>-Quellpaket ist ein Beispiel dafür, wie dies "
"mit einer handgemachten <filename>debian/rules</filename>-Datei verwaltet "
"wird."

#. type: Content of: <chapter><section><title>
#: best-pkging-practices.dbk:162
msgid "Best practices for <filename>debian/control</filename>"
msgstr "Optimale Vorgehensweisen für <filename>debian/control</filename>"

#. type: Content of: <chapter><section><para>
#: best-pkging-practices.dbk:164
msgid ""
"The following practices are relevant to the "
"<filename>debian/control</filename> file.  They supplement the <ulink "
"url=\"&url-debian-policy;ch-binary.html#s-descriptions\">Policy on package "
"descriptions</ulink>."
msgstr ""
"Die folgenden Vorgehensweisen sind maßgeblich für die Datei "
"<filename>debian/control</filename>. Sie ergänzen die <ulink "
"url=\"&url-debian-policy;ch-binary.html#s-descriptions\">Richtlinien für "
"Paketbeschreibungen</ulink>."

#. type: Content of: <chapter><section><para>
#: best-pkging-practices.dbk:170
msgid ""
"The description of the package, as defined by the corresponding field in the "
"<filename>control</filename> file, contains both the package synopsis and "
"the long description for the package.  <xref linkend=\"bpp-desc-basics\"/> "
"describes common guidelines for both parts of the package description.  "
"Following that, <xref linkend=\"bpp-pkg-synopsis\"/> provides guidelines "
"specific to the synopsis, and <xref linkend=\"bpp-pkg-desc\"/> contains "
"guidelines specific to the description."
msgstr ""
"Die Beschreibung des Pakets, wie sie durch das entsprechende Feld in der "
"Datei <filename>control</filename> definiert wird, enthält sowohl die "
"Paketübersicht, als auch die ausführliche Beschreibung des Pakets. <xref "
"linkend=\"bpp-desc-basics\"/> beschreibt übliche Richtlinien für beide Teile "
"der Paketbeschreibung. Diesen folgend stellt  <xref "
"linkend=\"bpp-pkg-synopsis\"/> Richtlinien speziell für die Übersicht bereit "
"und <xref linkend=\"bpp-pkg-desc\"/> enthält spezielle Richtlinien für die "
"Beschreibung."

#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:179
msgid "General guidelines for package descriptions"
msgstr "Allgemeine Richtlinien für Paketbeschreibungen"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:181
msgid ""
"The package description should be written for the average likely user, the "
"average person who will use and benefit from the package.  For instance, "
"development packages are for developers, and can be technical in their "
"language.  More general-purpose applications, such as editors, should be "
"written for a less technical user."
msgstr ""
"Die Paketbeschreibung sollte für den erwarteten Durchschnittsanwender "
"geschrieben werden, der Durchschnittsperson, die das Paket benutzt und davon "
"profitiert. Entwicklungspakete sind beispielsweise für Entwickler und können "
"in einer technischen Sprache verfasst werden. Anwendungen für allgemeinere "
"Zwecke, wie Editoren, sollten für Anwender mit weniger technischem "
"Verständnis geschrieben werden."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:188
msgid ""
"Our review of package descriptions lead us to conclude that most package "
"descriptions are technical, that is, are not written to make sense for "
"non-technical users.  Unless your package really is only for technical "
"users, this is a problem."
msgstr ""
"Die Durchsicht der Paketbeschreibungen mündet in der Schlussfolgerung, dass "
"die meisten Paketbeschreibungen technischer Natur sind, also nicht so "
"geschrieben, das sie für Anwender ohne technischen Hintergrund einen Sinn "
"ergeben. Sofern Ihr Paket nicht wirklich für technikkundige Anwender ist, ist "
"dies ein Problem."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:194
msgid ""
"How do you write for non-technical users? Avoid jargon.  Avoid referring to "
"other applications or frameworks that the user might not be familiar with — "
"GNOME or KDE is fine, since users are probably familiar with these terms, "
"but GTK+ is probably not.  Try not to assume any knowledge at all.  If you "
"must use technical terms, introduce them."
msgstr ""
"Wie können sie für nicht technikkundige Anwender schreiben? Vermeiden Sie "
"Fachsprache. Vermeiden Sie, sich auf Anwendungen und Rahmenwerke zu beziehen, "
"mit denen der Anwender möglicherweise nicht vertraut ist – GNOME oder KDE "
"sind in Ordnung, da Anwender wahrscheinlich mit diesen Begriffen vertraut "
"sind, aber GTK+ vermutlich nicht. Versuchen Sie nicht irgendein Wissen "
"vorauszusetzen, geben Sie eine Einführung."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:201
msgid ""
"Be objective.  Package descriptions are not the place for advocating your "
"package, no matter how much you love it.  Remember that the reader may not "
"care about the same things you care about."
msgstr ""
"Seien Sie objektiv. Paketbeschreibungen sind nicht der richtige Ort, um Ihr "
"Paket zu verfechten, egal wie Sie sehr sie es mögen. Denken Sie daran, dass "
"der Leser nicht die gleichen Dinge wichtig nimmt, wie Sie."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:206
msgid ""
"References to the names of any other software packages, protocol names, "
"standards, or specifications should use their canonical forms, if one "
"exists.  For example, use X Window System, X11, or X; not X Windows, "
"X-Windows, or X Window.  Use GTK+, not GTK or gtk.  Use GNOME, not Gnome.  "
"Use PostScript, not Postscript or postscript."
msgstr ""
"Bezüge zu Namen anderer Softwarepakete, Protokollnamen, Standards oder "
"Spezifikationen sollten, falls sie existiert, in ihrer vorschriftsmäßigen "
"Form verwandt werden. Benutzen Sie zum Beispiel X Window System, X11 oder X, "
"nicht X Windows, X-Windows, or X Window. Benutzen Sie GTK+, nicht GTK oder "
"gtk. Benutzen Sie GNOME nicht Gnome. Benutzen Sie PostScript, nicht "
"Postscript oder postscript."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:213
msgid ""
"If you are having problems writing your description, you may wish to send it "
"along to &email-debian-l10n-english; and request feedback."
msgstr ""
"Falls Sie Probleme beim Verfassen Ihrer Beschreibung haben, könnten Sie sie "
"an &email-debian-l10n-english; senden und um Rückmeldung ersuchen."

#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:219
msgid "The package synopsis, or short description"
msgstr "Die Paketübersicht oder Kurzbeschreibung"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:221
msgid ""
"Policy says the synopsis line (the short description) must be concise, not "
"repeating the package name, but also informative."
msgstr ""
"Die Richtlinie sagt, die Übersichtszeile (die Kurzbeschreibung) muss kurz "
"sein, darf den Paketnamen nicht wiederholen, muss aber auch informativ sein."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:225
# s/as/is/
msgid ""
"The synopsis functions as a phrase describing the package, not a complete "
"sentence, so sentential punctuation is inappropriate: it does not need extra "
"capital letters or a final period (full stop). It should also omit any "
"initial indefinite or definite article — \"a\", \"an\", or \"the\". Thus for "
"instance:"
msgstr ""
"Die Übersichtsfunktionen ist ein Ausdruck, der das Paket beschreibt, kein "
"kompletter Satz, daher ist Zeichensetzung unangebracht: Es wird weder eine "
"besondere Großschreibung noch ein abschließender Punkt benötigt. Außerdem "
"sollten jegliche bestimmten und unbestimmten Artikel am Anfang weggelassen "
"werden – »a«, »an« oder »the«. Deshalb zum Beispiel:"

#. type: Content of: <chapter><section><section><screen>
#: best-pkging-practices.dbk:231
#, no-wrap
msgid ""
"Package: libeg0\n"
"Description: exemplification support library\n"
msgstr ""
"Package: libeg0\n"
"Description: exemplification support library\n"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:235
msgid ""
"Technically this is a noun phrase minus articles, as opposed to a verb "
"phrase.  A good heuristic is that it should be possible to substitute the "
"package <replaceable>name</replaceable> and "
"<replaceable>synopsis</replaceable> into this formula:"
msgstr ""
"Technisch gesehen ist dies eine Nominalphrase im Gegensatz zu einer "
"Verbalphrase. Eine gute Entscheidungsregel ist, dass es möglich sein sollte, "
"den Paket-<replaceable>Namen</replaceable> und die "
"<replaceable>Übersicht</replaceable> in diesem Schema zu ersetzen:"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:240
msgid ""
"The package <replaceable>name</replaceable> provides {a,an,the,some} "
"<replaceable>synopsis</replaceable>."
msgstr ""
"The package <replaceable>Name</replaceable> provides {a,an,the,some} "
"<replaceable>Übersicht</replaceable>."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:244
msgid ""
"Sets of related packages may use an alternative scheme that divides the "
"synopsis into two parts, the first a description of the whole suite and the "
"second a summary of the package's role within it:"
msgstr ""
"Zusammenstellungen verwandter Pakete können ein alternatives Schema benutzen, "
"das die Übersicht in zwei Teile unterteilt, als erstes eine Beschreibung der "
"ganzen Suite und als zweites eine Zusammenfassung der Rolle, die das Paket "
"darin spielt:"

#. type: Content of: <chapter><section><section><screen>
#: best-pkging-practices.dbk:249
#, no-wrap
msgid ""
"Package: eg-tools\n"
"Description: simple exemplification system (utilities)\n"
"\t\t\t              \n"
"Package: eg-doc\n"
"Description: simple exemplification system - documentation\n"
msgstr ""
"Package: eg-tools\n"
"Description: simple exemplification system (utilities)\n"
"\t\t\t              \n"
"Package: eg-doc\n"
"Description: simple exemplification system - documentation\n"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:256
msgid ""
"These synopses follow a modified formula. Where a package "
"\"<replaceable>name</replaceable>\" has a synopsis "
"\"<replaceable>suite</replaceable> (<replaceable>role</replaceable>)\" or "
"\"<replaceable>suite</replaceable> - <replaceable>role</replaceable>\", the "
"elements should be phrased so that they fit into the formula:"
msgstr ""
"Diese Übersicht folgt einem geänderten Schema. Wo ein Paket "
"»<replaceable>Name</replaceable>« die Übersicht "
"»<replaceable>Suite</replaceable> (<replaceable>Rolle</replaceable>)« oder "
"»<replaceable>Suite</replaceable> - <replaceable>Rolle</replaceable>« hat, "
"sollten die Elemente so ausgedrückt werden, dass sie in dieses Schema passen:"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:263
msgid ""
"The package <replaceable>name</replaceable> provides {a,an,the} "
"<replaceable>role</replaceable> for the <replaceable>suite</replaceable>."
msgstr ""
"The package <replaceable>name</replaceable> provides {a,an,the} "
"<replaceable>role</replaceable> for the <replaceable>suite</replaceable>."

#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:269
msgid "The long description"
msgstr "Die ausführliche Beschreibung"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:271
msgid ""
"The long description is the primary information available to the user about "
"a package before they install it.  It should provide all the information "
"needed to let the user decide whether to install the package.  Assume that "
"the user has already read the package synopsis."
msgstr ""
"Die ausführliche Beschreibung ist die wichtigste für den Benutzer verfügbare "
"Information über ein Paket, bevor er es installiert. Sie sollte alle nötigen "
"Informationen bereitstellen, damit der Anwender entscheiden kann, ob er das "
"Paket installiert. Es ist anzunehmen, dass der Benutzer bereits die "
"Paketübersicht gelesen hat."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:277
msgid "The long description should consist of full and complete sentences."
msgstr "Die ausführliche Beschreibung sollte aus vollständigen Sätzen bestehen."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:280
msgid ""
"The first paragraph of the long description should answer the following "
"questions: what does the package do? what task does it help the user "
"accomplish? It is important to describe this in a non-technical way, unless "
"of course the audience for the package is necessarily technical."
msgstr ""
"Der erste Absatz der ausführlichen Beschreibung sollte die folgenden Fragen "
"beantworten: Was tut das Paket? Bei welchen Aufgaben hilft es dem Anwender? "
"Es ist wichtig dies auf eine nicht technische Weise zu beschreiben, sogar "
"dann, wenn die Zielgruppe des Pakets notwendigerweise einen technischen "
"Hintergrund hat."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:286
msgid ""
"The following paragraphs should answer the following questions: Why do I as "
"a user need this package? What other features does the package have? What "
"outstanding features and deficiencies are there compared to other packages "
"(e.g., if you need X, use Y instead)? Is this package related to other "
"packages in some way that is not handled by the package manager (e.g., this "
"is the client for the foo server)?"
msgstr ""
"Die folgenden Absätze sollten die folgenden Fragen beantworten: Warum "
"benötige ich als Benutzer dieses Paket? Welche anderen Funktionen bietet das "
"Paket? Welche herausragenden Funktionen und Mängel gibt es im Vergleich zu "
"anderen Paketen (z.B. falls Sie X benötigen, benutzen Sie Y)? Steht das Paket "
"in einem Zusammenhang mit anderen Paketen, die nicht vom Paketmanager "
"gehandhabt werden (z.B. ist dies der Client für den Foo-Server)?"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:294
msgid ""
"Be careful to avoid spelling and grammar mistakes.  Ensure that you "
"spell-check it.  Both <command>ispell</command> and "
"<command>aspell</command> have special modes for checking "
"<filename>debian/control</filename> files:"
msgstr ""
"Seien Sie vorsichtig, um Rechtschreib- und Grammatikfehler zu vermeiden. "
"Sorgen Sie für eine Rechtschreibprüfung. Sowohl <command>ispell</command> als "
"auch <command>aspell</command> haben spezielle Modi zur Prüfung von "
"<filename>debian/control</filename>-Dateien:"

#. type: Content of: <chapter><section><section><screen>
#: best-pkging-practices.dbk:299
#, no-wrap
msgid "ispell -d american -g debian/control\n"
msgstr "ispell -d american -g debian/control\n"

#. type: Content of: <chapter><section><section><screen>
#: best-pkging-practices.dbk:302
#, no-wrap
msgid "aspell -d en -D -c debian/control\n"
msgstr "aspell -d en -D -c debian/control\n"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:305
msgid ""
"Users usually expect these questions to be answered in the package "
"description:"
msgstr ""
"Anwender erwarten normalerweise, dass diese Fragen in der Paketbeschreibung "
"beantwortet werden:"

#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
#: best-pkging-practices.dbk:310
msgid ""
"What does the package do? If it is an add-on to another package, then the "
"short description of the package we are an add-on to should be put in here."
msgstr ""
"Was tut das Paket? Falls es eine Erweiterung eines anderen Pakets ist, dann "
"sollte eines Kurzbeschreibung des Pakets, das es erweitert, hier eingefügt "
"werden."

#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
#: best-pkging-practices.dbk:316
msgid ""
"Why should I want this package? This is related to the above, but not the "
"same (this is a mail user agent; this is cool, fast, interfaces with PGP and "
"LDAP and IMAP, has features X, Y, and Z)."
msgstr ""
"Warum sollte ich dieses Paket wollen? Dies bezieht sich auf das "
"vorhergehende, aber nicht das gleiche (dies ist ein Mail-Client. Er ist toll, "
"schnell, hat Schnittstellen zu PGP, LDAP und IMAP, hat die Funktionen X, Y "
"und Z)."

#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
#: best-pkging-practices.dbk:323
msgid ""
"If this package should not be installed directly, but is pulled in by "
"another package, this should be mentioned."
msgstr ""
"Falls dieses Paket nicht direkt installiert werden sollte, sondern von einem "
"anderen Paket mitinstalliert wird, sollte die erwähnt werden."

#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
#: best-pkging-practices.dbk:329
msgid ""
"If the package is <literal>experimental</literal>, or there are other "
"reasons it should not be used, if there are other packages that should be "
"used instead, it should be here as well."
msgstr ""
"Falls das Paket <literal>experimental</literal> ist oder es andere Gründe "
"gibt, weshalb es nicht benutzt werden sollte und wenn es andere Pakete gibt, "
"die stattdessen benutzt werden sollen, sollte dies auch hier stehen."

#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
#: best-pkging-practices.dbk:336
msgid ""
"How is this package different from the competition? Is it a better "
"implementation? more features? different features? Why should I choose this "
"package."
msgstr ""
"Was unterscheidet dieses Paket von der Konkurrenz? Ist es eine bessere "
"Implementierung? Mehr Funktionen? Andere Funktionen? Warum sollte die Wahl "
"auf dieses Paket fallen?"

#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:349
msgid "Upstream home page"
msgstr "Homepage der Originalautoren"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:351
msgid ""
"We recommend that you add the URL for the package's home page in the "
"<literal>Homepage</literal> field of the <literal>Source</literal> section "
"in <filename>debian/control</filename>.  Adding this information in the "
"package description itself is considered deprecated."
msgstr ""
"Es wird empfohlen, dass Sie die URL der Homepage des Pakets in das Feld "
"<literal>Homepage</literal> im Abschnitt <literal>Source</literal> von "
"<filename>debian/control</filename> hinzufügen. Diese Information in die "
"Paketbeschreibung selbst einzutragen, wird als missbilligt angesehen."

#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:359
msgid "Version Control System location"
msgstr "Ort des Versionsverwaltungssystems"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:361
msgid ""
"There are additional fields for the location of the Version Control System "
"in <filename>debian/control</filename>."
msgstr ""
"Es gibt zusätzliche Felder für den Ort des Versionsverwaltungssystems in "
"<filename>debian/control</filename>."

#. type: Content of: <chapter><section><section><section><title>
#: best-pkging-practices.dbk:365
msgid "Vcs-Browser"
msgstr "Vcs-Browser"

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:367
msgid ""
"Value of this field should be a <literal>http://</literal> URL pointing to a "
"web-browsable copy of the Version Control System repository used to maintain "
"the given package, if available."
msgstr ""
"Der Wert dieses Feldes sollte eine <literal>http://</literal>-URL sein, die "
"auf eine via Web durchstöberbare Kopie des Versionsverwaltungssystems-Depots "
"verweist, das benutzt wird, um das angegebene Paket zu verwalten, falls "
"verfügbar."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:372
msgid ""
"The information is meant to be useful for the final user, willing to browse "
"the latest work done on the package (e.g.  when looking for the patch fixing "
"a bug tagged as <literal>pending</literal> in the bug tracking system)."
msgstr ""
"Die Information ist dazu gedacht, dem Endanwender zu nutzen, der gewillt ist, "
"die letzte am Paket geleistete Arbeit zu durchstöbern (z.B. wenn nach einem "
"Patch gesucht wird, der einen Fehler behebt, der in der Fehlerdatenbank als "
"<literal>pending</literal> gekennzeichnet ist)."

#. type: Content of: <chapter><section><section><section><title>
#: best-pkging-practices.dbk:379
msgid "Vcs-*"
msgstr "Vcs-*"

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:381
msgid ""
"Value of this field should be a string identifying unequivocally the "
"location of the Version Control System repository used to maintain the given "
"package, if available.  <literal>*</literal> identify the Version Control "
"System; currently the following systems are supported by the package "
"tracking system: <literal>arch</literal>, <literal>bzr</literal> (Bazaar), "
"<literal>cvs</literal>, <literal>darcs</literal>, <literal>git</literal>, "
"<literal>hg</literal> (Mercurial), <literal>mtn</literal> (Monotone), "
"<literal>svn</literal> (Subversion).  It is allowed to specify different VCS "
"fields for the same package: they will all be shown in the PTS web "
"interface."
msgstr ""
"Der Wert dieses Feldes sollte eine Zeichenkette sein, die den Ort des "
"Versionsverwaltungssystem-Depots eindeutig identifiziert, das zur Verwaltung "
"des angegebenen Pakets benutzt wird, falls verfügbar. <literal>*</literal> "
"identifiziert das Versionsverwaltungssystem. Aktuell werden die folgenden vom "
"Paketverfolgungssystem unterstützt: <literal>arch</literal>, "
"<literal>bzr</literal> (Bazaar), <literal>cvs</literal>, "
"<literal>darcs</literal>, <literal>git</literal>, <literal>hg</literal> "
"(Mercurial), <literal>mtn</literal> (Monotone) und <literal>svn</literal> "
"(Subversion). Es ist erlaubt, mehrere unterschiedliche "
"Versionsverwaltungssystem-Felder für das gleiche Paket anzugeben: Sie werden "
"alle auf der PTS-Web-Schnittstelle angezeigt."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:392
msgid ""
"The information is meant to be useful for a user knowledgeable in the given "
"Version Control System and willing to build the current version of a package "
"from the VCS sources.  Other uses of this information might include "
"automatic building of the latest VCS version of the given package.  To this "
"end the location pointed to by the field should better be version agnostic "
"and point to the main branch (for VCSs supporting such a concept).  Also, "
"the location pointed to should be accessible to the final user; fulfilling "
"this requirement might imply pointing to an anonymous access of the "
"repository instead of pointing to an SSH-accessible version of the same."
msgstr ""
"Die Information ist für Benutzer bestimmt, die im gegebenen "
"Versionsverwaltungssystem sachkundig sind und bereit, die aktuelle Version "
"des Pakets aus den VCS-Quellen zu erstellen. Andere Nutzungen dieser "
"Information könnten das automatische Erstellen der letzen VCS-Version des "
"Pakets umfassen. Dazu sollte der vom Feld angegebene Ort, die Version nicht "
"kennen und auf den Hauptzweig zeigen (bei Versionsverwaltungssystemen, die "
"dieses Konzept unterstützen). Außerdem sollte der Endanwender auf den Ort, "
"auf den verwiesen wird, zugreifen können. Die Erfüllung dieser Anforderungen "
"könnte einen anonymen Zugriff voraussetzen, statt auf eine Version davon zu "
"verweisen, auf die über SSH zugegriffen wird."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:403
msgid ""
"In the following example, an instance of the field for a Subversion "
"repository of the <systemitem role=\"package\">vim</systemitem> package is "
"shown.  Note how the URL is in the <literal>svn://</literal> scheme (instead "
"of <literal>svn+ssh://</literal>) and how it points to the "
"<filename>trunk/</filename> branch.  The use of the "
"<literal>Vcs-Browser</literal> and <literal>Homepage</literal> fields "
"described above is also shown."
msgstr ""
"Im folgenden Beispiel wird ein Fall von einem Feld eines Subversions-Depots "
"des Pakets <systemitem role=\"package\">vim</systemitem> gezeigt. Beachten "
"Sie, wie die URL im <literal>svn://</literal>-Schema aufgebaut ist (im "
"Gegensatz zu <literal>svn+ssh://</literal>) und wie sie auf den Zweig "
"<filename>trunk/</filename> zeigt. Außerdem wird die Benutzung der Felder "
"<literal>Vcs-Browser</literal> und <literal>Homepage</literal>, wie oben "
"beschrieben, ebenfalls gezeigt."

#. type: Content of: <chapter><section><section><section><screen>
#: best-pkging-practices.dbk:412
#, no-wrap
msgid ""
"  Source: vim\n"
"  Section: editors\n"
"  Priority: optional\n"
"  &lt;snip&gt;\n"
"  Vcs-Svn: svn://svn.debian.org/svn/pkg-vim/trunk/packages/vim\n"
"  Vcs-Browser: http://svn.debian.org/wsvn/pkg-vim/trunk/packages/vim\n"
"  Homepage: http://www.vim.org\n"
msgstr ""
"  Source: vim\n"
"  Section: editors\n"
"  Priority: optional\n"
"  &lt;snip&gt;\n"
"  Vcs-Svn: svn://svn.debian.org/svn/pkg-vim/trunk/packages/vim\n"
"  Vcs-Browser: http://svn.debian.org/wsvn/pkg-vim/trunk/packages/vim\n"
"  Homepage: http://www.vim.org\n"

#. type: Content of: <chapter><section><title>
#: best-pkging-practices.dbk:427
msgid "Best practices for <filename>debian/changelog</filename>"
msgstr "Optimale Vorgehensweisen für <filename>debian/changelog</filename>"

#. type: Content of: <chapter><section><para>
#: best-pkging-practices.dbk:429
msgid ""
"The following practices supplement the <ulink "
"url=\"&url-debian-policy;ch-docs.html#s-changelogs\">Policy on changelog "
"files</ulink>."
msgstr ""
"Die folgenden Vorgehensweisen ergänzen die <ulink "
"url=\"&url-debian-policy;ch-docs.html#s-changelogs\">Richtlinien für "
"Änderungsprotokolldateien</ulink>."

#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:434
msgid "Writing useful changelog entries"
msgstr "Verfassen nützlicher Änderungsprotokolleinträge"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:436
msgid ""
"The changelog entry for a package revision documents changes in that "
"revision, and only them.  Concentrate on describing significant and "
"user-visible changes that were made since the last version."
msgstr ""
"Der Änderungsprotokolleintrag einer Paketüberarbeitung dokumentiert "
"Änderungen in nur dieser Überarbeitung. Der Schwerpunkt liegt auf der "
"Beschreibung bedeutender und für den Anwender sichtbarer Änderungen, die seit "
"der letzten Version vorgenommen wurden."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:441
msgid ""
"Focus on <emphasis>what</emphasis> was changed — who, how and when are "
"usually less important.  Having said that, remember to politely attribute "
"people who have provided notable help in making the package (e.g., those who "
"have sent in patches)."
msgstr ""
"Der Fokus liegt darauf, <emphasis>was</emphasis> geändert wurde – wer, wie "
"und wann ist normalerweise nicht so wichtig. Erinnern Sie gleichwohl höflich "
"an die Leute, die merklich Hilfe beim Erstellen des Pakets geleistet haben "
"(die z.B. Patche gesandt haben)."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:447
msgid ""
"There's no need to elaborate the trivial and obvious changes.  You can also "
"aggregate several changes in one entry.  On the other hand, don't be overly "
"terse if you have undertaken a major change.  Be especially clear if there "
"are changes that affect the behaviour of the program.  For further "
"explanations, use the <filename>README.Debian</filename> file."
msgstr ""
"Es ist nicht nötig, die belanglosen und offensichtlichen Änderungen näher "
"auszuführen. Sie können außerdem mehrere Änderungen in einem Eintrag "
"zusammenfassen. Fassen Sie sich andererseits nicht zu kurz, falls Sie eine "
"größere Änderung vorgenommen haben. Stellen Sie insbesondere klar, falls es "
"Änderungen gibt, die das Verhalten des Programms ändern. Benutzen Sie für "
"weitere Erklärungen die Datei <filename>README.Debian</filename>."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:454
msgid ""
"Use common English so that the majority of readers can comprehend it.  Avoid "
"abbreviations, tech-speak and jargon when explaining changes that close "
"bugs, especially for bugs filed by users that did not strike you as "
"particularly technically savvy.  Be polite, don't swear."
msgstr ""
"Benutzen Sie geläufiges Englisch, so dass die Mehrheit der Leser es begreifen "
"kann. Vermeiden Sie Abkürzungen, technische Begriffe und Fachsprache, wenn "
"Sie Änderungen erklären, die Fehlerberichte schließen, insbesondere bei "
"Fehlern, die von Anwendern eingereicht wurden, die Ihnen als technisch "
"unerfahren aufgefallen sind. Seien Sie höflich, fluchen Sie nicht."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:460
msgid ""
"It is sometimes desirable to prefix changelog entries with the names of the "
"files that were changed.  However, there's no need to explicitly list each "
"and every last one of the changed files, especially if the change was small "
"or repetitive.  You may use wildcards."
msgstr ""
"Manchmal ist es wünschenswert, den Änderungsprotokolleinträgen die Namen der "
"Dateien voranzustellen, die geändert wurden. Es ist jedoch nicht nötig, "
"explizit jede einzelne geänderte Datei aufzuführen, insbesondere dann nicht, "
"wenn die Änderung klein oder wiederholend war. Sie können Platzhalter "
"verwenden."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:466
msgid ""
"When referring to bugs, don't assume anything.  Say what the problem was, "
"how it was fixed, and append the closes: #nnnnn string.  See <xref "
"linkend=\"upload-bugfix\"/> for more information."
msgstr ""
"Treffen Sie keine Annahmen, wenn Sie sich auf Fehler beziehen. Sagen Sie, "
"welches Problem vorlag, wie es behoben wurde und hängen Sie die Zeichenkette "
"»closes: #nnnnn« an. Weitere Informatioenn erhalten Sie unter <xref "
"linkend=\"upload-bugfix\"/>."

#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:473
msgid "Common misconceptions about changelog entries"
msgstr "Häufige Missverständnisse über Änderungsprotokolleinträge"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:475
msgid ""
"The changelog entries should <emphasis role=\"strong\">not</emphasis> "
"document generic packaging issues (Hey, if you're looking for foo.conf, it's "
"in /etc/blah/.), since administrators and users are supposed to be at least "
"remotely acquainted with how such things are generally arranged on Debian "
"systems.  Do, however, mention if you change the location of a configuration "
"file."
msgstr ""
"Die Änderungsprotokolleinträge sollten <emphasis "
"role=\"strong\">keine</emphasis> allgemeinen Paketierungsthemen dokumentieren "
"(Hey, falls Sie die Foo.conf suchen, die ist in /etc/blah/.), da von "
"Administratoren und Anwendern angenommen wird, dass sie zumindest entfernt "
"damit vertraut sind, wie solche Dinge im Allgemeinen auf Debian-Systemen "
"eingerichtet sind. Erwähnen Sie jedoch, wenn Sie den Ort einer "
"Konfigurationsdatei ändern."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:483
msgid ""
"The only bugs closed with a changelog entry should be those that are "
"actually fixed in the same package revision.  Closing unrelated bugs in the "
"changelog is bad practice.  See <xref linkend=\"upload-bugfix\"/>."
msgstr ""
"Die einzigen Fehler, die mit einem Änderungsprotokolleintrag geschlossen "
"werden, sollten Fehler sein, die tatsächlich in der gleichen Überarbeitung "
"des Pakets behoben werden. Das Schließen von Fehlern ohne Bezug dazu, ist "
"eine falsche Vorgehensweise. Siehe <xref linkend=\"upload-bugfix\"/>."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:488
msgid ""
"The changelog entries should <emphasis role=\"strong\">not</emphasis> be "
"used for random discussion with bug reporters (I don't see segfaults when "
"starting foo with option bar; send in more info), general statements on "
"life, the universe and everything (sorry this upload took me so long, but I "
"caught the flu), or pleas for help (the bug list on this package is huge, "
"please lend me a hand).  Such things usually won't be noticed by their "
"target audience, but may annoy people who wish to read information about "
"actual changes in the package.  See <xref linkend=\"bug-answering\"/> for "
"more information on how to use the bug tracking system."
msgstr ""
"Die Änderungsprotokolleinträge sollten <emphasis "
"role=\"strong\">nicht</emphasis> für zufällige Diskussionen mit Leuten, die "
"Fehler melden (Ich kann keine Schutzverletzungen sehen, wenn ich Foo mit der "
"Option Bar starte. Senden Sie weitere Informationen.), allgemeine Äußerungen "
"über das Leben, das Universum und alles mögliche (Entschuldigung, dass der "
"Upload so lange brauchte, aber ich hatte die Grippe.) oder Hilfeersuchen (Die "
"Fehlerliste für dieses Paket ist riesig, bitte packen Sie mit an) benutzt "
"werden. Solche Dinge werden normalerweise nicht von Ihrer Zielgruppe bemerkt, "
"könnten aber viele Leute stören, die Informationen über tatsächliche "
"Änderungen am Paket lesen möchten. Weitere Informationen über die Benutzung "
"der Fehlerdatenbank finden Sie unter <xref linkend=\"bug-answering\"/>."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:499
msgid ""
"It is an old tradition to acknowledge bugs fixed in non-maintainer uploads "
"in the first changelog entry of the proper maintainer upload.  As we have "
"version tracking now, it is enough to keep the NMUed changelog entries and "
"just mention this fact in your own changelog entry."
msgstr ""
"Es ist ein alter Brauch im ersten regulären Upload des Paketbetreuers das "
"Beheben von Fehlern durch Non-Maintainer-Uploads zu bestätigen. Da Debian nun "
"über eine Versionsverwaltung verfügt, reicht es aus, die "
"NMU-Änderungsprotokolleinträge aufzubewahren und diese Tatsache nur in Ihrem "
"eigenen Änderungsprotokolleintrag zu erwähnen."

#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:507
msgid "Common errors in changelog entries"
msgstr "Häufige Fehler in Änderungsprotokolleinträgen"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:509
msgid ""
"The following examples demonstrate some common errors or examples of bad "
"style in changelog entries."
msgstr ""
"Die folgenden Beispiele demonstrieren einige häufige Fehler oder Beispiele "
"für schlechten Stil in Änderungsprotokolleinträgen."

#. type: Content of: <chapter><section><section><screen>
#: best-pkging-practices.dbk:513
#, no-wrap
# FIXME Die folgenden Einträge gehören nicht in die POT-Schablone
msgid "  * Fixed all outstanding bugs.\n"
msgstr "  * Fixed all outstanding bugs.\n"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:516
msgid "This doesn't tell readers anything too useful, obviously."
msgstr "Dies teilt den Lesern offensichtlich nichts Nützliches mit."

#. type: Content of: <chapter><section><section><screen>
#: best-pkging-practices.dbk:519
#, no-wrap
msgid "  * Applied patch from Jane Random.\n"
msgstr "  * Applied patch from Jane Random.\n"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:522
msgid "What was the patch about?"
msgstr "Was war das für ein Patch?"

#. type: Content of: <chapter><section><section><screen>
#: best-pkging-practices.dbk:525
#, no-wrap
msgid "  * Late night install target overhaul.\n"
msgstr "  * Late night install target overhaul.\n"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:528
msgid ""
"Overhaul which accomplished what? Is the mention of late night supposed to "
"remind us that we shouldn't trust that code?"
msgstr ""
"Welche Reparatur wurde ausgeführt? Soll die Erwähnung der späten Nacht daran "
"erinnern, dass man dem Code nicht trauen sollte?"

#. type: Content of: <chapter><section><section><screen>
#: best-pkging-practices.dbk:532
#, no-wrap
msgid "  * Fix vsync FU w/ ancient CRTs.\n"
msgstr "  * Fix vsync FU w/ ancient CRTs.\n"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:535
msgid ""
"Too many acronyms, and it's not overly clear what the, uh, fsckup (oops, a "
"curse word!) was actually about, or how it was fixed."
msgstr ""
"Zu viele Abkürzungen und es ist nicht klar, wovon der äh ... Mist (Hoppla, "
"ein Schimpfwort) tatsächlich handelt oder wie er repariert wurde."

#. type: Content of: <chapter><section><section><screen>
#: best-pkging-practices.dbk:539
#, no-wrap
msgid "  * This is not a bug, closes: #nnnnnn.\n"
msgstr "  * This is not a bug, closes: #nnnnnn.\n"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:542
msgid ""
"First of all, there's absolutely no need to upload the package to convey "
"this information; instead, use the bug tracking system.  Secondly, there's "
"no explanation as to why the report is not a bug."
msgstr ""
"Erst einmal ist es absolut unnötig, das Paket hochzuladen, um diese "
"Information zu übermitteln. Benutzen Sie stattdessen die Fehlerdatenbank. "
"Zweitens fehlt die Erklärung, warum dieser Bericht kein Fehler ist."

#. type: Content of: <chapter><section><section><screen>
#: best-pkging-practices.dbk:547
#, no-wrap
msgid "  * Has been fixed for ages, but I forgot to close; closes: #54321.\n"
msgstr "  * Has been fixed for ages, but I forgot to close; closes: #54321.\n"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:550
msgid ""
"If for some reason you didn't mention the bug number in a previous changelog "
"entry, there's no problem, just close the bug normally in the BTS.  There's "
"no need to touch the changelog file, presuming the description of the fix is "
"already in (this applies to the fixes by the upstream authors/maintainers as "
"well, you don't have to track bugs that they fixed ages ago in your "
"changelog)."
msgstr ""
"Falls Sie aus irgend einem Grund die Fehlernummer in einem früheren "
"Änderungsprotokolleintrag nicht erwähnt haben, ist das kein Problem. "
"Schließen Sie den Fehler einfach im BTS. Es ist nicht nötig, die "
"Änderungsprotokolldatei anzurühren, vorausgesetzt, die Beschreibung der "
"Fehlerbehebung ist bereits darin enthalten (Dies gilt auch für Reparaturen "
"durch die Originalautoren/-Betreuer. Sie müssen keine Fehler verfolgen, die "
"diese bereits vor Jahren in Ihrem Änderungsprotokoll behoben haben)."

#. type: Content of: <chapter><section><section><screen>
#: best-pkging-practices.dbk:557
#, no-wrap
msgid "  * Closes: #12345, #12346, #15432\n"
msgstr "  * Closes: #12345, #12346, #15432\n"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:560
msgid ""
"Where's the description? If you can't think of a descriptive message, start "
"by inserting the title of each different bug."
msgstr ""
"Wo ist die Beschreibung? Falls Ihnen keine aussagekräftige Nachricht "
"einfällt, beginnen Sie, die Titel der verschiedenen Fehler einzufügen."

#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:566
msgid "Supplementing changelogs with <filename>NEWS.Debian</filename> files"
msgstr ""
"Änderungsprotokolle mit <filename>NEWS.Debian</filename>-Dateien ergänzen"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:568
msgid ""
"Important news about changes in a package can also be put in "
"<filename>NEWS.Debian</filename> files.  The news will be displayed by tools "
"like <systemitem role=\"package\">apt-listchanges</systemitem>, before all "
"the rest of the changelogs.  This is the preferred means to let the user "
"know about significant changes in a package.  It is better than using "
"<systemitem role=\"package\">debconf</systemitem> notes since it is less "
"annoying and the user can go back and refer to the "
"<filename>NEWS.Debian</filename> file after the install.  And it's better "
"than listing major changes in <filename>README.Debian</filename>, since the "
"user can easily miss such notes."
msgstr ""
"Wichtige Nachrichten über Änderungen in einem Paket können auch in die "
"<filename>NEWS.Debian</filename>-Dateien geschrieben werden. Die Nachrichten "
"werden durch Werkzeuge wie <systemitem "
"role=\"package\">apt-listchanges</systemitem> vor dem ganzen Rest des "
"Änderungsprotokolls angezeigt. Dies ist das vorzugsweise Mittel, dem Anwender "
"bedeutende Änderungen in einem Paket mitzuteilen. Es ist besser, als "
"<systemitem role=\"package\">debconf</systemitem>-Notizen zu benutzen, da es "
"weniger stört und der Anwender nach der Installation zurückgehen und in der "
"<filename>NEWS.Debian</filename>-Datei nachschlagen kann. Es ist auch besser, "
"als die Hauptänderungen in <filename>README.Debian</filename> aufzuführen, da "
"der Anwender solche Notizen leicht übersehen kann."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:579
msgid ""
"The file format is the same as a debian changelog file, but leave off the "
"asterisks and describe each news item with a full paragraph when necessary "
"rather than the more concise summaries that would go in a changelog.  It's a "
"good idea to run your file through <literal>dpkg-parsechangelog</literal> to "
"check its formatting as it will not be automatically checked during build as "
"the changelog is.  Here is an example of a real "
"<filename>NEWS.Debian</filename> file:"
msgstr ""
"Das Dateiformat entspricht dem des Änderungsprotokolls, die Sternchen werden "
"allerdings weggelassen und jedes Nachrichtenelement wird, wenn nötig, mit "
"einem vollständigen Satz beschrieben, statt der kurz gefassten "
"Zusammenfassungen, die in ein Änderungsprotokoll einfließen. Sie sind gut "
"beraten, Ihre Datei durch <literal>dpkg-parsechangelog</literal> laufen zu "
"lassen, um ihre Formatierung zu prüfen, da sie nicht automatisch während des "
"Builds getestet wird, so wie dies beim Änderungsprotokoll getan wird. Hier "
"nun ein Beispiel einer echten <filename>NEWS.Debian</filename>-Datei:"

#. type: Content of: <chapter><section><section><screen>
#: best-pkging-practices.dbk:588
#, no-wrap
msgid ""
"cron (3.0pl1-74) unstable; urgency=low\n"
"\n"
"    The checksecurity script is no longer included with the cron package:\n"
"    it now has its own package, checksecurity. If you liked the\n"
"    functionality provided with that script, please install the new\n"
"    package.\n"
"\n"
" -- Steve Greenland &lt;stevegr@debian.org&gt;  Sat,  6 Sep 2003 17:15:03 "
"-0500\n"
msgstr ""
"cron (3.0pl1-74) unstable; urgency=low\n"
"\n"
"    The checksecurity script is no longer included with the cron package:\n"
"    it now has its own package, checksecurity. If you liked the\n"
"    functionality provided with that script, please install the new\n"
"    package.\n"
"\n"
" -- Steve Greenland &lt;stevegr@debian.org&gt;  Sat,  6 Sep 2003 17:15:03 "
"-0500\n"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:598
msgid ""
"The <filename>NEWS.Debian</filename> file is installed as "
"<filename>/usr/share/doc/<replaceable>package</replaceable>/NEWS.Debian.gz</filename>.  "
"It is compressed, and always has that name even in Debian native packages.  "
"If you use <literal>debhelper</literal>, "
"<literal>dh_installchangelogs</literal> will install "
"<filename>debian/NEWS</filename> files for you."
msgstr ""
"Die Datei <filename>NEWS.Debian</filename> wird als <filename>/usr/share/doc/"
"<replaceable>Paket</replaceable>/NEWS.Debian.gz</filename> installiert. Sie "
"ist komprimiert und hat immer diesen Namen, auch in nativen Debian-Paketen. "
"Falls Sie <literal>debhelper</literal> benutzen, wird "
"<literal>dh_installchangelogs</literal> die "
"<filename>debian/NEWS</filename>-Dateien für Sie installieren."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:605
msgid ""
"Unlike changelog files, you need not update <filename>NEWS.Debian</filename> "
"files with every release.  Only update them if you have something "
"particularly newsworthy that user should know about.  If you have no news at "
"all, there's no need to ship a <filename>NEWS.Debian</filename> file in your "
"package.  No news is good news!"
msgstr ""
"Anders als Änderungsprotokolldateien, müssen Sie die "
"<filename>debian/NEWS</filename>-Dateien nicht bei jeder Veröffentlichung "
"aktualisieren. Aktualisieren Sie sie nur, wenn Sie etwas besonders "
"berichtenswertes haben, worüber der Anwender Bescheid wissen sollte. Falls "
"Sie überhaupt keine Nachrichten haben, ist es nicht nötig, Ihrem Paket eine "
"<filename>debian/NEWS</filename>-Datei mitzugeben. Keine Nachricht ist eine "
"gute Nachricht!"

#. type: Content of: <chapter><section><title>
#: best-pkging-practices.dbk:627
msgid "Best practices for maintainer scripts"
msgstr "Optimale Vorgehensweisen für Betreuerskripte"

#. type: Content of: <chapter><section><para>
#: best-pkging-practices.dbk:629
msgid ""
"Maintainer scripts include the files <filename>debian/postinst</filename>, "
"<filename>debian/preinst</filename>, <filename>debian/prerm</filename> and "
"<filename>debian/postrm</filename>.  These scripts take care of any package "
"installation or deinstallation setup which isn't handled merely by the "
"creation or removal of files and directories.  The following instructions "
"supplement the <ulink url=\"&url-debian-policy;\">Debian Policy</ulink>."
msgstr ""
"Betreuerskripte beinhalten die Dateien <filename>debian/postinst</filename>, "
"<filename>debian/preinst</filename>, <filename>debian/prerm</filename> und "
"<filename>debian/postrm</filename>. Diese Skripte geben auf jede "
"Installations- oder Deinstallationseinrichtung des Pakets acht, die bloß "
"durch Erstellen und Entfernen von Dateien und Verzeichnissen gehandhabt wird. "
"Die folgenden Anweisungen ergänzen die <ulink "
"url=\"&url-debian-policy;\">Debian Policy</ulink>."

#. type: Content of: <chapter><section><para>
#: best-pkging-practices.dbk:637
msgid ""
"Maintainer scripts must be idempotent.  That means that you need to make "
"sure nothing bad will happen if the script is called twice where it would "
"usually be called once."
msgstr ""
"Betreuerskripte müssen Idempotent sein. Dies bedeuted, dass Sie sicherstellen "
"müssen, dass nichts Schlimmes passiert, wenn das Skript zweimal aufgerufen "
"wird, während es normalerweise einmal aufgerufen würde."

#. type: Content of: <chapter><section><para>
#: best-pkging-practices.dbk:642
msgid ""
"Standard input and output may be redirected (e.g.  into pipes) for logging "
"purposes, so don't rely on them being a tty."
msgstr ""
"Standardein- und -ausgabe könnten zu Protokollierungszwecken umgeleitet "
"werden (z.B. in Pipes), verlassen Sie sich daher nicht darauf, dass sie ein "
"Terminal sind."

#. type: Content of: <chapter><section><para>
#: best-pkging-practices.dbk:646
msgid ""
"All prompting or interactive configuration should be kept to a minimum.  "
"When it is necessary, you should use the <systemitem "
"role=\"package\">debconf</systemitem> package for the interface.  Remember "
"that prompting in any case can only be in the <literal>configure</literal> "
"stage of the <filename>postinst</filename> script."
msgstr ""
"Jegliche Bedienerführung oder interaktive Konfiguration sollte so gering wie "
"möglich gehalten werden. Wenn es nötig ist, sollten Sie das Paket "
"<systemitem role=\"package\">debconf</systemitem> für die Schnittstelle "
"benutzen. Denken Sie daran, dass diese Bedienerführung nur in der "
"<literal>configure</literal>-Stufe des <filename>postinst</filename>-Skripts "
"stattfinden kann."

#. type: Content of: <chapter><section><para>
#: best-pkging-practices.dbk:653
msgid ""
"Keep the maintainer scripts as simple as possible.  We suggest you use pure "
"POSIX shell scripts.  Remember, if you do need any bash features, the "
"maintainer script must have a bash shebang line.  POSIX shell or Bash are "
"preferred to Perl, since they enable <systemitem "
"role=\"package\">debhelper</systemitem> to easily add bits to the scripts."
msgstr ""
"Halten Sie die Betreuerskripte so einfach wie möglich. Es wird empfohlen, nur "
"reine POSIX-Shell-Skripte zu benutzen. Falls Sie irgendwelche Bash-Funktionen "
"benötigen, vergessen Sie nicht, dass das Betreuerskript eine Shebang-Zeile "
"haben muss. POSIX-Shell oder Bash werden für Perl bevorzugt, da sie "
"<systemitem role=\"package\">debhelper</systemitem> ermöglichen, den Skripten "
"einfach Teile hinzuzufügen."

#. type: Content of: <chapter><section><para>
#: best-pkging-practices.dbk:660
msgid ""
"If you change your maintainer scripts, be sure to test package removal, "
"double installation, and purging.  Be sure that a purged package is "
"completely gone, that is, it must remove any files created, directly or "
"indirectly, in any maintainer script."
msgstr ""
"Falls Sie Ihre Betreuerskripte ändern, stellen Sie sicher, dass Sie das "
"Entfernen des Pakets, die mehrmalige Installation und das vollständige "
"Entfernen testen. Vergewissern Sie sich, dass nach dem vollständigen "
"Entfernen des Pakets alles komplett weg ist, sprich, es muss jede erzeugte "
"Datei entfernen, die direkt oder indirekt in irgendeinem Betreuerskript "
"erstellt wurde."

#. type: Content of: <chapter><section><para>
#: best-pkging-practices.dbk:666
msgid ""
"If you need to check for the existence of a command, you should use "
"something like"
msgstr ""
"Falls Sie prüfen möchten, ob ein Befehl existiert, sollten Sie so etwas "
"benutzen:"

#. type: Content of: <chapter><section><programlisting>
#: best-pkging-practices.dbk:669
#, no-wrap
msgid "if [ -x /usr/sbin/install-docs ]; then ..."
msgstr "if [ -x /usr/sbin/install-docs ]; then ..."

#. type: Content of: <chapter><section><para>
#: best-pkging-practices.dbk:671
msgid ""
"If you don't wish to hard-code the path of a command in your maintainer "
"script, the following POSIX-compliant shell function may help:"
msgstr ""
"Falls Sie nicht dem Pfad eines Befehls fest ins Betreuerskript schreiben "
"möchten, könnte die folgende POSIX-konforme Shell-Funktion helfen:"

#. type: Content of: <chapter><section><para>
#: best-pkging-practices.dbk:676
msgid ""
"You can use this function to search <varname>$PATH</varname> for a command "
"name, passed as an argument.  It returns true (zero) if the command was "
"found, and false if not.  This is really the most portable way, since "
"<literal>command -v</literal>, <command>type</command>, and "
"<command>which</command> are not POSIX."
msgstr ""
"Sie können diese Funktion benutzen, um <varname>$PATH</varname> nach einem "
"Befehlsnamen zu durchsuchen, der als Argument übergegeben wird. Sie gibt "
"»true« (null) zurück, falls der Befehl gefunden wurde und »false«, falls "
"nicht. Dies ist wirklich die portierbarste Möglichkeit, da <literal>command "
"-v</literal>, <command>type</command> und <command>which</command> nicht "
"POSIX-konform sind."

#. type: Content of: <chapter><section><para>
#: best-pkging-practices.dbk:683
msgid ""
"While <command>which</command> is an acceptable alternative, since it is "
"from the required <systemitem role=\"package\">debianutils</systemitem> "
"package, it's not on the root partition.  That is, it's in "
"<filename>/usr/bin</filename> rather than <filename>/bin</filename>, so one "
"can't use it in scripts which are run before the <filename>/usr</filename> "
"partition is mounted.  Most scripts won't have this problem, though."
msgstr ""
"Obwohl <command>which</command> eine akzeptable Alternative ist, da es aus "
"dem benötigten Paket <systemitem role=\"package\">debianutils</systemitem> "
"stammt, liegt es nicht auf der Wurzel-Partition. Zumindest liegt es eher in "
"<filename>/usr/bin</filename> als in <filename>/bin</filename>, so dass es "
"nicht in Skripten benutzt werden kann, die vor dem Einhängen von "
"<filename>/usr</filename> ausgeführt werden. Dieses Problem werden allerdings "
"die meisten Skripte nicht haben."

#. type: Content of: <chapter><section><title>
#: best-pkging-practices.dbk:693
msgid ""
"Configuration management with <systemitem "
"role=\"package\">debconf</systemitem>"
msgstr ""
"Konfigurationsverwaltung mit <systemitem role=\"package\">debconf</systemitem>"

#. type: Content of: <chapter><section><para>
#: best-pkging-practices.dbk:695
msgid ""
"<systemitem role=\"package\">Debconf</systemitem> is a configuration "
"management system which can be used by all the various packaging scripts "
"(<filename>postinst</filename> mainly) to request feedback from the user "
"concerning how to configure the package.  Direct user interactions must now "
"be avoided in favor of <systemitem role=\"package\">debconf</systemitem> "
"interaction.  This will enable non-interactive installations in the future."
msgstr ""
"<systemitem role=\"package\">Debconf</systemitem> ist ein "
"Konfigurationsverwaltungssystem, das von allerlei Paketierungsskripten "
"(hauptsächlich <filename>postinst</filename>) benutzt werden kann, um "
"Rückmeldungen von Anwendern betreffend der Paketkonfiguration abzufragen. "
"Direkte Benutzer-Interaktion muss nun zugunsten der Interaktion mit "
"<systemitem role=\"package\">debconf</systemitem> vermieden werden. Dies wird "
"in Zukunft nicht interaktive Installationen ermöglichen."

#. type: Content of: <chapter><section><para>
#: best-pkging-practices.dbk:703
msgid ""
"Debconf is a great tool but it is often poorly used.  Many common mistakes "
"are listed in the <citerefentry> "
"<refentrytitle>debconf-devel</refentrytitle> <manvolnum>7</manvolnum> "
"</citerefentry> man page.  It is something that you must read if you decide "
"to use debconf.  Also, we document some best practices here."
msgstr ""
"Debconf ist ein großartiges Werkzeug, aber es wird oft mangelhaft benutzt. "
"Viele alltägliche Fehler sind auf der Handbuchseite <citerefentry> "
"<refentrytitle>debconf-devel</refentrytitle> <manvolnum>7</manvolnum> "
"</citerefentry> aufgeführt. Manchmal ist es nötig zu lesen, falls Sie sich "
"entscheiden Debconf zu benutzen. Außerdem werden hier ein paar optimale "
"Vorgehensweisen vorgestellt."

#. type: Content of: <chapter><section><para>
#: best-pkging-practices.dbk:710
msgid ""
"These guidelines include some writing style and typography recommendations, "
"general considerations about debconf usage as well as more specific "
"recommendations for some parts of the distribution (the installation system "
"for instance)."
msgstr ""
"Diese Richtlinien enthalten einige Schreibstil- und Typografie-Empfehlungen, "
"allgemeine Betrachtungen über die Benutzung von Debconf, ebenso wie "
"spezifischere Empfehlungen für einige Teile der Distribution (das "
"Installationssystem besispielsweise)."

#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:716
msgid "Do not abuse debconf"
msgstr "Missbrauchen Sie Debconf nicht"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:718
msgid ""
"Since debconf appeared in Debian, it has been widely abused and several "
"criticisms received by the Debian distribution come from debconf abuse with "
"the need of answering a wide bunch of questions before getting any little "
"thing installed."
msgstr ""
"Seit Debconf in Debian erschien, wurde es verbreitet missbraucht und viel von "
"der Kritik, die bei der Debian-Distribution einging, rührte vom "
"Debconf-Missbrauch mit der Notwendigkeit, ein großes Fragenbündel zu "
"beantworten, bevor eine Kleinigkeit installiert war."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:724
msgid ""
"Keep usage notes to what they belong: the <filename>NEWS.Debian</filename>, "
"or <filename>README.Debian</filename> file.  Only use notes for important "
"notes which may directly affect the package usability.  Remember that notes "
"will always block the install until confirmed or bother the user by email."
msgstr ""
"Behalten Sie Aufrufnotizen dort, wozu sie gehören: den Dateien "
"<filename>NEWS.Debian</filename> oder <filename>README.Debian</filename>. "
"Benutzen Sie nur Notizen für wichtige Anmerkungen, die direkt die "
"Benutzbarkeit des Pakets beeinflussen. Bedenken Sie, dass Notizen die "
"Installation immer blockieren, bis Sie bestätigt wurden oder den Anwender per "
"E-Mail bleästigt haben."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:730
msgid ""
"Carefully choose the questions priorities in maintainer scripts.  See "
"<citerefentry> <refentrytitle>debconf-devel</refentrytitle> "
"<manvolnum>7</manvolnum> </citerefentry> for details about priorities.  Most "
"questions should use medium and low priorities."
msgstr ""
"Wählen Sie die Prioritäten der Fragen in Betreuerskripten sorgfältig. "
"Einzelheiten über Prioritäten finden Sie unter <citerefentry> "
"<refentrytitle>debconf-devel</refentrytitle> <manvolnum>7</manvolnum> "
"</citerefentry>. Die meisten Fragen sollten mittlere oder niedrige "
"Prioritäten nutzen."

#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:738
msgid "General recommendations for authors and translators"
msgstr "Allgemeine Empfehlungen für Autoren und Übersetzer"

#. type: Content of: <chapter><section><section><section><title>
#: best-pkging-practices.dbk:740
msgid "Write correct English"
msgstr "Schreiben Sie korrektes Englisch."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:742
msgid ""
"Most Debian package maintainers are not native English speakers.  So, "
"writing properly phrased templates may not be easy for them."
msgstr ""
"Die meisten Debian-Paketbetreuer haben nicht Englisch als Muttersprache. "
"Daher ist es für sie nicht einfach, korrekt formulierte Schablonen zu "
"verfassen."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:746
msgid ""
"Please use (and abuse) &email-debian-l10n-english; mailing list.  Have your "
"templates proofread."
msgstr ""
"Bitte benutzen (und missbrauchen) Sie die Mailingliste "
"&email-debian-l10n-english;. Lassen Sie Ihre Schablonen korrekturlesen."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:750
msgid ""
"Badly written templates give a poor image of your package, of your "
"work... or even of Debian itself."
msgstr ""
"Schlecht geschriebene Schablonen werfen ein armseliges Bild auf Ihr Paket, "
"Ihre Arbeit ... oder sogar auf Debian selbst."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:754
msgid ""
"Avoid technical jargon as much as possible.  If some terms sound common to "
"you, they may be impossible to understand for others.  If you cannot avoid "
"them, try to explain them (use the extended description).  When doing so, "
"try to balance between verbosity and simplicity."
msgstr ""
"Vermeiden Sie soweit möglich technische Fachsprache. Wenn sich einige "
"Begriffe für Sie vertraut anhören, könnten sie für andere unverständlich "
"sein. Falls sie sich nicht vermeiden lassen, versuchen Sie sie zu erklären "
"(benutzen Sie die längere Beschreibung). Versuchen Sie dabei, zwischen "
"Aussagekraft und Einfachheit abzuwägen."

#. type: Content of: <chapter><section><section><section><title>
#: best-pkging-practices.dbk:762
msgid "Be kind to translators"
msgstr "Seien sie nett zu Übersetzern"

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:764
msgid ""
"Debconf templates may be translated.  Debconf, along with its sister package "
"<command>po-debconf</command> offers a simple framework for getting "
"templates translated by translation teams or even individuals."
msgstr ""
"Debconf-Schablonen können übersetzt werden. Debconf bietet zusammen mit "
"seinem Schwesterpaket <command>po-debconf</command> ein einfaches Gerüst, um "
"Schablonen durch Übersetzer-Teams oder sogar einzelne Personen übersetzen zu "
"lassen."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:769
msgid ""
"Please use gettext-based templates.  Install <systemitem "
"role=\"package\">po-debconf</systemitem> on your development system and read "
"its documentation (<command>man po-debconf</command> is a good start)."
msgstr ""
"Bitte benutzen Sie Gettext-basierte Schablonen. Installieren Sie <systemitem "
"role=\"package\">po-debconf</systemitem> auf Ihrem Entwicklungssystem und "
"lesen Sie dessen Dokumentation (<command>man po-debconf</command> ist ein "
"guter Anfang)."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:774
msgid ""
"Avoid changing templates too often.  Changing templates text induces more "
"work to translators which will get their translation fuzzied.  A fuzzy "
"translation is a string for which the original changed since it was "
"translated, therefore requiring some update by a translator to be usable.  "
"When changes are small enough, the original translation is kept in PO files "
"but marked as <literal>fuzzy</literal>."
msgstr ""
"Vermeiden Sie, Schablonen häufig zu ändern. Das Ändern von Schablonen führt "
"zu Mehrarbeit für Übersetzer, deren Übersetzungen unvollständig werden. Eine "
"unvollständige Übersetzung ist eine Zeichenkette, bei der sich seit dem "
"Übersetzen das Original geändert hat und das daher eine Aktualisierung durch "
"den Übersetzer benötigt. Wenn die Änderungen klein genug sind, wird die "
"Originalübersetzung in den PO-Dateien beibehalten und mit "
"<literal>fuzzy</literal> gekennzeichnet."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:782
msgid ""
"If you plan to do changes to your original templates, please use the "
"notification system provided with the <systemitem "
"role=\"package\">po-debconf</systemitem> package, namely the "
"<command>podebconf-report-po</command>, to contact translators.  Most active "
"translators are very responsive and getting their work included along with "
"your modified templates will save you additional uploads.  If you use "
"gettext-based templates, the translator's name and e-mail addresses are "
"mentioned in the PO files headers and will be used by "
"<command>podebconf-report-po</command>."
msgstr ""
"Falls Sie planen, Änderungen an Ihren Originalschablonen vorzunehmen, "
"benutzen Sie bitte das Benachrichtigungssystem namens "
"<command>podebconf-report-po</command>, das vom Paket <systemitem "
"role=\"package\">po-debconf</systemitem> bereitgestellt wird, um die "
"Übersetzer zu kontaktieren. Die meisten aktiven Übersetzer sind sehr "
"zugänglich und Ihre Arbeit zusammen mit Ihren geänderten Schablonen "
"einzubeziehen, wird Sie vor zusätzlichen Uploads bewahren. Falls Sie "
"Gettext-basierte Schablonen verwenden, werden die Namen und E-Mail-Adressen "
"der Übersetzer in den Kopfzeilen der PO-Dateien erwähnt und von "
"<command>podebconf-report-po</command> benutzt."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:794
msgid "A recommended use of that utility is:"
msgstr "Ein empfohlene Art, das Hilfswerkzeug zu benutzen ist:"

#. type: Content of: <chapter><section><section><section><programlisting>
#: best-pkging-practices.dbk:796
#, no-wrap
msgid ""
"cd debian/po &amp;&amp; podebconf-report-po --call --languageteam "
"--withtranslators --deadline=\"+10 days\""
msgstr ""
"cd debian/po &amp;&amp; podebconf-report-po --call --languageteam "
"--withtranslators --deadline=\"+10 days\""

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:798
msgid ""
"This command will first synchronize the PO and POT files in "
"<filename>debian/po</filename> with the templates files listed in "
"<filename>debian/po/POTFILES.in</filename>.  Then, it will send a call for "
"new translations, in the &email-debian-i18n; mailing list. Finally, it will "
"also send a call for translation updates to the language team (mentioned in "
"the <literal>Language-Team</literal> field of each PO file)  as well as the "
"last translator (mentioned in <literal>Last-translator</literal>)."
msgstr ""
"Dieser Befehl wird zuerst die PO- und POT-Dateien in "
"<filename>debian/po</filename> mit dem Schablonendateien synchronisieren, die "
"in <filename>debian/po/POTFILES.in</filename> aufgeführt sind. Dann wird er "
"einen Aufruf für neue Übersetzungen an die Mailingliste &email-debian-i18n; "
"senden. Am Schluss wird er außerdem einen Aufruf für neue Übersetzungen an "
"das Sprach-Team (im Feld <literal>Language-Team</literal> jeder PO-Datei "
"erwähnt) sowie den letzten Übersetzer (erwähnt in "
"<literal>Last-translator</literal>) senden."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:807
msgid ""
"Giving a deadline to translators is always appreciated, so that they can "
"organize their work. Please remember that some translation teams have a "
"formalized translate/review process and a delay lower than 10 days is "
"considered as unreasonable. A shorter delay puts too much pressure on "
"translation teams and should be kept for very minor changes."
msgstr ""
"Es wird immer gewürdigt, wenn Sie den Übersetzern einen Abgabetermin geben, "
"so dass sie ihre Arbeit organisieren können. Bitte denken Sie daran, dass "
"einige Übersetzer-Teams einen formalisierten Übersetzung-/Korrekturprozess "
"haben und eine Zeitspanne, die kürzer als zehn Tage ist, als unangemessen "
"angesehen wird. Eine kürzere Frist übt zuviel Druck auf die Übersetzer-Teams "
"aus und sollte für sehr kleine Änderungen genommen werden."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:814
msgid ""
"If in doubt, you may also contact the translation team for a given language "
"(debian-l10n-xxxxx@&lists-host;), or the &email-debian-i18n; mailing list."
msgstr ""
"Im Zweifelsfall können Sie auch das Übersetzer-Team für eine bestimmte "
"Sprache (debian-l10n-xxxxx@&lists-host;) oder die Mailingliste "
"&email-debian-i18n; kontaktieren."

#. type: Content of: <chapter><section><section><section><title>
#: best-pkging-practices.dbk:821
msgid "Unfuzzy complete translations when correcting typos and spelling"
msgstr ""
"Entfernen Sie die Fuzzy-Markierungen in vollständigen Übersetzungen, wenn Sie "
"Tipp- und Rechtschreibfehler korrigieren."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:823
msgid ""
"When the text of a debconf template is corrected and you are <emphasis "
"role=\"strong\">sure</emphasis> that the change does <emphasis "
"role=\"strong\">not</emphasis> affect translations, please be kind to "
"translators and <emphasis>unfuzzy</emphasis> their translations."
msgstr ""
"Wenn der Text einer Debconf-Schablone korrigiert wurde und Sie <emphasis "
"role=\"strong\">sicher</emphasis> sind, dass die Änderung <emphasis "
"role=\"strong\">keine</emphasis> Übersetzungen beeinflusst, seien Sie so nett "
"zu Übersetzern, die <emphasis>Fuzzy</emphasis>-Markierungen aus deren "
"Übersetzungen zu entfernen."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:829
msgid ""
"If you don't do so, the whole template will not be translated as long as a "
"translator will send you an update."
msgstr ""
"Falls Sie dies nicht tun, wird die ganze Schablone nicht übersetzt, bis Ihnen "
"ein Übersetzer eine Aktualisierung zusendet."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:833
msgid ""
"To <emphasis>unfuzzy</emphasis> translations, you can use two methods. The "
"first method does <emphasis>preventive</emphasis> search and replace actions "
"in the PO files. The latter uses <command>gettext</command> utilities to "
"<emphasis>unfuzzy</emphasis> strings."
msgstr ""
"Um aus Übersetzungen <emphasis>Fuzzy-Markierungen zu entfernen</emphasis>, "
"können Sie nach zwei Methoden verfahren. Bei der ersten Methode werden "
"<emphasis>präventiv</emphasis> Such- und Ersetzungsaktionen in den PO-Dateien "
"durchgeführt. Letztere benutzt <command>gettext</command>-Hilfswerkzeuge, um "
"aus Zeichenketten <emphasis>Fuzzy-Markierungen zu entfernen</emphasis>."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:839
msgid "<emphasis>Preventive unfuzzy</emphasis> method:"
msgstr ""
"Methode <emphasis>Fuzzy-Markierungen präventiv zu entfernen</emphasis>:"

#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:844
msgid ""
"Try finding a complete translation file <emphasis "
"role=\"strong\">before</emphasis> the change:"
msgstr ""
"Versuchen Sie eine vollständige Übersetzungsdatei <emphasis "
"role=\"strong\">vor</emphasis> der Änderung zu finden:"

#. type: Content of: <chapter><section><section><section><orderedlist><listitem><programlisting>
#: best-pkging-practices.dbk:847 best-pkging-practices.dbk:918
#, no-wrap
msgid ""
"for i in debian/po/*po; do echo -n $i: ; msgfmt -o /dev/null --statistics "
"$i; done"
msgstr ""
"for i in debian/po/*po; do echo -n $i: ; msgfmt -o /dev/null --statistics "
"$i; done"

#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:849
msgid ""
"The file only showing <emphasis>translated</emphasis> items will be used as "
"the reference file. If there is none (which should not happen if you take "
"care to properly interact with translators), you should use the file with "
"the most translated strings."
msgstr ""
"Die Datei, die nur <emphasis>übersetzte</emphasis> Elemente anzeigt, wird als "
"Bezugsdatei benutzt. Falls es keine gibt (was nicht vorkommen sollte, falls "
"Sie auf ein fachgerechtes Zusammenspiel mit Übersetzern achten), sollten Sie "
"die Datei mit den meisten übersetzten Zeichenketten benutzen."

#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:857
msgid ""
"Identify the needed change. In this example, let's assume the change is "
"about fixing a typo in the word <literal>typo</literal> which was "
"inadvertently written as <literal>tpyo</literal>. Therefore, the change is "
"<command>s/tpyo/typo</command>."
msgstr ""
"Finden Sie heraus, welche Änderung nötig ist. In diesem Beispiel wird davon "
"ausgegangen, dass die Änderung darin besteht, einen Tippfehler im Wort "
"<literal>typo</literal> zu korrigieren, das versehentlich "
"<literal>tpyo</literal> geschrieben wurde. Daher ist die Änderung "
"<command>s/tpyo/typo</command>."

#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:865
msgid ""
"Check that this change is only applied to the place where you really intend "
"to make it and <emphasis role=\"strong\">not</emphasis> in any other place "
"where the original string is appropriate. This specifically applies to "
"change in punctuation, for instance."
msgstr ""
"Prüfen Sie, ob die Änderung nur an der Stelle angewandt wird, an der Sie sie "
"wirklich vornehmen möchten und <emphasis role=\"strong\">nicht</emphasis> an "
"irgendeiner anderen Stelle, an der die Originalzeichenkette so gewollt ist. "
"Dies wird beispielsweise eigens bei der Änderung der Zeichensetzung angewandt."

#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:873
msgid ""
"Modify all PO files by using <command>sed</command>. The use of that command "
"is recommended over any text editor to guarantee that the files encoding "
"will not be broken by the edit action:"
msgstr ""
"Ändern Sie alle PO-Dateien mittels <command>sed</command>. Es wird empfohlen, "
"diesen Befehl über einen Text-Editor zu benutzen, um zu gewährleisten, dass "
"die Zeichencodierung der Datei nicht durch die Bearbeitungsaktion zerstört "
"wird:"

#. type: Content of: <chapter><section><section><section><orderedlist><listitem><programlisting>
#: best-pkging-practices.dbk:878
#, no-wrap
msgid ""
"cd debian/po\n"
"for i in *.po; do sed -i 's/tpyo/typo/g' $i; done\n"
msgstr ""
"cd debian/po\n"
"for i in *.po; do sed -i 's/tpyo/typo/g' $i; done\n"

#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:884
msgid "Change the debconf template file to fix the typo."
msgstr "Ändern Sie die Debconf-Schablone, um den Tippfehler zu korrigieren."

#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:889
msgid "Run <command>debconf-updatepo</command>."
msgstr "Führen Sie <command>debconf-updatepo</command> aus."

#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:894
msgid ""
"Check the <filename>foo.po</filename> reference file. Its statistics should "
"not be changed:"
msgstr ""
"Prüfen Sie die Bezugsdatei <filename>foo.po</filename>. Die Statistik dieser "
"Datei sollte unverändert sein:"

#. type: Content of: <chapter><section><section><section><orderedlist><listitem><programlisting>
#: best-pkging-practices.dbk:898
#, no-wrap
msgid "msgfmt -o /dev/null --statistics debian/po/foo.po\n"
msgstr "msgfmt -o /dev/null --statistics debian/po/foo.po\n"

#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:903
msgid ""
"If the file's statistics changed, you did something wrong. Try again or ask "
"for help on the &email-debian-i18n; mailing list."
msgstr ""
"Falls sich die Statistik dieser Datei geändert hat, haben Sie etwas falsch "
"gemacht. Versuchen Sie es erneut oder bitten Sie auf der Mailingliste "
"&email-debian-i18n; um Hilfe."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:909
msgid "Gettext utilities method:"
msgstr "Methode mit Gettext-Hilfswerkzeugen:"

#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:914
msgid ""
"Put all incomplete PO files out of the way.  You can check the completeness "
"by using (needs the <systemitem role=\"package\">gettext</systemitem> "
"package installed):"
msgstr ""
"Räumen Sie alle unvollständigen PO-Dateien aus dem Weg. Sie können die "
"Vollständigkeit prüfen (das Paket <systemitem "
"role=\"package\">gettext</systemitem> muss installiert sein):"

#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:922
msgid ""
"Move all files which report either fuzzy strings to a temporary place.  "
"Files which report no fuzzy strings (only translated and untranslated) will "
"be kept in place."
msgstr ""
"Verschieben Sie alle Dateien, die auch unvollständige Zeichenketten enthalten "
"temporär an eine andere Stelle. Dateien ohne unvollständige Zeichenketten "
"(nur übersetzt und unübersetzte) bleiben wo sie sind."

#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:929
msgid ""
"Now <emphasis role=\"strong\">and now only</emphasis>, modify the template "
"for the typos and check again that translation are not impacted (typos, "
"spelling errors, sometimes typographical corrections are usually OK)."
msgstr ""
"Ändern sie nun <emphasis role=\"strong\">und nur nun</emphasis> die "
"Tippfehler in der Schablone und prüfen Sie erneut, ob keine Übersetzungen "
"betroffen sind (normalerweise sind Tippfehler, Rechtschreibfehler und "
"manchmal typografische Korrekturen OK)."

#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:936
msgid ""
"Run <command>debconf-updatepo</command>.  This will fuzzy all strings you "
"modified in translations.  You can see this by running the above again."
msgstr ""
"Führen Sie <command>debconf-updatepo</command> aus. Dies wird alle von Ihnen "
"in Übersetzungen geänderten Zeichenketten mit »fuzzy« markieren. Sie können "
"dies sehen, wenn Sie obigen Aufruf erneut ausführen."

#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:942
msgid "Use the following command:"
msgstr "Benutzen Sie den folgenden Befehl:"

#. type: Content of: <chapter><section><section><section><orderedlist><listitem><programlisting>
#: best-pkging-practices.dbk:944
#, no-wrap
msgid "for i in debian/po/*po; do msgattrib --output-file=$i --clear-fuzzy $i; done"
msgstr ""
"for i in debian/po/*po; do msgattrib --output-file=$i --clear-fuzzy $i; done"

#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:948
msgid ""
"Move back to <filename>debian/po</filename> the files which showed fuzzy "
"strings in the first step."
msgstr ""
"Verschieben Sie die Dateien mit unvollständige Zeichenketten aus dem ersten "
"Schritt zurück nach <filename>debian/po</filename>."

#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:953
msgid "Run <command>debconf-updatepo</command> again."
msgstr "Führen Sie erneut <command>debconf-updatepo</command> aus."

#. type: Content of: <chapter><section><section><section><title>
#: best-pkging-practices.dbk:960
msgid "Do not make assumptions about interfaces"
msgstr "Treffen Sie keine Annahmen über Schnittstellen."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:962
msgid ""
"Templates text should not make reference to widgets belonging to some "
"debconf interfaces.  Sentences like <emphasis>If you answer "
"Yes...</emphasis> have no meaning for users of graphical interfaces which "
"use checkboxes for boolean questions."
msgstr ""
"Schablonentext sollte keinen Bezug auf Steuerelemente herstellen, die zu "
"irgendwelchen Debconf-Schnittstellen gehören. Sätze wie <emphasis>If you "
"answer Yes...</emphasis> haben keinen Sinn für Benutzer grafischer "
"Oberflächen, die für die Beantwortung logischer Fragen Kontrollkästchen "
"verwenden."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:967
msgid ""
"String templates should also avoid mentioning the default values in their "
"description.  First, because this is redundant with the values seen by the "
"users.  Also, because these default values may be different from the "
"maintainer choices (for instance, when the debconf database was preseeded)."
msgstr ""
"Zeichenkettenschablonen sollten außerdem vermeiden, Vorgabewerte in ihrer "
"Beschreibung zu erwähnen. Erstens sind diese zusätzlich zu den Werten, die "
"der Anwender sieht, vorhanden. Außerdem könnten sich diese Werte von der "
"Auswahl des Paketbetreuers unterscheiden (zum Beispiel, wenn die "
"Debconf-Datenbank vorbelegt war)."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:973
msgid ""
"More generally speaking, try to avoid referring to user actions.  Just give "
"facts."
msgstr ""
"Versuchen Sie, allgemein ausgedrückt, Bezug auf Benutzeraktionen zu "
"vermeiden. Geben Sie nur Tatsachen wieder."

#. type: Content of: <chapter><section><section><section><title>
#: best-pkging-practices.dbk:979
msgid "Do not use first person"
msgstr "Reden Sie nicht in der ersten Person."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:981
msgid ""
"You should avoid the use of first person (<emphasis>I will do "
"this...</emphasis> or <emphasis>We recommend...</emphasis>).  The computer "
"is not a person and the Debconf templates do not speak for the Debian "
"developers.  You should use neutral construction.  Those of you who already "
"wrote scientific publications, just write your templates like you would "
"write a scientific paper.  However, try using active voice if still "
"possible, like <emphasis>Enable this if ...</emphasis> instead of "
"<emphasis>This can be enabled if...</emphasis>."
msgstr ""
"Sie sollten vermeiden, in der ersten Person zu reden (<emphasis>I will do "
"this...</emphasis> oder <emphasis>We recommend...</emphasis>). Der Rechner "
"ist keine Person und die Debconf-Schablonen sprechen nicht stellvertretend "
"für Debian-Entwickler. Sie sollten neutrale Formulierungen benutzen. "
"Diejenigen unter Ihnen, die bereits wissenschaftliche Publikationen verfasst "
"haben, können ihre Schablonen so schreiben, als würden Sie wissenschaftliche "
"Papiere verfassen. Versuchen Sie jedoch, wenn möglich, eine aktive Anrede zu "
"verwenden, wie <emphasis>Enable this if ...</emphasis> anstelle von "
"<emphasis>This can be enabled if...</emphasis>."

#. type: Content of: <chapter><section><section><section><title>
#: best-pkging-practices.dbk:991
msgid "Be gender neutral"
msgstr "Formulieren Sie geschlechtsneutral"

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:993
msgid ""
"The world is made of men and women.  Please use gender-neutral constructions "
"in your writing."
msgstr ""
"Die Welt wird von Männern und Frauen bevölkert. Bitte benutzen Sie in Ihren "
"Texten geschlechtsneutrale Formulierungen."

#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:1001
msgid "Templates fields definition"
msgstr "Definition von Schablonenfeldern"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1003
msgid ""
"This part gives some information which is mostly taken from the "
"<citerefentry> <refentrytitle>debconf-devel</refentrytitle> "
"<manvolnum>7</manvolnum> </citerefentry> manual page."
msgstr ""
"Dieser Teil stellt einige Informationen bereit, die meistens von der "
"Handbuchseite <citerefentry> <refentrytitle>debconf-devel</refentrytitle> "
"<manvolnum>7</manvolnum> </citerefentry> abgefragt wird."

#. type: Content of: <chapter><section><section><section><title>
#: best-pkging-practices.dbk:1008
# Nicht übersetzen --> siehe Manpage aus letztem String
msgid "Type"
msgstr "Type"

#. type: Content of: <chapter><section><section><section><section><title>
#: best-pkging-practices.dbk:1010
msgid "string"
msgstr "string"

#. type: Content of: <chapter><section><section><section><section><para>
#: best-pkging-practices.dbk:1012
msgid "Results in a free-form input field that the user can type any string into."
msgstr ""
"resultiert in einem Eingabefeld freier Form, in das der Benutzer jegliche "
"Zeichenkette eingeben kann."

#. type: Content of: <chapter><section><section><section><section><title>
#: best-pkging-practices.dbk:1017
msgid "password"
msgstr "password"

#. type: Content of: <chapter><section><section><section><section><para>
#: best-pkging-practices.dbk:1019
msgid ""
"Prompts the user for a password.  Use this with caution; be aware that the "
"password the user enters will be written to debconf's database.  You should "
"probably clean that value out of the database as soon as is possible."
msgstr ""
"gibt dem Benutzer eine Eingabeaufforderung für ein Passwort aus. Benutzen Sie "
"dies mit Vorsicht. Vergegenwärtigen Sie sich, dass das Passwort, das der "
"Benutzer eingibt, in die Debconf-Datenbank geschrieben wird. Sie sollten "
"diesen Wert möglicherweise aus der Datenbank löschen, sobald dies möglich ist."

#. type: Content of: <chapter><section><section><section><section><title>
#: best-pkging-practices.dbk:1026
msgid "boolean"
msgstr "boolean"

#. type: Content of: <chapter><section><section><section><section><para>
#: best-pkging-practices.dbk:1028
msgid ""
"A true/false choice.  Remember: true/false, <emphasis role=\"strong\">not "
"yes/no</emphasis>..."
msgstr ""
"eine Auswahl »wahr/falsch«. Denken Sie daran: true/false, nicht <emphasis "
"role=\"strong\">yes/no</emphasis> ..."

#. type: Content of: <chapter><section><section><section><section><title>
#: best-pkging-practices.dbk:1034
msgid "select"
msgstr "select"

#. type: Content of: <chapter><section><section><section><section><para>
#: best-pkging-practices.dbk:1036
msgid ""
"A choice between one of a number of values.  The choices must be specified "
"in a field named 'Choices'.  Separate the possible values with commas and "
"spaces, like this: <literal>Choices: yes, no, maybe</literal>."
msgstr ""
"Eine Auswahl aus mehreren Werten. Die Auswahlmöglichkeiten müssen in einem "
"»Choices« benannten Feld angegeben werden. Trennen Sie die möglichen Werte "
"mit Komma und Leerzeichen, wie hier: <literal> Choices: yes, no, "
"maybe</literal>."

#. type: Content of: <chapter><section><section><section><section><para>
#: best-pkging-practices.dbk:1041
msgid ""
"If choices are translatable strings, the 'Choices' field may be marked as "
"translatable by using <literal>__Choices</literal>. The double underscore "
"will split out each choice in a separate string."
msgstr ""
"Falls Auswahlmöglichkeiten übersetzbare Zeichenketten sind, könnte das Feld "
"durch Benutzung von <literal>__Choices</literal> als übersetzbar "
"gekennzeichnet werden. Der doppelte Unterstrich wird jede Auswahl in eine "
"separate Zeichenkette heraustrennen."

#. type: Content of: <chapter><section><section><section><section><para>
#: best-pkging-practices.dbk:1046
msgid ""
"The <command>po-debconf</command> system also offers interesting "
"possibilities to only mark <emphasis role=\"strong\">some</emphasis> choices "
"as translatable.  Example:"
msgstr ""
"Das System <command>po-debconf</command> bietet außerdem interessante "
"Möglichkeiten nur <emphasis role=\"strong\">einige</emphasis> "
"Auswahlmöglichkeiten als übersetzbar zu kennzeichnen. Ein Beispiel:"

#. type: Content of: <chapter><section><section><section><section><programlisting>
#: best-pkging-practices.dbk:1051
#, no-wrap
msgid ""
"Template: foo/bar\n"
"Type: Select\n"
"#flag:translate:3\n"
"__Choices: PAL, SECAM, Other\n"
"_Description: TV standard:\n"
" Please choose the TV standard used in your country.\n"
msgstr ""
"Template: foo/bar\n"
"Type: Select\n"
"#flag:translate:3\n"
"__Choices: PAL, SECAM, Other\n"
"_Description: TV standard:\n"
" Please choose the TV standard used in your country.\n"

#. type: Content of: <chapter><section><section><section><section><para>
#: best-pkging-practices.dbk:1059
msgid ""
"In that example, only the 'Other' string is translatable while others are "
"acronyms that should not be translated. The above allows only 'Other' to be "
"included in PO and POT files."
msgstr ""
"In diesem Beispiel ist nur die Zeichenkette »Other« übersetzbar, während das "
"andere Abkürzungen sind, die nicht übersetzt werden sollten. Obiges "
"ermöglicht, dass nur »Other« in die POT- und PO-Dateien eingefügt wird."

#. type: Content of: <chapter><section><section><section><section><para>
#: best-pkging-practices.dbk:1064
msgid ""
"The debconf templates flag system offers many such possibilities. The "
"<citerefentry> <refentrytitle>po-debconf</refentrytitle> "
"<manvolnum>7</manvolnum> </citerefentry> manual page lists all these "
"possibilities."
msgstr ""
"Das Schaltersystem der Debconf-Schablonen bietet viele solcher Möglichkeiten. "
"Die Handbuchseite <citerefentry> <refentrytitle>po-debconf</refentrytitle> "
"<manvolnum>7</manvolnum> </citerefentry> führt all diese Möglichkeiten auf."

#. type: Content of: <chapter><section><section><section><section><title>
#: best-pkging-practices.dbk:1072
msgid "multiselect"
msgstr "multiselect"

#. type: Content of: <chapter><section><section><section><section><para>
#: best-pkging-practices.dbk:1074
msgid ""
"Like the select data type, except the user can choose any number of items "
"from the choices list (or chose none of them)."
msgstr ""
"Wie der Datentyp »select«, außer dass der Benutzer eine beliebige Anzahl von "
"Elementen aus der Auswahlliste auswählen kann (oder gar keins)."

#. type: Content of: <chapter><section><section><section><section><title>
#: best-pkging-practices.dbk:1080
msgid "note"
msgstr "note"

#. type: Content of: <chapter><section><section><section><section><para>
#: best-pkging-practices.dbk:1082
msgid ""
"Rather than being a question per se, this datatype indicates a note that can "
"be displayed to the user.  It should be used only for important notes that "
"the user really should see, since debconf will go to great pains to make "
"sure the user sees it; halting the install for them to press a key, and even "
"mailing the note to them in some cases."
msgstr ""
"Statt per se eine Frage zu sein, gibt dieser Datentyp eine Anmerkung an, die "
"dem Benutzer angezeigt werden kann. Sie sollte nur für wichtige Anmerkungen "
"benutzt werden, die der Benutzer wirklich sehen sollte, weil Debconf großen "
"Aufwand betreibt, um sicherzustellen, dass der Benutzer sie sieht und die "
"Installation anhält, so dass der Benutzer eine Taste drückt und sogar in "
"manchen Fällen eine Benachrichtigung per E-Mail bekommt."

#. type: Content of: <chapter><section><section><section><section><title>
#: best-pkging-practices.dbk:1091
msgid "text"
msgstr "text"

#. type: Content of: <chapter><section><section><section><section><para>
#: best-pkging-practices.dbk:1093
msgid "This type is now considered obsolete: don't use it."
msgstr "Dieser Typ wird nun als veraltet angesehen: Benutzen Sie ihn nicht."

#. type: Content of: <chapter><section><section><section><section><title>
#: best-pkging-practices.dbk:1098
msgid "error"
msgstr "error"

#. type: Content of: <chapter><section><section><section><section><para>
#: best-pkging-practices.dbk:1100
msgid ""
"This type is designed to handle error messages.  It is mostly similar to the "
"note type.  Frontends may present it differently (for instance, the dialog "
"frontend of cdebconf draws a red screen instead of the usual blue one)."
msgstr ""
"Dieser Typ wurde entworfen, um Fehlermeldungen zu handhaben. Er ist meist dem "
"Typ »note« ähnlich. Oberflächen könnten ihn unterschiedlich anzeigen (die "
"Oberfläche von Cdebconf zeichnet beispielsweise einen roten statt des "
"üblichen blauen Bildschirms)."

#. type: Content of: <chapter><section><section><section><section><para>
#: best-pkging-practices.dbk:1105
msgid ""
"It is recommended to use this type for any message that needs user attention "
"for a correction of any kind."
msgstr ""
"Es wird empfohlen, diesen Typ für jegliche Nachricht zu verwenden, die die "
"Aufmerksamkeit des Anwenders für irgendeine Art von Korrektur auf sich ziehen "
"muss."

#. type: Content of: <chapter><section><section><section><title>
#: best-pkging-practices.dbk:1113
msgid "Description: short and extended description"
msgstr "Description: Kurze und längere Beschreibung"

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1115
msgid ""
"Template descriptions have two parts: short and extended.  The short "
"description is in the Description: line of the template."
msgstr ""
"Schablonenbeschreibungen haben zwei Teile: kurz und länger. Die "
"Kurzbeschreibung steht in der Zeile »Description:« der Schablone."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1119
# FIXME s/accomodated/accommodated/
msgid ""
"The short description should be kept short (50 characters or so) so that it "
"may be accomodated by most debconf interfaces.  Keeping it short also helps "
"translators, as usually translations tend to end up being longer than the "
"original."
msgstr ""
"Die Kurzbeschreibung sollte knapp gehalten werden (ungefähr 50 Zeichen), so "
"dass sie in den meisten Debconf-Schnittstellen untergebracht werden kann. Es "
"hilft obendrein Übersetzern, wenn sie kurz gehalten wird, da Übersetzungen "
"normalerweise dazu neigen, länger als das Original zu sein."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1125
msgid ""
"The short description should be able to stand on its own.  Some interfaces "
"do not show the long description by default, or only if the user explicitely "
"asks for it or even do not show it at all.  Avoid things like What do you "
"want to do?"
msgstr ""
"Die Kurzbeschreibung sollte für sich allein stehen können. Einige "
"Schnittstellen zeigen standardmäßig die ausführliche Beschreibung nicht, nur "
"dann, wenn der Benutzer danach fragt oder sogar überhaupt nicht an. "
"Vermeiden Sie Dinge wie »Was möchten Sie tun?«"

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1131
msgid ""
"The short description does not necessarily have to be a full sentence.  This "
"is part of the keep it short and efficient recommendation."
msgstr ""
"Die Kurzbeschreibung muss nicht notwendigerweise aus einem vollständigen Satz "
"bestehen. Dies ist Teil der Forderung nach kurzen, brauchbaren Empfehlungen."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1135
msgid ""
"The extended description should not repeat the short description word for "
"word.  If you can't think up a long description, then first, think some "
"more.  Post to debian-devel.  Ask for help.  Take a writing class! That "
"extended description is important.  If after all that you still can't come "
"up with anything, leave it blank."
msgstr ""
"Die längere Beschreibung sollte die Kurzbeschreibung nicht Wort für Wort "
"wiederholen. Falls Ihnen keine ausführliche Beschreibung einfällt, denken Sie "
"zuerst etwas mehr nach. Schreiben Sie an Debian-devel. Bitten Sie um Hilfe. "
"Nehmen Sie Schreibunterricht! Diese längere Beschreibung ist wichtig. Falls "
"Sie nach allem noch immer nicht damit zurecht kommen, lassen Sie sie leer."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1142
msgid ""
"The extended description should use complete sentences.  Paragraphs should "
"be kept short for improved readability.  Do not mix two ideas in the same "
"paragraph but rather use another paragraph."
msgstr ""
"Die längere Beschreibung sollte in ganzen Sätzen verfasst sein. Absätze "
"sollten kurz gehalten werden, um die Leserlichkeit zu verbessern. Vermischen "
"Sie nicht zwei Ideen in einem Absatz, sondern benutzen Sie lieber einen "
"anderen Absatz."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1147
msgid ""
"Don't be too verbose.  User tend to ignore too long screens.  20 lines are "
"by experience a border you shouldn't cross, because that means that in the "
"classical dialog interface, people will need to scroll, and lot of people "
"just don't do that."
msgstr ""
"Seien Sie nicht zu gesprächig. Benutzer tendieren dazu, zu lange Bildflächen "
"zu ignorieren. 20 Zeilen sind erfahrungsgemäß die Grenze, die Sie nicht "
"überschreiten sollten, da dies bedeuted, dass Anwender klassische "
"Dialogfenster nicht scrollen müssen und viele Leute tun das einfach nicht."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1153
msgid ""
"The extended description should <emphasis role=\"strong\">never</emphasis> "
"include a question."
msgstr ""
"Die längere Beschreibung sollte <emphasis role=\"strong\">keine</emphasis> "
"Frage enthalten."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1157
msgid ""
"For specific rules depending on templates type (string, boolean, etc.), "
"please read below."
msgstr ""
"Um etwas über besondere Regeln zu erfahren, die vom Schablonentyp (string, "
"boolean etc.) abhängen, lesen Sie das Folgende."

#. type: Content of: <chapter><section><section><section><title>
#: best-pkging-practices.dbk:1163
msgid "Choices"
msgstr "Choices"

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1165
msgid ""
"This field should be used for select and multiselect types.  It contains the "
"possible choices which will be presented to users.  These choices should be "
"separated by commas."
msgstr ""
"Dieses Feld sollte für »select«- und »multiselect«-Typen verwandt werden. Es "
"enthält die Auswahlmöglichkeiten, die dem Benutzer angezeigt werden. Diese "
"Auswahlmöglichkeiten sollten durch Kommas getrennt werden."

#. type: Content of: <chapter><section><section><section><title>
#: best-pkging-practices.dbk:1172
msgid "Default"
msgstr "Default"

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1174
msgid ""
"This field is optional.  It contains the default answer for string, select "
"and multiselect templates.  For multiselect templates, it may contain a "
"comma-separated list of choices."
msgstr ""
"Dieses Feld ist optional. Es enthält die vorgegebene Antwort für die "
"»string«-, »select«- und »multiselect«-Schablonen. Für "
"»multiselect«-Schablonen könnte es eine durch Kommas getrennte Auswahlliste "
"enthalten."

#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:1183
msgid "Templates fields specific style guide"
msgstr "Stil-Anleitung speziell für Schablonenfelder"

#. type: Content of: <chapter><section><section><section><title>
#: best-pkging-practices.dbk:1185
msgid "Type field"
msgstr "Feld »Type«"

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1187
msgid ""
"No specific indication except: use the appropriate type by referring to the "
"previous section."
msgstr ""
"keine besondere Angabe, außer: Benutzen Sie den geeigneten Typ bezogen auf "
"den vorhergehenden Abschnitt."

#. type: Content of: <chapter><section><section><section><title>
#: best-pkging-practices.dbk:1193
msgid "Description field"
msgstr "Feld »Description«"

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1195
msgid ""
"Below are specific instructions for properly writing the Description (short "
"and extended) depending on the template type."
msgstr ""
"Es folgen spezifische Anweisungen für ordnungsgemäßes Verfassen der "
"Beschreibung (kurz und länger), abhängig vom Schablonentyp."

#. type: Content of: <chapter><section><section><section><section><title>
#: best-pkging-practices.dbk:1199
msgid "String/password templates"
msgstr "»string«-/»password«-Schablonen"

#. type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
#: best-pkging-practices.dbk:1203
msgid ""
"The short description is a prompt and <emphasis "
"role=\"strong\">not</emphasis> a title.  Avoid question style prompts (IP "
"Address?) in favour of opened prompts (IP address:).  The use of colons is "
"recommended."
msgstr ""
"Die Kurzbeschreibung ist eine Abfrage und <emphasis "
"role=\"strong\">kein</emphasis> Titel. Vermeiden Sie den Fragestil (IP "
"address?) und geben Sie offenen Abfragen (IP address:) den Vorzug. Es wird "
"empfohlen Doppelpunkte zu benutzen."

#. type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
#: best-pkging-practices.dbk:1210
msgid ""
"The extended description is a complement to the short description.  In the "
"extended part, explain what is being asked, rather than ask the same "
"question again using longer words.  Use complete sentences.  Terse writing "
"style is strongly discouraged."
msgstr ""
"Die längere Beschreibung ist eine Ergänzung der Kurzbeschreibung. Im "
"erweiterten Teil erklären Sie, was gefragt ist, anstatt die gleiche Frage in "
"längerer Formulierung wieder zu stellen. Benutzen Sie ganze Sätze. Von "
"knappem Schreibstil wird strikt abgeraten."

#. type: Content of: <chapter><section><section><section><section><title>
#: best-pkging-practices.dbk:1220
msgid "Boolean templates"
msgstr "»boolean«-Schablonen"

#. type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
#: best-pkging-practices.dbk:1224
# FIXME missing full stop
msgid ""
"The short description should be phrased in the form of a question which "
"should be kept short and should generally end with a question mark.  Terse "
"writing style is permitted and even encouraged if the question is rather "
"long (remember that translations are often longer than original versions)"
msgstr ""
"Die Kurzbeschreibung sollte in der Frageform ausgedrückt werden, die kurz "
"gehalten und generell mit einem Fragezeichen beendet werden sollte. Knapper "
"Schreibstil ist erlaubt und sogar gewollt, falls die Frage eher lang ist. "
"(Denken Sie daran, dass Übersetzungen oft länger als die Originalversionen "
"sind.)"

#. type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
#: best-pkging-practices.dbk:1232
msgid ""
"Again, please avoid referring to specific interface widgets.  A common "
"mistake for such templates is if you answer Yes-type constructions."
msgstr ""
"Nochmals: Bitte vermeiden Sie, sich auf Schnittstellen-spezifische Dinge zu "
"beziehen. Es ist ein häufiges Missverständnis bei solchen Schablonen, wenn "
"Sie Ja-Typ-Konstruktionen antworten."

#. type: Content of: <chapter><section><section><section><section><title>
#: best-pkging-practices.dbk:1240
msgid "Select/Multiselect"
msgstr "»select«/»multiselect«"

#. type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
#: best-pkging-practices.dbk:1244
msgid ""
"The short description is a prompt and <emphasis "
"role=\"strong\">not</emphasis> a title.  Do <emphasis "
"role=\"strong\">not</emphasis> use useless Please choose...  constructions.  "
"Users are clever enough to figure out they have to choose something...:)"
msgstr ""
"Die Kurzbeschreibung ist eine Abfrage und <emphasis "
"role=\"strong\">kein</emphasis> Titel. Benutzen Sie <emphasis "
"role=\"strong\">keine</emphasis> nutzlosen »Please choose...«-Konstruktionen. "
"Anwender sind klug genug herauszufinden, dass sie etwas auswählen sollen ... "
":)"

#. type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
#: best-pkging-practices.dbk:1252
msgid ""
"The extended description will complete the short description.  It may refer "
"to the available choices.  It may also mention that the user may choose more "
"than one of the available choices, if the template is a multiselect one "
"(although the interface often makes this clear)."
msgstr ""
"Die längere Beschreibung wird die Kurzbeschreibung vervollständigen. Sie "
"könnte sich auf die verfügbaren Auswahlmöglichkeiten beziehen. Sie könnte "
"zudem erwähnen, dass der Anwender unter mehr als einer verfügbaren "
"Auswahlmöglichkeit wählen kann, falls es sich um eine »multiselect«-Schablone "
"handelt."

#. type: Content of: <chapter><section><section><section><section><title>
#: best-pkging-practices.dbk:1262
msgid "Notes"
msgstr "»notes«"

#. type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
#: best-pkging-practices.dbk:1266
msgid ""
"The short description should be considered to be a <emphasis "
"role=\"strong\">title</emphasis>."
msgstr ""
"Die Kurzbeschreigung sollte als <emphasis role=\"strong\">Titel</emphasis> "
"betrachtet werden."

#. type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
#: best-pkging-practices.dbk:1271
msgid ""
"The extended description is what will be displayed as a more detailed "
"explanation of the note.  Phrases, no terse writing style."
msgstr ""
"Die längere Beschreibung ist das, was als detaillierte Erklärung der Notiz "
"angezeigt wird. Sätze, kein knapper Schreibstil."

#. type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
#: best-pkging-practices.dbk:1277
msgid ""
"<emphasis role=\"strong\">Do not abuse debconf.</emphasis> Notes are the "
"most common way to abuse debconf.  As written in debconf-devel manual page: "
"it's best to use them only for warning about very serious problems.  The "
"<filename>NEWS.Debian</filename> or <filename>README.Debian</filename> files "
"are the appropriate location for a lot of notes.  If, by reading this, you "
"consider converting your Note type templates to entries in "
"<filename>NEWS.Debian</filename> or <filename>README.Debian</filename>, plus "
"consider keeping existing translations for the future."
msgstr ""
"<emphasis role=\"strong\">Missbrauchen Sie Debconf nicht.</emphasis> Notizen "
"sind die häufigste Art, auf die Debconf missbraucht wird. Wie steht doch in "
"der Handbuchseite von »debconf-devel« geschrieben: Es ist am Besten, dies nur "
"für Warnungen über sehr ernsthafte Probleme zu benutzen. Die Dateien "
"<filename>NEWS.Debian</filename> oder <filename>README.Debian</filename> sind "
"für viele Notizen der passende Ort. Denken Sie, wenn Sie dies lesen, darüber "
"nach, Ihre Schablonen des Typs »notes« zu Einträgen in "
"<filename>NEWS.Debian</filename> oder <filename>README.Debian</filename> "
"umzuwandeln und existierende Übersetzungen für die Zukunft aufzubewahren."

#. type: Content of: <chapter><section><section><section><title>
#: best-pkging-practices.dbk:1292
msgid "Choices field"
msgstr "Das Feld »Choices«"

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1294
msgid ""
"If the Choices are likely to change often, please consider using the "
"__Choices trick.  This will split each individual choice into a single "
"string, which will considerably help translators for doing their work."
msgstr ""
"Falls sich »Choices« zu oft ändert, sollten Sie in Betracht ziehen, zum "
"__Choices-Trick zu greifen. Dies wird jede einzelne Auswahl in eine einzelne "
"Zeichenkette aufteilen, was Übersetzern beträchtlich bei ihrer Arbeit helfen "
"wird."

#. type: Content of: <chapter><section><section><section><title>
#: best-pkging-practices.dbk:1301 best-pkging-practices.dbk:1339
msgid "Default field"
msgstr "Das Feld »Default«"

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1303
msgid ""
"If the default value, for a select template, is likely to vary depending on "
"the user language (for instance, if the choice is a language choice), please "
"use the _Default trick."
msgstr ""
"Falls der Vorgabewert für eine Auswahlschablone sich wahrscheinlich abhängig "
"von der Sprache des Anwenders unterscheidet (zum Beispiel, weil es sich bei "
"der Auswahl um eine Sprachauswahl handelt), benutzen Sie bitte den "
"_Default-Trick."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1308
msgid ""
"This special field allow translators to put the most appropriate choice "
"according to their own language.  It will become the default choice when "
"their language is used while your own mentioned Default Choice will be used "
"when using English."
msgstr ""
"Dieses Spezialfeld ermöglicht Übersetzern, die am Besten zu ihrer Sprache "
"passende Auswahl zu nehmen. Es wird die vorgegebene Auswahl sein, wenn "
"ihre Sprache benutzt wird, während Ihre eigene erwähnte »Default Choice« "
"benutzt wird, wenn Sie Englisch benutzen."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1314
msgid "Example, taken from the geneweb package templates:"
msgstr "Ein Beispiel aus den Schablonen des Pakets Geneweb:"

#. type: Content of: <chapter><section><section><section><screen>
#: best-pkging-practices.dbk:1317
#, no-wrap
msgid ""
"Template: geneweb/lang\n"
"Type: select\n"
"__Choices: Afrikaans (af), Bulgarian (bg), Catalan (ca), Chinese (zh), Czech "
"(cs), Danish (da), Dutch (nl), English (en), Esperanto (eo), Estonian (et), "
"Finnish (fi), French (fr), German (de), Hebrew (he), Icelandic (is), Italian "
"(it), Latvian (lv), Norwegian (no), Polish (pl), Portuguese (pt), Romanian "
"(ro), Russian (ru), Spanish (es), Swedish (sv)\n"
"# This is the default choice. Translators may put their own language here\n"
"# instead of the default.\n"
"# WARNING : you MUST use the ENGLISH NAME of your language\n"
"# For instance, the french translator will need to put French (fr) here.\n"
"_Default: English[ translators, please see comment in PO files]\n"
"_Description: Geneweb default language:\n"
msgstr ""
"Template: geneweb/lang\n"
"Type: select\n"
"__Choices: Afrikaans (af), Bulgarian (bg), Catalan (ca), Chinese (zh), Czech "
"(cs), Danish (da), Dutch (nl), English (en), Esperanto (eo), Estonian (et), "
"Finnish (fi), French (fr), German (de), Hebrew (he), Icelandic (is), Italian "
"(it), Latvian (lv), Norwegian (no), Polish (pl), Portuguese (pt), Romanian "
"(ro), Russian (ru), Spanish (es), Swedish (sv)\n"
"# This is the default choice. Translators may put their own language here\n"
"# instead of the default.\n"
"# WARNING : you MUST use the ENGLISH NAME of your language\n"
"# For instance, the french translator will need to put French (fr) here.\n"
"_Default: English[ translators, please see comment in PO files]\n"
"_Description: Geneweb default language:\n"

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1328
msgid ""
"Note the use of brackets which allow internal comments in debconf fields.  "
"Also note the use of comments which will show up in files the translators "
"will work with."
msgstr ""
"Beachten Sie, dass die Benutzung von Klammern Kommentare in Debconf-Feldern "
"erlaubt. Beachten Sie außerdem, dass die Benutzung von Kommentaren in Dateien "
"zu sehen sein wird, mit denen Übersetzer arbeiten."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1333
msgid ""
"The comments are needed as the _Default trick is a bit confusing: the "
"translators may put their own choice"
msgstr ""
"Die Kommentare werden benötigt, da der _Default-Trick etwas verwirrendes ist: "
"Die Übersetzer könnten ihre eigene Auswahl nehmen."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1341
msgid ""
"Do NOT use empty default field.  If you don't want to use default values, do "
"not use Default at all."
msgstr ""
"Benutzen Sie KEIN leeres »Default«-Feld. Falls Sie keine Vorgabewerte "
"benutzen möchten, benutzen Sie Default überhaupt nicht."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1345
msgid ""
"If you use po-debconf (and you <emphasis role=\"strong\">should</emphasis>, "
"see <xref linkend=\"s6.5.2.2\"/>), consider making this field translatable, "
"if you think it may be translated."
msgstr ""
"Falls Sie Po-debconf benutzen (und das <emphasis "
"role=\"strong\">sollten </emphasis> Sie, lesen Sie <xref "
"linkend=\"s6.5.2.2\"/>), erwägen Sie, dieses Feld übersetzbar zu machen, wenn "
"Sie der Meinung sind, es könnte übersetzt werden."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1350
# FIXME superfluous second bracket
msgid ""
"If the default value may vary depending on language/country (for instance "
"the default value for a language choice), consider using the special "
"_Default type documented in <citerefentry> "
"<refentrytitle>po-debconf</refentrytitle> <manvolnum>7</manvolnum> "
"</citerefentry>)."
msgstr ""
"Falls der Vorgabewert von Sprache oder Land abhängen könnte (zum Beispiel, "
"weil es sich bei der Auswahl um eine Sprachauswahl handelt), ziehen Sie in "
"Betracht, den Typ _Default zu benutzen, der in <citerefentry> "
"<refentrytitle>po-debconf</refentrytitle> <manvolnum>7</manvolnum> "
"</citerefentry> dokumentiert wird."

#. type: Content of: <chapter><section><title>
#: best-pkging-practices.dbk:1362
msgid "Internationalization"
msgstr "Internationalisierung"

#. type: Content of: <chapter><section><para>
#: best-pkging-practices.dbk:1364
msgid ""
"This section contains global information for developers to make translators' "
"life easier.  More information for translators and developers interrested in "
"internationalization are available in the <ulink "
"url=\"&url-i18n-l10n;\">Internationalisation and localisation in "
"Debian</ulink> documentation."
msgstr ""
"Der zweite Abschnitt enthält globale Informationen für Entwickler, um "
"Übersetzern das Leben leichter zu machen. Weitere Informationen für "
"Übersetzer und Entwickler, die sich für Internationalisierung interessieren, "
"sind in der Dokumentation <ulink "
"url=\"&url-i18n-l10n;\">Internationalisierung und Lokalisierung</ulink> "
"verfügbar."

#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:1371
msgid "Handling debconf translations"
msgstr "Handhabung von Debconf-Übersetzungen"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1373
msgid ""
"Like porters, translators have a difficult task.  They work on many packages "
"and must collaborate with many different maintainers.  Moreover, most of the "
"time, they are not native English speakers, so you may need to be "
"particularly patient with them."
msgstr ""
"Wie Portierende haben auch Übersetzer noch andere Aufgaben. Sie arbeiten an "
"vielen Paketen und müssen mit vielen verschiedenen Paketbetreuern "
"zusammenwirken. Außerdem ist Englisch meist nicht ihre Muttersprache. Sie "
"sollten ihnen daher besondere Geduld entgegenbringen."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1379
msgid ""
"The goal of <systemitem role=\"package\">debconf</systemitem> was to make "
"packages configuration easier for maintainers and for users.  Originally, "
"translation of debconf templates was handled with "
"<command>debconf-mergetemplate</command>.  However, that technique is now "
"deprecated; the best way to accomplish <systemitem "
"role=\"package\">debconf</systemitem> internationalization is by using the "
"<systemitem role=\"package\">po-debconf</systemitem> package.  This method "
"is easier both for maintainer and translators; transition scripts are "
"provided."
msgstr ""
"Das Ziel von <systemitem role=\"package\">debconf</systemitem> war die "
"Vereinfachung der Paketkonfiguration für Betreuer und Anwender. Ursprünglich "
"wurde die Übersetzung von Debconf-Schablonen mit "
"<command>debconf-mergetemplate</command> gehandhabt. Nun wird diese Technik "
"jedoch missbilligt. Die Internationalisierung von <systemitem "
"role=\"package\">debconf</systemitem> ist am besten mit dem Paket <systemitem "
"role=\"package\">po-debconf</systemitem> zu erreichen. Diese Methode ist "
"sowohl für Betreuer als auch für Übersetzer einfacher. Es werden "
"Umwandlungsskripte bereitgestellt."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1389
msgid ""
"Using <systemitem role=\"package\">po-debconf</systemitem>, the translation "
"is stored in <filename>.po</filename> files (drawing from "
"<command>gettext</command> translation techniques).  Special template files "
"contain the original messages and mark which fields are translatable.  When "
"you change the value of a translatable field, by calling "
"<command>debconf-updatepo</command>, the translation is marked as needing "
"attention from the translators.  Then, at build time, the "
"<command>dh_installdebconf</command> program takes care of all the needed "
"magic to add the template along with the up-to-date translations into the "
"binary packages.  Refer to the <citerefentry> "
"<refentrytitle>po-debconf</refentrytitle> <manvolnum>7</manvolnum> "
"</citerefentry> manual page for details."
msgstr ""
"Wenn <systemitem role=\"package\">po-debconf</systemitem> benutzt wird, "
"werden sie Übersetzungen in <filename>.po</filename>-Dateien gespeichert "
"(mit <command>gettext</command>-Übersetzungstechniken herausgezogen). "
"Spezielle Schablonendateien enthalten die Originalnachrichten und "
"markieren, welche Felder übersetzbar sind. Wenn Sie den Wert eines "
"übersetzbaren Feldes durch Aufruf von <command>debconf-updatepo</command> "
"ändern, wird die Übersetzung  für Übersetzerals aufmerksamkeitsbedürfend "
"gekennzeichnet. Dann, zur Build-Zeit, wird das Programm "
"<command>dh_installdebconf</command> wie von Zauberhand dafür sorgen, dass "
"alle Schablonen zusammen mit den aktuellen Übersetzungen in die Binärpakete "
"einfließen. Weitere Einzelheiten können Sie der Handbuchseite <citerefentry> "
"<refentrytitle>po-debconf</refentrytitle> <manvolnum>7</manvolnum> "
"</citerefentry> entnehmen."

#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:1405
msgid "Internationalized documentation"
msgstr "Internationalisierte Dokumentation"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1407
msgid ""
"Internationalizing documentation is crucial for users, but a lot of labor.  "
"There's no way to eliminate all that work, but you can make things easier "
"for translators."
msgstr ""
"Internationalisierte Dokumentation für Anwender ist wichtig, bereitet aber "
"viel Mühe. Es gibt keine Möglichkeit, all diese Arbeit zu beseitigen, aber "
"Sie können den Übersetzern einige Dinge erleichtern."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1412
msgid ""
"If you maintain documentation of any size, it is easier for translators if "
"they have access to a source control system.  That lets translators see the "
"differences between two versions of the documentation, so, for instance, "
"they can see what needs to be retranslated.  It is recommended that the "
"translated documentation maintain a note about what source control revision "
"the translation is based on.  An interesting system is provided by <ulink "
"url=\"&url-i18n-doc-check;\">doc-check</ulink> in the <systemitem "
"role=\"package\">debian-installer</systemitem> package, which shows an "
"overview of the translation status for any given language, using structured "
"comments for the current revision of the file to be translated and, for a "
"translated file, the revision of the original file the translation is based "
"on.  You might wish to adapt and provide that in your VCS area."
msgstr ""
"Falls Sie Dokumentationen in irgendwelchem Umfang betreuen, ist es für "
"Übersetzer einfacher, wenn Sie Zugriff auf das Versionsverwaltungssystem "
"haben. Dadurch können Übersetzer die Unterschiede zwischen zwei Versionen der "
"Dokumentation anschauen, so dass sie beispielsweise sehen können, was neu "
"übersetzt werden muss. Es wird empfohlen, dass die übersetzte Dokumentation "
"eine Notiz darüber bereithält, auf welcher Revision der Quellenverwaltung die "
"Übersetzung basiert. Ein interessantes System wird von <ulink "
"url=\"&url-i18n-doc-check;\">doc-check</ulink> aus dem <systemitem "
"role=\"package\">debian-installer</systemitem>-Paket bereitgestellt, das eine "
"Übersicht über den Übersetzungsstatus für eine angegebene Sprache anzeigt. "
"Dazu werden strukturierte Kommentare für die aktuelle Revision der zu "
"übersetzenden Datei und für eine übersetzte Datei die Revision des Originals "
"auf der die Übersetzung basiert, angezeigt. Möglicherweise möchten Sie dies "
"anpassen und in Ihrem VCS-Bereich bereitstellen."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1426
msgid ""
"If you maintain XML or SGML documentation, we suggest that you isolate any "
"language-independent information and define those as entities in a separate "
"file which is included by all the different translations.  This makes it "
"much easier, for instance, to keep URLs up to date across multiple files."
msgstr ""
"Falls Sie XML- oder SGML-Dokumentationen betreuen, wird geraten, dass Sie "
"jegliche sprachabhängigen Informationen isolieren und diese als Instanzen in "
"einer separaten Datei definieren, die in allen verschiedenen Übersetzungen "
"enthalten ist. Dies macht es beispielsweise viel einfacher, URLs über mehrere "
"Dateien hinweg aktuell zu halten."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1432
msgid ""
"Some tools (e.g. <systemitem role=\"package\">po4a</systemitem>, <systemitem "
"role=\"package\">poxml</systemitem>, or the <systemitem "
"role=\"package\">translate-toolkit</systemitem>) are specialized in "
"extracting the translatable material from different formats.  They produce "
"PO files, a format quite common to translators, which permits to see what "
"needs to be retranslated when the translated document is updated."
msgstr ""
"Einige Werkzeuge (z.B. <systemitem role=\"package\">po4a</systemitem>, "
"<systemitem role=\"package\">poxml</systemitem> oder <systemitem "
"role=\"package\">translate-toolkit</systemitem>) sind darauf spezialisiert, "
"übersetzbares Material aus verschiedenen Formaten zu extrahieren. Sie "
"erstellen PO-Dateien, ein für Übersetzer ziemlich häufiges Format, das eine "
"Übersicht darüber gibt, was übersetzt werden muss, wenn das übersetzte "
"Dokument aktualisiert wurde."

#. type: Content of: <chapter><section><title>
#: best-pkging-practices.dbk:1444
msgid "Common packaging situations"
msgstr "Übliche Paketierungssituationen"

#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:1455
msgid "Packages using <command>autoconf</command>/<command>automake</command>"
msgstr "Pakete benutzen <command>autoconf</command>/<command>automake</command>"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1457
msgid ""
"Keeping <command>autoconf</command>'s <filename>config.sub</filename> and "
"<filename>config.guess</filename> files up to date is critical for porters, "
"especially on more volatile architectures.  Some very good packaging "
"practices for any package using <command>autoconf</command> and/or "
"<command>automake</command> have been synthesized in &file-bpp-autotools; "
"from the <systemitem role=\"package\">autotools-dev</systemitem> package.  "
"You're strongly encouraged to read this file and to follow the given "
"recommendations."
msgstr ""
"Die Dateien <filename>config.sub</filename> und "
"<filename>config.guess</filename> von <command>autoconf</command> aktuell zu "
"halten ist für Portierende kritisch, insbesondere auf eher unbeständigen "
"Architekturen. Einige sehr gute Paketierungsvorgehensweisen für irgendwelche "
"Pakete, die <command>autoconf</command> und/oder <command>automake</command> "
"benutzen, wurden in &file-bpp-autotools; aus dem Paket <systemitem "
"role=\"package\">autotools-dev</systemitem> zusammengefasst. Es wird "
"eindringlich geraten, diese Datei und die folgenden Empfehlungen zu lesen."

#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:1469
msgid "Libraries"
msgstr "Bibliotheken"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1471
msgid ""
"Libraries are always difficult to package for various reasons.  The policy "
"imposes many constraints to ease their maintenance and to make sure upgrades "
"are as simple as possible when a new upstream version comes out.  Breakage "
"in a library can result in dozens of dependent packages breaking."
msgstr ""
"Bibliotheken unterscheiden sich immer von Paketen aus unterschiedlichen "
"Gründen. Die Richtlinien verhängen mehrere Beschränkungen, um ihre Verwaltung "
"zu erleichtern und sicherzustellen, dass Upgrades so einfach wie möglich "
"sind, wenn eine neue Originalversion herauskommt. Eine kaputte Bibliothek "
"kann dazu führen, dass Dutzende davon abhängige Pakete kaputtgehen."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1477
msgid ""
"Good practices for library packaging have been grouped in <ulink "
"url=\"&url-libpkg-guide;\">the library packaging guide</ulink>."
msgstr ""
"Gute Vorgehensweisen für das Paketieren von Bibliotheken wurden in der <ulink "
"url=\"&url-libpkg-guide;\">Anleitung zum Paketieren von Bibliotheken</ulink> "
"zusammengefasst."

#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:1484
msgid "Documentation"
msgstr "Dokumentation"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1486
msgid ""
"Be sure to follow the <ulink url=\"&url-debian-policy;ch-docs.html\">Policy "
"on documentation</ulink>."
msgstr ""
"Achten Sie darauf, dass Sie den <ulink "
"url=\"&url-debian-policy;ch-docs.html\">Richtlinien für Dokumentation</ulink> "
"folgen."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1491
msgid ""
"If your package contains documentation built from XML or SGML, we recommend "
"you not ship the XML or SGML source in the binary package(s).  If users want "
"the source of the documentation, they should retrieve the source package."
msgstr ""
"Falls Ihr Paket Dokumentation enthält, die aus XML oder SGML erstellt wurde, "
"wird empfohlen, nicht die XML- oder SGML-Quellen im (in den) Binärpaket(en) "
"mitzuliefern. Falls Anwender die Quelle der Dokumentation möchten, sollten "
"sie die Paketquelle abrufen."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1496
msgid ""
"Policy specifies that documentation should be shipped in HTML format.  We "
"also recommend shipping documentation in PDF and plain text format if "
"convenient and if output of reasonable quality is possible.  However, it is "
"generally not appropriate to ship plain text versions of documentation whose "
"source format is HTML."
msgstr ""
"Die Richtlinie gibt an, dass die Dokumentation im HTML-Format weitergegeben "
"werden sollte. Außerdem wird empfohlen, die Dokumentation im PDF-Format und "
"als Klartext mitzuliefern, falls geeignet und falls die Ausgabe in einer "
"vernünftigen Qualität möglich ist. Es ist allgemein jedoch nicht angemessen, "
"Klartextversionen von Dokumentationen mitzuliefern, deren Quellformat HTML "
"ist."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1503
msgid ""
"Major shipped manuals should register themselves with <systemitem "
"role=\"package\">doc-base</systemitem> on installation.  See the <systemitem "
"role=\"package\">doc-base</systemitem> package documentation for more "
"information."
msgstr ""
"Bedeutende mitgelieferte Handbücher sollten sich selbst bei der Installation "
"mit <systemitem role=\"package\">doc-base</systemitem> registrieren. Weitere "
"Einzelheiten erhalten Sie in der Dokumentation des Pakets <systemitem "
"role=\"package\">doc-base</systemitem>."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1509
msgid ""
"Debian policy (section 12.1) directs that manual pages should accompany "
"every program, utility, and function, and suggests them for other objects "
"like configuration files. If the work you are packaging does not have such "
"manual pages, consider writing them for inclusion in your package, and "
"submitting them upstream."
msgstr ""
"Die Debian-Richtlinien (Abschnitt 12.1) schreiben vor, dass Handbuchseiten "
"jedes Programm, jedes Hilfswerkzeug und jede Funktion begleiten sollten und "
"für andere Objekte, wie Konfigurationsdateien, nahegelegt werden. Falls die "
"von Ihnen paketierte Arbeit nicht über eine solche Handbuchseite verfügt, "
"dann überlegen Sie sich, eine zu schreiben, die Ihrem Paket beigefügt und an "
"die Originalautoren gesandt wird."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1516
msgid ""
"The manpages do not need to be written directly in the troff format.  "
"Popular source formats are Docbook, POD and reST, which can be converted "
"using <command>xsltproc</command>, <command>pod2man</command> and "
"<command>rst2man</command> respectively. To a lesser extent, the "
"<command>help2man</command> program can also be used to write a stub."
msgstr ""
"Die Handbuchseiten müssen nicht direkt im Troff-Format geschrieben werden. "
"Beliebte Quellformate sind Docbook, POD und reST, die mit "
"<command>xsltproc</command>, <command>pod2man</command> beziehungsweise "
"<command>rst2man</command> umgewandelt werden können. In geringerem Maße kann "
"außerdem das Programm <command>help2man</command> benutzt werden, um einen "
"Abschnitt zu schreiben."

#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:1525
msgid "Specific types of packages"
msgstr "Besondere Pakettypen"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1527
msgid ""
"Several specific types of packages have special sub-policies and "
"corresponding packaging rules and practices:"
msgstr ""
"Mehrere besondere Typen von Paketen haben spezielle Unterrichtlinien und "
"zugehörige Paketierungsregeln und -Vorgehensweisen:"

#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
#: best-pkging-practices.dbk:1533
msgid ""
"Perl related packages have a <ulink url=\"&url-perl-policy;\">Perl "
"policy</ulink>, some examples of packages following that policy are "
"<systemitem role=\"package\">libdbd-pg-perl</systemitem> (binary perl "
"module) or <systemitem role=\"package\">libmldbm-perl</systemitem> (arch "
"independent perl module)."
msgstr ""
"Perl zugehörige Pakete haben eine <ulink "
"url=\"&url-perl-policy;\">Perl-Richtlinie</ulink>. Einige Beispiele für "
"Pakete, die dieser Richtlinie folgen, sind <systemitem "
"role=\"package\">libdbd-pg-perl</systemitem> (binäres Perl-Modul) oder "
"<systemitem role=\"package\">libmldbm-perl</systemitem> "
"(architekturunabhängiges Perl-Modul)."

#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
#: best-pkging-practices.dbk:1542
msgid ""
"Python related packages have their python policy; see &file-python-policy; "
"in the <systemitem role=\"package\">python</systemitem> package."
msgstr ""
"Python zugehörige Pakete haben ihre Python-Richtlinie. Siehe "
"&file-python-policy; im Paket <systemitem "
"role=\"package\">python</systemitem>."

#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
#: best-pkging-practices.dbk:1549
msgid ""
"Emacs related packages have the <ulink url=\"&url-emacs-policy;\">emacs "
"policy</ulink>."
msgstr ""
"Emacs zugehörige Pakete haben die <ulink "
"url=\"&url-emacs-policy;\">Emacs-Richtlinie</ulink>."

#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
#: best-pkging-practices.dbk:1556
msgid ""
"Java related packages have their <ulink url=\"&url-java-policy;\">java "
"policy</ulink>."
msgstr ""
"Java zugehörige Pakete haben ihre <ulink "
"url=\"&url-java-policy;\">Java-Richtlinie</ulink>."

#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
#: best-pkging-practices.dbk:1563
msgid ""
"Ocaml related packages have their own policy, found in &file-ocaml-policy; "
"from the <systemitem role=\"package\">ocaml</systemitem> package.  A good "
"example is the <systemitem role=\"package\">camlzip</systemitem> source "
"package."
msgstr ""
"Ocaml zugehörige Pakete haben ihre eigene Richtlinie, die unter "
"&file-ocaml-policy; im Paket <systemitem role=\"package\">ocaml</systemitem> "
"gefunden werden kann. Ein gutes Beispiel ist das Quellpaket <systemitem "
"role=\"package\">camlzip</systemitem>."

#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
#: best-pkging-practices.dbk:1571
msgid ""
"Packages providing XML or SGML DTDs should conform to the recommendations "
"found in the <systemitem role=\"package\">sgml-base-doc</systemitem> "
"package."
msgstr ""
"Pakete, die XML- oder SGML-DTDs bereitstellen, sollten konform zu den "
"Empfehlungen in Paket <systemitem role=\"package\">sgml-base-doc</systemitem> "
"sein."

#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
#: best-pkging-practices.dbk:1577
msgid ""
"Lisp packages should register themselves with <systemitem "
"role=\"package\">common-lisp-controller</systemitem>, about which see "
"&file-lisp-controller;."
msgstr ""
"Lisp-Pakete sollten sich selbst mit <systemitem "
"role=\"package\">common-lisp-controller</systemitem> registrieren. Siehe dazu "
"&file-lisp-controller;."

#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:1607
msgid "Architecture-independent data"
msgstr "Architekturunabhängige Daten"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1609
msgid ""
"It is not uncommon to have a large amount of architecture-independent data "
"packaged with a program.  For example, audio files, a collection of icons, "
"wallpaper patterns, or other graphic files.  If the size of this data is "
"negligible compared to the size of the rest of the package, it's probably "
"best to keep it all in a single package."
msgstr ""
"Es ist nicht unüblich, eine größere Menge architekturunabhängiger Daten mit "
"einem Programm zu paketieren, Zum Beispiel Audiodateien, eine Symbolsammlung, "
"Hintergrundmuster oder grafische Dateien. Falls die Größe dieser Daten "
"vernachlässigbar im Vergleich zum Rest des Pakets ist, ist es wahrscheinlich "
"am besten, alles in einem einzelnen Paket zu halten."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1616
msgid ""
"However, if the size of the data is considerable, consider splitting it out "
"into a separate, architecture-independent package "
"(<filename>_all.deb</filename>).  By doing this, you avoid needless "
"duplication of the same data into eleven or more .debs, one per each "
"architecture.  While this adds some extra overhead into the "
"<filename>Packages</filename> files, it saves a lot of disk space on Debian "
"mirrors.  Separating out architecture-independent data also reduces "
"processing time of <command>lintian</command> (see <xref "
"linkend=\"tools-lint\"/>) when run over the entire Debian archive."
msgstr ""
"Ist die Größe allerdings beachtlich, denken Sie darüber nach, sie in ein "
"separates architekturunabhängiges Paket (<filename>_all.deb</filename>) "
"auszulagern. Imdem Sie dies tun, vermeiden Sie nutzlose Vervielfältigung der "
"gleichen Daten in elf oder mehr .debs, eins je Architektur. Indem dies "
"einigen zusätzlichen Zuschlag zu den <filename>Packages</filename>-Dateien "
"hinzufügt, spart es viel Plattenplatz auf Debian-Spiegeln. Das Heraustrennen "
"architekturunabhängiger Daten vermindert auch die Ausführungszeit von "
"<command>lintian</command> (siehe <xref linkend=\"tools-lint\"/>), wenn es "
"für das ganze Debian-Archiv ausgeführt wird."

#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:1628
msgid "Needing a certain locale during build"
msgstr "Eine bestimmte Locale wird während des Builds benötigt"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1630
msgid ""
"If you need a certain locale during build, you can create a temporary file "
"via this trick:"
msgstr ""
"Falls Sie eine bestimmte Locale während des Builds benötigen, können Sie "
"mittels dieses Tricks eine temporäre Datei erstellen:"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1634
msgid ""
"If you set <varname>LOCPATH</varname> to the equivalent of "
"<filename>/usr/lib/locale</filename>, and <varname>LC_ALL</varname> to the "
"name of the locale you generate, you should get what you want without being "
"root.  Something like this:"
msgstr ""
"Falls Sie <varname>LOCPATH</varname> auf die Entsprechung von "
"<filename>/usr/lib/locale</filename> und <varname>LC_ALL</varname> auf den "
"Namen der Locale setzen, die sie generieren, sollten Sie erreichen, was Sie "
"möchten ohne dass Sie Root sind. Etwas wie Folgendes:"

#. type: Content of: <chapter><section><section><screen>
#: best-pkging-practices.dbk:1639
#, no-wrap
msgid ""
"LOCALE_PATH=debian/tmpdir/usr/lib/locale\n"
"LOCALE_NAME=en_IN\n"
"LOCALE_CHARSET=UTF-8\n"
"\n"
"mkdir -p $LOCALE_PATH\n"
"localedef -i $LOCALE_NAME.$LOCALE_CHARSET -f $LOCALE_CHARSET "
"$LOCALE_PATH/$LOCALE_NAME.$LOCALE_CHARSET\n"
"\n"
"# Using the locale\n"
"LOCPATH=$LOCALE_PATH LC_ALL=$LOCALE_NAME.$LOCALE_CHARSET date\n"
msgstr ""
"LOCALE_PATH=debian/tmpdir/usr/lib/locale\n"
"LOCALE_NAME=en_IN\n"
"LOCALE_CHARSET=UTF-8\n"
"\n"
"mkdir -p $LOCALE_PATH\n"
"localedef -i $LOCALE_NAME.$LOCALE_CHARSET -f $LOCALE_CHARSET "
"$LOCALE_PATH/$LOCALE_NAME.$LOCALE_CHARSET\n"
"\n"
"# Using the locale\n"
"LOCPATH=$LOCALE_PATH LC_ALL=$LOCALE_NAME.$LOCALE_CHARSET date\n"

#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:1652
msgid "Make transition packages deborphan compliant"
msgstr "Machen Sie vorübergehende Pakete Deborphan-konform"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1654
msgid ""
"Deborphan is a program for helping users to detect which packages can safely "
"be removed from the system, i.e.  the ones that have no packages depending "
"on them.  The default operation is to search only within the libs and "
"oldlibs sections, to hunt down unused libraries.  But when passed the right "
"argument, it tries to catch other useless packages."
msgstr ""
"Deborphan ist ein Programm, das Anwendern hilft Pakete aufzuspüren, die "
"sicher vom System entfernt werden können, d.h. diejenigen, von denen keine "
"Pakete abhängen. Die Standardoperation ist, nur innerhalb der Abschnitte "
"»libs« und »oldlibs« zu suchen, um Jagd auf unbenutzte Bibliotheken zu "
"machen. Wenn aber das richtige Argument übergeben wird, versucht es auch "
"andere nutzlose Pakete zu erwischen."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1661
msgid ""
"For example, with <literal>--guess-dummy</literal>, "
"<command>deborphan</command> tries to search all transitional packages which "
"were needed for upgrade but which can now safely be removed.  For that, it "
"looks for the string dummy or transitional in their short description."
msgstr ""
"Mit <literal>--guess-dummy</literal> versucht <command>deborphan</command> "
"zum Beispiel alle vorübergehenden Pakete zu suchen, die zum Upgrade benötigt "
"wurden, die nun aber sicher entfernt werden können. Dazu sucht es nach den "
"Zeichenketten »dummy« oder »transitional« in dessen Kurzbeschreibung."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1668
msgid ""
"So, when you are creating such a package, please make sure to add this text "
"to your short description.  If you are looking for examples, just run: "
"<command>apt-cache search .|grep dummy</command> or <command>apt-cache "
"search .|grep transitional</command>."
msgstr ""
"Wenn Sie also solch ein Paket erstellen, achten Sie bitte darauf, diesen Text "
"zu Ihrer Kurzbeschreibung hinzuzufügen. Falls Sie sich nach Beispielen "
"umsehen, führen Sie einfach <command>apt-cache search .|grep dummy</command> "
"oder <command>apt-cache search .|grep transitional</command> aus."

#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:1676
msgid "Best practices for <filename>.orig.tar.{gz,bz2,lzma}</filename> files"
msgstr ""
"Optimale Vorgehensweisen für "
"<filename>.orig.tar.{gz,bz2,lzma}</filename>-Dateien"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1678
msgid ""
"There are two kinds of original source tarballs: Pristine source and "
"repackaged upstream source."
msgstr ""
"Es gibt zwei Arten von Original-Quell-Tarballs: unberührte Quellen und neu "
"paketierte Quellen der Originalautoren."

#. type: Content of: <chapter><section><section><section><title>
#: best-pkging-practices.dbk:1682
msgid "Pristine source"
msgstr "Unberührte Quellen"

#. type: Content of: <chapter><section><section><section><para><footnote><para>
#: best-pkging-practices.dbk:1686
msgid ""
"We cannot prevent upstream authors from changing the tarball they distribute "
"without also incrementing the version number, so there can be no guarantee "
"that a pristine tarball is identical to what upstream "
"<emphasis>currently</emphasis> distributing at any point in time.  All that "
"can be expected is that it is identical to something that upstream once "
"<emphasis>did</emphasis> distribute.  If a difference arises later (say, if "
"upstream notices that he wasn't using maximal compression in his original "
"distribution and then re-<command>gzip</command>s it), that's just too bad.  "
"Since there is no good way to upload a new "
"<filename>.orig.tar.{gz,bz2,lzma}</filename> for the same version, there is "
"not even any point in treating this situation as a bug."
msgstr ""
"Originalautoren können nicht daran gehindert werden, den Tarball, den sie "
"verteilen, zu ändern ohne die Versionsnummer zu erhöhen, daher kann nicht "
"gewährleistet werden, dass ein unberührter Tarball mit dem identisch ist, was "
"die Originalautoren <emphasis>aktuell</emphasis> zu irgendeinem Zeitpunkt "
"weitergeben. Alles was erwartet werden kann, ist, dass es identisch ist mit "
"etwas ist, das die Originalautoren einmal weitergegeben "
"<emphasis>haben</emphasis>. Falls sich später ein Unterschied ergibt (etwa, "
"wenn die Originalautoren merken, dass sie in ihrer Distribution des Originals "
"keine maximale Komprimierung nutzen und es dann erneut mit "
"<command>gzip</command> packen), ist das einfach Pech. Da es keine brauchbare "
"Möglichkeit gibt, ein neues  <filename>.orig.tar.{gz,bz2,lzma}</filename> für "
"die gleiche Version hochzuladen, gibt es auch keinen Punkt, an dem diese "
"Situation als ein Fehler behandelt wird."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1684
msgid ""
"The defining characteristic of a pristine source tarball is that the "
"<filename>.orig.tar.{gz,bz2,lzma}</filename> file is byte-for-byte identical "
"to a tarball officially distributed by the upstream author.<placeholder "
"type=\"footnote\" id=\"0\"/> This makes it possible to use checksums to "
"easily verify that all changes between Debian's version and upstream's are "
"contained in the Debian diff.  Also, if the original source is huge, "
"upstream authors and others who already have the upstream tarball can save "
"download time if they want to inspect your packaging in detail."
msgstr ""
"Das charakteristische Merkmal eines unberührten Tarballs ist, dass die "
"<filename>.orig.tar.{gz,bz2,lzma}</filename>-Datei Byte für Byte identisch "
"mit einem offiziell weitergegebenen Tarball des Originalautors "
"ist.<placeholder type=\"footnote\" id=\"0\"/> Dies ermöglicht die Benutzung "
"von Prüfsummen, um auf einfache Weise alle Änderungen zwischen Debians "
"Version und der der Originalautoren zu prüfen, die in der Diff-Datei in "
"Debian enthalten sind. Falls außerdem die Originalquelle riesig ist, können "
"Originalautoren und andere, die bereits den Original-Tarball haben, "
"Download-Zeit sparen, falls sie Ihre Paketierung im Detail inspizieren "
"möchten."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1704
msgid ""
"There is no universally accepted guidelines that upstream authors follow "
"regarding to the directory structure inside their tarball, but "
"<command>dpkg-source</command> is nevertheless able to deal with most "
"upstream tarballs as pristine source.  Its strategy is equivalent to the "
"following:"
msgstr ""
"Es gibt keine allgemein anerkannten Richtlinien, denen Originalautoren "
"betreffend der Verzeichnisstruktur innerhalb ihres Tarballs folgen, aber "
"<command>dpkg-source</command> ist dennoch in der Lage mit den meisten "
"Tarballs von Originalautoren als unberührte Quelle umzugehen. Seine Strategie "
"entspricht dem Folgenden:"

#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:1712
msgid "It unpacks the tarball in an empty temporary directory by doing"
msgstr "Es entpackt den Tarball in eine leeres temporäres Verzeichnis mittels"

#. type: Content of: <chapter><section><section><section><orderedlist><listitem><screen>
#: best-pkging-practices.dbk:1715
#, no-wrap
msgid ""
"zcat "
"path/to/<replaceable>packagename</replaceable>_<replaceable>upstream-version</replaceable>.orig.tar.gz "
"| tar xf -\n"
msgstr ""
"zcat "
"path/to/<replaceable>Paketname</replaceable>_<replaceable>Originalversion"
"</replaceable>.orig.tar.gz | tar xf -\n"

#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:1720
msgid ""
"If, after this, the temporary directory contains nothing but one directory "
"and no other files, <command>dpkg-source</command> renames that directory to "
"<filename><replaceable>packagename</replaceable>-<replaceable>upstream-version</replaceable>(.orig)</filename>.  "
"The name of the top-level directory in the tarball does not matter, and is "
"forgotten."
msgstr ""
"Falls das temporäre Verzeichnis danach nur ein Verzeichnis und keine anderen "
"Dateien enthält, benennt <command>dpkg-source</command> dieses Verzeichnis in "
"<filename><replaceable>Paketname</replaceable>_<replaceable>Originalversion"
"</replaceable>(.orig)</filename> um. Der Name des Verzeichnisses auf der "
"obersten Ebene im Tarball ist ohne Bedeutung und geht verloren."

#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:1729
msgid ""
"Otherwise, the upstream tarball must have been packaged without a common "
"top-level directory (shame on the upstream author!).  In this case, "
"<command>dpkg-source</command> renames the temporary directory "
"<emphasis>itself</emphasis> to "
"<filename><replaceable>packagename</replaceable>-<replaceable>upstream-version</replaceable>(.orig)</filename>."
msgstr ""
"Andernfalls muss der Tarball der Originalautoren ohne ein sonst übliches "
"Verzeichnis der obersten Ebene gepackt worden sein (Schande über den "
"Originalautor!). In diesem Fall benennt <command>dpkg-source</command> das "
"temporäre Verzeichnis <emphasis>selbst</emphasis> in <filename><replaceable>Paketname"
"</replaceable>_<replaceable>Originalversion</replaceable>(.orig)</filename> "
"um."

#. type: Content of: <chapter><section><section><section><title>
#: best-pkging-practices.dbk:1740
msgid "Repackaged upstream source"
msgstr "Neu paketierte Originalquelle"

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1742
msgid ""
"You <emphasis role=\"strong\">should</emphasis> upload packages with a "
"pristine source tarball if possible, but there are various reasons why it "
"might not be possible.  This is the case if upstream does not distribute the "
"source as gzipped tar at all, or if upstream's tarball contains "
"non-DFSG-free material that you must remove before uploading."
msgstr ""
"Sie <emphasis role=\"strong\">sollten</emphasis> Pakete, wenn möglich, mit "
"einem unberührten Quell-Tarball hochladen, aber es gibt viele Gründe, warum "
"das manchmal nicht möglich ist. Dies ist der Fall, wenn die Originalautoren "
"die Quelle gar nicht als Gzip-gepackte Tar-Datei weitergeben oder falls der "
"Tarball der Originalautoren nicht DFSG-freies Material enthält, das Sie vor "
"den Hochladen entfernen müssen."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1749
msgid ""
"In these cases the developer must construct a suitable "
"<filename>.orig.tar.{gz,bz2,lzma}</filename> file himself.  We refer to such "
"a tarball as a repackaged upstream source.  Note that a repackaged upstream "
"source is different from a Debian-native package.  A repackaged source still "
"comes with Debian-specific changes in a separate "
"<filename>.diff.gz</filename> or "
"<filename>.debian.tar.{gz,bz2,lzma}</filename> and still has a version "
"number composed of <replaceable>upstream-version</replaceable> and "
"<replaceable>debian-version</replaceable>."
msgstr ""
"In diesen Fällen muss der Entwickler selbst eine geeignete "
"<filename>.orig.tar.{gz,bz2,lzma}</filename>-Datei bauen. Solch ein Tarball "
"wird neu paketierten Originalquellen zugeordnet. Beachten Sie, dass sich eine "
"neu paketierte Originalquelle von einem nativen Debian-Paket unterscheidet. "
"Eine neu paketierte Quelle kommt mit Debian-spezifischen Änderungen in einem "
"separaten <filename>.diff.gz</filename> oder "
"<filename>.debian.tar.{gz,bz2,lzma}</filename> daher und hat eine "
"Versionsnummer, die sich aus der <replaceable>Originalversion</replaceable> "
"und der <replaceable>Debian-version</replaceable> zusammensetzt."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1758
msgid ""
"There may be cases where it is desirable to repackage the source even though "
"upstream distributes a <filename>.tar.{gz,bz2,lzma}</filename> that could in "
"principle be used in its pristine form.  The most obvious is if "
"<emphasis>significant</emphasis> space savings can be achieved by "
"recompressing the tar archive or by removing genuinely useless cruft from "
"the upstream archive.  Use your own discretion here, but be prepared to "
"defend your decision if you repackage source that could have been pristine."
msgstr ""
"Es könnte Gründe geben, aus denen es wünschenswert wäre, die Quelle neu zu "
"paketieren, obwohl die Originalautoren ein "
"<filename>.tar.{gz,bz2,lzma}</filename> verteilen, dass im Prinzip in seiner "
"unberührten Form benutzt werden könnte. Der naheliegendste Grund ist, wenn "
"<emphasis>signifikante</emphasis> Platzersparnis durch Neukomprimierung des "
"Tar-Archivs oder Entfernen von wirklich nutzlosem Müll aus dem Qriginalarchiv "
"erzielt werden kann. Handeln Sie hier nach eigenem Ermessen, aber seien Sie "
"darauf vorbereitet, Ihre Entscheidung zu verteidigen, falls Sie eine Quelle "
"neu paketieren, die unberührt sein könnte."

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1767
msgid "A repackaged <filename>.orig.tar.{gz,bz2,lzma}</filename>"
msgstr "Ein neu paketiertes <filename>.orig.tar.{gz,bz2,lzma}</filename>"

#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:1772
msgid ""
"<emphasis role=\"strong\">should</emphasis> be documented in the resulting "
"source package.  Detailed information on how the repackaged source was "
"obtained, and on how this can be reproduced should be provided in "
"<filename>debian/copyright</filename>.  It is also a good idea to provide a "
"<literal>get-orig-source</literal> target in your "
"<filename>debian/rules</filename> file that repeats the process, as "
"described in the Policy Manual, <ulink "
"url=\"&url-debian-policy;ch-source.html#s-debianrules\">Main building "
"script: <filename>debian/rules</filename></ulink>."
msgstr ""
"<emphasis role=\"strong\">sollte</emphasis> im resultierenden Quellpaket "
"dokumentiert sein. Detaillierte Informationen, wie die neu paketierte Quelle "
"gewonnen wurde und wie dies reproduziert werden kann, sollten in "
"<filename>debian/copyright</filename> bereitgestellt werden. Es ist außerdem "
"eine gute Idee, ein <literal>get-orig-source</literal>-Target in Ihrer "
"<filename>debian/rules</filename>-Datei bereitzustellen, die den Prozess "
"wiederholt, wie im Richtlinien-Handbuch beschrieben <ulink "
"url=\"&url-debian-policy;ch-source.html#s-debianrules\">Main building "
"script: <filename>debian/rules</filename></ulink>."

#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para><footnote><para>
#: best-pkging-practices.dbk:1787
msgid ""
"As a special exception, if the omission of non-free files would lead to the "
"source failing to build without assistance from the Debian diff, it might be "
"appropriate to instead edit the files, omitting only the non-free parts of "
"them, and/or explain the situation in a <filename>README.source</filename> "
"file in the root of the source tree.  But in that case please also urge the "
"upstream author to make the non-free components easier separable from the "
"rest of the source."
msgstr ""
"Als besondere Ausnahme könnte, falls das Auslassen unfreier Dateien dazu "
"führen würde, dass das Build der Quelle ohne Unterstützung aus dem "
"Debian-Diff fehlschlägt, das Bearbeiten der Dateien anstelle des Weglassens "
"unfreier Teile davon und/oder Erklären der Situation in einer "
"<filename>README.source</filename>-Datei im Wurzelverzeichnis der Quelle "
"angemessen sein. Ermahnen Sie in diesem Fall aber auch den Originalautor, "
"unfreie Komponenten leichter aus dem Quelltext heraustrennbar zu machen."

#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:1785
msgid ""
"<emphasis role=\"strong\">should not</emphasis> contain any file that does "
"not come from the upstream author(s), or whose contents has been changed by "
"you.<placeholder type=\"footnote\" id=\"0\"/>"
msgstr ""
"<emphasis role=\"strong\">sollte keine</emphasis> Datei enthalten, die nicht "
"von dem/den Origianlautor(en) stammt oder deren Inhalt von Ihnen "
"geändert wurde.<placeholder type=\"footnote\" id=\"0\"/>"

#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:1798
msgid ""
"<emphasis role=\"strong\">should</emphasis>, except where impossible for "
"legal reasons, preserve the entire building and portablility infrastructure "
"provided by the upstream author.  For example, it is not a sufficient reason "
"for omitting a file that it is used only when building on MS-DOS.  "
"Similarly, a <filename>Makefile</filename> provided by upstream should not "
"be omitted even if the first thing your <filename>debian/rules</filename> "
"does is to overwrite it by running a configure script."
msgstr ""
"<emphasis role=\"strong\">sollte</emphasis> außer, wenn es aus rechtlichen "
"Gründen unmöglich ist, die ganze Erstellungs- und Portierungsinfrastruktur "
"aufbewahren, die vom Originalautor bereitgestellt wurde. Es ist zum Beispiel "
"kein ausreichender Grund für das Weglassen einer Datei, wenn sie nur für die "
"Erstellung unter MS-DOS benutzt wird. Gleichermaßen sollte ein "
"<filename>Makefile</filename>, das vom Originalautor bereitgestellt wurde "
"nicht einmal dann weggelassen werden, wenn das erste, was Ihre "
"<filename>debian/rules</filename> tut, das Überschreiben durch Ausführen "
"eines Konfigurationsskripts ist."

#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:1807
msgid ""
"(<emphasis>Rationale:</emphasis> It is common for Debian users who need to "
"build software for non-Debian platforms to fetch the source from a Debian "
"mirror rather than trying to locate a canonical upstream distribution "
"point)."
msgstr ""
"(<emphasis>Begründung:</emphasis> Es ist üblich für Debian-Anwender, die "
"Software für nicht-Debian-Plattformen erstellen möchten, die Quellen von "
"einem Debian-Spiegel abzurufen, anstatt den Punkt der ordnungsgemäßen "
"Originaldistribution zu suchen)."

#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:1814
msgid ""
"<emphasis role=\"strong\">should</emphasis> use "
"<filename><replaceable>packagename</replaceable>-<replaceable>upstream-version</replaceable>.orig</filename> "
"as the name of the top-level directory in its tarball.  This makes it "
"possible to distinguish pristine tarballs from repackaged ones."
msgstr ""
"<emphasis role=\"strong\">sollte</emphasis> als Namen des Verzeichnisses auf "
"der obersten Ebene des Tarballs <filename><replaceable>Paketname"
"</replaceable>-<replaceable>Originalversion</replaceable>.orig</filename> "
"benutzen. Dies ermöglicht die Unterscheidung von unberührten und neu "
"paketierten Tarballs."

#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:1822
msgid ""
"<emphasis role=\"strong\">should</emphasis> be gzipped or bzipped with "
"maximal compression."
msgstr ""
"<emphasis role=\"strong\">sollte</emphasis> mit Gzip oder Bzip mit der "
"maximalen Komprimierung gepackt werden."

#. type: Content of: <chapter><section><section><section><title>
#: best-pkging-practices.dbk:1829
msgid "Changing binary files"
msgstr "Ändern binärer Dateien"

#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1831
msgid ""
"Sometimes it is necessary to change binary files contained in the original "
"tarball, or to add binary files that are not in it. This is fully supported "
"when using source packages in “3.0 (quilt)” format, see the "
"<citerefentry><refentrytitle>dpkg-source</refentrytitle><manvolnum>1</manvolnum></citerefentry> "
"manual page for details. When using the older format “1.0”, binary files "
"can't be stored in the <filename>.diff.gz</filename> so you must store an "
"<command>uuencode</command>d (or similar) version of the file(s)  and decode "
"it at build time in <filename>debian/rules</filename> (and move it in its "
"official location)."
msgstr ""
"Manchmal ist es nötig, binäre Dateien zu ändern, die im Original-Tarball "
"enthalten sind oder binäre Dateien hinzuzufügen, die nicht darin enthalten "
"sind. Dies wird vollständig unterstützt, wenn Sie Quellpakete im Format "
"»3.0 (quilt)« benutzen. Lesen Sie die Handbuchseite <citerefentry>"
"<refentrytitle>dpkg-source</refentrytitle><manvolnum>1</manvolnum>"
"</citerefentry>, um weitere Einzelheiten zu erfahren. Wenn Sie das ältere "
"Format »1.0« benutzen, können binäre Dateien nicht im "
"<filename>.diff.gz</filename> gespeichert werden, daher müssen Sie eine mit "
"<command>uuencode</command> (oder ähnlichem) kodierte Version der Datei(en) "
"speichern und zur Erstellungszeit in <filename>debian/rules</filename> "
"entschlüsseln (und an ihren offiziellen Platz verschieben)."

#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:1846
msgid "Best practices for debug packages"
msgstr "Optimale Vorgehensweisen für Debug-Pakete"

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1848
msgid ""
"A debug package is a package with a name ending in -dbg, that contains "
"additional information that <command>gdb</command> can use.  Since Debian "
"binaries are stripped by default, debugging information, including function "
"names and line numbers, is otherwise not available when running "
"<command>gdb</command> on Debian binaries.  Debug packages allow users who "
"need this additional debugging information to install it, without bloating a "
"regular system with the information."
msgstr ""
"Ein Debug-Paket ist ein Paket, dessen Name mit -dbg endet. Es enthält "
"zusätzliche Informationen, die <command>gdb</command> benutzen kann. Da "
"Debian-Programme standardmäßig unverhüllt sind, sind Debugging-Informationen, "
"einschließlich Namen und Zeilennummern andernfalls nicht verfügbar, wenn "
"<command>gdb</command> auf Debian-Programmen ausgeführt wird. Debug-Pakete "
"ermöglichen Anwendern, die diese zusätzlichen Debugging-Informationen "
"benötigen, sie zu installieren ohne das normale System mit diesen "
"Informationen aufzublähen."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1856
msgid ""
"It is up to a package's maintainer whether to create a debug package or "
"not.  Maintainers are encouraged to create debug packages for library "
"packages, since this can aid in debugging many programs linked to a "
"library.  In general, debug packages do not need to be added for all "
"programs; doing so would bloat the archive.  But if a maintainer finds that "
"users often need a debugging version of a program, it can be worthwhile to "
"make a debug package for it.  Programs that are core infrastructure, such as "
"apache and the X server are also good candidates for debug packages."
msgstr ""
"Es liegt beim Paketbetreuer, ob ein Debug-Paket erstellt wird oder nicht. "
"Betreuer werden aufgefordert Debug-Pakete für Bibliothekenpakete zu "
"erstellen, da dies bei der Fehlersuche in vielen Programmen helfen kann, die "
"mit der Bibliothek verlinkt werden. Im Allgemeinen gibt es keine "
"Notwendigkeit für Debug-Pakete zu allen Programmen; dies würde das Archiv "
"aufblähen. Falls aber ein Betreuer findet, dass Anwender oft die "
"Debugging-Version eines Programms benötigen, kann es lohnenswert sein, ein "
"Debug-Paket dafür zu erstellen. Programme die zur Kerninfrastruktur gehören, "
"wie Apache oder der X-Server sind ebenfalls geeignete Kandidaten für "
"Debug-Pakete."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1866
msgid ""
"Some debug packages may contain an entire special debugging build of a "
"library or other binary, but most of them can save space and build time by "
"instead containing separated debugging symbols that <command>gdb</command> "
"can find and load on the fly when debugging a program or library.  The "
"convention in Debian is to keep these symbols in "
"<filename>/usr/lib/debug/<replaceable>path</replaceable></filename>, where "
"<replaceable>path</replaceable> is the path to the executable or library.  "
"For example, debugging symbols for <filename>/usr/bin/foo</filename> go in "
"<filename>/usr/lib/debug/usr/bin/foo</filename>, and debugging symbols for "
"<filename>/usr/lib/libfoo.so.1</filename> go in "
"<filename>/usr/lib/debug/usr/lib/libfoo.so.1</filename>."
msgstr ""
"Einige Debug-Pakete könnten ein ganz spezielles Debugging-Build einer "
"Bibliothek oder eines anderen Programms haben, aber die meisten können "
"Speicher und Build-Zeit sparen, indem sie stattdessen separate "
"Debugging-Symbole enthalten, die <command>gdb</command> spontan finden und "
"laden kann, wenn in einem Programm oder einer Bibliothek nach Fehlern gesucht "
"wird. Die Konvention in Debian besagt, dass diese Symbole in "
"<filename>/usr/lib/debug/<replaceable>Pfad</replaceable></filename> "
"aufbewahrt werden, wobei <replaceable>Pfad</replaceable> der Pfad zum "
"ausführbaren Programm oder der Bibliothek ist. Debugging-Symbole für "
"<filename>/usr/bin/foo</filename> wandern beispielsweise nach "
"<filename>/usr/lib/debug/usr/bin/foo</filename> und Debugging-Symbole für "
"<filename>/usr/lib/libfoo.so.1</filename> nach "
"<filename>/usr/lib/debug/usr/lib/libfoo.so.1</filename>."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1878
msgid ""
"The debugging symbols can be extracted from an object file using "
"<command>objcopy --only-keep-debug</command>.  Then the object file can be "
"stripped, and <command>objcopy --add-gnu-debuglink</command> used to specify "
"the path to the debugging symbol file.  <citerefentry> "
"<refentrytitle>objcopy</refentrytitle> <manvolnum>1</manvolnum> "
"</citerefentry> explains in detail how this works."
msgstr ""
"Die Debugging-Symbole können mit <command>objcopy --only-keep-debug</command> "
"aus einer Objektdatei extrahiert werden. Dann kann die Objektdatei enthüllt "
"und <command>objcopy --add-gnu-debuglink</command> benutzt werden, um den "
"Pfad zur Debugging-Symboldatei anzugeben. <citerefentry> "
"<refentrytitle>objcopy</refentrytitle> <manvolnum>1</manvolnum> "
"</citerefentry> erklärt im Detail, wie dies funktioniert."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1886
msgid ""
"The <command>dh_strip</command> command in <systemitem "
"role=\"package\">debhelper</systemitem> supports creating debug packages, "
"and can take care of using <command>objcopy</command> to separate out the "
"debugging symbols for you.  If your package uses <systemitem "
"role=\"package\">debhelper</systemitem>, all you need to do is call "
"<command>dh_strip --dbg-package=libfoo-dbg</command>, and add an entry to "
"<filename>debian/control</filename> for the debug package."
msgstr ""
"Der Befehl <command>dh_strip</command> in <systemitem "
"role=\"package\">debhelper</systemitem> unterstützt das Erstellen von "
"Debug-Paketen und kann sich um die Benutzung von <command>objcopy</command> "
"kümmern, um die Debugging-Symbole für Sie herauszusuchen. Falls Ihr Paket "
"<systemitem role=\"package\">debhelper</systemitem> benutzt, müssen Sie nur "
"<command>dh_strip --dbg-package=libfoo-dbg</command> aufrufen und einen "
"Eintrag in <filename>debian/control</filename> für das Debug-Paket hinzufügen."

#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1893
msgid ""
"Note that the debug package should depend on the package that it provides "
"debugging symbols for, and this dependency should be versioned.  For "
"example:"
msgstr ""
"Beachten Sie, dass Debug-Pakete von dem Paket abhängen sollten, für das sie "
"Debugging-Symbole bereitstellen und diese Abhängigkeit sollte mit einer "
"Version versehen werden. Zum Beispiel:"

#. type: Content of: <chapter><section><section><screen>
#: best-pkging-practices.dbk:1897
#, no-wrap
msgid "Depends: libfoo (= ${binary:Version})\n"
msgstr "Depends: libfoo (= ${binary:Version})\n"