From d3a6c9ffd77beca67dff86ed56e0f40c3d15c71a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Gero=20Schw=C3=A4ricke?= Date: Wed, 29 Jul 2026 11:24:27 +0200 Subject: [PATCH 1/4] Manual: fix formatting on distfiles example --- Manual.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Manual.md b/Manual.md index e85cfb57d284be..9c55e7e06e05b1 100644 --- a/Manual.md +++ b/Manual.md @@ -512,7 +512,7 @@ can be separated by whitespaces. The files must end in `.tar.lzma`, `.tar.xz`, `.txz`, `.tar.bz2`, `.tbz`, `.tar.gz`, `.tgz`, `.gz`, `.bz2`, `.tar` or `.zip`. To define a target filename, append `>filename` to the URL. Example: - distfiles="http://foo.org/foo-1.0.tar.gz http://foo.org/bar-1.0.tar.gz>bar.tar.gz" +`distfiles="http://foo.org/foo-1.0.tar.gz http://foo.org/bar-1.0.tar.gz>bar.tar.gz"`. To avoid repetition, several variables for common hosting sites exist: From 67bfc3589f49407451340dc9f12b4124edb1a160 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Gero=20Schw=C3=A4ricke?= Date: Wed, 29 Jul 2026 11:27:27 +0200 Subject: [PATCH 2/4] Manual: use real checksum example and drop quotes Quotes are only used when specifying multiple checksums. --- Manual.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/Manual.md b/Manual.md index 9c55e7e06e05b1..047582d4ebccc7 100644 --- a/Manual.md +++ b/Manual.md @@ -536,7 +536,8 @@ Example: - `checksum` The `sha256` digests matching `${distfiles}`. Multiple files can be separated by blanks. Please note that the order must be the same than -was used in `${distfiles}`. Example: `checksum="kkas00xjkjas"` +was used in `${distfiles}`. +Example: `checksum=ee43eb65b005b1adf2914a8e462466d0cc4b4b639bf7ba1e62741f2ab2a6fb0f`. If a distfile changes its checksum for every download because it is packaged on the fly on the server, like e.g. snapshot tarballs from any of the From d530faa2e2cea19dfe1e186c1eb8b0abc63bd01d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Gero=20Schw=C3=A4ricke?= Date: Tue, 28 Jul 2026 11:28:12 +0200 Subject: [PATCH 3/4] Manual: add manual checksum command --- Manual.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/Manual.md b/Manual.md index 047582d4ebccc7..6b9764c640b937 100644 --- a/Manual.md +++ b/Manual.md @@ -536,7 +536,8 @@ Example: - `checksum` The `sha256` digests matching `${distfiles}`. Multiple files can be separated by blanks. Please note that the order must be the same than -was used in `${distfiles}`. +was used in `${distfiles}`. You can manually generate the checksum using +`xbps-digest `. Example: `checksum=ee43eb65b005b1adf2914a8e462466d0cc4b4b639bf7ba1e62741f2ab2a6fb0f`. If a distfile changes its checksum for every download because it is packaged From 8d9a44b838c011e73966b8994ca0ea8e74208174 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Gero=20Schw=C3=A4ricke?= Date: Wed, 29 Jul 2026 11:31:10 +0200 Subject: [PATCH 4/4] Manual: update checksum command xbps-src uses xbps-digest internally. While sha256sum should arrive at the same result using sha256sum in the manual suggests to the reader that sha256sum is used internally. --- Manual.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Manual.md b/Manual.md index 6b9764c640b937..d63ef8a58831c9 100644 --- a/Manual.md +++ b/Manual.md @@ -545,7 +545,7 @@ on the fly on the server, like e.g. snapshot tarballs from any of the `https://*.googlesource.com/` sites, the checksum of the `archive contents` can be specified by prepending a commercial at (@). For tarballs you can find the contents checksum by using the command -`tar xf --to-stdout | sha256sum`. +`tar xf --to-stdout | xbps-digest`. - `wrksrc` The directory name where the package sources are extracted, set to `${pkgname}-${version}`.