update_check: auto-prefix refs/tags/ for info/refs patterns; adapt 101 update files

Manual.md

@@ -913,6 +913,14 @@ file in the same directory as the relevant `template` file:
   mentioned.  If unset, defaults to `homepage` and the directories where
 `distfiles` reside.
 
+- `distfiles_only` if set to `yes`, the package homepage is excluded
+  from the URLs scanned for version detection.  Only the directories
+  derived from `distfiles` (and any URL set via `site`) are checked.
+  This is useful when a custom `pattern` is tuned for a specific
+  endpoint format (such as a git forge's `info/refs`) and would
+  produce spurious matches against unrelated numbers appearing in the
+  homepage HTML.
+
 - `pkgname` is the package name the default pattern checks for.
 If unset, defaults to `pkgname` from the template.
 
@@ -944,6 +952,51 @@ in url. Defaults to `(|\.x)`.
 in cases where checking for updates is impossible or does not make sense.
 This should be set to a string describing why it is disabled.
 
+#### Git forge endpoints
+
+When `update_check.sh` scans URLs against a git forge's `info/refs`
+endpoint (used automatically for `github.com`, `gitlab.*`,
+`bitbucket.org`, `codeberg.org`, and `git.sr.ht` URLs), custom
+`pattern` entries may omit the `refs/tags/` prefix; it is auto-prefixed
+when not already present.  For example, these two patterns are
+equivalent for a GitHub-hosted package:
+
+	pattern='refs/tags/vulkan-sdk-\K[\d.]+'
+	pattern='vulkan-sdk-\K[\d.]+'
+
+The second form is preferred: it keeps the pattern focused on the
+package-specific tag convention rather than restating the endpoint
+format.
+
+This auto-prefixing only applies when the URL contains `info/refs`;
+patterns used against URLs set explicitly via `site` are matched
+as-written.
+
+#### Choosing between `site`, `distfiles_only` and the default behavior
+
+Most packages need neither `site` nor `distfiles_only`: the default
+behavior of scanning the homepage and distfiles directories works
+well when the `pattern` (or the default regex) has a strong anchor
+that won't match unrelated content.
+
+Use `distfiles_only=yes` when:
+
+- A custom `pattern` is specific enough to detect versions on the
+  distfiles URL, but matches unrelated numbers when applied to the
+  package homepage.
+
+Use `site=URL` when:
+
+- The version cannot be detected from `homepage` or `distfiles`
+  directories alone (e.g., upstream lists versions on a separate
+  release page).
+- One of the URLs in `distfiles` is a secondary file (such as a
+  pkg-config template fetched from `raw.githubusercontent.com`) that
+  produces unwanted matches independently of the homepage.
+- A non-standard `info/refs` endpoint must be targeted (e.g., a
+  self-hosted forge whose URL doesn't match the automatic patterns
+  above).
+
 <a id="patches"></a>
 ### Handling patches
 

common/xbps-src/shutils/update_check.sh

@@ -43,7 +43,7 @@ update_check() {
             *ftp.gnome.org*|*download.gnome.org*) ;;
             *archive.xfce.org*) ;;
             *)
-                printf '%s\n' "$homepage" ;;
+                [ "$distfiles_only" = yes ] || printf '%s\n' "$homepage" ;;
         esac
         for i in $distfiles; do
             printf '%s\n' "${i%/*}/"
