This is an automated email from the git hooks/post-receive script.

guillem pushed a commit to branch main
in repository dpkg.

View the commit online:
https://git.dpkg.org/cgit/dpkg/dpkg.git/commit/?id=96e6f04fe2bdd1122e7bebadc44e63d8bdd8fe75

commit 96e6f04fe2bdd1122e7bebadc44e63d8bdd8fe75
Author: Guillem Jover <[email protected]>
AuthorDate: Wed Jan 24 22:52:23 2024 +0100

    man, doc: Fix dpkg-buildapi option and command grouping in descriptions
    
    The --help output did not have a Commands section nor included it in its
    usage blurb. The manual page did not have an OPTIONS section.
---
 man/dpkg-buildapi.pod    | 16 +++++++++++-----
 scripts/dpkg-buildapi.pl |  8 +++++---
 2 files changed, 16 insertions(+), 8 deletions(-)

diff --git a/man/dpkg-buildapi.pod b/man/dpkg-buildapi.pod
index de2670183..49c8d477a 100644
--- a/man/dpkg-buildapi.pod
+++ b/man/dpkg-buildapi.pod
@@ -36,11 +36,6 @@ This program was introduced in dpkg 1.22.0.
 
 =over
 
-=item B<-c>I<control-file>
-
-Specifies the main source control file to read information from.
-The default is F<debian/control>.
-
 =item B<--help>
 
 Show the usage message and exit.
@@ -51,6 +46,17 @@ Show the version and exit.
 
 =back
 
+=head1 OPTIONS
+
+=over
+
+=item B<-c>I<control-file>
+
+Specifies the main source control file to read information from.
+The default is F<debian/control>.
+
+=back
+
 =head1 ENVIRONMENT
 
 =over
diff --git a/scripts/dpkg-buildapi.pl b/scripts/dpkg-buildapi.pl
index b34bcf56a..ec86fcd96 100755
--- a/scripts/dpkg-buildapi.pl
+++ b/scripts/dpkg-buildapi.pl
@@ -36,12 +36,14 @@ sub version()
 sub usage()
 {
     printf g_(
-'Usage: %s [<option>...]')
+'Usage: %s [<option>...] [<command>]')
+    . "\n\n" . g_(
+'Commands:
+  -?, --help               show this help message.
+  -v, --version            show the version.')
     . "\n\n" . g_(
 'Options:
   -c<control-file>         get control info from this file.
-  -?, --help               show this help message.
-  -v, --version            show the version.
 '), $Dpkg::PROGNAME;
 }
 

-- 
Dpkg.Org's dpkg

Reply via email to