.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43) .\" .\" 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 "USCAN.DE 1" .TH USCAN.DE 1 "2023-12-12" "Debian-Hilfswerkzeuge" " " .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "BEZEICHNUNG" .IX Header "BEZEICHNUNG" uscan \- durchsucht/beobachtet Quellen der Ursprungsautoren nach neuen Veröffentlichungen der Software .SH "ÜBERSICHT" .IX Header "ÜBERSICHT" \&\fBuscan\fR [\fIOptionen\fR] [\fIPfad\fR] .SH "BESCHREIBUNG" .IX Header "BESCHREIBUNG" For basic usage, \fBuscan\fR is executed without any arguments from the root of the Debianized source tree where you see the \fIdebian/\fR directory, or a directory containing multiple source trees. .PP Unless \-\-watchfile is given, \fBuscan\fR looks recursively for valid source trees starting from the current directory (see the below section \*(L"Directory name checking\*(R" for details). .PP For each valid source tree found, typically the following happens: .IP "\(bu" 4 \&\fBuscan\fR liest den ersten Eintrag in \fIdebian/changelog\fR, um den Namen des Quellpakets \fI\fR und die neueste Version der Ursprungsautoren zu bestimmen. .IP "\(bu" 4 \&\fBuscan\fR verarbeitet die Watch-Zeilen \fIdebian/watch\fR von oben nach unten in einem einzigen Durchlauf. .RS 4 .IP "\(bu" 4 \&\fBuscan\fR lädt eine Web-Seite von der in \fIdebian/watch\fR angegebenen \fI\s-1URL\s0\fR herunter. .IP "\(bu" 4 \&\fBuscan\fR extrahiert Hrefs, die auf Tarbälle der Ursprungsautoren von der durch \fISuchmuster\fR in \fIdebian/watch\fR angegebenen Web-Seite zeigen. .IP "\(bu" 4 \&\fBuscan\fR lädt den Tarball der Ursprungsautoren mit der höchsten Version, die neuer ist, als die letzte Version der Ursprungsautoren, herunter. .IP "\(bu" 4 \&\fBuscan\fR speichert den heruntergeladenen Tarball ins übergeordnete \fB../\fR Verzeichnis: \fI../\-.tar.gz\fR .IP "\(bu" 4 \&\fBuscan\fR ruft \fBmk-origtargz\fR auf, um den Quell-Tarball zu erstellen: \fI../_.orig.tar.gz\fR .RS 4 .IP "\(bu" 4 Bei einem Paket aus mehreren Tarbällen der Ursprungsautoren (\s-1MUT\s0) wird der untergeordnete Tarball der Ursprungsautoren stattdessen \fI../_.orig\-.tar.gz\fR genannt. .RE .RS 4 .RE .IP "\(bu" 4 Dies wird wiederholt, bis alle Zeilen in \fIdebian/watch\fR verarbeitet wurden. .RE .RS 4 .RE .IP "\(bu" 4 \&\fBuscan\fR ruft \fBuupdate\fR auf, um den an Debian angepassten Quellverzeichnisbaum zu erstellen: \fI../\-/*\fR .PP Bitte beachten Sie Folgendes: .IP "\(bu" 4 For simplicity, the compression method used in examples is \fBgzip\fR with \&\fB.gz\fR suffix. Other methods such as \fBxz\fR, \fBbzip2\fR, and \fBlzma\fR with corresponding \fBxz\fR, \fBbz2\fR and \fBlzma\fR suffixes may also be used. .IP "\(bu" 4 Die neue \fBVersion=4\fR aktiviert die Behandlung von Paketen mit mehreren Tarbällen der Ursprungsautoren (\s-1MUT\s0), dies ist aber ein seltener Fall bei der Debian-Paketierung. Für ein einzelnes Tarball-Paket der Ursprungsautoren gibt es nur eine Watch-Zeile und kein \fI../_.orig\-.tar.gz\fR . .IP "\(bu" 4 \&\fBuscan\fR erzeugt mit der Option \fB\-\-verbose\fR einen für Menschen lesbaren Bericht über die Ausführung von \fBuscan\fR. .IP "\(bu" 4 \&\fBuscan\fR erzeugt mit der Option \fB\-\-debug\fR einen für Menschen lesbaren Bericht über die Ausführung von \fBuscan\fR einschließlich der Status interner Variablen. .IP "\(bu" 4 \&\fBuscan\fR with the \fB\-\-extra\-debug\fR option produces a human readable report of \fBuscan\fR's execution including internal variable states and remote content during \*(L"search\*(R" step. .IP "\(bu" 4 \&\fBuscan\fR erzeugt mit der Option \fB\-\-dehs\fR einen Bericht über den Paketstatus der Ursprungsautoren im XML-Format für andere Programme, wie das Debian External Health System. .IP "\(bu" 4 Der vorrangige Zweck von \fBuscan\fR ist es, festzustellen, ob die neueste Version des Tarballs der Ursprungsautoren verwendet wird oder nicht und den neuesten Tarball der Ursprungsautoren herunterzuladen. Die Ordnung der Versionen wird durch \fBdpkg \-\-compare\-versions\fR festgelegt. .IP "\(bu" 4 \&\fBuscan\fR beschränkt mit der Option \fB\-\-safe\fR seine Funktionalität auf seinen vorrangigen Zweck. Sowohl das erneute Packen heruntergeladener Dateien als auch das Aktualisieren des Quellverzeichnisbaums werden übersprungen, um die Ausführung unsicherer Skripte zu vermeiden. Dies ändert außerdem die Voreinstellung auf \fB\-\-no\-download\fR und \fB\-\-skip\-signature\fR. .SH "FORMAT DER WATCH-DATEI" .IX Header "FORMAT DER WATCH-DATEI" Das derzeitig Format der Version 4 von \fIdebian/watch\fR kann wie folgt zusammengefasst werden .IP "\(bu" 4 Führende Leerzeichen und Tabulatoren werden weggelassen. .IP "\(bu" 4 Leere Zeilen werden weggelassen. .IP "\(bu" 4 Eine Zeile, die mit \fB#\fR (Doppelkreuz) beginnt, ist eine Kommentarzeile und wird weggelassen. .IP "\(bu" 4 Ein einzelner \fB\e\fR (Rückwärtsschrägstrich) am Ende einer Zeile wird weggelassen und die nächste Zeile wird nach dem Entfernen führender Leerzeichen und Tabulatoren angehängt. Die verbundene Zeile wird als einzelne Zeile ausgewertet. (Es ist maßgeblich, ob das Leerzeichen vor dem einzelnen \fB\e\fR vorhanden ist oder nicht.) .IP "\(bu" 4 Die erste Nichtkommentarzeile ist: .RS 4 .IP "\fBversion=4\fR" 4 .IX Item "version=4" .RE .RS 4 .Sp Dies ist eine benötigte Zeile und die empfohlene Versionsnummer. .Sp Falls Sie hier stattdessen »\fBversion=3\fR« benutzen, funktionieren einige Funktionalitäten möglicherweise nicht wie hier beschrieben. Siehe \*(L"\s-1CHRONIK UND UPGRADES\s0 DURCHFÜHREN\*(R". .RE .IP "\(bu" 4 Die folgenden Nichtkommentarzeilen (Watch-Zeilen) geben die Regeln für die Auswahl der Kandidaten für Tarball-URLs der Ursprungsautoren in einem der folgenden drei Formate an: .RS 4 .IP "\(bu" 4 \&\fBopts="\fR \fI…\fR \fB"\fR \fBhttp://\fR\fI\s-1URL\s0\fR \fISuchmuster\fR [\fIVersion\fR [\fISkript\fR]] .IP "\(bu" 4 \&\fBhttp://\fR\fI\s-1URL\s0\fR \fISuchmuster\fR [\fIVersion\fR [\fISkript\fR]] .IP "\(bu" 4 \&\fBopts="\fR \fI…\fR \fB"\fR .RE .RS 4 .Sp Hier gibt .IP "\(bu" 4 \&\fBopts="\fR \fI…\fR \fB"\fR das Verhalten von \fBuscan\fR an. Siehe »WATCH«\-DATEIOPTIONEN. .IP "\(bu" 4 \&\fBhttp://\fR\fI\s-1URL\s0\fR gibt die Web-Seite an, auf der die Ursprungsautoren den Link auf das neueste Quellarchiv veröffentlichen. .RS 4 .IP "\(bu" 4 \&\fBhttps://\fR\fI\s-1URL\s0\fR kann ebenfalls verwendet werden sowie .IP "\(bu" 4 \&\fBftp://\fR\fI\s-1URL\s0\fR .IP "\(bu" 4 Einige Teile der \fI\s-1URL\s0\fR können im Suchmuster des regulären Ausdrucks in \&\fB(\fR und \fB)\fR eingeschlossen werden, wie etwa \fB/foo/bar\-([\e.\ed]+)/\fR. (Falls mehrere Verzeichnisse passen, wird die höchste Version herausgegriffen). Andernfalls wird die \fI\s-1URL\s0\fR wörtlich genommen. .RE .RS 4 .RE .IP "\(bu" 4 \&\fISuchmuster\fR gibt die vollständige Zeichenkette des Suchmusters für Hrefs auf der Web-Seite an. Siehe »WATCH«\-DATEIBEISPIELE. .RS 4 .IP "\(bu" 4 Alle passenden Teile in \fB(\fR und \fB)\fR werden mit \fB.\fR (Punkt) verbunden, um die Version der Ursprungsautoren zu bilden. .IP "\(bu" 4 Falls die Hrefs keine Verzeichnisse enthalten, können Sie diese mit dem vorherigen Eintrag kombinieren. D.h., \fBhttp://\fR\fI\s-1URL\s0\fR\fB/\fR\fISuchmuster\fR . .RE .RS 4 .RE .IP "\(bu" 4 \&\fIversion\fR schränkt ein, welcher Tarball der Ursprungsautoren heruntergeladen werden kann. Auf jeden Fall wird die neueste verfügbare Version ausgewählt. .RS 4 .IP "\(bu" 4 \&\fBdebian\fR \fIVoreinstellung\fR erfordert, dass der herunterzuladende Tarball der Ursprungsautoren neuer als die aus \fIdebian/changelog\fR erhaltene Version ist. .IP "\(bu" 4 \&\fIVersionsnummer\fR wie beispielsweise \fB12.5\fR erfordert, dass der Tarball der Ursprungsautoren neuer als die \fIVersionsnummer\fR ist. .IP "\(bu" 4 \&\fBsame\fR erfordert, dass die heruntergeladene Version des untergeordneten Tarballs exakt dieselbe wie die des ersten heruntergeladenen Tarballs der Ursprungsautoren ist. (nur nützlich bei \s-1MUT\s0) .IP "\(bu" 4 \&\fBprevious\fR schränkt die Version der Signaturdatei ein. (verwendet mit pgpmode=previous) .IP "\(bu" 4 \&\fBignore\fR schränkt die Version des untergeordneten Tarballs nicht ein. (kann für \s-1MUT\s0 nützlich sein) .IP "\(bu" 4 \&\fBgroup\fR erfordert, dass der herunterzuladende Tarball der Ursprungsautoren neuer als die aus \fIdebian/changelog\fR erhaltene Version ist. Die Paketversion ist aus allen »group«\-Versionen der Ursprungsautoren zusammengesetzt. .IP "\(bu" 4 \&\fBchecksum\fR requires the downloading upstream tarball to be newer than the version obtained from \fIdebian/changelog\fR. Package version is the concatenation of the version of the main tarball, followed by a checksum of all the tarballs using the \*(L"checksum\*(R" version system. At least the main upstream source has to be declared as \*(L"group\*(R". .RE .RS 4 .RE .IP "\(bu" 4 \&\fISkript\fR wird am Ende der \fBuscan\fR\-Ausführung mit den von \fBuscan\fR bereitgestellten geeigneten Argumenten ausgeführt \fIVoreinstellung: keine Aktion\fR. .RS 4 .IP "\(bu" 4 Das typische Debian-Paket ist ein nichtnatives Paket, das aus einem Tarball der Ursprungsautoren erstellt wurde. Üblicherweise wird nur eine einzelne Zeile der Watch-Zeile in einem der beiden ersten Formate benutzt. Dabei wird \fIversion\fR auf \fBdebian\fR und \fIscript\fR auf \fBuupdate\fR gesetzt. .IP "\(bu" 4 Ein natives Paket sollte \fIscript\fR nicht angeben. .IP "\(bu" 4 Ein Paket aus mehreren Tarbällen der Ursprungsautoren (\s-1MUT\s0) sollte \&\fBuupdate\fR als \fIscript\fR in der letzten Watch-Zeile angeben und die Angabe von \fIscript\fR in den restlichen Watch-Zeilen überspringen. .RE .RS 4 .RE .IP "\(bu" 4 Das letzte Format einer Watch-Zeile ist nützlich, um beständige Parameter zu setzen: \fBuser-agent\fR, \fBcompression\fR. Falls dieses Format benutzt wird, muss darauf die \fI\s-1URL\s0\fR folgen, die Watch-Zeilen definiert. .IP "\(bu" 4 [ und ] sind im im obigen Format, um die optionalen Teilen zu kennzeichnen und sollten nicht eingetippt werden. .RE .RS 4 .RE .PP Es gibt ein paar spezielle Zeichenketten, die durch \fBuscan\fR ersetzt werden, um das Schreiben der Watch-Datei zu erleichtern. .IP "\fB\f(CB@PACKAGE\fB@\fR" 4 .IX Item "@PACKAGE@" Dies wird durch den Quellpaketnamen aus der ersten Zeile der Datei \fIdebian/changelog\fR ersetzt. .IP "\fB\f(CB@ANY_VERSION\fB@\fR" 4 .IX Item "@ANY_VERSION@" Dies wird durch den regulären Ausdruck der gültigen Version der Ursprungsautoren ersetzt. (aufnehmend) .Sp .Vb 1 \& [\-_]?[Vv]?(\ed[\e\-+\e.:\e~\eda\-zA\-Z]*) .Ve .IP "\fB\f(CB@ARCHIVE_EXT\fB@\fR" 4 .IX Item "@ARCHIVE_EXT@" Dies wird durch den regulären Ausdruck der typischen Archiverweiterung ersetzt. (nicht aufnehmend) .Sp .Vb 1 \& (?i)(?:\e.(?:tar\e.xz|tar\e.bz2|tar\e.gz|tar\e.zstd?|zip|tgz|tbz|txz)) .Ve .IP "\fB\f(CB@SIGNATURE_EXT\fB@\fR" 4 .IX Item "@SIGNATURE_EXT@" Dies wird durch den regulären Ausdruck der typischen Signaturdateierweiterung ersetzt. (nicht aufnehmend) .Sp .Vb 1 \& (?i)(?:\e.(?:tar\e.xz|tar\e.bz2|tar\e.gz|tar\e.zstd?|zip|tgz|tbz|txz))\*(Aq(?:\e.(?:asc|pgp|gpg|sig|sign))\*(Aq .Ve .IP "\fB\f(CB@DEB_EXT\fB@\fR" 4 .IX Item "@DEB_EXT@" Dies wird durch den regulären Ausdruck der typischen Debian-Dateinamenerweiterung ersetzt. (einfangend) .Sp .Vb 1 \& [\e+~](debian|dfsg|ds|deb)(\e.)?(\ed+)?$ .Ve .PP Einige Dateierweiterungen sind absichtlich nicht enthalten, um falsche Treffer zu vermeiden. Sie können solche Muster für Dateierweiterungen aber immer noch manuell setzen. .SH "»WATCH«\-DATEIOPTIONEN" .IX Header "»WATCH«-DATEIOPTIONEN" \&\fBuscan\fR liest die in \fBopts="\fR \fI…\fR \fB"\fR angegebenen Optionen, um sein Verhalten anzupassen. Mehrere Optionen \fIOption1\fR, \fIOption2\fR, \fIOption3\fR, … können als \fBopts="\fR\fIOption1\fR, \fIOption2\fR, \fIOption3\fR\fB,\fR \fI … \fR\fB"\fR gesetzt werden. Die doppelten Anführungszeichen werden nötig, falls Optionen irgendwelche Leerräume enthalten. .PP Sofern sie nicht als beständig notiert sind, sind die meisten Optionen nur innerhalb der Watch-Zeile gültig, in der sie stehen. .PP Die verfügbaren Watch-Optionen sind: .IP "\fBcomponent=\fR\fIKomponente\fR" 4 .IX Item "component=Komponente" setzt den Namen des untergeordneten Quell-Tarballs für ein MUT-Paket als \fI_.orig\-.tar.gz\fR. .IP "\fBctype=\fR\fIcomponent-type\fR" 4 .IX Item "ctype=component-type" Set the type of component \fI(only \*(L"nodejs\*(R" and \*(L"perl\*(R" are available for now)\fR. This will help uscan to find current version if component version is ignored. .Sp When using \fBctype=nodejs\fR, uscan tries to find a version in \f(CW\*(C`package.json\*(C'\fR, when using \fBctype=perl\fR, uscan tries to find a version in \f(CW\*(C`META.json\*(C'\fR. If a version is found, it is used as current version for this component, regardless version found in Debian version string. This permits a better change detection when using \fIignore\fR or \fIchecksum\fR as Debian version. .IP "\fBcompression=\fR\fIMethode\fR" 4 .IX Item "compression=Methode" setzt die Komprimierungs\-\fIMethode\fR, wenn ein Tarball erneut gepackt wird (beständig). .Sp Verfügbare \fIMethode\fRn sind die, die mk-origtargz unterstützt, also \fBxz\fR, \fBgzip\fR (alias \fBgz\fR), \fBbzip2\fR (alias \fBbz2\fR), \fBlzma\fR, \fBdefault\fR. Die Voreinstellung ist derzeit \fBxz\fR. Wenn Uscan in einem Debian-Quelldepot, dessen Format »1.0« oder nicht definiert ist, gestartet wird, wechselt die Methode zu \fBgzip\fR. .Sp Bitte beachten Sie, dass das erneute Packen des Tarballs der Ursprungsautoren durch \fBmk-origtargz\fR nur vorkommt, wenn eine der folgenden Bedingungen erfüllt ist: .RS 4 .IP "\(bu" 4 \&\fB\s-1USCAN_REPACK\s0\fR ist in der Devscripts-Konfiguration gesetzt. (Siehe DEVSCRIPT-KONFIGURATIONSVARIABLEN. .IP "\(bu" 4 \&\fB\-\-repack\fR wurde auf der Befehlszeile gesetzt. Siehe <\s-1BEFEHLZEILENOPTIONEN\s0>. .IP "\(bu" 4 \&\fBrepack\fR wurde in der Watch-Zeile als \fBopts="repack,\fR\fI…\fR\fB"\fR gesetzt. .IP "\(bu" 4 Das Archiv der Ursprungsautoren ist vom Typ \fBzip\fR einschließlich \fBjar\fR, \&\fBxpi\fR, … .IP "\(bu" 4 The upstream archive is of \fBzstd\fR (Zstandard) type. .IP "\(bu" 4 In \fIdebian/copyright\fR sind \fBFiles-Excluded\fR\- oder \&\fBFiles\-Excluded\-\fR\fIKomponente\fR\-Absätze gesetzt, damit das von \fBuscan\fR aufgerufene \fBmk-origtargz\fR Dateien aus dem Tarball der Ursprungsautoren entfernt und ihn erneut packt. Siehe \*(L"\s-1BEISPIELE\s0 FÜR COPYRIGHT-DATEIEN\*(R" und \&\fBmk\-origtargz\fR\|(1). .RE .RS 4 .RE .IP "\fBrepack\fR" 4 .IX Item "repack" erzwingt das erneute Packen der Tarballs der Ursprungsautoren mittels der Komprimierungs\-\fIMethode\fR. .IP "\fBrepacksuffix=\fR\fIEndung\fR" 4 .IX Item "repacksuffix=Endung" fügt der Debian-Paketversion der Ursprungsautoren nur die \fIEndung\fR hinzu, wenn der Quelltext-Tarball erneut gepackt wird. Diese Regel sollte nur für einen einzelnen Tarball der Ursprungsautoren verwendet werden. .IP "\fBmode=\fR\fIModus\fR" 4 .IX Item "mode=Modus" setzt den Herunterlade\-\fIModus\fR. .RS 4 .IP "\fB\s-1LWP\s0\fR" 4 .IX Item "LWP" Dieser Modus ist die Voreinstellung, durch den der angegebene Tarball von der Archiv-URL im Web heruntergeladen wird. Der interne \fBModus\fR wird je nach \s-1URL\s0 automatisch auf \fBhttp\fR oder \fBftp\fR aktualisiert. .IP "\fBgit\fR" 4 .IX Item "git" Dieser Modus greift mit dem Befehl \fBgit\fR direkt auf das Git-Archiv der Ursprungsautoren zu und packt den Quelltextverzeichnisbaum mit der angegebenen Markierung über \fIVergleichsmuster\fR in \fIQuellpaketversion\fR\fB.tar.xz\fR. .Sp Falls die Ursprungsautoren den veröffentlichten Tarball über ihre Web-Schnittstelle veröffentlichen, verwenden Sie bitte diese anstelle dieses Modus. Dieser Modus ist die letzte Rückfalloption. .Sp Für den Git-Modus gibt \fIVergleichsmuster\fR das vollständige Zeichenkettenmuster für Markierungen anstelle von Hrefs an. Falls \fIVergleichsmuster\fR auf \fBrefs/tags/\fR\fIMarkierungsvergleichsmuster\fR gesetzt ist, lädt \fBuscan\fR die Quelle von der \fBrefs/tags/\fR\fIpassenden-Markierung\fR des Git-Depots herunter. Die Version der Ursprungsautoren wird aus dem Zusammenhängen der passenden Teile in \fB(\fR … \fB)\fR mit \fB.\fR extrahiert. Siehe »WATCH«\-DATEIBEISPIELE. .Sp Falls \fIVergleichsmuster\fR auf \fB\s-1HEAD\s0\fR gesetzt ist, lädt \fBuscan\fR die Quelle vom \fB\s-1HEAD\s0\fR des Git-Depots herunter und die passende \fIVersion\fR wird automatisch mit dem Datum und dem Hash von \fB\s-1HEAD\s0\fR des Git-Depots erzeugt. .Sp Falls \fIVergleichsmuster\fR auf \fBrefs/heads/\fR\fIZweig\fR gesetzt ist, lädt \fBuscan\fR die Quelle von dem angegebenen \fIZweig\fR des Git-Depots herunter. .Sp Das lokale Depot wird vorübergehend als ein Bare-Git-Depotverzeichnis unterhalb des Zielverzeichnisses erzeugt, in dem das heruntergeladene Archiv erstellt wird. Dies wird normalerweise nach dem Ausführen von \fBUscan\fR gelöscht. Dieses lokale Depot wird aufbewahrt, falls die Option \fB\-\-debug\fR benutzt wird. .Sp Falls das aktuelle Verzeichnis ein Git-Depot ist und das gesuchte Depot eine der registrierten »externen« aufgeführt ist, wird Uscan es benutzen, statt es separat zu klonen. Die einzige lokale Änderung besteht darin, dass Uscan einen »fetch«\-Befehl zum Erneuern des Depots ausführt. .IP "\fBsvn\fR" 4 .IX Item "svn" This mode accesses the upstream Subversion archive directly with the \fBsvn\fR command and packs the source tree. .Sp For svn mode, \fImatching-pattern\fR specifies the full string matching pattern for directories under Subversion repository directory, specified via \s-1URL.\s0 The upstream version is extracted from concatenating the matched parts in \fB(\fR ... \fB)\fR with \fB.\fR . .Sp If \fImatching-pattern\fR is set to \fB\s-1HEAD\s0\fR, \fBuscan\fR downloads the latest source tree of the \s-1URL.\s0 The upstream version is then constructed by appending the last revision of the \s-1URL\s0 to \fB0.0~svn\fR. .Sp As commit signing is not possible with Subversion, the default \fBpgpmode\fR is set to \fBnone\fR when \fBmode=svn\fR. Settings of \fBpgpmode\fR other than \fBdefault\fR and \fBnone\fR are reported as errors. .RE .RS 4 .RE .IP "\fBpretty=\fR\fIRegel\fR" 4 .IX Item "pretty=Regel" setzt die Versionszeichenkette der Ursprungsautoren auf ein beliebiges Format als optionales \fBopts\fR\-Argument, wenn das \fIVergleichsmuster\fR \fB\s-1HEAD\s0\fR oder \fBheads/\fR\fIZweig\fR für den \fBgit\fR\-Modus ist. Die genaue Syntax finden Sie in der Handbuchseite von \fBgit-log\fR unter \fBtformat\fR. Die Voreinstellung ist \fBpretty=0.0~git%cd.%h\fR. In diesem Fall können keine \fBuversionmangle\fR\-Regeln angewendet werden. .Sp When \fBpretty=describe\fR is used, the upstream version string is the output of the "\fBgit describe \-\-tags | sed s/\-/./g\fR" command instead. For example, if the commit is the \fB5\fR\-th after the last tag \fBv2.17.12\fR and its short hash is \fBged992511\fR, then the string is \fBv2.17.12.5.ged992511\fR . For this case, it is good idea to add \fBuversionmangle=s/^/0.0~/\fR or \fBuversionmangle=s/^v//\fR to make the upstream version string compatible with Debian. Please note that in order for \fBpretty=describe\fR to function well, upstream need to avoid tagging with random alphabetic tags. .Sp \&\fBpretty=describe\fR erzwingt die Einstellung \fBgitmode=full\fR, um das Depot automatisch vollständig lokal zu klonen. .IP "\fBdate=\fR\fIRegel\fR" 4 .IX Item "date=Regel" setzt die durch die Option \fBpretty\fR benutzte Datumszeichenkette auf ein beliebiges Format als ein optionales \fBopts\fR\-Argument, wenn \fIVergleichsmuster\fR \fB\s-1HEAD\s0\fR oder \fBheads/\fR\fIZweig\fR für den \fBgit\fR\-Modus ist. Die genaue Syntax finden Sie in der \fBstrftime\fR\-Handbuchseite. Die Voreinstellung ist \fBdate=%Y%m%d\fR. .IP "\fBgitexport=\fR\fImode\fR" 4 .IX Item "gitexport=mode" Set the git archive export operation \fImode\fR. The default is \fBgitexport=default\fR. Set this to \fBgitexport=all\fR to include all files in the .orig.tar archive, ignoring any \fIexport-ignore\fR git attributes defined by the upstream. .Sp This option is valid only in git mode. .IP "\fBgitmode=\fR\fIModus\fR" 4 .IX Item "gitmode=Modus" setzt den Git\-Klonbetriebs\-. Voreinstellung ist \fBgitmode=shallow\fR. Für einige dumme Git-Server müssen Sie möglicherweise manuell \fBgitmode=full\fR setzen, um das vollständige Klonen zu erzwingen. .Sp Falls das aktuelle Verzeichnis ein Git-Depot ist und das gesuchte Depot inmitten der registrierten »fernen« aufgeführt ist, wird Uscan es benutzen, statt es separat zu klonen. .IP "\fBpgpmode=\fR\fIModus\fR" 4 .IX Item "pgpmode=Modus" setzt den \fIModus\fR zum Prüfen von PGP\-/GPG\-Signaturen. .RS 4 .IP "\fBauto\fR" 4 .IX Item "auto" \&\fBuscan\fR prüft, ob mögliche URLs eine Signaturdatei haben und erzeugt automatisch eine \fBpgpsigurlmangle\fR\-Regel, um sie zu verwenden. .IP "\fBdefault\fR" 4 .IX Item "default" verwendet \fBpgpsigurlmangle=\fR\fIRegeln\fR, um die zur Auswahl stehende URL-Zeichenkette der Signaturdatei für die Tarball-URL der Ursprungsautoren zu erzeugen. (Voreinstellung) .Sp Falls die angegebene \fBpgpsigurlmangle\fR fehlt, überprüft \fBuscan\fR mögliche URLs auf Signaturdateien und schlägt die Aufnahme einer \fBpgpsigurlmangle\fR\-Regel vor. .IP "\fBmangle\fR" 4 .IX Item "mangle" verwendet \fBpgpsigurlmangle=\fR\fIRegeln\fR, um die zu Auswahl stehende URL-Zeichenkette der Signaturdatei für die Tarball-URL der Ursprungsautoren zu erzeugen. .IP "\fBnext\fR" 4 .IX Item "next" prüft diesen heruntergeladenen Tarball mit der Signaturdatei, die in der nächsten Watch-Zeile angegeben ist. Die nächste Watch-Zeile muss \fBpgpmode=previous\fR lauten, sonst findet keine Prüfung statt. .IP "\fBprevious\fR" 4 .IX Item "previous" prüft den in der vorhergehenden Watch-Zeile angegebenen heruntergeladenen Tarball mit dieser Signaturdatei. Die vorhergehende Watch-Zeile muss \fBpgpmode=next\fR lauten. .IP "\fBself\fR" 4 .IX Item "self" überprüft die heruntergeladene Datei \fIfoo.Erw\fR mit ihrer eigenen Signatur und extrahiert die darin enthaltene Tarball-Datei als \fIfoo\fR. .IP "\fBgittag\fR" 4 .IX Item "gittag" prüft die Markierungssignatur, falls \fBmode=git\fR. .IP "\fBnone\fR" 4 .IX Item "none" keine Signatur verfügbar (keine Warnung) .RE .RS 4 .RE .IP "\fBsearchmode=\fR\fIModus\fR" 4 .IX Item "searchmode=Modus" setzt den auswertenden Suchmodus. .RS 4 .IP "\fBhtml\fR \fI(Voreinstellung)\fR: sucht Muster im »href«\-Parameter von \-HTML\-Markierungen" 4 .IX Item "html (Voreinstellung): sucht Muster im »href«-Parameter von -HTML-Markierungen" .PD 0 .IP "\fBplain\fR: sucht Muster in der gesamten Seite" 4 .IX Item "plain: sucht Muster in der gesamten Seite" .PD Dies ist nützlich, falls der Seiteninhalt \s-1JSON\s0 statt \s-1HTML\s0 ist. Beispiel mit npmjs.com: .Sp .Vb 4 \& version=4 \& opts="searchmode=plain" \e \& https://registry.npmjs.org/aes\-js \e \& https://registry.npmjs.org/aes\-js/\-/aes\-js\-(\ed[\ed\e.]*)@ARCHIVE_EXT@ .Ve .RE .RS 4 .RE .IP "\fBdecompress\fR" 4 .IX Item "decompress" dekomprimiert vor der Prüfung der PGP\-/GPG\-Signatur komprimierte Archive. .IP "\fBbare\fR" 4 .IX Item "bare" deaktiviert allen Site-spezifischen Kode für Sonderfälle wie den Gebrauch von URL-Weiterleitungen und Änderungen des Seiteninhalts. (beständig) .IP "\fBuser\-agent=\fR\fIUser-Agent-Zeichenkette\fR" 4 .IX Item "user-agent=User-Agent-Zeichenkette" setzt die verwendete User-Agent-Zeichenkette, um den \s-1HTTP\s0(S)\-Server als \fIuser-agent-string\fR zu kontaktieren. (beständig) .Sp Die Option \fBuser-agent\fR sollte allein in der Watch-Zeile ohne \fI\s-1URL\s0\fR angegeben werden, um die Verwendung von Strichpunkten oder Kommas darin zu ermöglichen. .IP "\fBpasv\fR, \fBpassive\fR" 4 .IX Item "pasv, passive" benutzt bei FTP-Verbindungen den PASV-Modus. .Sp Falls der PASV-Modus aufgrund der Client-seitigen Netzwerkumgebung benötigt wird, richten Sie stattdessen \fBuscan\fR per \s-1BEFEHLSZEILENOPTIONEN\s0 oder DEVSCRIPT-KONFIGURATIONSVARIABLEN ein, dass es den PASV-Modus benutzt. .IP "\fBactive\fR, \fBnopasv\fR" 4 .IX Item "active, nopasv" verwendet bei der FTP-Verbindung nicht den PASV-Modus. .IP "\fBunzipopt=\fR\fIOptionen\fR" 4 .IX Item "unzipopt=Optionen" fügt die zusätzlichen Optionen hinzu, die mit dem Befehl \fBunzip\fR verwendet werden, wie beispielsweise \fB\-a\fR, \fB\-aa\fR und \fB\-b\fR, wenn er durch \fBmk-origtargz\fR ausgeführt wird. .IP "\fBdversionmangle=\fR\fIRegeln\fR" 4 .IX Item "dversionmangle=Regeln" bringt die letzte in \fIdebian/changelog\fR gefundene Versionszeichenkette der Ursprungsautoren in Normalform, um sie mit der verfügbaren Tarball-Version der Ursprungsautoren zu vergleichen. Üblicherweise wird hier die Debian-spezifische Erweiterung wie \fBs/@DEB_EXT@//\fR entfernt. .Sp Sie können auch \fBdversionmangle=auto\fR benutzen, dies ist identisch mit \fBdversionmangle=s/@DEB_EXT@//\fR. .IP "\fBdirversionmangle=\fR\fIRegeln\fR" 4 .IX Item "dirversionmangle=Regeln" bringt die Verzeichnispfadzeichenkette, die zum regulären Ausdruck innerhalb von Klammern von \fBhttp://\fR\fI\s-1URL\s0\fRpasst, als sortierbare Versionsindexzeichenkette in Normalform. Dies wird nur als Index zum Sortieren des Verzeichnispfads benutzt. .Sp Ersetzung wie \fBs/PRE/~pre/; s/RC/~rc/\fR kann hilfreich sein. .IP "\fBpagemangle=\fR\fIRegeln\fR" 4 .IX Item "pagemangle=Regeln" bringt die heruntergeladene Webseiten-Zeichenkette in Normalform. (Verwenden Sie dies nur, wenn es unbedingt nötig ist. Üblicherweise ist für diese \fIRegeln\fR der Schalter \fBg\fR erforderlich.) .Sp Dies ist praktisch, falls Sie auf Amazon \s-1AWS\s0 oder Subversion-Depots zugreifen wollen, bei denen nicht verwendet wird. .IP "\fBuversionmangle=\fR\fIRegeln\fR" 4 .IX Item "uversionmangle=Regeln" bringt die aus den Hrefs in der Quelle der Webseite extrahierten Kandidaten-Versionszeichenketten der Ursprungsautoren in Normalform. Dies wird als Sortierindex für Versionen benutzt, wenn die neueste Version der Ursprungsautoren ausgewählt wird. .Sp Ersetzung wie \fBs/PRE/~pre/; s/RC/~rc/\fR kann hilfreich sein. .IP "\fBversionmangle=\fR\fIRegeln\fR" 4 .IX Item "versionmangle=Regeln" syntaktische Kurzschrift für \fBuversionmangle=\fR\fIRegeln\fR\fB,dversionmangle=\fR\fIRegeln\fR .IP "\fBhrefdecode=percent\-encoding\fR" 4 .IX Item "hrefdecode=percent-encoding" wandelt die ausgewählten Href-Zeichenkette zum Tarball der Ursprungsautoren aus eine prozentkodierten hexadezimalen Zeichenkette in einer dekodierten URL-Zeichenkette für verschleierte Web-Sites um. Nur \fBpercent-encoding\fR ist verfügbar und es ist mit \fBs/%([A\-Fa\-f\ed]{2})/chr hex \f(CB$1\fB/eg\fR dekodiert. .IP "\fBdownloadurlmangle=\fR\fIRegeln\fR" 4 .IX Item "downloadurlmangle=Regeln" wandelt die Href-Zeichenkette des ausgewählten Tarballs der Ursprungsautoren in eine barrierefreie \s-1URL\s0 für verschleierte Websites um. Dies wird nach \fBhrefdecode\fR ausgeführt. .IP "\fBfilenamemangle=\fR\fIRegeln\fR" 4 .IX Item "filenamemangle=Regeln" erzeugt aus der ausgewählten Href-Zeichenkette den Tarball-Dateinamen der Ursprungsautoren, falls \fISuchmuster\fR die \fI\fR aus der ausgewählten Href-Zeichenkette extrahieren kann. Andernfalls wird der Tarball-Dateiname der Ursprungsautoren aus seiner vollständigen URL-Zeichenkette erzeugt und die fehlende \fI\fR aus dem erzeugten Tarball-Dateinamen der Ursprungsautoren gesetzt. .Sp Ohne diese Option wird der Standard-Tarball-Dateiname erzeugt, indem der letzte Bestandteil der \s-1URL\s0 genommen und alles nach einem »?« oder »#« entfernt wird. .IP "\fBpgpsigurlmangle=\fR\fIRegeln\fR" 4 .IX Item "pgpsigurlmangle=Regeln" erzeugt die Kandidaten-Signaturdatei-URL-Zeichenkette der Ursprungsautoren aus der Tarball-URL der Ursprungsautoren. .IP "\fBoversionmangle=\fR\fIRegeln\fR" 4 .IX Item "oversionmangle=Regeln" erzeugt die Versionszeichenkette \fI\fR des Quell-Tarballs \fI_.orig.tar.gz\fR aus \fI\fR. Dies sollte verwendet werden, um einem MUT-Paket eine Erweiterung wie \fB+dfsg\fR hinzuzufügen. .PP Hier werden die Regeln zum Zerlegen die \fIRegeln\fR auf die entsprechende Zeichenkette anwenden. In einer Zerlegungsregelzeichenkette können mehrere Regeln angegeben werden, indem die zusammengesetzte Zeichenkette jede Zerlegungs\-\fIRegel\fR durch einen \fB;\fR (Strichpunkt) trennt. .PP Keine Zerlegungs\-\fIRegel\fR kann \fB;\fR (Strichpunkt), \fB,\fR (Komma) oder \fB"\fR (doppeltes Anführungszeichen) enthalten. .PP Jede Zerlegungs\-\fIRegel\fR verhält sich, als ob ein Perl-Befehl »\fI\f(CI$Zeichenkette\fI\fR \fB=~\fR \fIRegel\fR« ausgeführt würde. Es gibt einige beachtenswerte Einzelheiten. .IP "\(bu" 4 \&\fIRegel\fR kann nur die Aktionen \fBs\fR, \fBtr\fR und \fBy\fR benutzen. .RS 4 .IP "\fBs/\fR\fIregulärer_Ausdruck\fR\fB/\fR\fIErsatz\fR\fB/\fR\fIOptionen\fR" 4 .IX Item "s/regulärer_Ausdruck/Ersatz/Optionen" gleicht Muster eines regulären Ausdrucks ab und ersetzt die Zielzeichenkette. Nur die Schalter \fBg\fR, \fBi\fR und \fBx\fR sind verfügbar. Verwenden Sie für Rückwärtsreferenzen die \fB\f(CB$1\fB\fR\-Syntax (nicht die \fB\e1\fR\-Syntax). Das Ausführen von Code ist nicht erlaubt (d.h. keine \fB(?{})\fR\- oder \fB(??{})\fR\-Konstrukte). .IP "\fBy/\fR\fIQuelle\fR\fB/\fR\fIZiel\fR\fB/\fR oder \fBtr/\fR\fIQuelle\fR\fB/\fR\fIZiel\fR\fB/\fR" 4 .IX Item "y/Quelle/Ziel/ oder tr/Quelle/Ziel/" kodiert die Zeichen in der Zielzeichenkette um. .RE .RS 4 .RE .SH "AUSFÜHRUNGSBEISPIEL" .IX Header "AUSFÜHRUNGSBEISPIEL" \&\fBuscan\fR liest den ersten Eintrag in \fIdebian/changelog\fR, um den Namen des Quellpakets und die neuste Version der Ursprungsautoren zu bestimmen. .PP Wenn zum Beispiel der erste Eintrag in \fIdebian/changelog\fR .IP "\(bu" 4 \&\fIbar\fR (\fB3:2.03+dfsg\-4\fR) unstable; urgency=low .PP lautet, ist der Name des Pakets \fIbar\fR und die neuste Paketversion von Debian \fB3:2.03+dfsg\-4\fR. .PP Die neuste Version der Ursprungsautoren wird auf die Normalform \fB2.03+dfsg\fR gebracht, indem die Epoche und die Debian-Revision entfernt werden. .PP Falls die Regel \fBdversionmangle\fR existiert, wird die neuste Version der Ursprungsautoren zusätzlich durch Anwenden dieser Regel darauf in Normalform gebracht. Falls zum Beispiel die neuste Version der Ursprungsautoren \fB2.03+dfsg\fR ist, zeigt dies an, dass der Tarball neu gepackt wurde. Die Endung \fB+dfsg\fR wird durch die Zeichenkettenersetzung \fBs/\e+dfsg\ed*$//\fR entfernt, um die neuste Version der Ursprungsautoren \fB2.03\fR nach Dversionmangle zu erzeugen. Sie wird mit den Kandidaten-Tarball-Versionen der Ursprungsautoren wie \fB2.03\fR, \fB2.04\fR, … verglichen, die auf deren Site gefunden wurden. Setzen Sie diese Regel daher wie folgt: .IP "\(bu" 4 \&\fBopts=\*(L"dversionmangle=s/\e+dfsg\ed*$//\*(R"\fR .PP \&\fBuscan\fR lädt eine in \fIdebian/watch\fR angegebene Webseite von \fBhttp://\fR\fI\s-1URL\s0\fR herunter. .IP "\(bu" 4 Falls der Verzeichnisnamensteil von \fI\s-1URL\s0\fR keine Klammern, \fB(\fR und \fB)\fR, hat, wird er als wortgetreu angesehen. .IP "\(bu" 4 Falls der Verzeichnisnamensteil von \fI\s-1URL\s0\fR keine Klammern, \fB(\fR und \fB)\fR, hat, durchsucht \fBuscan\fR rekursiv alle möglichen Verzeichnisse, um eine Seite mit der neuesten Version zu finden. Wenn die Regel \fBdirversionmangle\fR existiert, wird der erzeugte Sortierindex zum Finden der neuesten Version benutzt. Falls eine spezielle Version zum Herunterladen angegeben wurde, hat die passende Versionszeichenkette eine höhere Priorität als die neueste Version. .PP Diese \fBhttp://\fR\fI\s-1URL\s0\fR könnte beispielsweise so angegeben werden: .IP "\(bu" 4 \&\fBhttp://www.example.org/@ANY_VERSION@/\fR .PP Please note the trailing \fB/\fR in the above to make \fB\f(CB@ANY_VERSION\fB@\fR as the directory. .PP Falls die Regel \fBpagemangle\fR existiert, wird die ganze heruntergeladene Webseite als eine Zeichenkette in Normalform gebracht, indem diese Regel darauf angewendet wird. Dies ist ein sehr mächtiges Werkzeug und sollte mit Vorsicht benutzt werden. Verwenden Sie diese Regel nicht, falls Sie andere Zerlegungsregeln zum Erreichen dieses Ziels einsetzen können. .PP Die heruntergeladene Webseite wird nach Hrefs gescannt, die in der Markierung \fB\fR definiert sind, um die Kandidaten-Tarball-Hrefs der Ursprungsautoren zu orten. Diese Kandidaten-Tarball-Hrefs der Ursprungsautoren werden mit dem regulären Perl-Ausdrucksmuster \fISuchmuster\fR wie \fB\s-1DL\-\s0(?:[\ed\e.]+?)/foo\-(.+)\e.tar\e.gz\fR verglichen, um die Auswahl der Kandidaten zu begrenzen. Diese Mustersuche muss mit dem Anfang und dem Ende verankert werden. Kandidaten-Hrefs können zum Beispiel wie folgt aussehen: .IP "\(bu" 4 \&\fB\s-1DL\-2\s0.02/foo\-2.02.tar.gz\fR .IP "\(bu" 4 \&\fB\s-1DL\-2\s0.03/foo\-2.03.tar.gz\fR .IP "\(bu" 4 \&\fB\s-1DL\-2\s0.04/foo\-2.04.tar.gz\fR .PP Hier wird die passende Zeichenkette von \fB(.+)\fR im \fISuchmuster\fR als Kandidatenversion der Ursprungsautoren angesehen. Falls es mehrere passende Zeichenketten zu Übereinstimmungsmustern in \fISuchmuster\fR gibt, werden Sie alle mit \fB.\fR (Punkt) aneinandergehängt, um die Kandidatenversion der Ursprungsautoren zu bilden. Stellen Sie sicher, dass Sie den nicht übereinstimmenden regulären Ausdruck wie \fB(?:[\ed\e.]+?)\fR anstelle des variablen passenden Textteils ohne Bezug zur Version verwenden. .PP Dann sind die Kandidatenversionen der Ursprungsautoren: .IP "\(bu" 4 \&\fB2.02\fR .IP "\(bu" 4 \&\fB2.03\fR .IP "\(bu" 4 \&\fB2.04\fR .PP Der Dateiname des heruntergeladenen Tarballs wird grundsätzlich auf denselben Dateinamen gesetzt, wie der in der fernen \s-1URL\s0 der ausgewählten Href. .PP Falls die Regel \fBuversionmangle\fR existiert, werden die Kandidatenversionen der Ursprungsautoren durch Anwenden dieser Regel in Normalform gebracht. (Diese Regel kann nützlich sein, falls das Versionsschema der Ursprungsautoren nicht korrekt sortierbar ist, um die neueste Version zu identifizieren.) .PP Die Tarball-Href der Ursprungsautoren, die zur neuesten (von Uversionmangle) Kandidatenversion der Ursprungsautoren gehört, die neuer als die neuste (von Dversionmangle) Version der Ursprungsautoren, wird ausgewählt. .PP Falls mehrere Tarball-Hrefs der Ursprungsautoren zu einer einzigen Version mit verschiedenen existierenden Erweiterungen gehören, wird die am höchsten komprimierte ausgewählt. (Priorität: \fBtar.xz > tar.lzma > tar.bz2 > tar.gz\fR.) .PP Falls die ausgewählte Tarball-Href der Ursprungsautoren eine relative \s-1URL\s0 ist, wird sie mittels der Basis-URL der Webseite in eine absolute \s-1URL\s0 umgewandelt. Falls die Markierung \fB\fR auf der Webseite existiert, wird die ausgewählte Tarball-Href der Ursprungsautoren stattdessen mittels der angegebenen Basis-URL in der Basis-Markierung in eine absolute \s-1URL\s0 umgewandelt. .PP Falls die Regel \fBdownloadurlmangle\fR existiert, wird die ausgewählte Tarball-Href der Ursprungsautoren durch Anwenden dieser Regel in Normalform gebracht. (Dies ist für einige Sites mit verschleierter Herunterlade-URL nützlich.) .PP Falls die Regel \fBfilenamemangle\fR existiert, wird der Dateiname des heruntergeladenen Tarballs durch Anwenden dieser Regel auf die ausgewählte Href erzeugt, falls \fISuchmuster\fR die neueste Version \fI\fR der Ursprungsautoren aus der ausgewählten Href-Zeichenkette extrahieren kann. Andernfalls wird der Tarball-Dateiname der Ursprungsautoren aus seiner vollständigen URL-Zeichenkette und die fehlende \fI\fR aus dem erzeugten Tarball-Dateinamen der Ursprungsautoren erzeugt. .PP Ohne die Regel \fBfilenamemangle\fR wird der Vorgabe-Tarball-Dateiname der Ursprungsautoren erzeugt, indem vom letzten Bestandteil der \s-1URL\s0 alles nach jedem »?« oder »#« entfernt wird. .PP \&\fBuscan\fR lädt den ausgewählten Tarball der Ursprungsautoren in das übergeordnete Verzeichnis \fB../\fR herunter. Die heruntergeladene Datei kann zum Beispiel sein: .IP "\(bu" 4 \&\fI../foo\-2.04.tar.gz\fR .PP Diese heruntergeladene Version im vorhergehenden Beispiel soll \fB2.04\fR heißen, im Folgenden allgemein \fI\fR genannt. .PP Falls die Regel \fBpgpsigurlmangle\fR existiert, wird die Signaturdatei-URL der Ursprungsautoren durch Anwenden dieser Regel auf die (von Downloadurlmangle) ausgewählte Tarball-Href der Ursprungsautoren erzeugt und es wird versucht, die Signatur von dort herunterzuladen. .PP Falls die Regel \fBpgpsigurlmangle\fR nicht existiert, warnt \fBuscan\fR den Benutzer, falls die Signaturdatei der Ursprungsautoren unter derselben \s-1URL\s0 verfügbar ist und am Dateinamen die fünf üblichen Erweiterungen \fBasc\fR, \fBgpg\fR, \fBpgp\fR, \fBsig\fR und \fBsign\fR anhängen. (Sie können diese Warnung durch Setzen von \fBpgpmode=none\fR vermeiden.) .PP Falls die Signaturdatei heruntergeladen wird, wird der Tarball der Ursprungsautoren anhand dieser Signaturdatei auf seine Echtheit hin überprüft. Dies geschieht mittels des gehärteten Schlüsselbunds \fIdebian/upstream/signing\-key.asc\fR (siehe \*(L"\s-1BEISPIELE\s0 FÜR SCHLÜSSELBUNDDATEIEN\*(R"). Falls seine Signatur ungültig ist oder nicht durch einen der aufgeführten Schlüssel erstellt wurde, wird \fBuscan\fR einen Fehler melden. .PP Falls die Regel \fBoversionmangle\fR existiert, wird die Quellcode-Tarball-Version \fIOriginalversion\fR aus der heruntergeladenen \fIneueste-Ursprungsautorenversion\fR erzeugt, indem diese Regel angewendet wird. Diese Regel ist nützlich, um eine Erweiterung wie \fB+dfsg\fR an die Version aller Quellpakete des MUT-Pakets anzuhängen, bei denen der Mechanismus »repacksuffix« nicht funktioniert. .PP \&\fBuscan\fR ruft \fBmk-origtargz\fR auf, um den Quell-Tarball korrekt benannt für das Quellpaket mit \fB.orig.\fR (oder \fB.orig\-.\fR für die untergeordneten Tarbälle) im Dateinamen zu erzeugen. .IP "Fall A: Packen des Quelltext-Tarballs, so wie er ist" 4 .IX Item "Fall A: Packen des Quelltext-Tarballs, so wie er ist" \&\fBmk-origtargz\fR erstellt einen symbolischen Verweis \fI../bar_.orig.tar.gz\fR, der auf den heruntergeladenen lokalen Tarball der Ursprungsautoren verweist. \fIbar\fR ist hier der in \fIdebian/changelog\fR gefundene Quellpaketname. Der erzeugte symbolische Verweis könnte lauten: .RS 4 .IP "\(bu" 4 \&\fI../bar_2.04.orig.tar.gz\fR \-> \fIfoo\-2.04.tar.gz\fR (in der vorliegenden Form) .RE .RS 4 .Sp Normalerweise ist es in diesem Fall nicht nötig, \fBopts="dversionmangle=\fR \fI…\fR \fB"\fR zu setzen. .RE .IP "Fall B: Paketieren des Tarballs der Ursprungsautoren nach den Entfernen der Nicht-DFSG-Dateien" 4 .IX Item "Fall B: Paketieren des Tarballs der Ursprungsautoren nach den Entfernen der Nicht-DFSG-Dateien" \&\fBmk-origtargz\fR prüft den Dateinamenschnipsel des \fBFiles-Excluded\fR\-Abschnitts im ersten Teil von \fIdebian/copyright\fR und entfernt entsprechende Dateien, um einen neu gepackten Tarball der Ursprungsautoren zu erstellen. Normalerweise wird der neu gepackte Tarball der Ursprungsautoren mit der \fIEndung\fR in \fI../bar_.orig.tar.gz\fR umbenannt. Für das einzelne Paket der Ursprungsautoren wird die Option \fBrepacksuffix\fR benutzt. \fI\fR wird hier auf \fI\fR aktualisiert. .Sp Das Entfernen von Dateien ist nötig, falls Dateien nicht DFSG-konform sind. In diesem Fall wird als \fIEndung\fR \fB+dfsg\fR verwendet. .Sp Daher werden die kombinierten Optionen stattdessen als \fBopts=\*(L"dversionmangle=s/\e+dfsg\ed*$// ,repacksuffix=+dfsg\*(R"\fR gesetzt. .Sp Der neu gepackte Tarball der Ursprungsautoren könnte zum Beispiel so heißen: .RS 4 .IP "\(bu" 4 \&\fI../bar_2.04+dfsg.orig.tar.gz\fR (neu gepackt) .RE .RS 4 .RE .PP \&\fBuscan\fR ruft normalerweise »\fBuupdate\fR \fB\-\-find \-\-upstream\-version\fR \fIOriginalversion\fR« für die »version=4«\-Watch\-Datei auf. .PP Bitte beachten Sie, dass hier die Option \fB\-\-find\fR benutzt wird, da \fBmk-origtargz\fR bereits aufgerufen wurde, um die Datei \fB*.orig.tar.gz\fR zu erstellen. \fBuscan\fR nimmt \fIbar\fR aus \fIdebian/changelog\fR. .PP Es erstellt einen neuen Quellverzeichnisbaum der Ursprungsautoren unter dem Verzeichnis \fI../bar\-\fR und nutzt den Paketinhalt zum Anpassen an Debian. .SH "»WATCH«\-DATEIBEISPIELE" .IX Header "»WATCH«-DATEIBEISPIELE" Wenn Sie die Watch-Datei schreiben, sollten Sie sich auf die Webseite verlassen, die zuletzt die Quelle der Ursprungsautoren ankündigte. Sie sollten wenn möglich nicht versuchen, die Archivstruktur der Ursprungsautoren vorauszusagen. Es folgen typische \fIdebian/watch\fR\-Dateien. .PP Bitte beachten Sie, dass das Ausführen von \fBuscan\fR mit \fB\-v\fR oder \fB\-vv\fR offenbart, was intern genau passiert. .PP Es ist maßgeblich, ob vor dem abschließenden \fB\e\fR (Rückwärtsschrägstrich) ein Leerzeichen existiert oder nicht. .PP In den \s-1BEISPIELEN\s0 unterhalb werden einige nicht dokumentierte kürzere Konfigurationszeichenketten benutzt, um Ihnen Tipparbeit zu ersparen. Dies ist gewollt. \fBuscan\fR wurde so geschrieben, dass es einige häufige sinngemäße Abkürzungen akzeptiert, aber treiben Sie es nicht auf die Spitze. .SS "HTTP-Site (einfach)" .IX Subsection "HTTP-Site (einfach)" Es folgt ein Beispiel für einen einfachen einzelnen Tarball der Ursprungsautoren. .PP .Vb 3 \& version=4 \& http://example.com/~user/release/@PACKAGE@.html \e \& files/@PACKAGE@@ANY_VERSION@@ARCHIVE_EXT@ .Ve .PP Or without using the substitution strings (not recommended): http://example.com/~user/release/foo.html \e files/foo\-([\ed\e.]+)\e.tar\e.gz .PP .Vb 1 \& version=4 .Ve .PP Diese Watch-Datei lädt für das Quellpaket \fBfoo\-2.0.tar.gz\fR der Ursprungsautoren die Debian\-\fBorig.tar\fR\-Datei \fBfoo_2.0.orig.tar.gz\fR herunter. .SS "HTTP-Site (pgpsigurlmangle)" .IX Subsection "HTTP-Site (pgpsigurlmangle)" Es folgt ein Beispiel für einen einfachen einzelnen Tarball der Ursprungsautoren mit der passenden Signaturdatei im selben Dateipfad. .PP .Vb 3 \& version=4 \& opts="pgpsigurlmangle=s%$%.asc%" http://example.com/release/@PACKAGE@.html \e \& files/@PACKAGE@@ANY_VERSION@@ARCHIVE_EXT@ .Ve .PP Für das Quellpaket \fBfoo\-2.0.tar.gz\fR der Ursprungsautoren und die Signaturdatei \fBfoo\-2.0.tar.gz.asc\fR der Ursprungsautoren lädt diese Watch-Datei diese Dateien herunter, prüft die Echtheit mittels des Schlüsselbunds \fIdebian/upstream/signing\-key.asc\fR und erstellt die Debian\-\fBorig.tar\fR\-Datei \fBfoo_2.0.orig.tar.gz\fR. .PP Es folgt ein Beispiel für einen einfachen einzelnen Tarball der Ursprungsautoren mit der passenden Signaturdatei zum entpackten Tarball im selben Dateipfad. .PP .Vb 4 \& version=4 \& opts="pgpsigurlmangle=s%@ARCHIVE_EXT@$%.asc%,decompress" \e \& http://example.com/release/@PACKAGE@.html \e \& files/@PACKAGE@@ANY_VERSION@@ARCHIVE_EXT@ .Ve .PP Für das Quellpaket \fBfoo\-2.0.tar.gz\fR der Ursprungsautoren und die Signaturdatei \fBfoo\-2.0.tar.asc\fR der Ursprungsautoren lädt diese Watch-Datei diese Dateien herunter, prüft die Echtheit mittels des Schlüsselbunds \fIdebian/upstream/signing\-key.asc\fR und erstellt die Debian\-\fBorig.tar\fR\-Datei \fBfoo_2.0.orig.tar.gz\fR. .SS "HTTP-Site (pgpmode=next/previous)" .IX Subsection "HTTP-Site (pgpmode=next/previous)" Es folgt ein Beispiel für einen einfachen einzelnen Tarball der Ursprungsautoren mit der passenden Signaturdatei im nicht zugehörigen Dateipfad. .PP .Vb 5 \& version=4 \& opts="pgpmode=next" http://example.com/release/@PACKAGE@.html \e \& files/(?:\ed+)/@PACKAGE@@ANY_VERSION@@ARCHIVE_EXT@ debian \& opts="pgpmode=previous" http://example.com/release/@PACKAGE@.html \e \& files/(?:\ed+)/@PACKAGE@@ANY_VERSION@@SIGNATURE_EXT@ previous .Ve .PP Der Teil \fB(?:\ed+)\fR kann ein zufälliger Wert sein, Der Tarball kann \fB53\fR haben, während die Signaturdatei \fB33\fR haben kann. .PP Der Teil \fB([\ed\e.]+)\fR für die Signaturdatei hat eine strikte Voraussetzung, zum in der vorhergehenden Zeile angegebenen Tarball der Ursprungsautoren zu passen, die in der Watch-Zeile als \fIVersion\fR \fBprevious\fR enthält. .SS "HTTP-Site (flexibel)" .IX Subsection "HTTP-Site (flexibel)" Es folgt ein Beispiel für die maximale Flexibilität beim Tarball der Ursprungsautoren und Signaturdateierweiterungen. .PP .Vb 6 \& version=4 \& opts="pgpmode=next" http://example.com/DL/ \e \& files/(?:\ed+)/@PACKAGE@@ANY_VERSION@@ARCHIVE_EXT@ debian \& opts="pgpmode=previous" http://example.com/DL/ \e \& files/(?:\ed+)/@PACKAGE@@ANY_VERSION@@SIGNATURE_EXT@ \e \& previous .Ve .SS "HTTP-Site (einfache \s-1MUT\s0)" .IX Subsection "HTTP-Site (einfache MUT)" Hier ein Beispiel für die einfachen Pakete mit mehreren Tarbällen der Ursprungsautoren (»Multiple Upstream Tarballs«/MUT). .PP .Vb 10 \& version=4 \& opts="pgpsigurlmangle=s%$%.sig%" \e \& http://example.com/release/foo.html \e \& files/foo\-@ANY_VERSION@@ARCHIVE_EXT@ debian \& opts="pgpsigurlmangle=s%$%.sig%, component=bar" \e \& http://example.com/release/foo.html \e \& files/foobar\-@ANY_VERSION@@ARCHIVE_EXT@ same \& opts="pgpsigurlmangle=s%$%.sig%, component=baz" \e \& http://example.com/release/foo.html \e \& files/foobaz\-@ANY_VERSION@@ARCHIVE_EXT@ same .Ve .PP Für das Hauptquellpaket der Ursprungsautoren \fBfoo\-2.0.tar.gz\fR und die untergeordneten Quellpakete der Ursprungsautoren \fBfoobar\-2.0.tar.gz\fR und \fBfoobaz\-2.0.tar.gz\fR, die unter \fIbar/\fR und \fIbaz/\fR installiert werden, lädt diese Watch-Datei die Debian\-\fBorig.tar\fR\-Dateien \fBfoo_2.0.orig.tar.gz\fR, \fBfoo_2.0.orig\-bar.tar.gz\fR und \fBfoo_2.0.orig\-baz.tar.gz\fR herunter und erstellt sie. Außerdem werden diese Tarbälle der Ursprungsautoren anhand ihrer Signaturdateien überprüft. .SS "HTTP-Site (rekursives Durchsuchen des Verzeichnisses)" .IX Subsection "HTTP-Site (rekursives Durchsuchen des Verzeichnisses)" Es folgt ein Beispiel mit dem rekursiven Durchsuchen des Verzeichnisses nach dem Tarball der Ursprungsautoren und seiner Signaturdatei, die in einem Verzeichnis veröffentlicht wurden, das nach seiner Version benannt ist. .PP .Vb 4 \& version=4 \& opts="pgpsigurlmangle=s%$%.sig%, dirversionmangle=s/\-PRE/~pre/;s/\-RC/~rc/" \e \& http://tmrc.mit.edu/mirror/twisted/Twisted/@ANY_VERSION@/ \e \& Twisted\-@ANY_VERSION@@ARCHIVE_EXT@ .Ve .PP Hier sollte die Website unter folgender \s-1URL\s0 erreichbar sein: .PP .Vb 1 \& http://tmrc.mit.edu/mirror/twisted/Twisted/ .Ve .PP Hier wird die Regel \fBdirversionmangle\fR benutzt, um die Sortierreihenfolge der Verzeichnisnamen in die Normalform zu bringen. .SS "HTTP-Site (alternative Kurzschreibweise)" .IX Subsection "HTTP-Site (alternative Kurzschreibweise)" Für die blanke HTTP-Site, auf der Sie direkt die Archivdateinamen sehen können, ist die normale Watch-Datei: .PP .Vb 4 \& version=4 \& opts="pgpsigurlmangle=s%$%.sig%" \e \& http://www.cpan.org/modules/by\-module/Text/ \e \& Text\-CSV_XS\-@ANY_VERSION@@ARCHIVE_EXT@ .Ve .PP Dies kann in einer alternativen Kurzform neu geschrieben werden, die mit einer einzelnen Zeichenkette \s-1URL\s0 und Dateiname abdeckt: .PP .Vb 3 \& version=4 \& opts="pgpsigurlmangle=s%$%.sig%" \e \& http://www.cpan.org/modules/by\-module/Text/Text\-CSV_XS\-@ANY_VERSION@@ARCHIVE_EXT@ .Ve .PP In version=4 werden zu Beginn vorhandene Leerräume weggelassen. Daher kann diese alternative Kurzform auch wie folgt geschrieben werden: .PP .Vb 4 \& version=4 \& opts="pgpsigurlmangle=s%$%.sig%" \e \& http://www.cpan.org/modules/by\-module/Text/\e \& Text\-CSV_XS\-@ANY_VERSION@@ARCHIVE_EXT@ .Ve .PP Bitte beachten Sie den feinen Unterschied eines Leerzeichens vor dem abschließenden \fB\e\fR zwischen den ersten und letzten Beispielen. .SS "HTTP-Site (komische Version)" .IX Subsection "HTTP-Site (komische Version)" Für eine Site mit komischen Versionsnummern werden die eingeklammerten Gruppen mit einem \fB.\fR (Punkt) verbunden, um eine saubere Versionsnummer zu erstellen. .PP .Vb 2 \& version=4 \& http://www.site.com/pub/foobar/foobar_v(\ed+)_(\ed+)@ARCHIVE_EXT@ .Ve .SS "HTTP-Site (\s-1DFSG\s0)" .IX Subsection "HTTP-Site (DFSG)" Der Ursprungsautorenteil der Debian-Versionsnummer kann verarbeitet werden, um anzuzeigen, dass das Quellpaket zum Entfernen von Nicht-DFSG-Dateien neu gepackt wurde: .PP .Vb 3 \& version=4 \& opts="dversionmangle=s/\e+dfsg\ed*$//,repacksuffix=+dfsg" \e \& http://some.site.org/some/path/foobar\-@ANY_VERSION@@ARCHIVE_EXT@ .Ve .PP Siehe \*(L"\s-1BEISPIELE\s0 FÜR COPYRIGHT-DATEIEN\*(R" .SS "HTTP-Site (filenamemangle)" .IX Subsection "HTTP-Site (filenamemangle)" Der Tarball-Dateiname der Ursprungsautoren wird gefunden, indem der letzte Bestandteil der \s-1URL\s0 genommen und alles nach »?« oder »#« entfernt wird. .PP Falls dies nicht ihren Bedürfnissen entspricht, benutzen Sie \fBfilenamemangle\fR. \fI\fR könnte zum Beispiel wie folgt gehandhabt werden: .PP .Vb 3 \& version=4 \& opts=filenamemangle=s/.*=(.*)/$1/ \e \& http://foo.bar.org/dl/\e?path=&dl=foo\-@ANY_VERSION@@ARCHIVE_EXT@ .Ve .PP \&\fI\fR könnte wie folgt gehandhabt werden: .PP .Vb 3 \& version=4 \& opts=filenamemangle=s/.*=(.*)/foo\-$1\e.tar\e.gz/ \e \& http://foo.bar.org/dl/\e?path=&dl_version=@ANY_VERSION@ .Ve .PP Falls die Href-Zeichenkette mittels \fISuchmuster\fR keine Version aufweist, kann sie anhand der vollständigen \s-1URL\s0 mittels \fBfilenamemangle\fR ermittelt werden. .PP .Vb 3 \& version=4 \& opts=filenamemangle=s&.*/dl/(.*)/foo\e.tar\e.gz&foo\-$1\e.tar\e.gz& \e \& http://foo.bar.org/dl/@ANY_VERSION@/ foo.tar.gz .Ve .SS "HTTP-Site (downloadurlmangle)" .IX Subsection "HTTP-Site (downloadurlmangle)" Die Option \fBdownloadurlmangle\fR kann benutzt werden, um die \s-1URL\s0 der Datei zu verarbeiten, die heruntergeladen werden soll. Dies kann nur mit \fBhttp://\fR\-URLs benutzt werden. Dies kann nötig sein, falls der auf der Webseite angegebene Verweis auf irgendeine Weise in einen umgewandelt werden muss, der automatisch funktioniert, zum Beispiel: .PP .Vb 4 \& version=4 \& opts=downloadurlmangle=s/prdownload/download/ \e \& http://developer.berlios.de/project/showfiles.php?group_id=2051 \e \& http://prdownload.berlios.de/softdevice/vdr\-softdevice\-@ANY_VERSION@@ARCHIVE_EXT@ .Ve .SS "HTTP-Site (oversionmangle, \s-1MUT\s0)" .IX Subsection "HTTP-Site (oversionmangle, MUT)" Die Option \fBoversionmangle\fR kann benutzt werden, um die Version des Quell-Tarballs (\fB.orig.tar.gz\fR und \fB.orig\-bar.tar.gz\fR) zu verarbeiten. \fB+dfsg\fR kann der Version der Ursprungsautoren zum Beispiel wie folgt hinzugefügt werden: .PP .Vb 7 \& version=4 \& opts=oversionmangle=s/(.*)/$1+dfsg/ \e \& http://example.com/~user/release/foo.html \e \& files/foo\-@ANY_VERSION@@ARCHIVE_EXT@ debian \& opts="component=bar" \e \& http://example.com/~user/release/foo.html \e \& files/bar\-@ANY_VERSION@@ARCHIVE_EXT@ same .Ve .PP Siehe \*(L"\s-1BEISPIELE\s0 FÜR COPYRIGHT-DATEIEN\*(R" .SS "HTTP-Site (pagemangle)" .IX Subsection "HTTP-Site (pagemangle)" Die Option \fBpagemangle\fR kann benutzt werden, um die heruntergeladene Webseite vor dem Anwenden anderer Regeln zu verarbeiten. Die Nichtstandard-Webseite ohne ordnungsgemäße \fB\fR\-Einträge kann umgewandelt werden. Falls \fIfoo.html\fR zum Beispiel \fB\fR benutzt, kann dies wie folgt in das Standardseitenformat umgewandelt werden: .PP .Vb 4 \& version=4 \& opts=pagemangle="s/\fR \fI…\fR \fB\fR verwendet, kann dies wie folgt in das Standardseitenformat umgewandelt werden: .PP .Vb 4 \& version=4 \& opts="pagemangle=s%([^<]*)%$1%g" \e \& http://example.com/release/foo.html \e \& (?:.*)/@PACKAGE@@ANY_VERSION@@ARCHIVE_EXT@ .Ve .SS "FTP-Site (einfach):" .IX Subsection "FTP-Site (einfach):" .Vb 2 \& version=4 \& ftp://ftp.tex.ac.uk/tex\-archive/web/c_cpp/cweb/cweb\-@ANY_VERSION@@ARCHIVE_EXT@ .Ve .SS "FTP-Site (Sonderzeichen für reguläre Ausdrücke):" .IX Subsection "FTP-Site (Sonderzeichen für reguläre Ausdrücke):" .Vb 3 \& version=4 \& ftp://ftp.worldforge.org/pub/worldforge/libs/\e \& Atlas\-C++/transitional/Atlas\-C\e+\e+\-@ANY_VERSION@@ARCHIVE_EXT@ .Ve .PP Bitte beachten Sie, dass diese \s-1URL\s0 mit \fI … \fR\fBlibs/Atlas\-\*(C+/\fR\fI … \fR verbunden ist. Das erste \fB++\fR im Verzeichnispfad wird wörtlich verstanden, während es im Dateinamen durch \fB\e\fR maskiert wird. .SS "FTP-Site (komische Version)" .IX Subsection "FTP-Site (komische Version)" Dies ist eine weitere Art, eine Site mit komischen Versionsnummern zu handhaben, diesmal mittels Verarbeiten. (Beachten Sie, dass mehrere Gruppen vor dem Verarbeiten zusammengefügt werden und dass dieses Verarbeiten nur für die Versionsnummer des Basispfads und nicht für die Versionsnummern aller Pfade durchgeführt wird.) .PP .Vb 4 \& version=4 \& opts="uversionmangle=s/^/0.0./" \e \& ftp://ftp.ibiblio.org/pub/Linux/ALPHA/wine/\e \& development/Wine\-@ANY_VERSION@@ARCHIVE_EXT@ .Ve .SS "sf.net" .IX Subsection "sf.net" qa.debian.org führt eine Weiterleitung aus, die eine einfachere Form für eine \s-1URL\s0 von Sourceforge-basierten Projekten bietet. Das nachfolgende Format wird automatisch umgeschrieben, um den Weiterleitungsdienst mit der Watch-Datei zu verwenden: .PP .Vb 2 \& version=4 \& https://sf.net// \-@ANY_VERSION@@ARCHIVE_EXT@ .Ve .PP Schreiben Sie die Watch-Datei für \fBaudacity\fR wie folgt: .PP .Vb 2 \& version=4 \& https://sf.net/audacity/ audacity\-minsrc\-@ANY_VERSION@@ARCHIVE_EXT@ .Ve .PP Bitte beachten Sie, dass Sie auch weiterhin normale Funktionalitäten von \fBuscan\fR benutzen können, um eine Watch-Datei für diese Site einrichten zu können, ohne dabei die Weiterleitung zu verwenden. .PP .Vb 6 \& version=4 \& opts="uversionmangle=s/\-pre/~pre/, \e \& filenamemangle=s%(?:.*)audacity\-minsrc\-(.+)\e.tar\e.xz/download%\e \& audacity\-$1.tar.xz%" \e \& http://sourceforge.net/projects/audacity/files/audacity/@ANY_VERSION@/ \e \& (?:.*)audacity\-minsrc\-@ANY_VERSION@@ARCHIVE_EXT@/download .Ve .PP \&\fB%\fR wird hier als Trenner anstelle des vorgegebenen \fB/\fR benutzt. .SS "github.com" .IX Subsection "github.com" For GitHub based projects, you can use the releases or tags \s-1API\s0 page. If upstream releases properly named tarballs on their releases page, you can search for the browser download \s-1URL\s0 (\s-1API\s0 key \fIbrowser_download_url\fR): .PP .Vb 4 \& version=4 \& opts="searchmode=plain" \e \& https://api.github.com/repos///releases?per_page=100 \e \& https://github.com///releases/download/[^/]+/@PACKAGE@\-@ANY_VERSION@@ARCHIVE_EXT@ .Ve .PP If the release page only contains the auto-generated tar.gz source code tarball, search for the tarball \s-1URL\s0 (\s-1API\s0 key \fItarball_url\fR). The tarball \s-1URL\s0 uses only the version as the filename. You can rename the downloaded upstream tarball into the standard \fI\-.tar.gz\fR using \fBfilenamemangle\fR: .PP .Vb 4 \& version=4 \& opts="filenamemangle=s%.*/@ANY_VERSION@%@PACKAGE@\-$1.tar.gz%,searchmode=plain" \e \& https://api.github.com/repos///releases?per_page=100 \e \& https://api.github.com/repos///tarball/@ANY_VERSION@ .Ve .PP If there are no upstream releases, you can query the equivalent tags page: .PP .Vb 4 \& version=4 \& opts="filenamemangle=s%.*/@ANY_VERSION@%@PACKAGE@\-$1.tar.gz%,searchmode=plain" \e \& https://api.github.com/repos///tags?per_page=100 \e \& https://api.github.com/repos///tarball/refs/tags/@ANY_VERSION@ .Ve .PP If upstream releases alpha/beta tarballs, you will need to make use of the \fBuversionmangle\fR option: \fIuversionmangle=s/(a|alpha|b|beta|c|dev|pre|rc)/~$1/\fR .SS "PyPI" .IX Subsection "PyPI" Für Projekte, die auf PyPI basieren, führt pypi.debian.net einen Weiterleitungsdienst aus, der eine einfachere Form der \s-1URL\s0 ermöglicht. Das nachfolgende Format wird automatisch umgeschrieben, um den Weiterleitungsdienst mit der Watch-Datei zu verwenden: .PP .Vb 3 \& version=4 \& https://pypi.python.org/packages/source/// \e \& \-@ANY_VERSION@@ARCHIVE_EXT@ .Ve .PP Schreiben Sie die Watch-Datei für \fBcfn-sphere\fR wie folgt: .PP .Vb 3 \& version=4 \& https://pypi.python.org/packages/source/c/cfn\-sphere/ \e \& cfn\-sphere\-@ANY_VERSION@@ARCHIVE_EXT@ .Ve .PP Bitte beachten Sie, dass Sie auch weiterhin normale Funktionalitäten von \fBuscan\fR benutzen können, um eine Watch-Datei für diese Site einrichten zu können, ohne dabei die Weiterleitung zu verwenden. .PP .Vb 5 \& version=4 \& opts="pgpmode=none" \e \& https://pypi.python.org/pypi/cfn\-sphere/ \e \& https://pypi.python.org/packages/.*/.*/.*/\e \& cfn\-sphere\-@ANY_VERSION@@ARCHIVE_EXT@#.* .Ve .SS "code.google.com" .IX Subsection "code.google.com" Sites, die vom Google-Code-Dienst beherbergt wurden, sollten zu einer anderen Stelle (Github?) migriert worden sein. Bitte halten Sie Ausschau nach einer neueren Site der Ursprungsautoren, falls verfügbar. .SS "npmjs.org (Knotenmodule)" .IX Subsection "npmjs.org (Knotenmodule)" npmjs.org\-Module werden in JSON-Dateien veröffentlicht. Hier eine Möglichkeit, sie zu lesen: .PP .Vb 4 \& version=4 \& opts="searchmode=plain" \e \& https://registry.npmjs.org/aes\-js \e \& https://registry.npmjs.org/aes\-js/\-/aes\-js\-@ANY_VERSION@@ARCHIVE_EXT@ .Ve .SS "Gruppiertes Paket" .IX Subsection "Gruppiertes Paket" Einige Knotenmodule werden in mehrere kleine Pakete der Ursprungsautoren zerteilt. Hier eine Möglichkeit, sie zu gruppieren: .PP .Vb 10 \& version=4 \& opts="searchmode=plain,pgpmode=none" \e \& https://registry.npmjs.org/mongodb \e \& https://registry.npmjs.org/mongodb/\-/mongodb\-@ANY_VERSION@@ARCHIVE_EXT@ group \& opts="searchmode=plain,pgpmode=none,component=bson" \e \& https://registry.npmjs.org/bson \e \& https://registry.npmjs.org/bson/\-/bson\-@ANY_VERSION@@ARCHIVE_EXT@ group \& opts="searchmode=plain,pgpmode=none,component=mongodb\-core" \e \& https://registry.npmjs.org/mongodb\-core \e \& https://registry.npmjs.org/mongodb\-core/\-/mongodb\-core\-@ANY_VERSION@@ARCHIVE_EXT@ group \& opts="searchmode=plain,pgpmode=none,component=requireoptional" \e \& https://registry.npmjs.org/require_optional \e \& https://registry.npmjs.org/require_optional/\-/require_optional\-@ANY_VERSION@@ARCHIVE_EXT@ group .Ve .PP Die Paketversion ist dann zusammengesetzt aus den Versionen der Ursprungsautoren, getrennt durch »+~«. .PP To avoid having a too long version, the \*(L"checksum\*(R" method can be used. In this case, the main source has to be declared as \*(L"group\*(R": .PP .Vb 10 \& version=4 \& opts="searchmode=plain,pgpmode=none" \e \& https://registry.npmjs.org/mongodb \e \& https://registry.npmjs.org/mongodb/\-/mongodb\-@ANY_VERSION@@ARCHIVE_EXT@ group \& opts="searchmode=plain,pgpmode=none,component=bson" \e \& https://registry.npmjs.org/bson \e \& https://registry.npmjs.org/bson/\-/bson\-@ANY_VERSION@@ARCHIVE_EXT@ checksum \& opts="searchmode=plain,pgpmode=none,component=mongodb\-core" \e \& https://registry.npmjs.org/mongodb\-core \e \& https://registry.npmjs.org/mongodb\-core/\-/mongodb\-core\-@ANY_VERSION@@ARCHIVE_EXT@ checksum \& opts="searchmode=plain,pgpmode=none,component=requireoptional" \e \& https://registry.npmjs.org/require_optional \e \& https://registry.npmjs.org/require_optional/\-/require_optional\-@ANY_VERSION@@ARCHIVE_EXT@ checksum .Ve .PP The \*(L"checksum\*(R" is made up of the separate sum of each number composing the component versions. Following is an example with 3 components whose versions are \*(L"1.2.4\*(R", \*(L"2.0.1\*(R" and \*(L"10.0\*(R", with the main tarball having version \*(L"2.0.6\*(R": .PP .Vb 9 \& Main: 2.0.6 \& Comp1: 1 . 2 . 4 \& Comp2: 2 . 0 . 1 \& Comp3: 10 . 0 \& ================================ \& Result : 1+2+10 . 2+0+0 . 4+1 \& Checksum: 13 . 2 . 5 \& ================================ \& Final Version: 2.0.6+~cs13.2.5 .Ve .PP uscan will also display the original version string before being encoded into the checksum, which can for example be used in a debian/changelog entry to easily follow the changes: .PP .Vb 1 \& 2.0.6+~1.2.4+~2.0.1+~10.0 .Ve .PP \&\fBNote\fR: This feature currently accepts only versions composed of digits and full stops (`.`). .SS "direkter Zugriff auf ein Git-Depot (Markierungen)" .IX Subsection "direkter Zugriff auf ein Git-Depot (Markierungen)" Falls die Ursprungsautoren ihren Code nur über das Git-Depot veröffentlichen und ihr Code keine Web-Schnittstelle hat, um den Veröffentlichungs\-Tarball zu bekommen, können Sie \fBuscan\fR mit den Markierungen des Git-Depots benutzen, um die neue Veröffentlichung der Originalautoren nachzuverfolgen und zu paketieren. .PP .Vb 4 \& version=4 \& opts="mode=git, gitmode=full, pgpmode=none" \e \& http://git.ao2.it/tweeper.git \e \& refs/tags/v@ANY_VERSION@ .Ve .PP Bitte beachten Sie, dass »\fBgit ls-remote\fR« benutzt wird, um Bezüge zu Markierungen zu bekommen. .PP Falls eine Markierung \fBv20.5\fR am neusten ist, lädt das vorhergehende Beispiel \fIspkg\fR\fB\-20.5.tar.xz\fR herunter, nachdem das Git-Depot geklont wurde, was für dumme Git-Server notwendig ist. .PP Falls Markierungen signiert sind, setzen Sie \fBpgpmode=gittag\fR, um sie zu prüfen. .SS "direkter Zugriff auf das Git-Depot (\s-1HEAD\s0)" .IX Subsection "direkter Zugriff auf das Git-Depot (HEAD)" Falls die Ursprungsautoren ihren Code nur über das Git-Depot veröffentlichen und es weder eine Web-Schnittstelle noch Markierungen hat, um den Veröffentlichungs\-Tarball zu bekommen, können Sie \fBuscan\fR mit dem \s-1HEAD\s0 des Git-Depots benutzen, um die neue Veröffentlichung der Ursprungsautoren nachzuverfolgen und mit einer automatisch erstellten Versionszeichenkette zu paketieren. .PP .Vb 4 \& version=4 \& opts="mode=git, pgpmode=none" \e \& https://github.com/Debian/dh\-make\-golang \e \& HEAD .Ve .PP Bitte beachten Sie, dass eine lokale oberflächlich mit »\fBgit clone \-\-bare \-\-depth=1\fR …« angelegte Kopie des Git-Depots normalerweise im Zielverzeichnis erstellt wird. \fBuscan\fR erzeugt standardmäßig die neue Version der Ursprungsautoren mit »\fBgit log \-\-date=format:%Y%m%d \-\-pretty=0.0~git%cd.%h\fR« auf dieser lokalen Kopie des Depots. .PP Das Erzeugen der Versionszeichenkette der Ursprungsautoren kann nach Ihrem Geschmack angepasst werden, indem Sie die den \fBopts\fR\-Argumenten die Optionen \fBpretty\fR und \fBdate\fR hinzufügen. .SS "direct access to the Subversion repository (tags)" .IX Subsection "direct access to the Subversion repository (tags)" If the upstream only publishes its code via the Subversion repository and its code has no web interface to obtain the release tarball, you can use \fBuscan\fR with the tags of the Subversion repository to track and package the new upstream release. .PP .Vb 4 \& version=4 \& opts="mode=svn, pgpmode=none" \e \& svn://svn.code.sf.net/p/jmol/code/tags/ \e \& @ANY_VERSION@\e/ .Ve .SS "direct access to the Subversion repository (\s-1HEAD\s0)" .IX Subsection "direct access to the Subversion repository (HEAD)" If the upstream only publishes its code via the Subversion repository and its code has no web interface to obtain the release tarball, you can use \fBuscan\fR to get the most recent source of a subtree in the repository with an automatically generated version string. .PP .Vb 4 \& version=4 \& opts="mode=svn, pgpmode=none" \e \& svn://svn.code.sf.net/p/jmol/code/trunk/ \e \& HEAD .Ve .PP By default, \fBuscan\fR generates the new upstream version by appending the revision number to \*(L"0.0~svn\*(R". This can later be changed using \fBuversionmangle\fR. .SH "BEISPIELE FÜR COPYRIGHT-DATEIEN" .IX Header "BEISPIELE FÜR COPYRIGHT-DATEIEN" Es folgt ein Beispiel für die Datei \fIdebian/copyright\fR die ein automatisches erneutes Packen des Tarballs der Ursprungsautoren in \fI_.orig.tar.gz\fR anstößt (In \fIdebian/copyright\fR sind die Absätze \fBFiles-Excluded\fR und \fBFiles\-Excluded\-\fR\fIKomponente\fR ein Teil des ersten Abschnitts und dort ist eine leere Zeile vor den folgenden Abschnitten, die \fBFiles\fR und andere Absätze enthalten.): .PP .Vb 6 \& Format: http://www.debian.org/doc/packaging\-manuals/copyright\-format/1.0/ \& Files\-Excluded: exclude\-this \& exclude\-dir \& */exclude\-dir \& .* \& */js/jquery.js \& \& Files: * \& Copyright: … \& … .Ve .PP Hier ein weiteres Beispiel für die \fIdebian/copyright\fR\-Datei, die ein automatisches erneutes Packen der Tarbälle mit mehreren Paketen (\s-1MUT\s0) der Ursprungsautoren in \fI_.orig.tar.gz\fR und \fI_.orig\-bar.tar.gz\fR anstößt. .PP .Vb 11 \& Format: http://www.debian.org/doc/packaging\-manuals/copyright\-format/1.0/ \& Files\-Excluded: exclude\-this \& exclude\-dir \& */exclude\-dir \& .* \& */js/jquery.js \& Files\-Excluded\-bar: exclude\-this \& exclude\-dir \& */exclude\-dir \& .* \& */js/jquery.js \& \& Files: * \& Copyright: … \& … .Ve .PP Siehe mk\-origtargz>(1). .SH "BEISPIELE FÜR SCHLÜSSELBUNDDATEIEN" .IX Header "BEISPIELE FÜR SCHLÜSSELBUNDDATEIEN" Nehmen wir einmal an, dass »\fBUscan\-Testschlüssel (kein Geheimnis) \fR der Ursprungsautoren Pakete mit einem geheimen OpenPGP\-Schlüssel signiert und den zugehörigen öffentlichen OpenPGP\-Schlüssel veröffentlicht. Dieser öffentliche OpenPGP\-Schlüssel kann mittels der hexadezimalen Form auf drei Arten identifiziert werden. .IP "\(bu" 4 Der Fingerabdruck als die 20 Byte Daten, die vom öffentlichen OpenPGP\-Schlüssel berechnet wurden. Z.B.»\fB\s-1CF21 8F0E 7EAB F584 B7E2 0402 C77E 2D68 7254 3FAF\s0\fR« .IP "\(bu" 4 Die lange Schlüsselkennung als die letzten acht Byte des Fingerabdrucks. Z.B. »\fBC77E2D6872543FAF\fR« .IP "\(bu" 4 Die kurze Schlüsselkennung als die letzten vier Byte des Fingerabdrucks. Z.B. »\fB72543FAF\fR« .PP In Anbetracht, dass es Kollisionsangriffe auf die kurze Schlüsselkennung gibt, wird empfohlen, die lange Schlüsselkennung zum Empfang von Schlüsseln des öffentlichen Schlüsselservers zu verwenden. Sie müssen den heruntergeladenen OpenPGP\-Schlüssel mittels seines vollständigen und Ihnen bereits bekanntenFingerabdruckwerts prüfen, um festzustellen, ob es der vertrauenswürdige ist. .PP Die ASCII\-Hülle der Schlüsselbunddatei \fIdebian/upstream/signing\-key.asc\fR kann mit dem Befehl \fBgpg\fR (oder \fBgpg2\fR) wie folgt erstellt werden: .PP .Vb 12 \& $ gpg \-\-recv\-keys "C77E2D6872543FAF" \& ... \& $ gpg \-\-finger "C77E2D6872543FAF" \& pub 4096R/72543FAF 2015\-09\-02 \& Key fingerprint = CF21 8F0E 7EAB F584 B7E2 0402 C77E 2D68 7254 3FAF \& uid uscan test key (no secret) \& sub 4096R/52C6ED39 2015\-09\-02 \& $ cd path/to/\- \& $ mkdir \-p debian/upstream \& $ gpg \-\-export \-\-export\-options export\-minimal \-\-armor \e \& \*(AqCF21 8F0E 7EAB F584 B7E2 0402 C77E 2D68 7254 3FAF\*(Aq \e \& >debian/upstream/signing\-key.asc .Ve .PP Die binären Schlüsselbunddateien \fIdebian/upstream/signing\-key.pgp\fR und \fIdebian/upstream\-signing\-key.pgp\fR werden immer noch unterstützt, sind jedoch missbilligt. .PP Falls eine Gruppe von Entwicklern das Paket signiert, müssen Sie die Fingerabdrücke von ihnen allen im Argument für \fBgpg \-\-export …\fR aufführen, damit der Schlüsselbund alle ihre OpenPGP\-Schlüssel enthält. .PP Manchmal fragen Sie sich vielleicht, wer die Signaturdatei erstellt hat. Sie können die öffentliche Schlüsselkennung erhalten, um die abgetrennte Signaturdatei \fIfoo\-2.0.tar.gz.asc\fR zu erstellen, indem Sie \fBgpg\fR wie folgt ausführen: .PP .Vb 12 \& $ gpg \-vv foo\-2.0.tar.gz.asc \& gpg: armor: BEGIN PGP SIGNATURE \& gpg: armor header: Version: GnuPG v1 \& :signature packet: algo 1, keyid C77E2D6872543FAF \& version 4, created 1445177469, md5len 0, sigclass 0x00 \& digest algo 2, begin of digest 7a c7 \& hashed subpkt 2 len 4 (sig created 2015\-10\-18) \& subpkt 16 len 8 (issuer key ID C77E2D6872543FAF) \& data: [4091 bits] \& gpg: assuming signed data in \`foo\-2.0.tar.gz\*(Aq \& gpg: Signature made Sun 18 Oct 2015 11:11:09 PM JST using RSA key ID 72543FAF \& ... .Ve .SH "BEFEHLZEILENOPTIONEN" .IX Header "BEFEHLZEILENOPTIONEN" Für die einfache Benutzung benötigt \fBuscan\fR diese Optionen nicht. .IP "\fB\-\-conffile\fR, \fB\-\-conf\-file\fR" 4 .IX Item "--conffile, --conf-file" Standard-Konfigurationsdateien hinzufügen oder ersetzen (\f(CW\*(C`/etc/devscripts.conf\*(C'\fR und \f(CW\*(C`~/.devscripts\*(C'\fR). Dies kann nur als erste auf der Befehlszeile angegebene Option benutzt werden. .RS 4 .IP "replace:" 4 .IX Item "replace:" .Vb 1 \& uscan \-\-conf\-file test.conf \-\-verbose .Ve .IP "add:" 4 .IX Item "add:" .Vb 1 \& uscan \-\-conf\-file +test.conf \-\-verbose .Ve .Sp If one \fB\-\-conf\-file\fR has no \f(CW\*(C`+\*(C'\fR, default configuration files are ignored. .RE .RS 4 .RE .IP "\fB\-\-no\-conf\fR, \fB\-\-noconf\fR" 4 .IX Item "--no-conf, --noconf" liest keine Konfigurationsdateien. Dies kann nur als erste auf der Befehlszeile angegebene Option benutzt werden. .IP "\fB\-\-no\-verbose\fR" 4 .IX Item "--no-verbose" gibt keine detaillierten Informationen aus. (Voreinstellung) .IP "\fB\-\-verbose\fR, \fB\-v\fR" 4 .IX Item "--verbose, -v" zeigt detaillierte Informationen an. .IP "\fB\-\-debug\fR, \fB\-vv\fR" 4 .IX Item "--debug, -vv" Report verbose information and some internal state values. .IP "\fB\-\-extra\-debug\fR, \fB\-vvv\fR" 4 .IX Item "--extra-debug, -vvv" berichtet detaillierte Informationen einschließlich heruntergeladener Webseiten als verarbeitet zur Fehlersuche auf die Standardfehlerausgabe. .IP "\fB\-\-dehs\fR" 4 .IX Item "--dehs" sendet Ausgaben im DEHS-Stil (XML-Typ) an die Standardausgabe, während alle anderen Ausgaben von Uscan an die Standardfehlerausgabe gesandt werden. .IP "\fB\-\-no\-dehs\fR" 4 .IX Item "--no-dehs" verwendet nur das traditionelle Uscan\-Ausgabeformat.(Voreinstellung) .IP "\fB\-\-download\fR, \fB\-d\fR" 4 .IX Item "--download, -d" lädt die neue Veröffentlichung der Ursprungsautoren herunter. (Voreinstellung) .IP "\fB\-\-force\-download\fR, \fB\-dd\fR" 4 .IX Item "--force-download, -dd" lädt die neue Veröffentlichung der Ursprungsautoren sogar dann herunter, wenn sie aktuell ist (wird jedoch nicht die lokale Datei überschreiben). .IP "\fB\-\-overwrite\-download\fR, \fB\-ddd\fR" 4 .IX Item "--overwrite-download, -ddd" lädt die neue Veröffentlichung der Ursprungsautoren sogar dann herunter, wenn sie aktuell ist (kann die lokale Datei überschreiben). .IP "\fB\-\-no\-download\fR, \fB\-\-nodownload\fR" 4 .IX Item "--no-download, --nodownload" lädt die Informationen nicht herunter und meldet sie nicht. .Sp Vorher heruntergeladene Tarbälle können verwendet werden. .Sp ändert die Voreinstellung in \fB\-\-skip\-signature\fR. .IP "\fB\-\-signature\fR" 4 .IX Item "--signature" lädt die Signatur herunter. (Voreinstellung) .IP "\fB\-\-no\-signature\fR" 4 .IX Item "--no-signature" lädt die Signatur nicht herunter, prüft jedoch, ob sie bereits heruntergeladen wurde. .IP "\fB\-\-skip\-signature\fR" 4 .IX Item "--skip-signature" belästigt weder mit dem Herunterladen noch mit dem Prüfen der Signatur. .IP "\fB\-\-safe\fR, \fB\-\-report\fR" 4 .IX Item "--safe, --report" vermeidet die Ausführung unsicherer Skripte, indem sowohl das erneute Packen des heruntergeladenen Pakets als auch das Aktualisieren des neuen Quellcodeverzeichnisbaums übersprungen wird. .Sp ändert die Voreinstellung in \fB\-\-no\-download\fR und \fB\-\-skip\-signature\fR. .Sp Wenn \fBuscan\fR mit dem Ziel ausgeführt wird, den Status des Pakets der Ursprungsautoren in eine sicherheitsbewusste Umgebung aufzunehmen, stellen Sie sicher, dass Sie diese Option verwenden. .IP "\fB\-\-report\-status\fR" 4 .IX Item "--report-status" Dies entspricht dem Setzen der Option »\fB\-\-verbose \-\-safe\fR« .IP "\fB\-\-download\-version\fR \fIVersion\fR" 4 .IX Item "--download-version Version" gibt die \fIVersion\fR an, zu der die Veröffentlichung der Ursprungsautoren passen muss, um anstelle der Veröffentlichung mit der höchsten Versionsnummer berücksichtigt zu werden (eine bestmöglich erfüllte Funktionalität). .IP "\fB\-\-download\-debversion\fR \fIversion\fR" 4 .IX Item "--download-debversion version" gibt die Debian-Paketversion an, um die entsprechende Veröffentlichungsversion der Ursprungsautoren herunterzuladen. Die Regeln \fBdversionmangle\fR und \fBuversionmangle\fR werden berücksichtigt (eine bestmöglich erfüllte Funktionalität). .IP "\fB\-\-download\-current\-version\fR" 4 .IX Item "--download-current-version" lädt die aktuelle paketierte Version herunter (eine bestmöglich erfüllte Funktionalität). .IP "\fB\-\-check\-dirname\-level\fR \fIN\fR" 4 .IX Item "--check-dirname-level N" Die Erklärung dieser Option finden Sie im nachfolgenden Abschnitt \fBPrüfung von Verzeichnisnamen\fR. .IP "\fB\-\-check\-dirname\-regex\fR \fIregulärer_Ausdruck\fR" 4 .IX Item "--check-dirname-regex regulärer_Ausdruck" Die Erklärung dieser Option finden Sie im nachfolgenden Abschnitt \fBPrüfung von Verzeichnisnamen\fR. .IP "\fB\-\-destdir\fR \fIPfad\fR Normalerweise ändert \fBuscan\fR sein internes aktuelles Verzeichnis auf das Quellverzeichnis des Pakets, in dem \fIdebian/\fR liegt. Dann wird das Zielverzeichnis zum Herunterladen des Tarballs und anderer Dateien auf das übergeordnete Verzeichnis \fI../\fR dieses internen aktuellen Verzeichnisses gesetzt." 4 .IX Item "--destdir Pfad Normalerweise ändert uscan sein internes aktuelles Verzeichnis auf das Quellverzeichnis des Pakets, in dem debian/ liegt. Dann wird das Zielverzeichnis zum Herunterladen des Tarballs und anderer Dateien auf das übergeordnete Verzeichnis ../ dieses internen aktuellen Verzeichnisses gesetzt." Dieses Standardzielverzeichnis kann durch Setzen der Option \fB\-\-destdir\fR auf einen bestimmten \fIPfad\fR außer Kraft gesetzt werden. Falls dieser \fIPfad\fR relativ ist, wird das Zielverzeichnis relativ zum internen aktuellen Verzeichnis bestimmt, in dem \fBuscan\fR ausgeführt wird. Falls dieser \fIPfad\fR absolut ist, wird das Zielverzeichnis ungeachtet des internen aktuellen Verzeichnis, in dem \fBuscan\fR ausgeführt wird, auf \fIPfad\fR gesetzt. .Sp The above is true not only for the simple \fBuscan\fR run in the single source tree but also for the advanced scanning \fBuscan\fR run with subdirectories holding multiple source trees. .Sp Eine Ausnahme liegt vor, wenn \fB\-\-watchfile\fR und \fB\-\-package\fR zusammen benutzt werden. In diesem Fall werden das interne aktuelle Ausführungsverzeichnis von \fBuscan\fR und das Standardzielverzeichnis auf das aktuelle Verzeichnis \fI.\fR, von dem \fBuscan\fR gestartet wird, gesetzt. Das Standardzielverzeichnis kann auch hier durch Setzen der Option \fB\-\-destdir\fR außer Kraft gesetzt werden. .IP "\fB\-\-package\fR \fIPaket\fR" 4 .IX Item "--package Paket" gibt den Namen des zu prüfenden Pakets an, anstatt \fIdebian/changelog\fR zu untersuchen; dies erfordert die Optionen \fB\-\-upstream\-version\fR (es sei denn, in der Datei \fIwatch\fR wurde eine Version angegeben) sowie \fB\-\-watchfile\fR. Zudem wird kein Verzeichnis durchsucht und es wird nichts heruntergeladen. Diese Option setzt automatisch \fB\-\-no\-download\fR and \fB\-\-skip\-signature\fR. Sie ist wahrscheinlich in Verbindung mit dem DEHS-System (und \fB\-\-dehs\fR) an nützlichsten. .IP "\fB\-\-upstream\-version\fR \fIVersion_der_Ursprungsautoren\fR" 4 .IX Item "--upstream-version Version_der_Ursprungsautoren" gibt die aktuelle Version der Ursprungsautoren an, statt die \fIdebian/watch\fR\- oder \fIdebian/changelog\fR\-Datei zu untersuchen, um sie zu bestimmen. Dies wird ignoriert, falls ein Verzeichnis-Scan durchgeführt und mehr als eine \fIdebian/watch\fR\-Datei gefunden wird. .IP "\fB\-\-watchfile\fR \fIwatch-Datei\fR" 4 .IX Item "--watchfile watch-Datei" gibt die \fIWatch-Datei\fR an, statt eine Verzeichnisdurchsuchung durchzuführen, um sie zu bestimmen. Falls diese Option ohne \fB\-\-package\fR benutzt wird, muss \fBuscan\fR aus dem Debian-Paketquellenverzeichnisbaum aufgerufen werden (so dass \fIdebian/changelog\fR einfach beim Hochlaufen des Verzeichnisbaums gefunden werden kann). .Sp Eine Ausnahme liegt vor, wenn \fB\-\-watchfile\fR und \fB\-\-package\fR zusammen benutzt werden. \fBuscan\fR kann von überall aufgerufen werden und das interne Ausführungsverzeichnis von \fBuscan\fR sowie das Standardzielverzeichnis werden auf das aktuelle Verzeichnis \fI.\fR gesetzt, von wo \fBuscan\fR gestartet wird. .Sp Weitere Einzelheiten erfahren Sie in der Erläuterung von \fB\-\-destdir\fR. .IP "\fB\-\-bare\fR" 4 .IX Item "--bare" deaktiviert alle Site-spezifischen Codes für Sonderfälle, die URL-Weiterleitungen und Änderungen des Seiteninhalts durchführen. .IP "\fB\-\-http\-header\fR" 4 .IX Item "--http-header" Add specified header in \s-1HTTP\s0 requests for matching url. This option can be used more than one time, values must be in the form "baseUrl@Name=value. Example: .Sp .Vb 1 \& uscan \-\-http\-header https://example.org@My\-Token=qwertyuiop .Ve .Sp Security: .RS 4 .IP "The given \fIbaseUrl\fR must exactly match the base url before '/'. Examples:" 4 .IX Item "The given baseUrl must exactly match the base url before '/'. Examples:" .Vb 7 \& | \-\-http\-header value | Good for | Never used | \& +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-+ \& | https://example.org.com@Hdr=Value | https://example.org.com/... | | \& | https://example.org.com/@Hdr=Value | | X | \& | https://e.com:1879@Hdr=Value | https://e.com:1879/... | | \& | https://e.com:1879/dir@Hdr=Value | https://e.com:1879/dir/... | | \& | https://e.com:1879/dir/@Hdr=Value | | X | .Ve .IP "It is strongly recommended to not use this feature to pass a secret token over unciphered connection \fI(http://)\fR" 4 .IX Item "It is strongly recommended to not use this feature to pass a secret token over unciphered connection (http://)" .PD 0 .ie n .IP "You can use ""USCAN_HTTP_HEADER"" variable (in ""~/.devscripts"") to hide secret token from scripts" 4 .el .IP "You can use \f(CWUSCAN_HTTP_HEADER\fR variable (in \f(CW~/.devscripts\fR) to hide secret token from scripts" 4 .IX Item "You can use USCAN_HTTP_HEADER variable (in ~/.devscripts) to hide secret token from scripts" .RE .RS 4 .RE .IP "\fB\-\-no\-exclusion\fR" 4 .IX Item "--no-exclusion" .PD schließt Dateien, die in \fIdebian/copyright\fR im Feld \fBFiles-Excluded\fR erwähnt wurden, nicht automatisch aus. .IP "\fB\-\-pasv\fR" 4 .IX Item "--pasv" erzwingt bei FTP-Verbindungen den PASV-Modus. .IP "\fB\-\-no\-pasv\fR" 4 .IX Item "--no-pasv" verwendet bei FTP-Verbindungen nicht den PASV-Modus. .IP "\fB\-\-no\-symlink\fR" 4 .IX Item "--no-symlink" benennt den Original-Tarball weder um, noch wird er neu gepackt. .IP "\fB\-\-timeout\fR \fIN\fR" 4 .IX Item "--timeout N" setzt die Zeitüberschreitung auf \fIN\fR Sekunden (Voreinstellung 20 Sekunden). .IP "\fB\-\-user\-agent\fR, \fB\-\-useragent\fR" 4 .IX Item "--user-agent, --useragent" setzt die vorgegebene User-Agent-Kopfzeile außer Kraft. .IP "\fB\-\-help\fR" 4 .IX Item "--help" gibt eine kurze Gebrauchsinformation. .IP "\fB\-\-version\fR" 4 .IX Item "--version" zeigt Versionsinformationen. .PP \&\fBuscan\fR akzeptiert außerdem die folgenden Optionen und leitet sie an \fBmk-origtargz\fR weiter: .IP "\fB\-\-symlink\fR" 4 .IX Item "--symlink" erstellt symbolische \fBorig.tar.gz\fR\-Verweise (mit passender Endung) auf die heruntergeladenen Dateien. (Dies ist das Standardverhalten.) .IP "\fB\-\-copy\fR" 4 .IX Item "--copy" kopiert die heruntergeladenen Dateien, statt, wie oben beschrieben, symbolische Verweise darauf zu erstellen. .IP "\fB\-\-rename\fR" 4 .IX Item "--rename" benennt die heruntergeladenen Dateien um, statt, wie oben beschrieben, symbolische Verweise darauf zu erstellen. .IP "\fB\-\-repack\fR" 4 .IX Item "--repack" After having downloaded an lzma tar, xz tar, bzip tar, gz tar, zip, jar, xpi, zstd archive, repack it to the specified compression (see \fB\-\-compression\fR). .Sp The unzip package must be installed in order to repack zip, jar, and xpi archives, the xz-utils package must be installed to repack lzma or xz tar archives, and zstd must be installed to repack zstd archives. .IP "\fB\-\-compression\fR [ \fBgzip\fR | \fBbzip2\fR | \fBlzma\fR | \fBxz\fR ]" 4 .IX Item "--compression [ gzip | bzip2 | lzma | xz ]" Falls die Quellen der Originalautoren neu gepackt wurden (entweder weil die Option \fB\-\-repack\fR angegeben wurde oder \fIdebian/copyright\fR das Feld \fBFiles-Excluded\fR enthält), ist es möglich, die Komprimierungsmethode über diesen Parameter zu steuern. Voreinstellung ist für normale Tarbälle \fBgzip\fR und \fBxz\fR für Tarbälle, die direkt aus dem Git-Depot erstellt werden. .IP "\fB\-\-copyright\-file\fR \fICopyright-Datei\fR" 4 .IX Item "--copyright-file Copyright-Datei" schließt Dateien aus, die in \fBFiles-Excluded\fR in der angegebenen \fICopyright-Datei\fR erwähnt werden. Dies ist nützlich, wenn \fBuscan\fR nicht innerhalb eines Quellpaketverzeichnisses ausgeführt wird. .SH "DEVSCRIPT-KONFIGURATIONSVARIABLEN" .IX Header "DEVSCRIPT-KONFIGURATIONSVARIABLEN" Für den einfachen Gebrauch benötigt \fBuscan\fR das Setzen dieser Konfigurationsvariablen nicht. .PP Die beiden Konfigurationsdateien \fI/etc/devscripts.conf\fR und \fI~/.devscripts\fR werden durch eine Shell in dieser Reihenfolge eingelesen, um Konfigurationsvariablen zu setzen. Diese können durch Befehlszeilenoptionen außer Kraft gesetzt werden. Zu diesem Zweck werden Umgebungsvariablen ignoriert. Falls die erste angegebene Befehlszeilenoption \fB\-\-noconf\fR ist, werden diese Dateien nicht gelesen. Die derzeit bekannten Variablen sind: .IP "\fB\s-1USCAN_DOWNLOAD\s0\fR" 4 .IX Item "USCAN_DOWNLOAD" nur Herunterladen oder melden: .RS 4 .IP "\fBno\fR: entspricht \fB\-\-no\-download\fR, neuere Dateien der Ursprungsautoren werden nicht heruntergeladen." 4 .IX Item "no: entspricht --no-download, neuere Dateien der Ursprungsautoren werden nicht heruntergeladen." .PD 0 .IP "\fByes\fR: entspricht \fB\-\-download\fR, neuere Dateien der Ursprungsautoren werden heruntergeladen. Dies ist das Standardverhalten." 4 .IX Item "yes: entspricht --download, neuere Dateien der Ursprungsautoren werden heruntergeladen. Dies ist das Standardverhalten." .PD Siehe auch \fB\-\-force\-download\fR und \fB\-\-overwrite\-download\fR. .RE .RS 4 .RE .IP "\fB\s-1USCAN_SAFE\s0\fR" 4 .IX Item "USCAN_SAFE" Falls dies auf \fByes\fR gesetzt ist, verhindert \fBuscan\fR die Ausführung unsicherer Skripte, indem das erneute Packen heruntergeladener Pakete als auch das Aktualisieren des Quellverzeichnisbaums übersprungen werden. Dies entspricht den \fB\-\-safe\fR\-Optionen. Außerdem setzt dies die Voreinstellung auf \fB\-\-no\-download\fR und \fB\-\-skip\-signature\fR. .IP "\fB\s-1USCAN_PASV\s0\fR" 4 .IX Item "USCAN_PASV" Falls dies auf »yes« oder »no« gesetzt ist, wird dies erzwingen, dass FTP-Verbindungen den PASV-Modus verwenden beziehungsweise nicht verwenden. Falls dies auf »default« gesetzt ist, wird \fBNet::FTP\fR(3) eine Auswahl treffen (basiert hauptsächlich auf der Umgebungsvariable \fB\s-1FTP_PASSIVE\s0\fR). .IP "\fB\s-1USCAN_TIMEOUT\s0\fR" 4 .IX Item "USCAN_TIMEOUT" Falls dies auf eine Zahl \fIN\fR gesetzt ist, wird die Zeitüberschreitung auf \fIN\fR Sekunden eingestellt. Dies entspricht der Option \fB\-\-timeout\fR. .IP "\fB\s-1USCAN_SYMLINK\s0\fR" 4 .IX Item "USCAN_SYMLINK" Falls dies auf »no« gesetzt ist, wird kein symbolischer Verweis für \fIPaket\fR_\fIVersion\fR\fB.orig.tar.{gz|bz2|lzma|xz}\fR erstellt (entspricht der Option \fB\-\-no\-symlink\fR). Falls es auf \fByes\fR oder \fBsymlink\fR gesetzt ist, dann werden symbolische Verweise erstellt. Falls es auf \fBrename\fR gesetzt ist, werden die Dateien umbenannt (entspricht der Option \fB\-\-rename\fR). .IP "\fB\s-1USCAN_DEHS_OUTPUT\s0\fR" 4 .IX Item "USCAN_DEHS_OUTPUT" Falls dies auf \fByes\fR gesetzt ist, wird eine Ausgabe im DEHS-Stil verwendet. Dies entspricht der Option \fB\-\-dehs\fR. .IP "\fB\s-1USCAN_VERBOSE\s0\fR" 4 .IX Item "USCAN_VERBOSE" Falls dies auf \fByes\fR gesetzt ist, wird eine detaillierte Ausgabe erzeugt. Dies entspricht der Option \fB\-\-verbose\fR. .IP "\fB\s-1USCAN_USER_AGENT\s0\fR" 4 .IX Item "USCAN_USER_AGENT" Falls gesetzt, wird die angegebene User-Agent-Zeichenkette anstelle der vorgegebenen benutzt. Dies entspricht der Option \fB\-\-user\-agent\fR. .IP "\fB\s-1USCAN_DESTDIR\s0\fR" 4 .IX Item "USCAN_DESTDIR" Falls gesetzt, werden heruntergeladene Dateien in diesem Verzeichnis abgelegt. Dies entspricht der Option \fB\-\-destdir\fR. .IP "\fB\s-1USCAN_REPACK\s0\fR" 4 .IX Item "USCAN_REPACK" If this is set to yes, then after having downloaded a bzip tar, lzma tar, xz tar, zip or zstd archive, uscan will repack it to the specified compression (see \fB\-\-compression\fR). This is equivalent to the \fB\-\-repack\fR option. .IP "\fB\s-1USCAN_EXCLUSION\s0\fR" 4 .IX Item "USCAN_EXCLUSION" Falls dies auf »no« gesetzt ist, werden im Feld \fBFiles-Excluded\fR von \fIdebian/copyright\fR erwähnte Dateien ignoriert und es wird nicht versucht, Dateien auszuschließen. Dies entspricht der Option \fB\-\-no\-exclusion\fR. .IP "\fB\s-1USCAN_HTTP_HEADER\s0\fR" 4 .IX Item "USCAN_HTTP_HEADER" If set, the specified http header will be used if \s-1URL\s0 match. This is equivalent to \fB\-\-http\-header\fR option. .SH "EXIT-STATUS" .IX Header "EXIT-STATUS" Der Exit-Status gibt einige Hinweise, ob eine neuere Version gefunden wurde oder nicht; es wird geraten, die Ausgabe zu lesen, um genau zu bestimmen, was geschehen ist und ob irgendwelche Warnungen zu beachten sind. .IP "\fB0\fR" 4 .IX Item "0" Es wurde entweder \fB\-\-help\fR oder \fB\-\-version\fR benutzt oder es wurde für eine untersuchte \fIwatch\fR\-Datei eine neuere Version der Ursprungsautoren gefunden. .IP "\fB1\fR" 4 .IX Item "1" Es wurde für keine der untersuchten \fIwatch\fR\-Dateien eine neuere Version der Ursprungsautoren gefunden. .SH "FORTGESCHRITTENE FUNKTIONALITÄTEN" .IX Header "FORTGESCHRITTENE FUNKTIONALITÄTEN" \&\fBuscan\fR hat viele weitere verbesserte Funktionalitäten, die im obigen Abschnitt der Einfachheit halber übersprungen wurden. Schauen wir uns ihre Glanzlicher an. .PP \&\fBuscan\fR kann mit \fIPfad\fR als Argument ausgeführt werden, um das Startverzeichnis der Suche vom aktuellen Verzeichnis auf \fIPfad\fR zu ändern. .PP Falls Sie nicht genau wissen, was im Hintergrund geschieht, aktivieren Sie bitte die Option \fB\-\-verbose\fR. Falls dies nicht ausreicht, aktivieren Sie die Option \fB\-\-debug\fR, um alle internen Aktivitäten zu sehen. .PP Weitere Variationen finden Sie unter \s-1BEFEHLZEILENOPTIONEN\s0 und DEVSCRIPT-KONFIGURATIONSVARIABLEN. .SS "Benutzerdefiniertes Skript" .IX Subsection "Benutzerdefiniertes Skript" Der optionale Parameter \fISkript\fR in \fIdebian/watch\fR bedeutet, dass \fISkript\fR mit Optionen nach der Verarbeitung dieser Zeile ausgeführt wird, falls angegeben. .PP Wie \fBuscan\fR das benutzerdefinierte \fISkript\fR aufruft, finden Sie unter \*(L"\s-1CHRONIK UND UPGRADES\s0 DURCHFÜHREN\*(R". .PP Um die Kompatibilität mit anderen Werkzeugen wie \fBgit-buildpackage\fR zu wahren, ist es vermutlich keine gute Idee, benutzerdefinierte Skripte mit zufälligem Verhalten zu erstellen. Im Allgemeinen ist \fBuupdate\fR die beste Wahl für das nichtnative Paket und benutzerdefinierte Skripte, falls sie erstellt wurden, sollten sich wie \fBuupdate\fR verhalten. Einen möglichen Anwendungsfall finden Sie beispielsweise unter . .SS "URL-Umleitung" .IX Subsection "URL-Umleitung" Einige populären Websites haben ihre Seitenstruktur geändert, was Wartungsprobleme mit der Watch-Datei verursachte. Es gibt einige Weiterleitungsdienste, die erstellt wurden, um die Wartung der Watch-Datei zu erleichtern. Derzeit leitet \fBuscan\fR URL-Anfragen automatisch an die folgenden URLs weiter, um diese Situation zu bewältigen. .IP "\(bu" 4 .IP "\(bu" 4 .SS "Prüfung von Verzeichnisnamen" .IX Subsection "Prüfung von Verzeichnisnamen" Ähnlich wie viele andere Skripte im Paket \fBdevscripts\fR, erkundet \fBuscan\fR die abgefragten Verzeichnisbäume nach \fIdebian/changelog\fR\- und \fIdebian/watch\fR\-Dateien. Als eine Schutzmaßnahme gegen verirrte Dateien, die potenziell Probleme bereiten und um die Leistung zu steigern, wird es den Namen des übergeordneten Verzeichnisses untersuchen, sobald es die \fIdebian/changelog\fR\-Datei findet, und prüfen, ob der Verzeichnisname dem Paketnamen entspricht. Es wird nur versuchen, neuere Versionen des Pakets herunterzuladen und dann jede angefragte Aktion durchführen, falls der Verzeichnisname zum Paketnamen passt. Wie dies genau geschieht, wird durch die beiden Konfigurationsdateivariablen \fB\s-1DEVSCRIPTS_CHECK_DIRNAME_LEVEL\s0\fR und \fB\s-1DEVSCRIPTS_CHECK_DIRNAME_REGEX\s0\fR sowie ihren entsprechenden Befehlszeilenoptionen \fB\-\-check\-dirname\-level\fR und \fB\-\-check\-dirname\-regex\fR geregelt. .PP \&\fB\s-1DEVSCRIPTS_CHECK_DIRNAME_LEVEL\s0\fR kann die folgenden Werte annehmen: .IP "\fB0\fR" 4 .IX Item "0" prüft den Verzeichnisnamen nie. .IP "\fB1\fR" 4 .IX Item "1" prüft nur den Verzeichnisnamen, falls bei der Suche nach \fIdebian/changelog\fR das Verzeichnis geändert werden muss, das heißt, das Verzeichnis, das \fIdebian/changelog\fR enthält, nicht das Verzeichnis ist, aus dem \fBuscan\fR aufgerufen wurde. Dies ist das Standardverhalten. .IP "\fB2\fR" 4 .IX Item "2" prüft den Verzeichnisnamen immer. .PP Der Verzeichnisname wird geprüft, indem getestet wird, ob der aktuelle Verzeichnisname (wie er durch \fBpwd\fR\|(1) bestimmt wurde) zum regulären Ausdruck passt, der durch die Konfigurationsdateioption \fB\s-1DEVSCRIPTS_CHECK_DIRNAME_REGEX\s0\fR oder die Befehlszeilenoption \fB\-\-check\-dirname\-regex\fR \fIregulärer_Ausdruck\fR angegeben wurde. Hierbei ist regulärer_Ausdruck ein regulärer Perl-Ausdruck (siehe \fBperlre\fR\|(3perl)), der an den Anfang und das Ende verankert wird. Falls regulärer_Ausdruck ein \fB/\fR enthält, muss er auf den vollständigen Verzeichnispfad passen. Falls nicht, dann muss er auf den vollständigen Verzeichnisnamen passen. Falls regulärer_Ausdruck die Zeichenkette \fIPaket\fR beinhaltet, wird dies durch den Namen des Quellpakets ersetzt, wie er aus \fIdebian/changelog\fR bestimmt wird. Der vorgegebene Wert für den regulären_Ausdruck ist: \fIPaket\fR\fB(\-.+)?\fR, daher entspricht er Verzeichnisnamen wie \fBPaket\fR und \fIPaket\fR\-\fIVersion\fR. .SH "CHRONIK UND UPGRADES DURCHFÜHREN" .IX Header "CHRONIK UND UPGRADES DURCHFÜHREN" Dieser Abschnitt beschreibt kurz die rückwärtsinkompatiblen \fIwatch\fR\-Dateifunktionalitäten, die in jeder \fIwatch\fR\-Dateiversion hinzugefügt wurden, und die erste Version des \fBdevscripts\fR\-Pakets, das sie verstand. .IP "Vorversion 2" 4 .IX Item "Vorversion 2" Zu jener Zeit war die \fIwatch\fR\-Dateisyntax signifikant anders. Verwenden Sie sie nicht. Falls Sie ein Upgrade von einer \fIwatch\fR\-Datei einer Version vor 2 durchführen, wird Ihnen empfohlen, diese Handbuchseite zu lesen und von Grund auf neu zu beginnen. .IP "Version 2" 4 .IX Item "Version 2" \&\fBdevscripts\fR version 2.6.90: The first incarnation of the current style of \fIwatch\fR files. This version is also deprecated and will be rejected after the Debian 11 release. .IP "Version 3" 4 .IX Item "Version 3" \&\fBdevscripts\fR\-Version 2.8.12 führte das Folgende ein: korrekte Handhabung von Sonderzeichen regulärer Ausdrücke im Pfadteil, Verzeichnis\-/Pfadmusterabgleich, Versionsnummern in mehreren Teilen, Versionsnummerverarbeitung. Neuere Versionen haben außerden URL-Verarbeitung eingeführt. .Sp Falls Sie ein Upgrade von Version 2 durchführen, besteht die Hauptinkomatibilität, wenn Sie mehrere Gruppen im Musterteil haben; während nur die erste in Version 2 benutzt würde, werden sie alle in Version 3 verwendet. Um dieses Verhalten zu vermeiden, ändern Sie die Nichtversionsnummergruppen so, dass sie \fB(?:\fR \fI …\fR \fB)\fR\- anstelle von einfachen \fB(\fR \fI … \fR \fB)\fR\-Gruppen sind. .RS 4 .IP "\(bu" 4 \&\fBuscan\fR ruft das benutzerdefinierte \fISkript\fR als »\fISkript\fR \&\fB\-\-upstream\-version\fR \fIVersion\fR \&\fB../\fR\fIQuellpaket\fR\fB_\fR\fIVersion\fR\fB.orig.tar.gz\fR« auf. .IP "\(bu" 4 \&\fBuscan\fR ruft das Standard\-\fBuupdate\fR als »\fBuupdate\fR \fB\-\-no\-symlink \&\-\-upstream\-version\fR \fIVersion\fR \&\fB../\fR\fIQuellpaket\fR\fB_\fR\fIVersion\fR\fB.orig.tar.gz\fR auf. .RE .RS 4 .RE .IP "Version 4" 4 .IX Item "Version 4" \&\fBdevscripts\fR\-Version 2.15.10: die erste Verkörperung der \fIwatch\fR\-Datei, die mehrere Tarbälle der Ursprungsautoren unterstützt. .Sp Die Syntax der Watch-Datei wurde gelockert, um zur Lesbarkeit den Umgang mit mehr Leerräumen zu erlauben. .Sp Falls Sie ein benutzerdefiniertes Skript anstelle von \fBuupdate\fR haben, stoßen Sie möglicherweise ebenfalls beim Aktualisieren von Version 3 auf Probleme. .RS 4 .IP "\(bu" 4 \&\fBuscan\fR ruft das benutzerdefinierte \fISkript\fR als »\fISkript\fR \&\fB\-\-upstream\-version\fR \fIVersion\fR« auf. .IP "\(bu" 4 \&\fBuscan\fR ruft das Standard\-\fBuupdate\fR als »\fBuupdate\fR \fB\-\-find\fR \&\fB\-\-upstream\-version\fR \fIVersion\fR« auf. .RE .RS 4 .Sp Die Beschränkung für \fB\-\-dehs\fR wird aufgehoben, indem andere Ausgaben auf die Standardfehlerausgabe umgeleitet werden, wenn sie aktiviert ist. .RE .SH "SIEHE AUCH" .IX Header "SIEHE AUCH" \&\fBdpkg\fR\|(1), \fBmk\-origtargz\fR\|(1), \fBperlre\fR\|(1), \fBuupdate\fR\|(1), \fBdevscripts.conf\fR\|(5) .SH "AUTOR" .IX Header "AUTOR" Die Originalversion wurde von Christoph Lameter geschrieben. Bedeutende Verbesserungen, Änderungen und Fehlerbehebungen wurden von Julian Gilbey vorgenommen. Piotr Roszatycki fügte HTTP\-Unterstützung hinzu. Das Programm wurde neu in Perl von Julian Gilbey geschrieben. Xavier Guimard hat es mittels Moo in objektorientiertes Perl umgewandelt.