@@ -216,6 +216,13 @@ update_check() {
         rx=${pattern:-$rx}
         rx=${rx:-'(?<!-)\b\Q'"$pkgname"'\E[-_]?((src|source)[-_])?v?\K([^-/_\s]*?\d[^-/_\s]*?)(?=(?:[-_.](?:src|source|orig))?\.(?:[jt]ar|shar|t[bglx]z|tbz2|zip))\b'}
 
+        # When using a git forge's info/refs endpoint, custom patterns may
+        # omit the refs/tags/ anchor for brevity. Auto-prefix it if absent.
+        if [ -n "$pattern" ] && [[ "$url" == *info/refs* ]] && [[ "$rx" != refs/tags/* ]]; then
+            msg_verbose "auto-prefixing refs/tags/ to custom pattern\n"
+            rx="refs/tags/$rx"
+        fi
+
         if [ "${fetchedurls[$url]}" ]; then
             msg_verbose "already fetched $url\n"
             continue

srcpkgs/CImg/update

@@ -1 +1 @@
-pattern="/archive/refs/tags/v.\K[\d.]+(?=\.tar\.gz)"
+pattern="v\.\K\d+\.[\d.]+"

srcpkgs/EternalTerminal/update

@@ -1 +1 @@
-pattern='/archive/refs/tags/et-v?\K[\d\.]+(?=\.tar\.gz")'
+pattern="et-v?\K[\d.]+"

srcpkgs/ImageMagick/update

@@ -1 +1,2 @@
-pattern='/archive/refs/tags/\K[\d\.]+-\d+(?=\.tar\.gz)'
+distfiles_only=yes
+pattern="\K[\d.]+-\d+"

srcpkgs/Lucene++/update

@@ -1 +1 @@
-pattern="rel_\K[\d.]+(?=\.tar\.gz)"
+pattern="rel_\K[\d.]+"

srcpkgs/OpenSubdiv/update

@@ -1 +1,3 @@
-pattern="v\K[\d_+]+(?=\.tar\.gz)"
+distfiles_only=yes
+pattern="v\K\d+(?:_\d+)*(_RC\d*)?"
+ignore="*RC*"

srcpkgs/SPIRV-Headers/update

@@ -1 +1 @@
-pattern="/vulkan-sdk-\K[0-9.]+(?=.tar.gz)"
+pattern="vulkan-sdk-\K[\d.]+"

srcpkgs/SPIRV-LLVM-Translator19/update

@@ -1 +1 @@
-pattern="/v\K19\.[0-9.]+(?=\.tar\.gz)"
+pattern="v\K19\.[\d.]+"

srcpkgs/SPIRV-LLVM-Translator21/update

@@ -1 +1 @@
-pattern="/v\K21\.[0-9.]+(?=\.tar\.gz)"
+pattern="v\K21\.[\d.]+"

srcpkgs/SPIRV-LLVM-Translator22/update

@@ -1 +1 @@
-pattern="/v\K22\.[0-9.]+(?=\.tar\.gz)"
+pattern="v\K22\.[\d.]+"

srcpkgs/SPIRV-Tools/update

@@ -1 +1 @@
-pattern="/v\K[0-9.]+(?=.tar.gz)"
+pattern="vulkan-sdk-\K[\d.]+"

srcpkgs/UEFITool/update

@@ -1 +1,2 @@
-pattern='/archive/refs/tags/(v?|UEFITool)?\K[A-Z\d.]+(?=\.tar\.gz")'
+distfiles_only=yes
+pattern="\K[A-Z\d.]+"

srcpkgs/Vulkan-Headers/update

@@ -1 +1 @@
-pattern="/vulkan-sdk-\K[0-9.]+(?=.tar.gz)"
+pattern="vulkan-sdk-\K[\d.]+"

srcpkgs/Vulkan-Tools/update

@@ -1 +1 @@
-pattern="/vulkan-sdk-\K[0-9.]+(?=.tar.gz)"
+pattern="vulkan-sdk-\K[\d.]+"

srcpkgs/Vulkan-Utility-Libraries/update

@@ -1 +1 @@
-pattern="/vulkan-sdk-\K[0-9.]+(?=.tar.gz)"
+pattern="vulkan-sdk-\K[\d.]+"

srcpkgs/Vulkan-ValidationLayers/update

@@ -1 +1 @@
-pattern="/vulkan-sdk-\K[0-9.]+(?=.tar.gz)"
+pattern="vulkan-sdk-\K[\d.]+"

srcpkgs/asahi-uboot/update

@@ -1 +1 @@
-pattern='tags/asahi-v\K[\d.R-]+(?=\.tar\.gz)'
+pattern="asahi-v\K[\d.A-Za-z+-]+"

srcpkgs/atomicparsley/update

@@ -1,2 +1,2 @@
+pattern="(v?|${pkgname}-)?\K[\d.a-f]+"
 version="${version}.${_commit}"
-pattern='/archive/refs/tags/(v?|\Qatomicparsley\E-)?\K[\d.a-f]+(?=\.tar\.gz")'

srcpkgs/cgal/update

@@ -1 +1,2 @@
-pattern="releases/CGAL-\K[\d\.]*(?=\.tar\.gz)"
+pattern="v\K[\d.]+(-beta\d*)?"
+ignore="*beta*"

srcpkgs/cronutils/update

@@ -1 +1 @@
-pattern="/archive/refs/tags/version/\K[\d.]+(?=\.tar\.gz)"
+pattern="version/\K[\d.]+"

srcpkgs/discount/update

@@ -1 +1 @@
-pattern='v\K[\d.a-z]+(?=\.tar\.gz")'
+pattern="v\K[\d.a-z]+"

srcpkgs/eigen3.2/update

@@ -1,2 +1,3 @@
-pattern='eigen/get/\K[\d.]+(?=.tar.bz2)'
-ignore="3.3.*"
+distfiles_only=yes
+pattern="\K[\d.]+"
+ignore="3.[3-9]* [4-9]*"

srcpkgs/faac/update

@@ -1 +1,2 @@
-pattern='/archive/refs/tags/(v?|\Q${pkgname}\E-)?\K[\d\._]+(?=\.tar\.gz")'
+distfiles_only=yes
+pattern="(v?|${pkgname}-)?\K[\d._]+"

srcpkgs/faad2/update

@@ -1,2 +1,3 @@
-pattern='/archive/refs/tags/(v?|\Q${pkgname}\E-)?\K[\d\._]+(?=\.tar\.gz")'
+distfiles_only=yes
+pattern="(v?|${pkgname}-)?\K[\d._]+"
 ignore="2003*"

srcpkgs/flintlib/update

@@ -1,4 +1,5 @@
-pattern="/archive/refs/tags/v?\K[\d.]+(-(p|rc)[0-9]+)?(?=\.tar\.gz)"
+distfiles_only=yes
+pattern="v?\K[\d.]+(-(p|rc)[0-9]+)?"
 version=${version/+/.}
 if [[ "$version" != *rc* ]]; then
 	ignore=*rc*

srcpkgs/fntsample/update

@@ -1 +1 @@
-pattern='/archive/refs/tags/(release/|v?|\Q'"$pkgname"'\E-)?\K[\d\.]+(?=\.tar\.gz")'
+pattern="release/\K[\d.]+"

srcpkgs/font-adobe-source-code-pro/update

@@ -1 +1,2 @@
-pattern='(?!archive/refs/tags/)[0-9.]+(?=R?-[0-9./VARuivfr-]+[.]tar[.]gz)'
+distfiles_only=yes
+pattern="\K[\d.]+"

srcpkgs/gdmd/update

@@ -1 +1 @@
-pattern='(?<=script-)[0-9.]*(?=.tar.gz)'
+pattern="script-\K[\d.]+"

srcpkgs/gnome-epub-thumbnailer/update

@@ -1 +1 @@
-pattern="\Q$pkgname\E-\K[0-9.]+(?=\.tar)"
+pattern="${pkgname}-\K[0-9.]+"

srcpkgs/godot/update

@@ -1 +1 @@
-pattern='/archive/refs/tags/(v?|\Q'"$pkgname"'\E-)?\K[\d\.]+(?=-stable\.tar\.gz")'
+pattern="(v?|${pkgname}-)?\K[\d.]+(?=-stable)"

srcpkgs/gopls/update

@@ -1 +1,2 @@
-pattern='/archive/refs/tags/\Q'"$pkgname"'\E/v\K[\d\.]+(?=\.tar\.gz")'
+pattern="${pkgname}/v\K[\d.]+(-pre\.[0-9]+)?"
+ignore="*pre*"

srcpkgs/gzdoom/update

@@ -1 +1,2 @@
-pattern='/archive/refs/tags/(g|v?|\Q'"$pkgname"'\E-)?\K[\d\.]+(?=\.tar\.gz")'
+pattern="g\K[\d.]+(pre)?"
+ignore="*pre*"

srcpkgs/incron/update

@@ -1 +1 @@
-pattern="${pkgname}-\K[\d.]+(?=\.tar.bz2)"
+pattern="incron-\K[\d.]+"

srcpkgs/inih/update

@@ -1 +1 @@
-pattern='/r\K[\d.]+(?=.tar.gz)'
+pattern="r\K[\d.]+"

srcpkgs/intel-ucode/update

@@ -1 +1 @@
-pattern="microcode-\K[0-9]+(?=.tar)"
+pattern="microcode-\K[\d]+"

srcpkgs/inxi/update

@@ -1,2 +1,2 @@
-pattern="/archive/\K[\d.]+(?=[0-9a-z-]+\.tar\.gz)"
-version=${version%\.*}
+distfiles_only=yes
+pattern="\K[\d.]+"

srcpkgs/iverilog/update

@@ -1 +1,2 @@
-pattern='/archive/refs/tags/(v?|\Q'"$pkgname"'\E-)?\K[\d\_]+(?=\.tar\.gz")'
+distfiles_only=yes
+pattern="(v?|${pkgname}-)?\K[\d_]+"

srcpkgs/j4-dmenu-desktop/update

@@ -1 +1,2 @@
-pattern='/archive/refs/tags/(v?|\Q'"$pkgname"'\E-)?r\K[\d\.]+(?=\.tar\.gz")'
+pattern="r\K[\d.]+(-(rc|beta)[0-9]*)?"
+ignore="*rc* *beta*"

srcpkgs/kodi/update

@@ -1 +1,2 @@
-pattern="\d+\.[\d.]+(?=-\w+\.tar\.gz)"
+distfiles_only=yes
+pattern="\K\d+\.[\d.]+(?=-\w+)"

srcpkgs/lf/update

@@ -1 +1 @@
-pattern='archive/refs/tags/\Kr[0-9]+(?=\.tar.gz)'
+pattern="\Kr[\d.]+"

srcpkgs/libaccounts-qt/update

@@ -1 +1,2 @@
-pattern='/archive/[^/]+/'"$pkgname"'?-VERSION_\K[\d\.]+(?=\.tar\.gz")'
+distfiles_only=yes
+pattern="VERSION_\K[\d.]+"

srcpkgs/libblockdev/update

@@ -1 +1,2 @@
-pattern="\K[\d\.]*(?=-1\.tar\.gz)"
+distfiles_only=yes
+pattern="\K[\d.]+"

srcpkgs/libcgroup/update

@@ -1 +1,2 @@
-pattern="${pkgname}-v?\K[\d.]+(?=\.tar)"
+distfiles_only=yes
+pattern="v?\K[\d.]+"

srcpkgs/libeot/update

@@ -1 +1,2 @@
-pattern="(?<=v)[0-9][0-9.]+(?=.tar)|(?<=libeot-)[0-9][0-9.]+(?=.tar)"
+site="https://github.com/umanwizard/libeot/info/refs?service=git-upload-pack"
+pattern="v\K[\d.]+"

srcpkgs/libgit2-1.8/update

@@ -1 +1 @@
-pattern="v\K1\.8\.[\d.]+(?=\.tar\.gz)"
+pattern="v\K1\.8\.[\d.]+"

srcpkgs/libgit2-1.9/update

@@ -1 +1 @@
-pattern="v\K1\.9\.[\d.]+(?=\.tar\.gz)"
+pattern="v\K1\.9\.[\d.]+"

srcpkgs/libgme/update

@@ -1 +1,2 @@
-pattern="game-music-emu-\K[\d.]+"
+distfiles_only=yes
+pattern="\K[\d.]+"

srcpkgs/libhomfly/update

@@ -1 +1,2 @@
-pattern='/archive/refs/tags/\K[\d.r]+(?=\.tar\.gz")'
+distfiles_only=yes
+pattern="\K[\d.r]+"

srcpkgs/libkeybinder3/update

@@ -1 +1 @@
-pattern='/archive/refs/tags/(keybinder-3.0-v|v?|\Q'"$pkgname"'\E-)?\K[\d\.]+(?=\.tar\.gz")'
+pattern="keybinder-3.0-v\K[\d.]+"

srcpkgs/libluv/update

@@ -1 +1,2 @@
-pattern='/archive/refs/tags/(v?|\Q'"$pkgname"'\E-)?\K[-\d\.]+(?=\.tar\.gz")'
+site="https://github.com/luvit/luv/info/refs?service=git-upload-pack"
+pattern="(v?|${pkgname}-)?\K[-\d.]+"

srcpkgs/libmygui/update

@@ -1,2 +1,2 @@
 pkgname=MyGUI
-pattern='/archive/refs/tags/(v?|\Q'"$pkgname"'\E)?\K[\d\.]+(?=\.tar\.gz")'
+pattern="(v?|${pkgname})?\K[\d.]+"

srcpkgs/libui/update

@@ -1 +1,2 @@
-pattern='/libui/archive/refs/tags/\K[a-z]+[\d+.]+(?=.tar.gz)'
+distfiles_only=yes
+pattern="\K[a-z]+[\d.]+"

srcpkgs/libvidstab/update

@@ -1 +1 @@
-pattern='tag/release-\K.*(?=")'
+pattern="v\K[\d.]+"

srcpkgs/lilypond-doc/update

@@ -1,2 +1,3 @@
-version="${version}-1"
-pattern="lilypond-\K[\d.-]+(?=.documentation)"
+distfiles_only=yes
+pattern="v\K[\d.]+"
+ignore="2.27*"

srcpkgs/linux-asahi/update

@@ -1 +1 @@
-pattern='tags/asahi-\K[\d.-]+(?=\.tar\.gz)'
+pattern="asahi-\K${version%%.*}\.[\d.A-Za-z+-]+"

srcpkgs/liteide/update

@@ -1 +1 @@
-pattern='/archive/refs/tags/(x|v?|\Q'"$pkgname"'\E-)?\K[\d\.]+(?=\.tar\.gz")'
+pattern="x\K[\d.]+"

srcpkgs/lm_sensors/update

@@ -1 +1 @@
-pattern='V\K[\d-]+(?=</a>)'
+pattern="V\K[\d-]+"

srcpkgs/lmdb/update

@@ -1 +1 @@
-pattern='LMDB_\K[\d.]+(?=\.tar)'
+pattern="LMDB_\K[\d.]+"

srcpkgs/love/update

@@ -1 +1,2 @@
-pattern='/(get|downloads)/(v?|\Q'"$pkgname"'\E-)?\K[\d\.]+(?=(-linux-src)?\.tar)'
+distfiles_only=yes
+pattern="\K[\d.]+"

srcpkgs/lsyncd/update

@@ -1 +1 @@
-pattern="release-\K[\d\.]*(?=\.tar.gz)"
+pattern="release-\K[\d.]+"

srcpkgs/lua54-luafilesystem/update

@@ -1,2 +1,2 @@
-pattern='/archive/refs/tags/(v?|\Q'"$pkgname"'\E-)?\K[\d._]+(?=\.tar\.gz")'
+pattern="(v?|${pkgname}-)?\K[\d._]+"
 version=${version//_/.}

srcpkgs/mame/update

@@ -1 +1 @@
-pattern="${pkgname}\K\d+(?=\.tar)"
+pattern="mame\K\d+"

srcpkgs/mathjax2/update

@@ -1 +1,2 @@
-pattern='refs/tags/\K2[.][0-9.]*(?=.tar.gz)'
+distfiles_only=yes
+pattern="\K2\.[\d.]+"

srcpkgs/md4c/update

@@ -1 +1 @@
-pattern="release-\K[0-9.]+(?=.tar.gz)"
+pattern="release-\K[\d.]+"

srcpkgs/minio/update

@@ -1 +1 @@
-pattern="/archive/refs/tags/RELEASE\.\K[-\d]+(?=T[-\d]+Z\.tar\.gz)"
+pattern="RELEASE\.\K[\d-]+"

srcpkgs/miruo/update

@@ -1 +1 @@
-pattern='/archive/refs/tags/(v?|\Q'"$pkgname"'\E-)?\K[\d\.]+[a-z]*(?=\.tar\.gz")'
+pattern="(v?|${pkgname}-)?\K[\d.]+[a-z]*"

srcpkgs/moosefs/update

@@ -1 +1,2 @@
-pattern="$pkgname-\K[\d\.]*(?=\-1\.tar\.gz)"
+distfiles_only=yes
+pattern="v\K[\d.]+"

srcpkgs/openimageio/update

@@ -1 +1,3 @@
-pattern="Release-\K[\d\.]+(?=\.tar)"
+distfiles_only=yes
+pattern="v\K[\d.]+(-dev)?"
+ignore="*dev*"

srcpkgs/openjdk8/update

@@ -1 +1 @@
-pattern='shenandoah\K8u[\db-]+(?=\.tar\.gz)'
+pattern="shenandoah\K8u[\db-]+"

srcpkgs/otfcc/update

@@ -1,2 +1,2 @@
-pattern='/archive/refs/tags/(v?|\Q'"$pkgname"'\E-)?\K[-\d\.a-z]+(?=\.tar\.gz")'
+pattern="(v?|${pkgname}-)?\K[-\d.a-z]+"
 version="${version/alpha/.alpha}"

srcpkgs/pgbackrest/update

@@ -1 +1 @@
-pattern='/archive/refs/tags/(v?|\Qrelease/\E)?\K[\d\.]+(?=\.tar\.gz")'
+pattern="release/\K[\d.]+"

srcpkgs/poedit/update

@@ -1 +1 @@
-pattern='/archive/refs/tags/(v?|\Q'"$pkgname"'\E-)?\K[\d\.]+(?=-oss\.tar\.gz")'
+pattern="(v?|${pkgname}-)?\K[\d.]+(?=-oss)"

srcpkgs/python3-aioamqp/update

@@ -1 +1 @@
-pattern="${pkgname#*-}-\K[0-9.]*(?=.tar.gz)"
+pattern="aioamqp-\K[0-9.]+"

srcpkgs/python3-hypothesis/update

@@ -1,2 +1,2 @@
 pkgname=hypothesis-python
-pattern="${pkgname}-\K[0-9.]+\.0(?=\.tar\.gz)"
+pattern="${pkgname}-\K[0-9.]+"

srcpkgs/python3-pyqtgraph/update

@@ -1 +1,2 @@
-pattern='pyqtgraph-\K[\d.]+(?=")'
+distfiles_only=yes
+pattern="pyqtgraph-\K[\d.]+"

srcpkgs/re2/update

@@ -1 +1,2 @@
-pattern="\K[\d\-]*([\d\-]+)(?=\.tar\.gz)"
+distfiles_only=yes
+pattern="\K[\d-]+"

srcpkgs/redshift/update

@@ -1 +1,2 @@
-pattern='Redshift \K[\d.]+'
+distfiles_only=yes
+pattern="v\K[\d.]+"

srcpkgs/redsocks/update

@@ -1 +1,2 @@
-pattern="release-\K[\d.]*(?=\.tar\.gz)"
+distfiles_only=yes
+pattern="release-\K[\d.]+"

srcpkgs/sane/update

@@ -1 +1,2 @@
-pattern='href="/sane-project/backends/-/tags/[^\d\.]*\K[\d\.]*'
+distfiles_only=yes
+pattern="\K[\d.]+"

srcpkgs/sasm/update

@@ -1 +1,2 @@
-pattern=".*/archive/refs/tags/v\K.+(?=\.tar\.gz)"
+distfiles_only=yes
+pattern="v\K[\d.]+"

srcpkgs/sdl12-compat/update

@@ -1 +1 @@
-pattern='release-\K[\d.]+(?=\.tar\.gz")'
+pattern="release-\K[\d.]+"

srcpkgs/slurm-wlm/update

@@ -1,2 +1,3 @@
 pkgname=slurm
-pattern='slurm-\K[-\d]+(?=.tar.gz)'
+pattern="${pkgname}-\K[\d-]+(rc\d*)?"
+ignore="*rc*"

srcpkgs/spectrwm/update

@@ -1 +1 @@
-pattern="SPECTRWM_\K[\d\_]*(?=\.tar\.gz)"
+pattern="SPECTRWM_\K[\d_]+"

srcpkgs/swayr/update

@@ -1 +1,2 @@
-pattern='<title>Release swayr-\K[\d.]+(?=</title>)'
+distfiles_only=yes
+pattern="swayr-\K[\d.]+"

srcpkgs/swayrbar/update

@@ -1 +1,2 @@
-pattern='<title>Release swayrbar-\K[\d.]+(?=</title>)'
+distfiles_only=yes
+pattern="swayrbar-\K[\d.]+"

srcpkgs/taplo/update

@@ -1 +1 @@
-pattern="release-taplo-cli-\K[\d.]+(?=\.tar\.gz)"
+pattern="release-taplo-cli-\K[\d.]+"