.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "debhelper 7"
.TH debhelper 7 "2022-11-26" "13.11.1~bpo11+1" "Debhelper"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
debhelper\-compat\-upgrade\-checklist \- Upgrade checklist for supported
debhelper compat levels
.SH "ÜBERSICHT"
.IX Header "ÜBERSICHT"
This document is an upgrade checklist of all the supported debhelper compat
levels. It also lists all the support debhelper compat levels.
.PP
Information about how to declare the compat level is in
\&\*(L"\s-1COMPATIBILITY LEVELS\*(R"\s0 in \fBdebhelper\fR\|(7).
.PP
If you are upgrading from a (now) obsolete compat level, then please refer
to \fBdebhelper\-obsolete\-compat\fR\|(7).
.SH "BESCHREIBUNG"
.IX Header "BESCHREIBUNG"
.SS "Upgrade checklist for supported compatibility levels"
.IX Subsection "Upgrade checklist for supported compatibility levels"
Folgende Kompatibilitätsstufen sind verfügbar:
.IP "v15" 4
.IX Item "v15"
Diese Kompatibilitätsstufe ist immer noch für die Entwicklung
offen. Verwenden Sie sie mit Vorsicht.
.Sp
Changes from v14 are:
.RS 4
.IP "\-" 8
The \fBdh_auto_install\fR tool no longer defaults to \fB\-\-destdir=debian/\f(BIpackage\fB\fR for source packages only producing a single
binary.  If this behaviour is wanted, the package should explicitly activate
the \fBsingle-binary\fR dh addon (e.g., by adding \fBdh-sequence-single-binary\fR
to \fBBuild-Depends\fR) or pass \fB\-\-destdir\fR to \fBdh_auto_install\fR.
.Sp
The rationale for this change to avoid \*(L"surprises\*(R" when adding a second
binary package later.  Previously, debhelper would silently change behaviour
often resulting in empty binary packages being uploaded to the archive by
mistake. With the new behaviour, the \fBsingle-binary\fR addon will detect the
mismatch and warn the maintainer of what is about to happen.
.RE
.RS 4
.RE
.IP "v14" 4
.IX Item "v14"
Diese Kompatibilitätsstufe ist immer noch für die Entwicklung
offen. Verwenden Sie sie mit Vorsicht.
.Sp
Änderungen gegenüber v13 sind:
.RS 4
.IP "\-" 8
The \fBcmake\fR buildsystem now passes \fB\-DCMAKE_BUILD_RPATH_USE_ORIGIN=ON\fR to
\&\fBcmake\fR\|(1) to avoid some reproducibility issues.
.IP "\-" 8
The tool \fBdh_installsysusers\fR is now included in the default sequence. This
helper tool will process systemd sysusers files.
.IP "\-" 8
Use of the \fBdh_gconf\fR command in override and hook targets now causes an
error.  The \fBdh_gconf\fR command has been a no-op for years and was removed
in debhelper 13.4.
.IP "\-" 8
The \fBdh\fR sequencer will warn if the \fBsingle-binary\fR addon is implicitly
activated to warn maintainers of the pending compat 15 change in
\&\fBdh_auto_install\fR.
.Sp
Maintainers are urged to either explicitly activate the \fBsingle-binary\fR
addon to preserve the existing behaviour (e.g., by adding
\&\fBdh-sequence-single-binary\fR to Build-Depends), or explicitly passing
\&\fB\-\-destdir\fR to \fBdh_auto_install\fR if used and then passing \fB\-\-without
single-binary\fR to \fBdh\fR (the latter to silence the warning).
.Sp
The rationale for this change to avoid \*(L"surprises\*(R" when adding a second
binary package later.  Previously, debhelper would silently change behaviour
often resulting in empty binary packages being uploaded to the archive by
mistake. With the new behaviour, the \fBsingle-binary\fR addon will detect the
mismatch and warn the maintainer of what is about to happen.
.IP "\-" 8
The \fBdh_installalternatives\fR tool will now be run after \fBdh_link\fR rather
than after \fBdh_installinitramfs\fR in the default \fBdh\fR sequence.
.IP "\-" 8
The \fBdh_installpam\fR tool will now install \s-1PAM\s0 configuration files under \fI/usr/lib/pam.d/\fIpackage\fI\fR instead of \fI/etc/pam.d/\fIpackage\fI\fR.
.Sp
Please consider using the \*(L"rm_conffile\*(R" feature from \fBdh_installdeb\fR\|(1) to
ensure the proper removal of previous \s-1PAM\s0 files.
.IP "\-" 8
The \fBmeson+ninja\fR and \fBcmake\fR build systems now use \fBmeson install\fR and
\&\fBcmake \-\-install\fR, respectively, instead of \fBninja install\fR and \fBmake
install\fR in the \fBdh_auto_install\fR\|(1) call.  Any override of
\&\fBdh_auto_install\fR that passes extra parameters to the upstream build system
should be reviewed.
.RE
.RS 4
.RE
.IP "v13" 4
.IX Item "v13"
Dies ist der empfohlene Betriebsmodus.
.Sp
Die Änderungen gegenüber v12 sind:
.RS 4
.IP "\-" 8
Das Bausystem \fBmeson+ninja\fR benutzt anstelle von \fBninja test\fR nun \fBmeson
test\fR, wenn die Testsuite ausgeführt wird. Alles, was \fBdh_auto_test\fR außer
Kraft setzt und zusätzliche Parameter an das Testausführungsprogramm der
Ursprungsautoren übergibt, sollte überprüft werden, da \fBmeson test\fR auf der
Befehlszeile nicht mit \fBninja test\fR kompatibel ist.
.IP "\-" 8
Alle Debhelper\-ähnlichen Werkzeuge, die auf der offiziellen
Debhelper-Bibliothek basieren (einschließlich \fBdh\fR und den offiziellen
\&\fBdh_*\fR\-Werkzeugen) akzeptieren keine abgekürzten Befehlsparameter
mehr. Gleichzeitig sortiert \fBdh\fR nun Aufrufe zu überflüssigen
\&\fBdh_*\fR\-Hilfsprogrammen sogar dann aus, wenn lange Befehlszeilenoptionen
angegeben werden.
.IP "\-" 8
Die ELF-bezogenen Debhelper-Werkzeuge (\fBdh_dwz\fR, \fBdh_strip\fR,
\&\fBdh_makeshlibs\fR, \fBdh_shlibdeps\fR) werden nun standardmäßig nur noch für
architekturabhängige Pakete ausgeführt (d. h. sie werden von
\&\fB*\-indep\fR\-Zielen ausgeschlossen und standardmäßig mit \fB\-a\fR
übergeben). Falls Sie sie für \fB*\-indep\fR\-Ziele benötigen, können Sie eine
explizite Build-Depends in \fBdh-sequence-elf-tools\fR hinzufügen.
.IP "\-" 8
Das Drittanbieterbausystem \fBgradle\fR (aus dem Paket \fBgradle-debian-helper\fR)
führt nun automatisch eine von den Ursprungsautoren bereitgestellte
Testsuite aus. Setzen Sie \fBdh_auto_test\fR außer Kraft, um dieses Verhalten
zu unterbinden.
.IP "\-" 8
Das Werkzeug \fBdh_installman\fR beendet sich vorzeitig, falls es
widersprüchliche Definitionen einer Handbuchseite entdeckt. Dies kommt
üblicherweise vor, wenn das Bausystem der Ursprungsautoren eine komprimierte
Version installiert und das Paket eine nicht komprimierte Version der
Handbuchseite in \fIdebian/\fIpackage\fI.manpages\fR auflistet. Meist ist die
einfachste Lösung, die Handbuchseite aus \fIdebian/\fIpackage\fI.manpages\fR
zu entfernen (davon ausgehend, dass beide Versionen identisch sind).
.IP "\-" 8
Die \fBdh_auto_*\fR\-Hilfsprogramme setzen nun die Umgebungsvariablen \fB\s-1HOME\s0\fR
und gebräuchliche \fBXDG_*\fR\-Variablen zurück. Wie damit umgegangen wird,
können Sie Sie der Beschreibung für die Umgebungsvariablen in
\&\*(L"\s-1ENVIRONMENT\*(R"\s0 entnehmen.
.Sp
\&\fIDieses Funktionsmerkmal hat sich zwischen Debhelper 13 und Debhelper 13.2
geändert.\fR
.IP "\-" 8
Der Befehl \fBdh\fR wird nun einen Fehler ausgeben, falls ein Override\- oder
Hook-Ziel für einen veralteten Befehl in \fIdebian/rules\fR
(z.B. \fBoverride_dh_systemd_enable:\fR) vorhanden ist.
.IP "\-" 8
Der Befehl \fBdh_missing\fR wird nun auf \fB\-\-fail\-missing\fR voreingestellt. Dies
lässt sich zu einer nicht-fatalen Warnung zurückändern, indem explizit
\&\fB\-\-list\-missing\fR übergeben wird, wie es in Kompatibilitätsstufe 12 war.
.Sp
Falls Sie die Warnung gar nicht wollen, lassen Sie bitte den Aufruf von
\&\fBdh_missing\fR weg. Falls Sie den Befehlssequenzer \fBdh\fR benutzen, dann
können Sie dies mit einem leeren Override-Ziel in der Datei \fIdebian/rules\fR
oder dem passenden Paket erledigen. Zum Beispiel:
.Sp
.Vb 2
\&    # Disable dh_missing
\&    override_dh_missing:
.Ve
.IP "\-" 8
Der Befehlssequenzer \fBdh\fR führt nun in der Standardsequenz
\&\fBdh_installtmpfiles\fR aus. \fBdh_installtmpfiles\fR übernimmt die Handhabung
von tmpfiles.d\-Konfigurationsdateien. Diesbezügliche Funktionalität in
\&\fBdh_installsystemd\fR ist nun deaktiviert.
.Sp
Beachten Sie, dass \fBdh_installtmpfiles\fR auf \fIdebian/\fIPaket\fI.tmpfiles\fR
reagiert, wo \fBdh_installsystemd\fR einen Nahmen ohne das nachfolgende »s«
benutzt hat.
.IP "\-" 8
Viele \fBdh_*\fR\-Werkzeuge unterstützen nun eine eingeschränkte
Variablenexpandierung per \fB${foo}\fR\-Syntax. In vielen Fällen kann dies
benutzt werden, um Pfade zu referenzieren, die entweder Leerzeichen oder
\&\fBdpkg\-architecture\fR\|(1)\-Werte enthalten. Obwohl es den Bedarf an
\&\fBdh\-exec\fR\|(1) in einigen Fällen vermindern kann, ist es im Allgemeinen
\&\fBkein\fR Ersatz für \fBdh\-exec\fR\|(1). Falls Sie filtern, umbenennen
usw. möchten, wird das Paket weiterhin \fBdh\-exec\fR\|(1) benötigt.
.Sp
Bitte lesen Sie \*(L"Ersetzungen in Debhelper-Konfigurationsdateien\*(R", um mehr
über die Syntax und verfügbare Ersetzungsvariablen zu erfahren. An Verfasser
von \fBdh_*\fR\-Werkzeugen: Die Ersetzung und Expandierung ist Teil der
Funktionen \fBfilearray\fR und \fBfiledoublearray\fR.
.IP "\-" 8
Der Befehlssequenzer \fBdh\fR wird jetzt alle Hooks und Override-Ziele für
\&\fBdh_auto_test\fR, \fBdh_dwz\fR und \fBdh_strip\fR überspringen, wenn
\&\fB\s-1DEB_BUILD_OPTIONS\s0\fR die maßgeblichen \fBnocheck\fR\-/\fBnostrip\fR\-Optionen
aufführt.
.Sp
Alle Pakete, die sich darauf verlassen, dass diese Ziele immer ausgeführt
werden, sollten die betroffene Logik aus diesen Zielen heraus
verschieben. Z. B. müsste nicht-testbezogener Paketierungscode von
\&\fBoverride_dh_auto_test\fR nach \fBexecute_after_dh_auto_build\fR oder
\&\fBexecute_before_dh_auto_install\fR verschoben werden.
.IP "\-" 8
Das \fBcmake\fR\-Bausystem übergibt nun
\&\fB\-DCMAKE_SKIP_INSTALL_ALL_DEPENDENCY=ON\fR an \fBcmake\fR\|(1), um den
automatischen Installationsprozess zu beschleunigen. Falls Sie aus
irgendeinem Grund beim alten Verhalten bleiben möchten, übersteuern Sie den
Schalter:
.Sp
.Vb 1
\&    dh_auto_configure \-\- \-DCMAKE_SKIP_INSTALL_ALL_DEPENDENCY=OFF ...
.Ve
.RE
.RS 4
.RE
.IP "v12" 4
.IX Item "v12"
Änderungen gegenüber v11 sind:
.RS 4
.IP "\-" 8
Das Werkzeug \fBdh_makeshlibs\fR erzeugt nun standardmäßig Shlibs-Dateien mit
versionierter Abhängigkeit. Das bedeutet, dass \fB\-VUpstream\-Version\fR (alias
\&\fB\-V\fR) nun die Voreinstellung ist.
.Sp
Falls eine nicht versionierte Abhängigkeit in der Shlibs-Datei gewünscht
wird, kann dies stattdessen durch Übergabe von \fB\-VNone\fR erreicht
werden. Siehe aber auch \fBdh_makeshlibs\fR\|(1) für die Vorbehalte gegen nicht
versionierte Abhängigkeiten.
.IP "\-" 8
Die Option \fB\-s\fR (\fB\-\-same\-arch\fR) wurde entfernt. Bitte verwenden Sie
stattdessen \fB\-a\fR (\fB\-\-arch\fR).
.IP "\-" 8
Der Aufruf von \fBdh_clean \-k\fR verursacht jetzt einen Fehler statt einer
Warnung, es sei missbilligt.
.IP "\-" 8
Die Option \fB\-\-no\-restart\-on\-upgrade\fR in \fBdh_installinit\fR wurde
entfernt. Bitte verwenden Sie den neuen Namen \fB\-\-no\-stop\-on\-upgrade\fR.
.IP "\-" 8
Es gab einen Fehler in den \fBdoit\fR\- und ähnlichen Funktionen von
Debian::Debhelper::Dh_Lib, der unter einem bestimmten Umstand zum Öffnen
einer Shell führte. Dieser Fehler wurde nun entfernt, wodurch
Hilfsprogramme, die auf den Fehler setzen, mit der Meldung »command not
found« fehlschlagen.
.IP "\-" 8
\&\fB\-\-list\-missing\fR und \fB\-\-fail\-missing\fR in \fBdh_install\fR wurden
entfernt. Bitte verwenden Sie \fBdh_missing\fR und die zugehörigen Optionen,
die die durch andere Hilfsprogramme installierten Dateien ebenfalls sehen
können.
.IP "\-" 8
Das Hilfsprogramm \fBdh_installinit\fR installiert die Konfiguration für das
Init-System Upstart nicht mehr. Stattdessen bricht es das Bauen ab, wenn es
eine alte Upstart-Konfigurationsdatei findet. Der Fehler soll den
Paketbetreuer daran erinnern, sicherzugehen, dass die mit vorherigen
Versionen des Pakets mitgelieferten Konfigdateien (falls vorhanden) sauber
entfernt werden.
.IP "\-" 8
Das Werkzeug \fBdh_installdeb\fR wird die Grundprüfung einiger
\&\fBdpkg\-maintscript\-helper\fR\|(1)\-Befehle durchführen und sich mit einer
Fehlermeldung beenden, falls die Befehle ungültig zu sein scheinen.
.IP "\-" 8
Das Werkzeug \fBdh_missing\fR wird nun auf \fB\-\-list\-missing\fR voreingestellt.
.IP "\-" 8
Das Werkzeug \fBdh_makeshlibs\fR wird jetzt nur Bibliotheken an
\&\fBdpkg\-gensymbols\fR\|(1) übergeben, falls die ELF\-Binärdatei einen \s-1SONAME\s0 hat
(enthält ».so«).
.IP "\-" 8
Das Werkzeug \fBdh_compress\fR komprimiert keine Beispiele mehr (d. h. alles,
was in \fI</usr/share/doc/\fIPaket\fI/examples\fR> installiert ist).
.IP "\-" 8
Die Standardsequenz in \fBdh\fR enthält nun standardmäßig \fBdh_dwz\fR und
\&\fBdh_installinitramfs\fR. Dies macht die Sequenzen \fBdwz\fR und
\&\fBinstallinitramfs\fR überflüssig und sie werden mit einem Fehler
scheitern. Falls Sie diese Befehle überspringen wollen, fügen Sie bitte ein
leeres Override-Ziel in \fIdebian/rules\fR ein (z.B. \fIoverride_dh_dwz:\fR).
.IP "\-" 8
Die Bausysteme \fBMeson\fR und \fBAutoconf\fR setzen die Variable \fB\-\-libexecdir\fR
nicht mehr explizit und verlassen sich auf die Voreinstellung des Bausystems
– diese sollte \fB/usr/libexec\fR sein (per \s-1FHS 3.0,\s0 angenommen in der
Debian-Richtlinie 4.1.5).
.Sp
Falls ein spezielles Paket der Ursprungsautoren nicht die korrekte
Voreinstellung benutzt, kann der Parameter oft manuell per
\&\fBdh_auto_configure\fR\|(1) übergeben werden, etwa wie im folgenden Beispiel:
.Sp
.Vb 2
\&    override_dh_auto_configure:
\&        dh_auto_configure \-\- \-\-libexecdir=/usr/libexec
.Ve
.Sp
Beachten Sie das \fB\-\-\fR vor dem Parameter \fB\-\-libexecdir\fR.
.IP "\-" 8
\&\fBRetroactively removed in debhelper/13.5\fR:
.Sp
The \fBdh_installdeb\fR tool would no longer installs the maintainer provided
\&\fIconffiles\fR file as it was deemed unnecessary.  However, the
\&\fBremove-on-upgrade\fR from dpkg/1.20 made the file relevant again and
\&\fBdh_installdeb\fR now installs it again in compat levels 12+.
.IP "\-" 8
Das Werkzeug \fBdh_installsystemd\fR beruht nicht mehr auf \fBdh_installinit\fR,
um Systemd-Dienste zu handhaben, die über eine SysVinit-Alternative
verfügen. In einem solchen Fall müssen jetzt beide Werkzeuge benutzt werden,
um sicherzustellen, dass der Dienst sowohl unter SysVinit als auch unter
Systemd sauber gestartet wird.
.Sp
Falls Sie eine Methode haben, \fBdh_installinit\fR außer Kraft zu setzen
(z. B. indem Sie es mit \fB\-\-no\-start\fR aufrufen), dann werden Sie jetzt
wahrscheinlich auch eine für \fBdh_installsystemd\fR benötigen.
.Sp
Diese Änderung lässt \fBdh_installinit\fR ein \fImisc:Pre\-Depends\fR für \fBinit-system-helpers (>= 1.54~)\fR einspeisen. Bitte stellen Sie sicher, dass
das Paket \fB${misc:Pre\-Depends}\fR in seinem Feld \fBPre-Depends\fR aufführt,
bevor Sie ein Upgrade auf Kompatibilitätsstufe 12 durchführen.
.IP "\-" 8
Das Drittherstellerwerkzeug \fBdh_golang\fR (aus dem Paket \fBdh-golang\fR)
akzeptiert jetzt standardmäßig die Variable \fB\s-1DH_GOLANG_EXCLUDES\s0\fR für die
Quelleninstallation in \-dev\-Paketen und das nicht nur während des
Bauprozesses. Bitte setzen Sie \fB\s-1DH_GOLANG_EXCLUDES_ALL\s0\fR auf »false«, um zum
vorherigen Verhalten zurückzukehren. Einzelheiten und Beispiele finden Sie
unter \fB\fBDebian::Debhelper::Buildsystem::golang\fB\|(3pm)\fR.
.IP "\-" 8
\&\fBdh_installsystemduser\fR ist nun per Voreinstellung in der
Standard\-\fBdh\fR\-Sequenz enthalten.
.IP "\-" 8
Das Bausystem \fBpython-distutils\fR ist jetzt entfernt worden. Bitte verwenden
Sie stattdessen das Drittanbieterbausystem \fBpybuild\fR.
.RE
.RS 4
.RE
.IP "v11" 4
.IX Item "v11"
Von diesem Modus wird abgeraten.
.Sp
Von der Kompatibilitätsstufe 11 wird für neue Pakete abgeraten, da sie vvon
Funktionalitätswechselwirkungen zwischen dh_installinit und
dh_installsystemd betroffen ist, die dazu führen, dass in manchen Fällen
Dienste nicht korrekt laufen. Bitte erwägen Sie, stattdessen die
Kompatibilitätsstufen 10 oder 12 zu benutzen. Weitere Einzelheiten über das
Thema sind in Debian#887904 und
<https://lists.debian.org/debian\-release/2019/04/msg01442.html> verfügbar.
.Sp
Änderungen gegenüber v10 sind:
.RS 4
.IP "\-" 8
\&\fBdh_installinit\fR installiert keine \fIservice\fR\- oder \fItmpfile\fR\-Dateien
mehr. Es erstellt auch keine Betreuerskripte dafür. Bitte verwenden Sie das
neue Hilfsprogramm \fBdh_installsystemd\fR.
.IP "\-" 8
Die Hilfsprogramme \fBdh_systemd_enable\fR und \fBdh_systemd_start\fR wurden durch
das neue Hilfsprogramm \fBdh_installsystemd\fR ersetzt. Aus demselben Grund
wurde auch die \fBsystemd\fR\-Sequenz für \fBdh\fR entfernt. Wenn Sie das
Hilfswerkzeug \fBdh_installsystemd\fR deaktivieren möchten, verwenden Sie bitte
ein leeres Override-Ziel.
.Sp
Bitte beachten Sie, dass sich das Werkzeug \fBdh_installsystemd\fR in manchen
Fällen (z.B. bei der Verwendung des Parameters \fB\-\-name\fR) geringfügig anders
verhält.
.IP "\-" 8
\&\fBdh_installdirs\fR erstellt keine debian/\fIPaket\fR\-Verzeichnisse mehr, es sei
denn, dies wird ausdrücklich verlangt (oder es muss ein Unterverzeichnis
darin erstellt werden).
.Sp
Die große Mehrheit aller Pakete wird von dieser Änderung nicht betroffen
sein.
.IP "\-" 8
Das \fBmakefile\fR\-Bausystem übergibt nun \fBINSTALL=\*(L"install
\&\-\-strip\-program=true\*(R"\fR an \fBmake\fR\|(1). Davon abgeleitete Bausysteme
(z. B. \fBconfigure\fR oder \fBcmake\fR) sind von dieser Änderung nicht betroffen.
.IP "\-" 8
Das \fBautoconf\fR\-Bausystem übergibt nun \fB\-\-runstatedir=/run\fR an
\&\fI./configure\fR.
.IP "\-" 8
Das \fBcmake\fR\-Bausystem übergibt nun \fB\-DCMAKE_INSTALL_RUNSTATEDIR=/run\fR an
\&\fBcmake\fR\|(1).
.IP "\-" 8
\&\fBdh_installman\fR wird nun vorzugsweise die Sprache anhand des Pfadnamens
statt der Erweiterung bestimmen.
.IP "\-" 8
\&\fBdh_auto_install\fR wird jetzt nur das Zielverzeichnis erstellen, das es
benötigt. Vorher hätte es die Bauverzeichnisse für alle Pakete
erstellt. Dies hat keine Auswirkungen auf Pakete, die nur mit
Debhelper-Befehlen bauen, es könnte aber Programmfehler in Befehlen
offenlegen, die nicht in Debhelper enthalten sind.
.IP "\-" 8
Die Hilfsprogramme \fBdh_installdocs\fR, \fBdh_installexamples\fR,
\&\fBdh_installinfo\fR und \fBdh_installman\fR beenden sich jetzt mit Fehlermeldung,
falls ihre Konfiguration ein Muster aufweist, das zu nichts passt oder sich
auf einen Pfad bezieht, den es nicht gibt.
.Sp
Bekannte Ausnahmen umfassen das Bauen mit dem Profil \fBnodoc\fR, bei dem die
obigen Werkzeuge stillschweigend fehlschlagende Suchen mit Mustern
erlauben,welche zur Angabe von Dokumentation verwendet werden.
.IP "\-" 8
Die Hilfsprogramme \fBdh_installdocs\fR, \fBdh_installexamples\fR,
\&\fBdh_installinfo\fR und \fBdh_installman\fR akzeptieren nun den Parameter
\&\fB\-\-sourcedir\fR mit derselben Bedeutung wie \fBdh_install\fR. Überdies fallen
sie jetzt, so wie \fBdh_install\fR, auf \fIdebian/tmp\fR zurück.
.Sp
Migrationshinweis: Ein Fehler in Debhelper 11 bis 11.1.5 führte
fälschlicherweise dazu, dass \fBdh_installinfo\fR \fB\-\-sourcedir\fR ignoriert hat.
.IP "\-" 8
Die Bausysteme \fBperl-makemaker\fR und \fBperl-build\fR übergeben \fB\-I.\fR nicht
mehr an Perl. Pakete, die dieses Verhalten immer noch benötigen, können es
durch Verwendung der Umgebungsvariable \fB\s-1PERL5LIB\s0\fR emulieren, z. B. durch
Eintragen von \fBexport PERL5LIB=.\fR in ihre »debian/rules«\-Datei (oder
dergleichen).
.IP "\-" 8
\&\fB\s-1PERL_USE_UNSAFE_INC\s0\fR wird jetzt von \fBdh\fR oder den \fBdh_auto_*\fR\-Werkzeugen
nicht mehr gesetzt. Sie diente als Übergangslösung, um zu verhindern, dass
das gleichzeitige Bauen vieler Pakete scheitert.
.Sp
Beachten Sie, dass sie irgendwann komplett hinfällig wird, da die
Ursprungsautoren beabsichtigen, die Unterstützung für die Umgebungsvariable
\&\fB\s-1PERL_USE_UNSAFE_INC\s0\fR einzustellen. Wenn es so weit ist, wird diese
Variable nachträglich auch aus bestehenden Kompatibilitätsstufen entfernt.
.IP "\-" 8
Das Hilfsprogramm \fBdh_makeshlibs\fR wird nun mit einer Fehlermeldung beendet,
falls Objdump nach der Auswertung einer gegebenen Datei einen Rückgabewert
ungleich null zurückliefert.
.IP "\-" 8
Die Werkzeuge \fBdh_installdocs\fR und \fBdh_installexamples\fR können jezt die
\&\fImeiste\fR Dokumentation in einem anderen Pfad installieren, um die
Empfehlung der Debian-Richtlinien §12.3 (seit Version 3.9.7) zu erfüllen.
.Sp
Beachten Sie, dass diese Änderung nicht für dieses Quellpaket relevant ist
und Sie zur nächsten Änderung springen können, falls ein angegebenes
Quellpaket nur ein einziges Binärpaket in \fIdebian/control\fR enthält oder
keine \fI\-doc\fR\-Pakete dabei sind.
.Sp
Standardmäßig werden diese Werkzeuge nun versuchen, ein »Hauptpaket für die
Dokumentation« (ab hier \fIHauptdokumentationspaket\fR genannt) für jedes
\&\fI\-doc\fR\-Paket zu bestimmen. Falls sie ein derartiges
\&\fIHauptdokumentationspaket\fR finden, werden sie nun die Dokumentation in den
Pfad \fI/usr/share/doc/\fIHauptdokumentationspaket\fI\fR im angegebenen
Dokumentationspaket installieren. Das heißt, der Pfad kann sich ändern, aber
die Dokumentation wird immer noch im \fI\-doc\fR\-Paket mitgeliefert.
.Sp
Die Option \fB\-\-doc\-main\-package\fR kann benutzt werden, wenn die automatische
Erkennung unzureichend ist oder um den Pfad auf seinen vorherigen Wert
zurückzusetzen, falls es einen Grund gibt, von der Empfehlung der
Debian-Richlinien abzuweichen.
.Sp
Manche Dokumentation wird von dieser Änderung nicht beeinflusst. Diese
Ausnahmen umfassen die Copyright-Dateien, \s-1README\s0.Debian usw. Diese Dateien
werden weiterhin im Pfad \fI/usr/share/doc/\fIPaket\fI\fR installiert.
.IP "\-" 8
Die Werkzeuge \fBdh_strip\fR und \fBdh_shlibdeps\fR verwenden keine
Dateinamenmuster mehr, um zu bestimmen, welche Dateien verarbeitet
werden. Stattdessen öffnen sie die Datei und suchen nach einem ELF-Header,
um zu bestimmen, ob eine übergebene Datei ein gemeinsam benutztes Objekt
oder ein ausführbares binäres Programm ist.
.Sp
Diese Änderung kann dazu führen, dass mehr Dateien als vorher verarbeitet
werden.
.RE
.RS 4
.RE
.IP "v10" 4
.IX Item "v10"
Änderungen gegenüber v9 sind:
.RS 4
.IP "\-" 8
\&\fBdh_installinit\fR wird keine Datei namens debian/\fIPaket\fR mehr als
Init-Skript installieren.
.IP "\-" 8
\&\fBdh_installdocs\fR wird mit einem Fehler fehlschlagen, falls es Links
entdeckt, die mit \-\-link\-doc zwischen Paketen der Architektur »all« und
nicht\-»all« erzeugt wurden, da d binNMUs beschädigt.
.IP "\-" 8
\&\fBdh_installdeb\fR installiert keine vom Paketbetreuer bereitgestellte
debian/\fIPaket\fR.shlibs\-Datei mehr. Dies wird stattdessen von
\&\fBdh_makeshlibs\fR erledigt.
.IP "\-" 8
\&\fBdh_installwm\fR weigert sich, ein beschädigtes Paket zu erstellen, falls
keine Handbuchseite gefunden wird (erforderlich, um die Alternative zum
X\-Window-Manager zu registrieren).
.IP "\-" 8
\&\fB\-\-parallel\fR ist Debhelpers Voreinstellung für alle Bausysteme, die
paralleles Bauen unterstützen. Dies kann entweder durch Verwendung von
\&\fB\-\-no\-parallel\fR oder durch Übergabe von \fB\-\-max\-parallel\fR mit einem Wert
von 1 deaktiviert werden.
.IP "\-" 8
Der Befehl \fBdh\fR wird keinen der veralteten Parameter zur »manuellen
Sequenzsteuerung« (\fB\-\-before\fR, \fB\-\-after\fR, etc.) akzeptieren. Bitte
verwenden Sie stattdessen Aufhebungsziele (override targts).
.Sp
\&\fBNachträglich auf frühere Kompatibilitätsstufen angewandt\fR:  \fBdh\fR
akzeptiert seit Debhelper/12.4 nichts davon mehr.
.IP "\-" 8
Der Befehl \fBdh\fR wird keine Logdateien mehr benutzen, um zu protokollieren,
welche Befehle ausgeführt worden sind. Er wird aber \fItrotzdem\fR
nachverfolgen, ob er selbst schon einmal in der Bausequenz gelaufen ist und
sie ggf. überspringen.
.Sp
Die wichtigsten Auswirkungen davon sind:
.RS 8
.IP "\-" 4
Hierdurch wird die Fehlersuche bei den Sequenzen \fIinstall\fR und/oder
\&\fIbinary\fR einfacher, da sie nun einfach erneut ausgeführt werden können
(ohne, dass ein vollständiger »Aufräum\- und Neubau«\-Durchgang erforderlich
ist).
.IP "\-" 4
Der Pferdefuß hier liegt darin, dass \fBdh_*\fR nun nur noch nachverfolgt, was
in einem einzelnen Override-Ziel geschieht. Wenn alle Aufrufe eines
angegebenen \fBdh_cmd\fR\-Befehls im selben Override-Ziel stattfinden, wird
alles wie zuvor funktionieren.
.Sp
Beispiel, bei dem es schiefgehen kann:
.Sp
.Vb 2
\&  override_dh_foo:
\&    dh_foo \-pmein\-Paket
\&
\&  override_dh_bar:
\&    dh_bar
\&    dh_foo \-\-remaining
.Ve
.Sp
In diesem Fall wird der Aufruf von \fBdh_foo \-\-remaining\fR \fIaußerdem\fR
\&\fImein-Paket\fR enthalten, da \fBdh_foo \-pmein\-Paket\fR in einem separaten
Override-Ziel ausgeführt wird. Dieses Problem ist nicht auf \fB\-\-remaining\fR
begrenzt, es umfasst außerdem \fB\-a\fR, \fB\-i\fR, etc.
.RE
.RS 8
.RE
.IP "\-" 8
Der Befehl \fBdh_installdeb\fR maskiert nun die Zeilen in der
Konfigurationsdatei \fImaintscript\fR für die Shell. Dies war der ursprüngliche
Gedanke, aber es funktionierte nicht, wie es sollte und die Pakete begannen,
sich auf die unvollständige Shell-Maskierung zu verlassen (z.B. das Setzen
von Dateinamen in Anführungszeichen).
.IP "\-" 8
Voreinstellung für den Befehl \fBdh_installinit\fR ist nun
\&\fB\-\-restart\-after\-upgrade\fR. Für Pakete, die das vorhergehende Verhalten
erfordern, verwenden Sie bitte \fB\-\-no\-restart\-after\-upgrade\fR.
.IP "\-" 8
Die \fBautoreconf\fR\-Sequenz ist nun standardmäßig aktiviert. Bitte übergeben
Sie \fB\-\-without autoreconf\fR an \fBdh\fR, falls dies für ein angegebenes Paket
nicht erwünscht ist.
.IP "\-" 8
Die \fBsystemd\fR\-Sequenz ist nun standardmäßig aktiviert. Bitte übergeben Sie
\&\fB\-\-without systemd\fR an \fBdh\fR, falls dies für ein angegebenes Paket nicht
erwünscht ist.
.IP "\-" 8
\&\fBNachträglich entfernt\fR: \fBdh\fR erstellt das Bauverzeichnis des Pakets nicht
mehr, wenn die Ausführung von Debhelper-Befehlen übersprungen wird. Dies hat
keine Auswirkungen auf Pakete, die nur mit Debhelper-Befehlen bauen, es
könnte aber Fehler in Befehlen offenlegen, die nicht in Debhelper enthalten
sind.
.Sp
Diese Kompatibilitätsfunktionalität hatte einen Fehler seit ihrer Aufnahme
in Debhelper/9.20130516, der sie im Kompatibilitätsmodus 9 und älter zum
Scheitern brachte. Da es in den fünf Jahren ihres Bestehens keine Berichte
zu Problemen gab, die von diesem Fehler verursacht wurden, wurde sie nicht
überarbeitet, sondern entfernt.
.RE
.RS 4
.RE
.IP "v9" 4
.IX Item "v9"
Änderungen gegenüber v8 sind:
.RS 4
.IP "\-" 8
Multiarch\-Unterstützung. Insbesondere gibt \fBdh_auto_configure\fR
Multiarch-Verzeichnisse an Autoconf in \-\-libdir and \-\-libexecdir weiter.
.IP "\-" 8
dh kennt die üblichen Abhängigkeiten zwischen den Zielen in
debian/rules. Daher wird »dh binary« alle »build«\-, »build\-arch«\-,
»build\-indep«\-, »install«\-Ziele etc. ausführen, die in der Regeldatei
stehen. Es ist nicht nötig, explizit ein binäres Ziel mit expliziten
Abhängigkeiten zu den anderen Zielen zu definieren.
.IP "\-" 8
\&\fBdh_strip\fR komprimiert Debug-Symboldateien, um die Größe der installierten
»\-dbg«\-Paketen zu verringern.
.IP "\-" 8
\&\fBdh_auto_configure\fR enthält keinen Quellpaketnamen in \-\-libexecdir, wenn
Autoconf benutzt wird.
.IP "\-" 8
Standardmäßig aktiviert \fBdh\fR nicht \-\-with=python\-support.
.Sp
(Hinfällig, da das Werkzeug \fBdh_pysupport\fR aus Debian Stretch entfernt
wurde. Seit Debhelper/10.3 aktiviert \fBdh\fR diese Sequenzerweiterung
unabhängig von der Kompatibilitätsstufe nicht mehr.)
.IP "\-" 8
Alle \fBdh_auto_\fR\fI*\fR\-Debhelper\-Programme und \fBdh\fR setzen
Umgebungsvariablen, die durch \fBdpkg-buildflags\fR aufgelistet werden, sofern
sie nicht bereits gesetzt sind.
.IP "\-" 8
\&\fBdh_auto_configure\fR übergibt \s-1CFLAGS, CPPFLAGS\s0 und \s-1LDFLAGS\s0 von
\&\fBdpkg-buildflags\fR an Perls \fIMakefile.PL\fR und \fIBuild.PL.\fR
.IP "\-" 8
\&\fBdh_strip\fR legt getrennte Fehlersuchsymbole an einer Stelle ab, die auf
ihrer Baukennzahl basiert.
.IP "\-" 8
Ausführbare Debhelper-Konfigurationsdateien werden ausgeführt und ihre
Ausgabe wird als Konfiguration benutzt.
.RE
.RS 4
.Sp
Dieser Modus ist missbilligt.
.RE
.IP "v8" 4
.IX Item "v8"
Änderungen gegenüber v7 sind:
.RS 4
.IP "\-" 8
Befehle werden fehlschlagen anstatt zu warnen, wenn ihnen unbekannte
Optionen übergeben werden.
.IP "\-" 8
\&\fBdh_makeshlibs\fR führt \fBdpkg-gensymbols\fR auf allen gemeinsamen Bibliotheken
aus, für die es Shlib-Dateien generiert, wobei Bibliotheken mit \fB\-X\fR
ausgeschlossen werden können. Außerdem werden \fBdpkg-gensymbols\fR
Bibliotheken an unüblichen Orten übergeben, ohne dass es diese vorher
verarbeitet haben wird, was dazu führen kann, dass sich einige Pakete nicht
bauen lassen.
.IP "\-" 8
\&\fBdh\fR erfordert, dass die auszuführende Sequenz als erster Parameter
angegeben wird und sämtliche Schalter danach kommen. Das heißt, Sie
schreiben nicht »\fBdh \-\-foo $@\fR«, sondern »\fBdh $@ \-\-foo\fR«.
.IP "\-" 8
\&\fBdh_auto_\fR\fI*\fR bevorzugt Perls \fBModule::Build\fR gegenüber \fIMakefile.PL\fR.
.RE
.RS 4
.Sp
Dieser Modus ist missbilligt.
.RE
.IP "v7" 4
.IX Item "v7"
Dieser Modus ist missbilligt.
.Sp
Dies ist die unterste unterstützte Kompatibilitätsstufe.
.Sp
Falls Sie ein Upgrade von einer vorhergehenden Kompatibilitätsstufe
durchführen, überprüfen Sie bitte \fBdebhelper\-obsolete\-compat\fR\|(7).
.SH "SIEHE AUCH"
.IX Header "SIEHE AUCH"
.IP "\fBdebhelper\-obsolete\-compat\fR\|(7)" 4
.IX Item "debhelper-obsolete-compat"
Upgrading from a (now) obsolete compatibility level? This document covers
the upgrade checklist up to the earliest supported level.
.IP "\fBdebhelper\fR\|(7)" 4
.IX Item "debhelper"
General information about the debhelper framework. This document also covers
how to declare your chosen debhelper compat level.
.SH "ÜBERSETZUNG"
.IX Header "ÜBERSETZUNG"
Diese Übersetzung wurde mit dem Werkzeug
\&\fBpo4a\fR
<http://po4a.alioth.debian.org/>
durch Chris Leick
\&\fIc.leick@vollbio.de\fR
und das deutsche Debian\-Übersetzer\-Team im 
Dezember 2011 erstellt.
.PP
Bitte melden Sie alle Fehler in der Übersetzung an
\&\fIdebian\-l10n\-german@lists.debian.org\fR
oder als Fehlerbericht an das Paket
\&\fIdebhelper\fR.
.PP
Sie können mit dem folgenden Befehl das englische 
Original anzeigen
man \-L en Abschnitt Handbuchseite
.SH "AUTOREN"
.IX Header "AUTOREN"
Niels Thykier <niels@thykier.net>
.PP
Joey Hess