
        *****************************************************
        *           GENERATED FILE, DO NOT EDIT             *
        * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
        *****************************************************

This file was generated by po4a(7). Do not store it (in VCS, for example),
but store the PO file used as source file by po4a-translate.

In fact, consider this as a binary, and the PO file as a regular .c file:
If the PO get lost, keeping this translation up-to-date will be harder.

=encoding UTF-8

=head1 BEZEICHNUNG

deb-symbols - Debians erweiterte Informationsdatei von Laufzeitbibliotheken

=head1 ÜBERSICHT

B<DEBIAN/symbols>

=head1 BESCHREIBUNG

Die Symboldateien werden in Debian-Binärpaketen ausgeliefert. Deren Format ist eine Teilmenge der Vorlagensymboldateien, die von L<dpkg-gensymbols(1)> in Debian-Quellpaketen verwandt wird, siehe L<deb-src-symbols(5)>.

Das Format eines Eintrags für eine erweiterte Abhängigkeitsinformation einer Laufzeitbibliothek („shared library“) lautet:

Z<>
 I<Bibliothek-Soname> I<Hauptabhängigkeitsvorlage>
 [| I<alternative-Abhängigkeitsvorlage>]
 [...]
 [* I<Feldname>: I<Feldwert>]
 [...]
  I<Symbol> I<minimale_Version> [I<Kennung_der_Abhängigkeitsvorlage>]

Der I<Bibliotheks-Soname> ist genau der Wert des SONAME-Feldes, wie er von L<objdump(1)> exportiert wird. Eine I<Abhängigkeitsvorlage> ist eine Abhängigkeit, in der I<#MINVER#> dynamisch entweder von einer Versionsprüfung der Art „(E<gt>= I<Minimalversion>)“ oder durch nichts ersetzt wird, falls eine nicht-versionierte Abhängigkeit als ausreichend erachtet wird.

Jedem exportierten I<Symbol> (aufgeführt als I<Name>@I<Version>, mit I<Version> als „Base“, falls die Bibliothek nicht versioniert ist) wird eine I<Minimalversion> seiner Abhängigkeitsvorlage zugeordnet (die Hauptabhängigkeitsvorlage wird immer verwandt und wird am Ende mit der abhängigen, in I<Kennung_der_Abhängigkeitsvorlage> referenzierten Vorlage (falls vorhanden) kombiniert). Die erste alternative Abhängigkeitsvorlage wird mit 1 nummeriert, die zweite mit 2 usw. Jede Spalte ist genau durch ein Leerraum abgetrennt.

Jeder Eintrag für eine Bibliothek kann auch einige Felder mit Metainformationen enthalten. Diese Felder werden in Zeilen gespeichert, die mit einem Stern beginnen. Derzeit sind die einzig gültigen Felder:

=over 

=item B<Build-Depends-Package>

Es gibt den Namen des „-dev“-Pakets an, das der Bibliothek zugeordnet ist, und wird von B<dpkg-shlibdeps> verwandt, um sicherzustellen, dass die erstellte Abhängigkeit mindestens genauso strikt ist wie die zugehörige Bau-Abhängigkeit (seit Dpkg 1.14.13).

=item B<Build-Depends-Packages>

Identisch zu B<Build-Depends-Package>, akzeptiert aber eine Kommata-getrennte Liste an Paketnamen (seit Dpkg 1.20.0). Dieses Feld setzt jedes vorhandende Feld B<Build-Depends-Package> außer Kraft und ist mit „-dev“-Paketen und davon abhängigen Metapaketen, beispielsweise für eine Übergangsperiode, am nützlichsten.

=item B<Allow-Internal-Symbol-Groups>

Es gibt in einer durch Leerraumzeichen getrennten Liste an, welche internen Gruppen ignoriert werden sollten, so dass Symbole, die in diesen Gruppen enthalten sind, in die Ausgabedatei aufgenommen werden (seit Dpkg 1.20.1). Dies sollte nur für Toolchain-Pakete notwendig sein, die solche internen Symbole bereitstellen. Die verfügbaren Gruppen sind systemabhängig, für ELF- und GNU-basierte Systeme sind dies B<aeabi> und B<gomp>.

=item B<Ignore-Blacklist-Groups>

Ein veralteter Alias für B<Allow-Internal-Symbol-Groups> (seit Dpkg 1.20.1, unterstützt seit Dpkg 1.17.6).

=back

=head1 BEISPIELE

=head2 Einfache Symboldatei

 libftp.so.3 libftp3 #MINVER#
  DefaultNetbuf@Base 3.1-1-6
  FtpAccess@Base 3.1-1-6
  […]

=head2 Fortgeschrittene Symboldatei

 libGL.so.1 libgl1
 | libgl1-mesa-glx #MINVER#
 * Build-Depends-Package: libgl1-mesa-dev
  publicGlSymbol@Base 6.3-1
  […]
  implementationSpecificSymbol@Base 6.5.2-7 1
  […]

=head1 SIEHE AUCH

L<https://wiki.debian.org/Projects/ImprovedDpkgShlibdeps>, L<deb-src-symbols(5)>, L<dpkg-shlibdeps(1)>, L<dpkg-gensymbols(1)>.


=head1 ÜBERSETZUNG

Die deutsche Übersetzung wurde 2004, 2006-2024 von Helge Kreutzmann
<debian@helgefjell.de>, 2007 von Florian Rehnisch <eixman@gmx.de> und
2008 von Sven Joachim <svenjoac@gmx.de>
angefertigt. Diese Übersetzung ist Freie Dokumentation; lesen Sie die
GNU General Public License Version 2 oder neuer für die Kopierbedingungen.
Es gibt KEINE HAFTUNG.
