
        *****************************************************
        *           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 NAAM

dpkg-gensymbols - genereer symbolenbestanden (informatie over
afhankelijkheidsrelaties met gedeelde bibliotheken)

=head1 OVERZICHT

B<dpkg-gensymbols> [I<optie>...]

=head1 BESCHRIJVING

B<dpkg-gensymbols> doorzoekt een tijdelijke bouwboom (standaard is dat
debian/tmp) op zoek naar bibliotheken en genereert een I<symbols>-bestand
dat ze beschrijft. Dit bestand wordt dan als het niet leeg is, geïnstalleerd
in een onderliggende map van de bouwboom met de naam DEBIAN, zodat het
uiteindelijk opgenomen geraakt in de controle-informatie van het pakket.

Bij het genereren van deze bestanden gebruikt het als invoer bepaalde
symbolenbestanden die door de onderhouder aangeleverd worden. Het zoekt naar
de volgende bestanden (en gebruikt het eerste dat gevonden wordt):

=over 

=item *

debian/I<pakket>.symbols.I<arch>

=item *

debian/symbols.I<arch>

=item *

debian/I<pakket>.symbols

=item *

debian/symbols

=back

Het hoofddoel van deze bestanden is aan te geven welke de minimale versie is
die behoort bij elk van de symbolen die door de bibliotheken aangeleverd
worden. Gewoonlijk komt dit overeen met de eerste versie van het pakket dat
in dat symbool voorzag, maar dit kan door de onderhouder manueel verhoogd
worden indien de ABI van het symbool uitgebreid werd zonder dat daardoor de
neerwaartse compatibiliteit verbroken wordt. Het is de verantwoordelijkheid
van de onderhouder om deze bestanden up-to-date en accuraat te houden, maar
B<dpkg-gensymbols> helpt hierbij.

Indien het gegenereerde symbolenbestand verschilt van datgene wat de
onderhouder aanlevert, zal B<dpkg-gensymbols> de verschillen tussen de twee
versies tonen in diff-formaat. Bovendien kan dit zelfs tot een mislukking
leiden als de verschillen te significant zijn (u kunt aanpassen hoeveel
verschil u kunt tolereren; zie de optie B<-c>).

=head1 HET ONDERHOUD VAN SYMBOLENBESTANDEN

The base interchange format of the symbols file is described in
B<deb-symbols>(5), which is used by the symbols files included in binary
packages. These are generated from template symbols files with a format
based on the former, described in B<deb-src-symbols>(5)  and included in
source packages.

The symbols files are really useful only if they reflect the evolution of
the package through several releases. Thus the maintainer has to update them
every time that a new symbol is added so that its associated minimal version
matches reality.

The diffs contained in the build logs can be used as a starting point, but
the maintainer, additionally, has to make sure that the behaviour of those
symbols has not changed in a way that would make anything using those
symbols and linking against the new version, stop working with the old
version.

In most cases, the diff applies directly to the debian/I<package>.symbols
file. That said, further tweaks are usually needed: it's recommended for
example to drop the Debian revision from the minimal version so that
backports with a lower version number but the same upstream version still
satisfy the generated dependencies.  If the Debian revision can't be dropped
because the symbol really got added by the Debian specific change, then one
should suffix the version with ‘B<~>’.

Vooraleer een patch toe te passen op een symbolenbestand, moet de
onderhouder grondig controleren of dat wel correct is. Publieke symbolen
worden verondersteld niet te verdwijnen. Een patch zou dus idealiter enkel
nieuwe regels mogen toevoegen.

Note that you can put comments in symbols files.

Vergeet niet na te gaan of oudere symboolversies niet verhoogd moeten
worden. Er bestaat geen manier voor B<dpkg-gensymbols> om in dit verband
waarschuwingen te geven. Een diff (weergave van de verschillen) blindweg
toepassen of ervan uitgaan dat er niets aangepast moet worden als er geen
diff is zonder zelf op eventuele wijzigingen te controleren, kan leiden tot
pakketten met verslapte afhankelijkheidsrelaties die onterecht laten
veronderstellen dat ze met oudere pakketten kunnen samenwerken. Dit kan bij
(gedeeltelijke) opwaarderingen leiden tot moeilijk te vinden bugs.

