On Tue, Oct 28, 2025 at 12:48:46AM +0100, Agustin Martin wrote:
> > 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.

Hi,

Attached new version of suggested patches.

Regards,

-- 
Agustin
>From 43fbc09c950627b20b0b1b5c3ef02a95e2a8a3c1 Mon Sep 17 00:00:00 2001
From: Agustin Martin Domingo <[email protected]>
Date: Mon, 27 Oct 2025 23:54:10 +0100
Subject: [PATCH 1/2] scripts/debian-watch-4.pod: Minor change suggested in
 custom scripts section.

---
 scripts/debian-watch-4.pod | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/scripts/debian-watch-4.pod b/scripts/debian-watch-4.pod
index 9d1e6f81..0298d83f 100644
--- a/scripts/debian-watch-4.pod
+++ b/scripts/debian-watch-4.pod
@@ -121,8 +121,13 @@ At least the main upstream source has to be declared as "group".
 
 =back
 
-=item * I<script> is executed at the end of B<uscan> execution with appropriate
-arguments provided by B<uscan> I<(default: no action)>.
+=item * I<script> is executed at the end of B<uscan> execution with
+appropriate arguments provided by B<uscan>.
+Default script is L<uupdate> and custom scripts, if created,
+should behave as if L<uupdate>.
+See L<uscan/"Custom script"> for more details on custom scripts and
+L<uscan/"HISTORY AND UPGRADING"> for how B<uscan> invokes the custom
+I<script> (or L<uupdate>).
 
 =over
 
-- 
2.51.0

>From 8e4317817949ee68b0b67b335a80fee07b0de6b0 Mon Sep 17 00:00:00 2001
From: Agustin Martin Domingo <[email protected]>
Date: Tue, 28 Oct 2025 00:40:23 +0100
Subject: [PATCH 2/2] 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..792162bb 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> >>:
+
+This optional line in F<debian/watch> means to execute
+I<custom-script> with appropriate arguments provided by B<uscan>.
+Default script is L<uupdate> and custom scripts, if created,
+should behave as if L<uupdate>.
+See L<uscan/"Custom script"> for more details on custom scripts and
+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