PKGCTL-VERSION-SETUP(1)                "               PKGCTL-VERSION-SETUP(1)

BEZEICHNUNG
       pkgctl-version-setup - Nvchecker-Konfiguration automatisch erkennen und
       grundlegend einrichten

UBERSICHT
       pkgctl version setup [OPTIONEN] [PAKETBASIS<?>]

BESCHREIBUNG
       Dieser Unterbefehl automatisiert die Erstellung einer grundlegenden
       Konfigurationsdatei von nvchecker(1), in dem das in der
       PKGBUILD(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 .nvchecker.toml,
       basierend auf einem bestmoglichen Ratevorgang.

       Dies ist insbesondere fur die Initialisierung der Einstellungen von
       nvchecker(1) fur ein Paket nutzlich, um das manuelle Erstellen einer
       .nvchecker.toml-Datei zu vermeiden. Es vereinfacht den Prozess der
       Versionsprufung, insbesondere wenn die Uberwachung eines Pakets von
       einer Quellplattform zu einer anderen ubergeleitet wird, oder die
       Versionsprufung fur ein neues Paket aufgenommen wird.

       Falls PAKETBASIS nicht festgelegt ist, ist die Vorgabe fur den Befehl
       die Verwendung des aktuellen Arbeitsverzeichnisses.

       Um eine Liste der unterstutzten Quellen und ihrer erwarteten
       URL-Formate zu erhalten, lesen Sie bitten den Abschnitt Quellen.

OPTIONEN
       -f, --force
           Uberschreibt eine bestehende nvchecker(1)-Konfiguration.

       --prefer-platform-api
           Bevorzugt Plattform-spezifisches GitHub/GitLab-API gegenuber git(1)
           fur komplexe Falle.

       --url URL
           Leitet das zu uberprufende Ziel von der angegebenen URL statt aus
           den Eintragen des Feldes >>source<< ab.

       --no-check
           Fuhrt pkgctl-version-check(1) nach der Einrichtung nicht aus.

       --no-upstream
           Richtet eine leere Konfiguration fur Pakete ohne Originalquellen
           ein, wie Meta-Pakete. Dies darf nur fur Falle ohne Originalautoren
           verwandt werden, bitte kontaktieren Sie (auf Englisch) das
           Entwickler-Team fur Hilfestellungen bei Quellen von
           Originalautoren, die schwer zu konfigurieren sind.

       -h, --help
           Zeigt einen Hilfetext an.

QUELLEN
       Es folgen die aktuell unterstutzen Plattformen und Quellen, zusammen
       mit Beispielen von URL-Formaten, die ihre automatische Erkennung als
       bestimmter Quelltyp aktivieren:

       Git

           o    <https://github.com/example/project>

           o    <https://gitlab.com/example/group/project>

           o   git://git.foobar.org/Beispiel

           o   git+https://git.foobar.org/Beispiel

       GitHub

           o    <https://github.com/example/project>

           o
               <https://github.com/example/project/archive/v1.0/project-v1.0.tar.gz>

       GitLab

           o    <https://gitlab.com/example/group/project>

           o    <https://gitlab.archlinux.org/archlinux/devtools.git>

           o
               <https://gitlab.archlinux.org/archlinux/devtools/-/releases/v1.1.0/downloads/devtools-v1.1.0.tar.gz>

       Hackage

           o    <https://hackage.haskell.org/package/xmonad>

           o
               <https://hackage.haskell.org/package/xmonad-0.18.0/xmonad-0.18.0.tar.gz>

           o
               <https://hackage.haskell.org/packages/archive/xmonad/0.18.0/xmonad-0.18.0.tar.gz>

       NPM

           o    <https://registry.npmjs.org/node-gyp/-/node-gyp-10.0.1.tgz>

           o    <https://www.npmjs.com/package/node-gyp>

       PyPI

           o    <https://pypi.io/packages/source/p/pyflakes>

           o    <https://pypi.org/packages/source/b/bleach>

           o    <https://files.pythonhosted.org/packages/source/p/pyflakes>

           o    <https://pypi.org/project/SQLAlchemy/>

       RubyGems

           o    <https://rubygems.org/downloads/diff-lcs-1.5.1.gem>

           o    <https://rubygems.org/gems/diff-lcs>

       CPAN

           o
               <https://search.cpan.org/CPAN/authors/id/C/CO/COSIMO/Locale-PO-0.27.tar.gz>

           o
               <https://cpan.metacpan.org/authors/id/C/CO/COSIMO/Locale-PO-0.27.tar.gz>

       crates.io

           o    <https://static.crates.io/crates/shotgun/shotgun-1.0.crate>

           o    <https://crates.io/api/v1/crates/shotgun/1.0/download>

           o    <https://crates.io/crates/git-smash>

BEISPIELE
       pkgctl version setup
           Erkennt die Quellen aus dem PKGBUILD(5) des aktuellen
           Verzeichnisses und richtet eine grundlegende .nvchecker.toml ein.

       pkgctl version setup --url  <https://github.com/example/project>
           Erstellt eine .nvchecker.toml fur das aktuelle PKGBUILD(5), setzt
           aber die Quell-URL mit dem angegebenen GitHub-Projekt ausser Kraft.

SIEHE AUCH
       pkgctl-version(1), pkgctl-version-check(1), nvchecker(1), PKGBUILD(5)

HOMEPAGE
         <https://gitlab.archlinux.org/archlinux/devtools>

       Bitte melden Sie Fehler und Funktionalitatswunsche auf Englisch in dem
       Fehlererfassungssystem. Bitte versuchen Sie bei Fehlern so gut wie
       moglich, einen reproduzierbaren Testfall zu erstellen.

UBERSETZUNG
       Die deutsche Ubersetzung dieser Handbuchseite wurde von Helge
       Kreutzmann <debian@helgefjell.de> erstellt.

       Diese Ubersetzung ist Freie Dokumentation; lesen Sie die GNU General
       Public License Version 3 <https://www.gnu.org/licenses/gpl-3.0.html>
       oder neuer bezuglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG
       ubernommen.

       Wenn Sie Fehler in der Ubersetzung dieser Handbuchseite finden,
       schicken Sie bitte eine E-Mail an die Mailingliste der Ubersetzer:
       <debian-l10n-german@lists.debian.org>.

 "                              28. August 2025        PKGCTL-VERSION-SETUP(1)