=head2 Goed beheer van bibliotheken

Een goed onderhouden bibliotheek heeft de volgende functionaliteit:

=over 

=item *

haar API is stabiel (publieke symbolen worden nooit verwijderd, enkel worden
nieuwe publieke symbolen toegevoegd) en zij ondergaat enkel op een
incompatibele manier veranderingen als de SONAME verandert;

=item *

idealiter gebruikt zij symboolversienummering om ondanks interne wijzigingen
en API-uitbreidingen ABI-stabiliteit te bekomen;

=item *

zij exporteert geen private symbolen (dergelijke symbolen kunnen de tag
optional krijgen om dat te omzeilen).

=back

Bij het onderhoud van een symbolenbestand is het gemakkelijk om het
verschijnen en verdwijnen van symbolen op te merken. Maar het is moeilijker
om incompatibele API- en ABI-wijzigingen op te merken. Daarom moet de
onderhouder het changelog-bestand van de toeleveraar grondig nakijken op
situaties waarbij de regels van goed bibliotheekbeheer geschonden
worden. Indien mogelijke problemen ontdekt worden, zou de toeleverende
auteur erover ingelicht moeten worden, aangezien een reparatie op het niveau
van de toeleveraar altijd te verkiezen valt boven een Debian-specifieke
tijdelijke oplossing.

=head1 OPTIES

=over 

=item B<-P>I<pakketbouwmap>

Zoek in I<pakketbouwmap> in plaats van in debian/tmp.

=item B<-p>I<pakket>

Definieer de pakketnaam. Is vereist als meer dan één binair pakket vermeld
wordt in debian/control (of indien er geen bestand debian/control is).

=item B<-v>I<versie>

Definieer de pakketversie. Standaard is dat de versie die uit
debian/changelog gehaald wordt. Is vereist indien het aanroepen gebeurt van
buiten de boom van het broncodepakket.

=item B<-e>I<bibliotheekbestand>

Analyseer enkel de expliciet vermelde bibliotheken in plaats van alle
publieke bibliotheken te zoeken. U kunt in I<bibliotheekbestand> gebruik
maken van shell-patronen met het oog op padnaamexpansie (zie de man-pagina
B<File::Glob>(3perl) voor details) om met één enkel argument meerdere
bibliotheken aan te duiden (anders heeft u meerdere malen B<-e> nodig).

=item B<-l>I<map>

Voeg I<map> vooraan toe aan de lijst van mappen waarin naar private gedeelde
bibliotheken gezocht moet worden (sinds dpkg 1.19.1). Deze optie kan
meermaals gebruikt worden.

B<Note:> Use this option instead of setting B<LD_LIBRARY_PATH>, as that
environment variable is used to control the run-time linker and abusing it
to set the shared library paths at build-time can be problematic when
cross-compiling for example.

=item B<-I>I<bestandsnaam>

Gebruik I<bestandsnaam> als referentiebestand om het symbolenbestand te
genereren dat in het pakket zelf geïntegreerd wordt.

=item B<-O>[I<bestandsnaam>]

Geef het gegenereerde symbolenbestand uit weer op de standaarduitvoer of
schrijf het naar I<bestandsnaam> als dat opgegeven werd, eerder dan naar
B<debian/tmp/DEBIAN/symbols> (of I<pakketbouwmap>B</DEBIAN/symbols> indien
B<-P> gebruikt werd). Indien I<bestandsnaam> reeds bestond, wordt de inhoud
ervan gebruikt als basis voor het gegenereerde symbolenbestand. U kunt van
deze functionaliteit gebruik maken om een symbolenbestand bij te werken
zodat het in overeenstemming is met een nieuwere toeleveraarsversie van uw
bibliotheek.

=item B<-t>

