Send patches - preferably formatted by git format-patch - to patches at archlinux32 dot org.
summaryrefslogtreecommitdiff
path: root/doc/man
diff options
context:
space:
mode:
Diffstat (limited to 'doc/man')
-rw-r--r--doc/man/arch-nspawn.1.asciidoc5
-rw-r--r--doc/man/archbuild.1.asciidoc2
-rw-r--r--doc/man/checkpkg.1.asciidoc2
-rw-r--r--doc/man/devtools.7.asciidoc28
-rw-r--r--doc/man/lddd.1.asciidoc2
-rw-r--r--doc/man/makechrootpkg.1.asciidoc7
-rw-r--r--doc/man/makerepropkg.1.asciidoc2
-rw-r--r--doc/man/mkarchroot.1.asciidoc5
-rw-r--r--doc/man/pkgctl-aur-drop-from-repo.1.asciidoc2
-rw-r--r--doc/man/pkgctl-aur.1.asciidoc2
-rw-r--r--doc/man/pkgctl-auth-login.1.asciidoc2
-rw-r--r--doc/man/pkgctl-auth-status.1.asciidoc2
-rw-r--r--doc/man/pkgctl-auth.1.asciidoc4
-rw-r--r--doc/man/pkgctl-build.1.asciidoc7
-rw-r--r--doc/man/pkgctl-db-remove.1.asciidoc18
-rw-r--r--doc/man/pkgctl-db-update.1.asciidoc2
-rw-r--r--doc/man/pkgctl-db.1.asciidoc43
-rw-r--r--doc/man/pkgctl-release.1.asciidoc2
-rw-r--r--doc/man/pkgctl-repo-clean.1.asciidoc40
-rw-r--r--doc/man/pkgctl-repo-clone.1.asciidoc4
-rw-r--r--doc/man/pkgctl-repo-create.1.asciidoc6
-rw-r--r--doc/man/pkgctl-repo.1.asciidoc14
-rw-r--r--doc/man/pkgctl-search.1.asciidoc2
-rw-r--r--doc/man/pkgctl-version-check.1.asciidoc8
-rw-r--r--doc/man/pkgctl-version-setup.1.asciidoc120
-rw-r--r--doc/man/pkgctl-version-upgrade.1.asciidoc13
-rw-r--r--doc/man/pkgctl-version.1.asciidoc15
-rw-r--r--doc/man/pkgctl.1.asciidoc25
28 files changed, 315 insertions, 69 deletions
diff --git a/doc/man/arch-nspawn.1.asciidoc b/doc/man/arch-nspawn.1.asciidoc
index a3e8ec1..ae6532b 100644
--- a/doc/man/arch-nspawn.1.asciidoc
+++ b/doc/man/arch-nspawn.1.asciidoc
@@ -28,8 +28,9 @@ Options
*-c* <dir>::
Set pacman cache, if no directory is specified the passed pacman.conf's cachedir is used with a fallback to '/etc/pacman.conf'
-*-f* <file>::
- Copy file from the host to the chroot
+*-f* <src>[:<dst>]::
+ Copy file from the host to the chroot.
+ If 'dst' is not provided, it defaults to 'src' inside of the chroot.
*-s*::
Do not run setarch
diff --git a/doc/man/archbuild.1.asciidoc b/doc/man/archbuild.1.asciidoc
index 2a2d843..9c1973d 100644
--- a/doc/man/archbuild.1.asciidoc
+++ b/doc/man/archbuild.1.asciidoc
@@ -43,6 +43,6 @@ Options
See Also
--------
-linkman:devtools[7]
+devtools(7)
include::include/footer.asciidoc[]
diff --git a/doc/man/checkpkg.1.asciidoc b/doc/man/checkpkg.1.asciidoc
index bd41416..4be3ae8 100644
--- a/doc/man/checkpkg.1.asciidoc
+++ b/doc/man/checkpkg.1.asciidoc
@@ -38,6 +38,6 @@ Options
See Also
--------
-linkman:find-libprovides[1]
+find-libprovides(1)
include::include/footer.asciidoc[]
diff --git a/doc/man/devtools.7.asciidoc b/doc/man/devtools.7.asciidoc
index 4ed11cf..9156d50 100644
--- a/doc/man/devtools.7.asciidoc
+++ b/doc/man/devtools.7.asciidoc
@@ -21,47 +21,47 @@ Programs
The list below gives a short overview; see the respective documentation
for details.
-linkman:pkgctl[1]
+pkgctl(1)
Unified command-line frontend for devtools
-linkman:archbuild[1]
+archbuild(1)
Build an Arch Linux package inside a clean chroot
-linkman:arch-nspawn[1]
+arch-nspawn(1)
Run a command or OS in a light-weight namespace container
-linkman:checkpkg[1]
+checkpkg(1)
Compare the current build package with the repository version
-linkman:diffpkg[1]
+diffpkg(1)
Compare package files using different modes
-linkman:export-pkgbuild-keys[1]
+export-pkgbuild-keys(1)
Export valid source signing keys from a PKGBUILD
-linkman:find-libdeps[1]
+find-libdeps(1)
Find soname dependencies for a package
-linkman:find-libprovides[1]
+find-libprovides(1)
Find soname's which are provided by a package
-linkman:lddd[1]
+lddd(1)
Find broken library links on your system
-linkman:mkarchroot[1]
+mkarchroot(1)
Creates an arch chroot in a specified location with a specified set of
packages
-linkman:makechrootpkg[1]
+makechrootpkg(1)
Build a PKGBUILD in a given chroot environment
-linkman:makerepropkg[1]
+makerepropkg(1)
Rebuild a package to see if it is reproducible
-linkman:offload-build[1]
+offload-build(1)
Build a PKGBUILD on a remote server using makechrootpkg
-linkman:sogrep[1]
+sogrep(1)
Find packages using a linked to a given shared library
include::include/footer.asciidoc[]
diff --git a/doc/man/lddd.1.asciidoc b/doc/man/lddd.1.asciidoc
index c6bff26..f3eed9d 100644
--- a/doc/man/lddd.1.asciidoc
+++ b/doc/man/lddd.1.asciidoc
@@ -20,6 +20,6 @@ collected data is written to a temporary directory created by mktemp.
See Also
--------
-linkman:ldd[1]
+ldd(1)
include::include/footer.asciidoc[]
diff --git a/doc/man/makechrootpkg.1.asciidoc b/doc/man/makechrootpkg.1.asciidoc
index 3aa1be5..34ba199 100644
--- a/doc/man/makechrootpkg.1.asciidoc
+++ b/doc/man/makechrootpkg.1.asciidoc
@@ -45,6 +45,9 @@ Options
*-D* <dir>::
Bind directory into build chroot as read-only
+*-t* <dir>[:opts]::
+ Mount a tmpfs at 'dir'. See the '--tmpfs' argument in systemd-nspawn(1) for more details.
+
*-u*::
Update the working copy of the chroot before building
This is useful for rebuilds without dirtying the pristine
@@ -76,5 +79,9 @@ Options
*-x* <when>::
Inspect chroot after build, possible modes are 'never' (default), 'always' or 'failure'
+See Also
+--------
+
+systemd-nspawn(1)
include::include/footer.asciidoc[]
diff --git a/doc/man/makerepropkg.1.asciidoc b/doc/man/makerepropkg.1.asciidoc
index 51a81ff..e2a0bbb 100644
--- a/doc/man/makerepropkg.1.asciidoc
+++ b/doc/man/makerepropkg.1.asciidoc
@@ -16,7 +16,7 @@ Given the path to a built pacman package(s), attempt to rebuild it using the
PKGBUILD in the current directory. The package will be built in an environment
as closely matching the environment of the initial package as possible, by
building up a chroot to match the information exposed in the package's
-linkman:BUILDINFO[5] manifest. On success, the resulting package will be
+BUILDINFO(5) manifest. On success, the resulting package will be
compared to the input package, and makerepropkg will report whether the
artifacts are identical.
diff --git a/doc/man/mkarchroot.1.asciidoc b/doc/man/mkarchroot.1.asciidoc
index a435852..edbb17e 100644
--- a/doc/man/mkarchroot.1.asciidoc
+++ b/doc/man/mkarchroot.1.asciidoc
@@ -32,8 +32,9 @@ Options
*-c* <dir>::
Set pacman cache.
-*-f* <file>::
+*-f* <src>[:<dst>]::
Copy file from the host to the chroot.
+ If 'dst' is not provided, it defaults to 'src' inside of the chroot.
*-s*::
Do not run setarch.
@@ -44,6 +45,6 @@ Options
See Also
--------
-linkman:pacman[1]
+pacman(1)
include::include/footer.asciidoc[]
diff --git a/doc/man/pkgctl-aur-drop-from-repo.1.asciidoc b/doc/man/pkgctl-aur-drop-from-repo.1.asciidoc
index a9d39c6..0b17f3b 100644
--- a/doc/man/pkgctl-aur-drop-from-repo.1.asciidoc
+++ b/doc/man/pkgctl-aur-drop-from-repo.1.asciidoc
@@ -36,6 +36,6 @@ Options
See Also
--------
-linkman:pkgctl-db-remove[1]
+pkgctl-db-remove(1)
include::include/footer.asciidoc[]
diff --git a/doc/man/pkgctl-aur.1.asciidoc b/doc/man/pkgctl-aur.1.asciidoc
index d69124a..a42f611 100644
--- a/doc/man/pkgctl-aur.1.asciidoc
+++ b/doc/man/pkgctl-aur.1.asciidoc
@@ -32,6 +32,6 @@ pkgctl aur drop-from-repo::
See Also
--------
-linkman:pkgctl-aur-drop-from-repo[1]
+pkgctl-aur-drop-from-repo(1)
include::include/footer.asciidoc[]
diff --git a/doc/man/pkgctl-auth-login.1.asciidoc b/doc/man/pkgctl-auth-login.1.asciidoc
index eeeec4e..0383c7e 100644
--- a/doc/man/pkgctl-auth-login.1.asciidoc
+++ b/doc/man/pkgctl-auth-login.1.asciidoc
@@ -35,6 +35,6 @@ Options
See Also
--------
-linkman:pkgctl-auth-status[1]
+pkgctl-auth-status(1)
include::include/footer.asciidoc[]
diff --git a/doc/man/pkgctl-auth-status.1.asciidoc b/doc/man/pkgctl-auth-status.1.asciidoc
index e23ee2e..e71d5ac 100644
--- a/doc/man/pkgctl-auth-status.1.asciidoc
+++ b/doc/man/pkgctl-auth-status.1.asciidoc
@@ -27,6 +27,6 @@ Options
See Also
--------
-linkman:pkgctl-auth-login[1]
+pkgctl-auth-login(1)
include::include/footer.asciidoc[]
diff --git a/doc/man/pkgctl-auth.1.asciidoc b/doc/man/pkgctl-auth.1.asciidoc
index 4912b02..d4ecf50 100644
--- a/doc/man/pkgctl-auth.1.asciidoc
+++ b/doc/man/pkgctl-auth.1.asciidoc
@@ -32,7 +32,7 @@ pkgctl auth status::
See Also
--------
-linkman:pkgctl-auth-login[1]
-linkman:pkgctl-auth-status[1]
+pkgctl-auth-login(1)
+pkgctl-auth-status(1)
include::include/footer.asciidoc[]
diff --git a/doc/man/pkgctl-build.1.asciidoc b/doc/man/pkgctl-build.1.asciidoc
index f7abdeb..beb6ee4 100644
--- a/doc/man/pkgctl-build.1.asciidoc
+++ b/doc/man/pkgctl-build.1.asciidoc
@@ -12,7 +12,8 @@ pkgctl build [OPTIONS] [PATH...]
Description
-----------
-TODO
+Build packages in clean chroot environment, offering various options
+and functionalities to customize the package building process.
Build Options
-------------
@@ -107,7 +108,7 @@ Options
See Also
--------
-linkman:pkgctl-release[1]
-linkman:pkgctl-db-update[1]
+pkgctl-release(1)
+pkgctl-db-update(1)
include::include/footer.asciidoc[]
diff --git a/doc/man/pkgctl-db-remove.1.asciidoc b/doc/man/pkgctl-db-remove.1.asciidoc
index a95766d..85f616b 100644
--- a/doc/man/pkgctl-db-remove.1.asciidoc
+++ b/doc/man/pkgctl-db-remove.1.asciidoc
@@ -12,13 +12,27 @@ pkgctl db remove [OPTIONS] [REPO] [PKGBASE]...
Description
-----------
-Remove packages from pacman repositories.
+Remove packages from pacman repositories. By default passing a pkgbase removes
+all split packages, debug packages as well as entries from the state repo for
+all existing architectures.
+
+Beware when using the `--partial` option, as it may most likely lead to
+undesired effects by leaving debug packages behind as well as dangling entries
+in the state repository.
Options
-------
+*--partial*::
+ Remove only partial pkgnames from a split package. This leaves debug
+ packages behind and pkgbase entries in the state repo.
+
*-a, --arch* 'ARCH'::
- Override the architecture (disables auto-detection)
+ Remove only one specific architecture (disables auto-detection).
+ By default all architectures are removed when this option is not used.
+
+*--noconfirm*::
+ Bypass any confirmation messages, should only be used with caution.
*-h, --help*::
Show a help text
diff --git a/doc/man/pkgctl-db-update.1.asciidoc b/doc/man/pkgctl-db-update.1.asciidoc
index ce73c01..02f92a3 100644
--- a/doc/man/pkgctl-db-update.1.asciidoc
+++ b/doc/man/pkgctl-db-update.1.asciidoc
@@ -1,5 +1,5 @@
pkgctl-db-update(1)
-=================
+===================
Name
----
diff --git a/doc/man/pkgctl-db.1.asciidoc b/doc/man/pkgctl-db.1.asciidoc
new file mode 100644
index 0000000..d3296c6
--- /dev/null
+++ b/doc/man/pkgctl-db.1.asciidoc
@@ -0,0 +1,43 @@
+pkgctl-db(1)
+============
+
+NAME
+----
+pkgctl-db - Pacman database modification utility for package updates, moves, and more.
+
+SYNOPSIS
+--------
+pkgctl db [OPTIONS] [SUBCOMMAND]
+
+DESCRIPTION
+-----------
+
+Managing the Pacman database and facilitate the modification of packages and their metadata
+within the database
+
+OPTIONS
+-------
+
+*-h, --help*::
+ Display usage information and available options.
+
+Subcommands
+-----------
+
+pkgctl db update::
+ Update the binary repository as final release step
+
+pkgctl db move::
+ Move packages between binary repositories
+
+pkgctl db remove::
+ Remove packages from binary repositories
+
+SEE ALSO
+--------
+
+pkgctl-db-update(1)
+pkgctl-db-move(1)
+pkgctl-db-remove(1)
+
+include::include/footer.asciidoc[]
diff --git a/doc/man/pkgctl-release.1.asciidoc b/doc/man/pkgctl-release.1.asciidoc
index 01a0c9e..b114b01 100644
--- a/doc/man/pkgctl-release.1.asciidoc
+++ b/doc/man/pkgctl-release.1.asciidoc
@@ -46,6 +46,6 @@ Options
See Also
--------
-linkman:pkgctl-db-update[1]
+pkgctl-db-update(1)
include::include/footer.asciidoc[]
diff --git a/doc/man/pkgctl-repo-clean.1.asciidoc b/doc/man/pkgctl-repo-clean.1.asciidoc
new file mode 100644
index 0000000..b39693c
--- /dev/null
+++ b/doc/man/pkgctl-repo-clean.1.asciidoc
@@ -0,0 +1,40 @@
+pkgctl-repo-clean(1)
+====================
+
+Name
+----
+
+pkgctl-repo-clean - Remove untracked files from the working tree
+
+Synopsis
+--------
+
+pkgctl repo clean [OPTION] [PATH]...
+
+Description
+-----------
+
+Cleans the working tree by recursively removing files that are not under
+version control, starting from the current directory.
+
+Files unknown to Git as well as ignored files are removed. This can, for
+example, be useful to remove all build products.
+
+Options
+-------
+
+*-i, --interactive*::
+ Show what would be done and clean files interactively
+
+*-n, --dry-run*::
+ Don't actually remove anything, just show what would be done
+
+*-h, --help*::
+ Show a help text
+
+See Also
+--------
+
+git-clean(1)
+
+include::include/footer.asciidoc[]
diff --git a/doc/man/pkgctl-repo-clone.1.asciidoc b/doc/man/pkgctl-repo-clone.1.asciidoc
index 421c71f..3ed218c 100644
--- a/doc/man/pkgctl-repo-clone.1.asciidoc
+++ b/doc/man/pkgctl-repo-clone.1.asciidoc
@@ -46,7 +46,7 @@ Options
See Also
--------
-linkman:pkgctl-repo-configure[1]
-linkman:pkgctl-repo-switch[1]
+pkgctl-repo-configure(1)
+pkgctl-repo-switch(1)
include::include/footer.asciidoc[]
diff --git a/doc/man/pkgctl-repo-create.1.asciidoc b/doc/man/pkgctl-repo-create.1.asciidoc
index 7c58776..f2606cc 100644
--- a/doc/man/pkgctl-repo-create.1.asciidoc
+++ b/doc/man/pkgctl-repo-create.1.asciidoc
@@ -33,8 +33,8 @@ Options
See Also
--------
-linkman:pkgctl-auth[1]
-linkman:pkgctl-repo-clone[1]
-linkman:pkgctl-repo-configure[1]
+pkgctl-auth(1)
+pkgctl-repo-clone(1)
+pkgctl-repo-configure(1)
include::include/footer.asciidoc[]
diff --git a/doc/man/pkgctl-repo.1.asciidoc b/doc/man/pkgctl-repo.1.asciidoc
index 57be170..c1fd298 100644
--- a/doc/man/pkgctl-repo.1.asciidoc
+++ b/doc/man/pkgctl-repo.1.asciidoc
@@ -32,6 +32,9 @@ Options
Subcommands
-----------
+pkgctl repo clean::
+ Remove untracked files from the working tree
+
pkgctl repo clone::
Clone a package repository
@@ -50,10 +53,11 @@ pkgctl repo web::
See Also
--------
-linkman:pkgctl-repo-clone[1]
-linkman:pkgctl-repo-configure[1]
-linkman:pkgctl-repo-create[1]
-linkman:pkgctl-repo-switch[1]
-linkman:pkgctl-repo-web[1]
+pkgctl-repo-clean(1)
+pkgctl-repo-clone(1)
+pkgctl-repo-configure(1)
+pkgctl-repo-create(1)
+pkgctl-repo-switch(1)
+pkgctl-repo-web(1)
include::include/footer.asciidoc[]
diff --git a/doc/man/pkgctl-search.1.asciidoc b/doc/man/pkgctl-search.1.asciidoc
index 8172b00..4df8db1 100644
--- a/doc/man/pkgctl-search.1.asciidoc
+++ b/doc/man/pkgctl-search.1.asciidoc
@@ -66,6 +66,6 @@ Output Options
See Also
--------
-linkman:pkgctl-auth[1]
+pkgctl-auth(1)
include::include/footer.asciidoc[]
diff --git a/doc/man/pkgctl-version-check.1.asciidoc b/doc/man/pkgctl-version-check.1.asciidoc
index 2543bcb..53e80db 100644
--- a/doc/man/pkgctl-version-check.1.asciidoc
+++ b/doc/man/pkgctl-version-check.1.asciidoc
@@ -28,8 +28,8 @@ required to track version changes from upstream sources.
Configuration
-------------
-Uses linkman:nvchecker[1] and a `.nvchecker.toml` file located alongside the
-PKGBUILD. Refer to the configuration section in linkman:pkgctl-version[1].
+Uses nvchecker(1) and a `.nvchecker.toml` file located alongside the
+PKGBUILD. Refer to the configuration section in pkgctl-version(1).
Options
-------
@@ -60,7 +60,7 @@ On exit, return one of the following codes:
See Also
--------
-linkman:pkgctl-version[1]
-linkman:nvchecker[1]
+pkgctl-version(1)
+nvchecker(1)
include::include/footer.asciidoc[]
diff --git a/doc/man/pkgctl-version-setup.1.asciidoc b/doc/man/pkgctl-version-setup.1.asciidoc
new file mode 100644
index 0000000..81ef008
--- /dev/null
+++ b/doc/man/pkgctl-version-setup.1.asciidoc
@@ -0,0 +1,120 @@
+pkgctl-version-setup(1)
+=======================
+
+Name
+----
+pkgctl-version-setup - Automatically detect and setup a basic nvchecker config
+
+Synopsis
+--------
+pkgctl version setup [OPTIONS] [PKGBASE...]
+
+Description
+-----------
+
+This subcommand automates the creation of a basic nvchecker(1) configuration
+file by analyzing the source array specified in the PKGBUILD(1) file of a
+package. This command intelligently detects various platforms and APIs (e.g.,
+GitHub, GitLab, PyPI) used by the package sources and generates a corresponding
+`.nvchecker.toml` configuration based on its best guess.
+
+This is particularly useful for initializing nvchecker(1) settings for a
+package without manually crafting the `.nvchecker.toml` file. It simplifies the
+process of setting up version checks, especially when transitioning a package's
+monitoring from one source platform to another or starting version checks for a
+new package.
+
+If no `PKGBASE` is specified, the command defaults to using the current working
+directory.
+
+To obtain a list of supported sources and their expected URL formats, please
+consult the sources section.
+
+Options
+-------
+
+*-f, --force*::
+ Overwrite existing nvchecker(1) configuration
+
+*--prefer-platform-api*::
+ Prefer platform specific GitHub/GitLab API over git for complex cases
+
+*--url* 'URL'::
+ Derive check target from the given URL instead of the source array entries
+
+
+*--no-check*::
+ Do not run pkgctl-version-check(1) after setup
+
+*-h, --help*::
+ Show a help text
+
+Sources
+-------
+
+Here are the currently supported platforms and sources, along with examples of
+URL formats that enable their automatic detection as specific source types:
+
+*Git*::
+ * https://github.com/example/project
+ * https://gitlab.com/example/group/project
+ * git://git.foobar.org/example
+ * git+https://git.foobar.org/example
+
+*GitHub*::
+ * https://github.com/example/project
+ * https://github.com/example/project/archive/v1.0/project-v1.0.tar.gz
+
+*GitLab*::
+ * https://gitlab.com/example/group/project
+ * https://gitlab.archlinux.org/archlinux/devtools.git
+ * https://gitlab.archlinux.org/archlinux/devtools/-/releases/v1.1.0/downloads/devtools-v1.1.0.tar.gz
+
+*Hackage*::
+ * https://hackage.haskell.org/package/xmonad
+ * https://hackage.haskell.org/package/xmonad-0.18.0/xmonad-0.18.0.tar.gz
+ * https://hackage.haskell.org/packages/archive/xmonad/0.18.0/xmonad-0.18.0.tar.gz
+
+*NPM*::
+ * https://registry.npmjs.org/node-gyp/-/node-gyp-10.0.1.tgz
+ * https://www.npmjs.com/package/node-gyp
+
+*PyPI*::
+ * https://pypi.io/packages/source/p/pyflakes
+ * https://pypi.org/packages/source/b/bleach
+ * https://files.pythonhosted.org/packages/source/p/pyflakes
+ * https://pypi.org/project/SQLAlchemy/
+
+*RubyGems*::
+ * https://rubygems.org/downloads/diff-lcs-1.5.1.gem
+ * https://rubygems.org/gems/diff-lcs
+
+*CPAN*::
+ * https://search.cpan.org/CPAN/authors/id/C/CO/COSIMO/Locale-PO-0.27.tar.gz
+ * https://cpan.metacpan.org/authors/id/C/CO/COSIMO/Locale-PO-0.27.tar.gz
+
+*crates.io*::
+ * https://static.crates.io/crates/shotgun/shotgun-1.0.crate
+ * https://crates.io/api/v1/crates/shotgun/1.0/download
+ * https://crates.io/crates/git-smash
+
+Examples
+--------
+
+*pkgctl version setup*::
+ Detects the source from the current directory's PKGBUILD(1) and
+ sets up a basic `.nvchecker.toml`.
+
+*pkgctl version setup --url https://github.com/example/project*::
+ Generates an `.nvchecker.toml` for the current PKGBUILD(1) but
+ overrides the source URL with the specified GitHub project.
+
+See Also
+--------
+
+pkgctl-version(1)
+pkgctl-version-check(1)
+nvchecker(1)
+PKGBUILD(5)
+
+include::include/footer.asciidoc[]
diff --git a/doc/man/pkgctl-version-upgrade.1.asciidoc b/doc/man/pkgctl-version-upgrade.1.asciidoc
index 68e6369..0cec0b6 100644
--- a/doc/man/pkgctl-version-upgrade.1.asciidoc
+++ b/doc/man/pkgctl-version-upgrade.1.asciidoc
@@ -18,7 +18,7 @@ upstream versions.
Upon execution, it automatically adjusts the PKGBUILD file, ensuring that the
pkgver field is set to match the latest version available from the upstream
source. In addition to updating the pkgver, this command also resets the pkgrel
-to 1.
+to 1 and updates checksums.
Outputs a summary of upgraded packages, up-to-date packages, and any check
failures.
@@ -29,12 +29,15 @@ required to track and implement version changes from upstream sources.
Configuration
-------------
-Uses linkman:nvchecker[1] and a `.nvchecker.toml` file located alongside the
-PKGBUILD. Refer to the configuration section in linkman:pkgctl-version[1].
+Uses nvchecker(1) and a `.nvchecker.toml` file located alongside the
+PKGBUILD. Refer to the configuration section in pkgctl-version(1).
Options
-------
+*--no-update-checksums*::
+ Disable computation and update of the checksums
+
*-v, --verbose*::
Display results including up-to-date versions
@@ -44,7 +47,7 @@ Options
See Also
--------
-linkman:pkgctl-version[1]
-linkman:nvchecker[1]
+pkgctl-version(1)
+nvchecker(1)
include::include/footer.asciidoc[]
diff --git a/doc/man/pkgctl-version.1.asciidoc b/doc/man/pkgctl-version.1.asciidoc
index fa83314..a72173b 100644
--- a/doc/man/pkgctl-version.1.asciidoc
+++ b/doc/man/pkgctl-version.1.asciidoc
@@ -15,7 +15,7 @@ Description
Commands related to package versions, including checks for outdated packages.
-Uses linkman:nvchecker[1] and a `.nvchecker.toml` file located alongside the
+Uses nvchecker(1) and a `.nvchecker.toml` file located alongside the
PKGBUILD.
Configuration
@@ -26,9 +26,12 @@ 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
-linkman:nvchecker[1]. This documentation provides insights into the possible
+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
@@ -48,13 +51,17 @@ 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
--------
-linkman:pkgctl-version-check[1]
-linkman:pkgctl-version-upgrade[1]
+pkgctl-version-check(1)
+pkgctl-version-setup(1)
+pkgctl-version-upgrade(1)
include::include/footer.asciidoc[]
diff --git a/doc/man/pkgctl.1.asciidoc b/doc/man/pkgctl.1.asciidoc
index d9a1d8c..287a62a 100644
--- a/doc/man/pkgctl.1.asciidoc
+++ b/doc/man/pkgctl.1.asciidoc
@@ -12,7 +12,12 @@ pkgctl [SUBCOMMAND] [OPTIONS]
Description
-----------
-TODO
+Command-line utility serving as a unified interface for multiple development tools.
+This tool aims to simplify and optimize interactions with devtools by offering
+various subcommands for executing tasks related to package management, repository management,
+version control, among others.
+
+Utilizing pkgctl enables users to efficiently administer their development workflows.
Options
-------
@@ -56,14 +61,14 @@ pkgctl version::
See Also
--------
-linkman:pkgctl-aur[1]
-linkman:pkgctl-auth[1]
-linkman:pkgctl-build[1]
-linkman:pkgctl-db[1]
-linkman:pkgctl-diff[1]
-linkman:pkgctl-release[1]
-linkman:pkgctl-repo[1]
-linkman:pkgctl-search[1]
-linkman:pkgctl-version[1]
+pkgctl-aur(1)
+pkgctl-auth(1)
+pkgctl-build(1)
+pkgctl-db(1)
+pkgctl-diff(1)
+pkgctl-release(1)
+pkgctl-repo(1)
+pkgctl-search(1)
+pkgctl-version(1)
include::include/footer.asciidoc[]