[cowdancer] 01/04: cowbuilder.8: Update for new command aliases

[James Clarke]

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

jrtc27 pushed a commit to branch master
in repository cowdancer.

commit 700df7a83644a62f09ed880a886877de2666061c
Author: James Clarke <jrtc27 at debian.org>
Date:   Tue Jan 17 21:48:19 2017 +0000

    cowbuilder.8: Update for new command aliases
---
 cowbuilder.8 | 52 ++++++++++++++++++++++++++++------------------------
 1 file changed, 28 insertions(+), 24 deletions(-)

diff --git a/cowbuilder.8 b/cowbuilder.8
index 99561b5..c77550d 100644
--- a/cowbuilder.8
+++ b/cowbuilder.8
@@ -2,7 +2,17 @@
 .SH "NAME"
 cowbuilder \- a pbuilder wrapper for cowdancer.
 .SH SYNOPSIS
-.BI "cowbuilder [" "commands" "] [" "options" "]"
+.BI "cowbuilder create [" "options" "]"
+.PP
+.BI "cowbuilder update [" "options" "]"
+.PP
+.BI "cowbuilder build [" "options" "] " ".dsc-file"
+.PP
+.BI "cowbuilder login [" "options" "]"
+.PP
+.BI "cowbuilder execute [" "options" "] -- " "script [" "script options" "]"
+.PP
+.BI "cowbuilder dumpconfig"
 .SH DESCRIPTION
 .B cowbuilder
 Executes the specified pbuilder operation with
@@ -14,35 +24,29 @@ Most commands invoke pbuilder with the specified commands, see
 pbuilder manual for details.
 
 .TP
-.B "\-\-create"
-
+\fB\-\-create\fR, \fBcreate\fR
 Create the base.cow image.
 The directory for base.cow should be empty, or this command will fail.
 
 .TP
-.B "\-\-update"
-
+\fB\-\-update\fR, \fBupdate\fR, \fBup\fR, \fBu\fR
 Update the base.cow image.
 
 .TP
-.BI "\-\-build " ".dsc-file"
-
+\fB\-\-build\fR, \fBbuild\fR, \fBb\fR
 Build a package given a .dsc file
 
 .TP
-.B "\-\-login"
-
+\fB\-\-login\fR, \fBlogin\fR, \fBl\fR
 Start a session within the base.cow.
 
 .TP
-.B "\-\-execute"
-
+\fB\-\-execute\fR, \fBexecute\fR, \fBe\fR
 Execute a command within the base.cow.
 
 .TP
-.B "--dumpconfig"
-
-dump configuration information.
+\fB\-\-dumpconfig\fR, \fBdumpconfig\fR
+Dump configuration information, used for debugging.
 
 .SH "OPTIONS"
 
@@ -69,7 +73,7 @@ configuration files have been read.
 .TP
 .BI "\-\-no\-cowdancer\-update"
 
-Do not use cowdancer on cowbuilder --update. Please use this option
+Do not use cowdancer on cowbuilder update. Please use this option
 when cowdancer is interfering with upgrade process, or cowdancer
 itself is being upgraded within chroot.
 
@@ -134,11 +138,11 @@ See
 .SH "EXAMPLES"
 
 .TP
-.B "cowbuilder --create"
+.B "cowbuilder create"
 Create a base.cow image.
 
 .nf
-# cowbuilder --create --hookdir /usr/share/doc/pbuilder/examples/workaround/ --distribution etch --debootstrap debootstrap --basepath /var/cache/pbuilder/base-test.cow
+# cowbuilder create --hookdir /usr/share/doc/pbuilder/examples/workaround/ --distribution etch --debootstrap debootstrap --basepath /var/cache/pbuilder/base-test.cow
 bash: /root/.pbuilderrc: No such file or directory
 W: /home/dancer/.pbuilderrc does not exist
 I: Running in no-targz mode
@@ -152,11 +156,11 @@ I: Retrieving Release
 .hy
 
 .TP 
-.B "cowbuilder --update"
+.B "cowbuilder update"
 Update the base.cow image.
 
 .nf
-# cowbuilder --update
+# cowbuilder update
 bash: /root/.pbuilderrc: No such file or directory
 I: Copying COW directory
 I: Invoking pbuilder
@@ -173,13 +177,13 @@ I: upgrading packages
 .hy
 
 .TP
-.B "cowbuilder --build test_0.1.dsc"
+.B "cowbuilder build test_0.1.dsc"
 Build the package specified in dsc file, with the base.cow image.
 
 .TP
 .B "pdebuild --pbuilder cowbuilder"
 Run
-.B "cowbuilder --build"
+.B "cowbuilder build"
 against the current directory.
 The current directory should be an extracted Debian source package directory.
 
@@ -191,7 +195,7 @@ to make this the default behavior for
 .B pdebuild.
 
 .TP
-.B "cowbuilder --login --bindmounts /home/dancer"
+.B "cowbuilder login --bindmounts /home/dancer"
 Start a cow-shell session inside base.cow, with 
 .I "/home/dancer"
  being bind-mounted to within chroot.
@@ -200,7 +204,7 @@ Note that cowbuilder will not cow-protect what is inside
 .B /home/
 
 .nf
-# cowbuilder --login --bindmount ${HOME}
+# cowbuilder login --bindmount ${HOME}
 bash: /root/.pbuilderrc: No such file or directory
 I: Copying COW directory
 I: Invoking pbuilder
@@ -216,7 +220,7 @@ I: entering the shell
 .hy
 
 .TP
-.B "cowbuilder --create --distribution sid --basepath /var/cache/pbuilder/base-test.cow"
+.B "cowbuilder create --distribution sid --basepath /var/cache/pbuilder/base-test.cow"
 Create a base.cow image with the path 
 .B "/var/cache/pbuilder/base-test.cow"
 and distribution sid.

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pbuilder/cowdancer.git