Schrijf het symbolenbestand in sjabloonmodus eerder dan in de indeling die
compatibel is met B<deb-symbols>(5). Het grootste verschil is dat in de
sjabloonmodus symboolnamen en tags geschreven worden in hun originele vorm
in tegenstelling tot in de compatibele modus waarin de verwerkte
symboolnamen ontdaan van hun tags gebruikt worden. Daarenboven kunnen bij
het schrijven van een standaard B<deb-symbols>(5)-bestand sommige symbolen
weggelaten worden (overeenkomstig de regels voor het verwerken van tags),
terwijl in een symbolenbestandsjabloon steeds alle symbolen neergeschreven
worden.

=item B<-c>I<[0-4]>

Definieer de controles die moeten gebeuren bij het vergelijken van het
gegenereerde symbolenbestand met het sjabloonbestand dat als vertrekpunt
gebruikt werd. Standaard is dat volgens niveau 1. Het verhogen van het
niveau leidt tot meer controles, terwijl alle controles van lagere niveaus
behouden blijven. Niveau 0 leidt nooit tot een mislukking. Niveau 1 mislukt
als er symbolen verdwenen zijn. Niveau 2 geeft een mislukking als nieuwe
symbolen geïntroduceerd werden. Niveau 3 mislukt als er bibliotheken
verdwenen zijn. Niveau 4 geeft een mislukking als nieuwe bibliotheken
geïntroduceerd werden.

Deze waarde kan vervangen worden door de omgevingsvariabele
B<DPKG_GENSYMBOLS_CHECK_LEVEL>.

=item B<-q>

Gedraag u rustig en genereer nooit een diff (een overzicht van de
verschillen) tussen het gegenereerde symbolenbestand en het sjabloonbestand
dat als vertrekpunt gebruikt werd en toon geen enkele waarschuwing in
verband met nieuwe/verloren bibliotheken of nieuwe/verloren symbolen. Deze
optie schakelt enkel de informatieve uitvoer uit, maar niet de controles
zelf (zie de optie B<-c>).

=item B<-a>I<arch>

Ga uit van I<arch> als hostarchitectuur bij het verwerken van
symbolenbestanden. Gebruik deze optie om een symbolenbestand of een diff
(overzicht van de verschillen) voor een willekeurige architectuur te
genereren op voorwaarde dat de binaire bestanden ervan reeds voorhanden
zijn.

=item B<-d>

Zet debug-modus aan. Talrijke berichten worden dan getoond om toe te lichten
wat B<dpkg-gensymbols> doet.

=item B<-V>

Schakel de breedsprakige modus in. Het gegenereerde symbolenbestand bevat
dan verouderde symbolen in de vorm van commentaar. In sjabloonmodus worden
daarenboven patroonsymbolen gevolgd door commentaar met daarin een opsomming
van de echte symbolen die met het patroon overeenkwamen.

=item B<-?>, B<--help>

Toon info over het gebruik en sluit af.

=item B<--version>

Toon de versie en sluit af.

=back

=head1 OMGEVING

=over 

=item B<DPKG_GENSYMBOLS_CHECK_LEVEL>

Overschrijft het controleniveau van het commando, zelfs als het argument
B<-c> opgegeven werd aan de commandoregel (merk op dat dit ingaat tegen de
algemeen geldende afspraak dat commandoregel-argumenten voorrang hebben op
omgevingsvariabelen).

=item B<DPKG_COLORS>

Stelt de kleurmodus in (sinds dpkg 1.18.5). Waarden die momenteel gebruikt
mogen worden zijn: B<auto> (standaard), B<always> en B<never>.

=item B<DPKG_NLS>

Indien dit ingesteld is, zal het gebruikt worden om te beslissen over het
activeren van moedertaalondersteuning, ook gekend als
internationaliseringsondersteuning (of i18n) (sinds dpkg 1.19.0). Geldige
waarden zijn: B<0> and B<1> (standaard).

=back

=head1 ZIE OOK

B<https://people.redhat.com/drepper/symbol-versioning>

B<https://people.redhat.com/drepper/goodpractice.pdf>

B<https://people.redhat.com/drepper/dsohowto.pdf>

B<deb-src-symbol>(5), B<deb-symbols>(5), B<dpkg-shlibdeps>(1).

