[master]: Document --revision better

--revision must start with a digit.

"--revision is broken (again)", thanks to Roland Koebler
Actually, in this case, it is the documentation which is broken; it
fails to mention that the revision number must start with a
digit. (Closes: #782447).

Signed-off-by: Manoj Srivastava <srivasta@debian.org>

3 files changed, 16 insertions, 13 deletions

diff --git a/debian/changelog b/debian/changelog
index dd6ccc0..2768238 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -5,8 +5,12 @@ kernel-package (13.015) UNRELEASED; urgency=low
   * Updated the VCS-* fields in the control file to use https transport.
   * Bug fix: "French translation update", thanks to David Prévot (Closes:
     #789078).
+  * Bug fix: "--revision is broken (again)", thanks to Roland Koebler
+    Actually, in this case, it is the documentation which is broken; it
+    fails to mention that the revision number must start with a
+    digit. (Closes: #782447).
 
- -- Manoj Srivastava <srivasta@debian.org>  Sat, 09 Jan 2016 23:46:38 -0800
+ -- Manoj Srivastava <srivasta@debian.org>  Sun, 10 Jan 2016 00:04:47 -0800
 
 kernel-package (13.014+nmu3) unstable; urgency=low
 
diff --git a/make-kpkg b/make-kpkg
index 65ed203..5cb8ec3 100755
--- a/make-kpkg
+++ b/make-kpkg
@@ -111,13 +111,12 @@ kernel source directory.
 
 =over 2
 
-Sets the Debian revision number for the packages produced to the
-argument B<number>. This has certain constraints: It only has an
-effect during the configure phase. I suggest you run make-kpkg clean
-unless you know what you are doing. Secondly, it may contain only
-alphanumerics and the characters + . (full stop, and plus)
-and must contain a digit. B<NOTE>: No hyphens allowed. (Look at the
-Debian policy manual for details).
+Sets the Debian revision number for the packages produced to the argument
+B<number>. This has certain constraints: It only has an effect during the
+configure phase. I suggest you run make-kpkg clean unless you know what you are
+doing. Secondly, it must start with a digit, it may contain only alphanumerics
+and the characters + . (full stop, and plus) and must contain a digit. B<NOTE>:
+No hyphens allowed. (Look at the Debian policy manual for details).
 
 Optionally, you may prepend the revision with a digit followed by a colon (:)
 
diff --git a/make-kpkg.8 b/make-kpkg.8
index fea0ff8..89327e0 100644
--- a/make-kpkg.8
+++ b/make-kpkg.8
@@ -105,11 +105,11 @@ Print out a usage message.
 .BI \-\-revision " number"
 Changes the version number for the packages produced to the argument
 .IR number .
-This has certain constraints: the version may contain only
-alphanumerics and the characters ~ + . (tilde, full stop and plus) and
-must contain a digit. (Look at the Policy manual for
-details). Optionally, you may prepend the revision with a digit
-followed by a colon (:). The default is
+This has certain constraints: the version must start with a digit. the
+version may contain only alphanumerics and the characters ~
++ . (tilde, full stop and plus) and must contain a digit. (Look at the
+Policy manual for details). Optionally, you may prepend the revision
+with a digit followed by a colon (:). The default is
 .B 10.00.Custom
 unless the environment variable
 .B DEBIAN_REVISION_MANDATORY