PKGCTL-VERSION(1)

NAME
pkgctl-version - Check and manage package versions against upstream

SYNOPSIS

pkgctl version [OPTIONS] [SUBCOMMAND]

DESCRIPTION

Commands related to package versions, including checks for outdated packages.

Uses nvchecker(1) and a .nvchecker.toml file located alongside the PKGBUILD.

CONFIGURATION

The .nvchecker.toml file must contain a section that matches the package’s pkgbase. The pkgbase section within the .nvchecker.toml file specifies the source and method for checking the latest version of the corresponding package.

Use pkgctl-version-setup(1) to automatically detect and setup a basic nvchecker config based on the source array of the package PKGBUILD.

For detailed information on the various configuration options available for the .nvchecker.toml file, refer to the configuration files section in nvchecker(1). This documentation provides insights into the possible options that can be utilized to customize the version checking process.

To supply GitHub or GitLab tokens to nvchecker, a keyfile.toml should be placed in the $XDG_CONFIG_HOME/nvchecker` directory. This keyfile is used for providing the necessary authentication tokens required for accessing the GitHub or GitLab API.

COMBINER SOURCE

To utilize the combiner source, the pkgbase section must be declared as the combiner source. Additionally, individual sections should be added using a quoted table key consisting of the pkgbase followed by the stage name, separated by double colons. For example: ["sudo:stage1"].

This allows to chain different sources together into one result, or allow multi stage transformation of our source via multiple regex.

OPTIONS

-h, --help
    Show a help text

SUBCOMMANDS

pkgctl version check
    Compares local package versions against upstream

pkgctl version setup
    Automatically detect and setup a basic nvchecker config

pkgctl version upgrade
    Adjust the PKGBUILD to match the latest upstream version

SEE ALSO

pkgctl-version-check(1) pkgctl-version-setup(1) pkgctl-version-upgrade(1)

HOMEPAGE

Please report bugs and feature requests in the issue tracker. Please do your best to provide a reproducible test case for bugs.