.\" -*- coding: UTF-8 -*-
'\" t
.\"     Title: pkgctl-version-setup
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.23
.\"      Date: 2025-08-28
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH PKGCTL\-VERSION\-SETUP 1 "28. August 2025" "\ \(dq " \ \(dq
.ie  \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de  URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if  \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH BEZEICHNUNG
pkgctl\-version\-setup \- Nvchecker\-Konfiguration automatisch erkennen und
grundlegend einrichten
.SH ÜBERSICHT
.sp
\fBpkgctl version setup\fP [\fIOPTIONEN\fP] [\fIPAKETBASIS…\fP]
.SH BESCHREIBUNG
.sp
Dieser Unterbefehl automatisiert die Erstellung einer grundlegenden
Konfigurationsdatei von \fBnvchecker\fP(1), in dem das in der
\fBPKGBUILD\fP(5)\-Datei spezifizierte Feld »source« eines Pakets untersucht
wird. Dieser Befehl erkennt intelligent verschiedene Plattformen und APIs
(z.B. GitHub, GitLab, PyPI), die von den Paketquellen verwandt werden, und
erstellt eine entsprechende Konfiguration \fI.nvchecker.toml\fP, basierend auf
einem bestmöglichen Ratevorgang.
.sp
Dies ist insbesondere für die Initialisierung der Einstellungen von
\fBnvchecker\fP(1) für ein Paket nützlich, um das manuelle Erstellen einer
\&\fI.nvchecker.toml\fP\-Datei zu vermeiden. Es vereinfacht den Prozess der
Versionsprüfung, insbesondere wenn die Überwachung eines Pakets von einer
Quellplattform zu einer anderen übergeleitet wird, oder die Versionsprüfung
für ein neues Paket aufgenommen wird.
.sp
Falls \fIPAKETBASIS\fP nicht festgelegt ist, ist die Vorgabe für den Befehl die
Verwendung des aktuellen Arbeitsverzeichnisses.
.sp
Um eine Liste der unterstützten Quellen und ihrer erwarteten URL\-Formate zu
erhalten, lesen Sie bitten den Abschnitt Quellen.
.SH OPTIONEN
.sp
\fB\-f\fP, \fB\-\-force\fP
.RS 4
Überschreibt eine bestehende \fBnvchecker\fP(1)\-Konfiguration.
.RE
.sp
\fB\-\-prefer\-platform\-api\fP
.RS 4
Bevorzugt Plattform\-spezifisches GitHub/GitLab\-API gegenüber \fBgit\fP(1) für
komplexe Fälle.
.RE
.sp
\fB\-\-url\fP \fIURL\fP
.RS 4
Leitet das zu überprüfende Ziel von der angegebenen URL statt aus den
Einträgen des Feldes »source« ab.
.RE
.sp
\fB\-\-no\-check\fP
.RS 4
Führt \fBpkgctl\-version\-check\fP(1) nach der Einrichtung nicht aus.
.RE
.sp
\fB\-\-no\-upstream\fP
.RS 4
Richtet eine leere Konfiguration für Pakete ohne Originalquellen ein, wie
Meta\-Pakete. Dies darf nur für Fälle ohne Originalautoren verwandt werden,
bitte kontaktieren Sie (auf Englisch) das Entwickler\-Team für
Hilfestellungen bei Quellen von Originalautoren, die schwer zu konfigurieren
sind.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
Zeigt einen Hilfetext an.
.RE
.SH QUELLEN
.sp
Es folgen die aktuell unterstützen Plattformen und Quellen, zusammen mit
Beispielen von URL\-Formaten, die ihre automatische Erkennung als bestimmter
Quelltyp aktivieren:
.sp
\fBGit\fP
.RS 4
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://github.com/example/project" "" ""
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://gitlab.com/example/group/project" "" ""
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
git://git.foobar.org/Beispiel
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
git+https://git.foobar.org/Beispiel
.RE
.RE
.sp
\fBGitHub\fP
.RS 4
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://github.com/example/project" "" ""
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://github.com/example/project/archive/v1.0/project\-v1.0.tar.gz" "" ""
.RE
.RE
.sp
\fBGitLab\fP
.RS 4
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://gitlab.com/example/group/project" "" ""
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://gitlab.archlinux.org/archlinux/devtools.git" "" ""
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://gitlab.archlinux.org/archlinux/devtools/\-/releases/v1.1.0/downloads/devtools\-v1.1.0.tar.gz" "" ""
.RE
.RE
.sp
\fBHackage\fP
.RS 4
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://hackage.haskell.org/package/xmonad" "" ""
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://hackage.haskell.org/package/xmonad\-0.18.0/xmonad\-0.18.0.tar.gz" "" ""
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://hackage.haskell.org/packages/archive/xmonad/0.18.0/xmonad\-0.18.0.tar.gz" "" ""
.RE
.RE
.sp
\fBNPM\fP
.RS 4
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://registry.npmjs.org/node\-gyp/\-/node\-gyp\-10.0.1.tgz" "" ""
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://www.npmjs.com/package/node\-gyp" "" ""
.RE
.RE
.sp
\fBPyPI\fP
.RS 4
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://pypi.io/packages/source/p/pyflakes" "" ""
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://pypi.org/packages/source/b/bleach" "" ""
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://files.pythonhosted.org/packages/source/p/pyflakes" "" ""
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://pypi.org/project/SQLAlchemy/" "" ""
.RE
.RE
.sp
\fBRubyGems\fP
.RS 4
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://rubygems.org/downloads/diff\-lcs\-1.5.1.gem" "" ""
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://rubygems.org/gems/diff\-lcs" "" ""
.RE
.RE
.sp
\fBCPAN\fP
.RS 4
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://search.cpan.org/CPAN/authors/id/C/CO/COSIMO/Locale\-PO\-0.27.tar.gz" "" ""
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://cpan.metacpan.org/authors/id/C/CO/COSIMO/Locale\-PO\-0.27.tar.gz" "" ""
.RE
.RE
.sp
\fBcrates.io\fP
.RS 4
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://static.crates.io/crates/shotgun/shotgun\-1.0.crate" "" ""
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://crates.io/api/v1/crates/shotgun/1.0/download" "" ""
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
.URL "https://crates.io/crates/git\-smash" "" ""
.RE
.RE
.SH BEISPIELE
.sp
\fBpkgctl version setup\fP
.RS 4
Erkennt die Quellen aus dem \fBPKGBUILD\fP(5) des aktuellen Verzeichnisses und
richtet eine grundlegende \fI.nvchecker.toml\fP ein.
.RE
.sp
\fBpkgctl version setup \-\-url
.URL "https://github.com/example/project" "" "\fP"
\fP
.RS 4
Erstellt eine \fI.nvchecker.toml\fP für das aktuelle \fBPKGBUILD\fP(5), setzt aber
die Quell\-URL mit dem angegebenen GitHub\-Projekt außer Kraft.
.RE
.SH "SIEHE AUCH"
.sp
\fBpkgctl\-version\fP(1), \fBpkgctl\-version\-check\fP(1), \fBnvchecker\fP(1),
\fBPKGBUILD\fP(5)
.SH HOMEPAGE
.sp
\fI
.URL "https://gitlab.archlinux.org/archlinux/devtools" "" "\fP"
\fP
.sp
\fIBitte melden Sie Fehler und Funktionalitätswünsche auf Englisch in dem Fehlererfassungssystem. Bitte versuchen Sie bei Fehlern so gut wie möglich, einen reproduzierbaren Testfall zu erstellen.\fP
.PP
.SH ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von
Helge Kreutzmann <debian@helgefjell.de>
erstellt.
.PP
Diese Übersetzung ist Freie Dokumentation; lesen Sie die
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License Version 3
.UE
oder neuer bezüglich der
Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.
.PP
Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden,
schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer:
.MT debian-l10n-german@lists.debian.org
.ME .