Package: dpkg-dev
Version: 1.17.23
Severity: wishlist
Tags: patch
Please clarify in the docs that a space is not valid in calls to
"-SField". For example, this is valid:
$ dpkg-parsechangelog --show-field Field
.. but this isn't:
$ dpkg-parsechangelog -S Field
Whilst this is perfectly fine and consistent with -l, -F, -L the manpage
and --help output kinda imply that the space is fine. This led to some
confusion as I thought my version of dpkg-dev was too old for this
newish switch, etc. etc.
The attached patch just makes this explicit in the docs.
Regards,
--
,''`.
: :' : Chris Lamb
`. `'` [email protected] / chris-lamb.co.uk
`-
diff --git a/man/dpkg-parsechangelog.1 b/man/dpkg-parsechangelog.1
index 0b78ad0..8f8c2e0 100644
--- a/man/dpkg-parsechangelog.1
+++ b/man/dpkg-parsechangelog.1
@@ -54,7 +54,7 @@ which are currently
.BR /usr/local/lib/dpkg/parsechangelog " and "
.BR /usr/lib/dpkg/parsechangelog .
.TP
-.BR \-S ", " \-\-show\-field " \fIfield\fP"
+.BR \-S \fIfield\fP ", " \-\-show\-field " \fIfield\fP"
Specifies the name of the field to show (since dpkg 1.17.0).
The field name is not printed, only its value.
.TP
diff --git a/scripts/dpkg-parsechangelog.pl b/scripts/dpkg-parsechangelog.pl
index 57a91e7..58b7546 100755
--- a/scripts/dpkg-parsechangelog.pl
+++ b/scripts/dpkg-parsechangelog.pl
@@ -49,7 +49,8 @@ sub usage {
-l<changelog-file> get per-version info from this file.
-F<changelog-format> force changelog format.
-L<libdir> look for changelog parsers in <libdir>.
- -S, --show-field <field> show the values for <field>.
+ -S<field>, show the values for <field>.
+ --show-field <field>
-?, --help show this help message.
--version show the version.')
. "\n\n" . _g(
