Control: tags -1 + patch

On Mon, Oct 27, 2025 at 07:14:34PM +0100, Agustin Martin wrote:
> Package: devscripts
> Version: 2.25.22
> Severity: normal
> 
> Dear Maintainer,
> 
> I have been testing debian-watch version 5 and found a problem related
> to custom scripts usage. I see no mention of custom scripts in
> debian-watch version 5 manpage.
> 
> I have browsed devscripts code and looking at
> /usr/share/perl5/Devscripts/Uscan/WatchSource.pm seems that internal
> name for custom scripts is "updatescript", so I tried 
> 
> Update-Script: debian/repack-local
> 
> in debian/watch version 5 and seems to work as I expected (updatescript
> should have also worked). If no changes are expected, this should be
> documented in debian-watch version 5 manpage as it was in debian-watch
> version 4.

A patch with minimal proposed changes to version 5 docs is attached. It
assumes that Update-Script: option is not expected to change.

> Regarding debian-watch-4.pod it indeed mentions custom scripts, although
> a subsection in the orginal uscan manual was not included in
> debian-watch-4.pod (but stays in uscan man page). It is not very
> important, although I would consider adding a line of it with something
> like attached patch.

This can be improved after above version 5 patch.

Regards,

-- 
Agustin
>From 81f6d4a28cefc88122206205006bda3fffce6db9 Mon Sep 17 00:00:00 2001
From: Agustin Martin Domingo <[email protected]>
Date: Tue, 28 Oct 2025 00:40:23 +0100
Subject: [PATCH] scripts/debian-watch.pod: Document Update-Script: option for
 custom scripts.

---
 scripts/debian-watch.pod | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/scripts/debian-watch.pod b/scripts/debian-watch.pod
index 3d2c2be2..f7505d4f 100644
--- a/scripts/debian-watch.pod
+++ b/scripts/debian-watch.pod
@@ -188,6 +188,18 @@ I<(just after "Version")>, else it will be ignored.
 
 =back
 
+=item * B<Update-Script:> I<< <custom-script> >>:
+
+The optional I<custom-script> parameter in F<debian/watch> means to
+execute a custom I<script> with options after processing this line
+if specified.
+Default script is L<uupdate> and custom scripts, if created,
+should behave as L<uupdate>.
+See L<uscan/"HISTORY AND UPGRADING"> for how B<uscan> invokes the
+custom I<script> (or L<uupdate>).
+
+=back
+
 =head2 Component options
 
 =over
-- 
2.51.0

Reply via email to