[Dehs-devel] SVN devscripts commit: r416 - in trunk: . debian

[Julian Gilbey]

Author: jdg
Date: 2006-04-22 22:05:20 +0000 (Sat, 22 Apr 2006)
New Revision: 416

Modified:
   trunk/debian/changelog
   trunk/uscan.1
Log:
* uscan: mention upgrading points in the manpage.

Modified: trunk/debian/changelog
===================================================================
--- trunk/debian/changelog	2006-04-22 21:42:04 UTC (rev 415)
+++ trunk/debian/changelog	2006-04-22 22:05:20 UTC (rev 416)
@@ -2,8 +2,9 @@
 
   * debuild: set DEB_{BUILD,HOST}_* variables as dpkg-buildpackage does
     (Closes: #364256)
+  * uscan: mention upgrading points in the manpage.
 
- -- Julian Gilbey <jdg at debian.org>  Sat, 22 Apr 2006 22:40:22 +0100
+ -- Julian Gilbey <jdg at debian.org>  Sat, 22 Apr 2006 23:05:10 +0100
 
 devscripts (2.9.19) unstable; urgency=low
 

Modified: trunk/uscan.1
===================================================================
--- trunk/uscan.1	2006-04-22 21:42:04 UTC (rev 415)
+++ trunk/uscan.1	2006-04-22 22:05:20 UTC (rev 416)
@@ -447,14 +447,15 @@
 1
 No newer upstream versions were located for any of the watchfiles
 examined.
-.SH HISTORY
+.SH "HISTORY AND UPGRADING"
 This section briefly describes the backwards-incompatible watchfile
 features which have been added in each watchfile version, and the
 first version of the \fBdevscripts\fR package which understood them.
 .TP
 .I Pre-version 2
 The watchfile syntax was significantly different in those days.  Don't
-use it.
+use it.  If you are upgrading from a pre-version 2 watchfile, you are
+advised to read this manpage and to start from scratch.
 .TP
 .I Version 2
 devscripts version 2.6.90: The first incarnation of the current style
@@ -464,6 +465,14 @@
 devscripts version 2.8.12: Introduced the following: correct handling
 of regex special characters in the path part, directory/path pattern
 matching, version number in several parts, version number mangling.
+Later versions have also introduced URL mangling.
+.TP
+.B " "
+If you are upgrading from version 2, the key incompatibility is if you
+have multiple groups in the pattern part; whereas only the first one
+would be used in version 2, they will all be used in version 3.  To
+avoid this behaviour, change the non-version-number groups to be
+(?:...) instead of a plain (...) group.
 .SH "SEE ALSO"
 .BR dpkg (1),
 .BR perlre (1),