On 7/22/25 11:17, Niels Thykier wrote:
Package: devscripts
Version: 2.25.16
Severity: normal
X-Debbugs-Cc: ni...@thykier.net,y...@debian.org
Hi Xavier,
Thanks for working on replacing the line-based watch file with the
deb822 format.
I am reading through the documentation of the watch file 5 format to
provide hover docs for it in `debputy`. While reading through the
documentation, I noted the docs suddenly introduces the term "matching
pattern", but nowhere does it explain what that is or how to set it
(despite repeatedly stating "If/when the matching pattern is set to ...")
My best guess is that `Version-Regex` is in fact the `matching pattern`,
but we never state that in the documentation. I was only able to get to
this by reading the v4 format doc and note that it used `matching
pattern` in the synopsis.
Assuming I understood correctly, I would recommend we rename `Version-
Regex` and document that its definition depends on which mode it is.
With each mode then defining whether `Matching-Pattern` is a regex, a
branch/tag name or something third.
Best regards,
Niels
Thank you for the report,
fixed by commit cea772be, now Version-Regex is an alias for Matching-Pattern
