regenerate md and man files

10 files changed, 25 insertions, 16 deletions

diff --git a/doc/man/git-bug-comment-add.1 b/doc/man/git-bug-comment-add.1
index f68a8bf9..f2763120 100644
--- a/doc/man/git-bug-comment-add.1
+++ b/doc/man/git-bug-comment-add.1
@@ -5,7 +5,7 @@
 
 .SH NAME
 .PP
-git\-bug\-comment\-add \- Add a new comment.
+git\-bug\-comment\-add \- Add a new comment to a bug.
 
 
 .SH SYNOPSIS
@@ -15,7 +15,7 @@ git\-bug\-comment\-add \- Add a new comment.
 
 .SH DESCRIPTION
 .PP
-Add a new comment.
+Add a new comment to a bug.
 
 
 .SH OPTIONS
diff --git a/doc/man/git-bug-comment.1 b/doc/man/git-bug-comment.1
index 234d7a01..f8d012ad 100644
--- a/doc/man/git-bug-comment.1
+++ b/doc/man/git-bug-comment.1
@@ -5,7 +5,7 @@
 
 .SH NAME
 .PP
-git\-bug\-comment \- Display or add comments.
+git\-bug\-comment \- Display or add comments to a bug.
 
 
 .SH SYNOPSIS
@@ -15,7 +15,7 @@ git\-bug\-comment \- Display or add comments.
 
 .SH DESCRIPTION
 .PP
-Display or add comments.
+Display or add comments to a bug.
 
 
 .SH OPTIONS
diff --git a/doc/man/git-bug-label-add.1 b/doc/man/git-bug-label-add.1
index a90e1d22..789bdd30 100644
--- a/doc/man/git-bug-label-add.1
+++ b/doc/man/git-bug-label-add.1
@@ -5,7 +5,7 @@
 
 .SH NAME
 .PP
-git\-bug\-label\-add \- Add a label.
+git\-bug\-label\-add \- Add a label to a bug.
 
 
 .SH SYNOPSIS
@@ -15,7 +15,7 @@ git\-bug\-label\-add \- Add a label.
 
 .SH DESCRIPTION
 .PP
-Add a label.
+Add a label to a bug.
 
 
 .SH OPTIONS
diff --git a/doc/man/git-bug-label-rm.1 b/doc/man/git-bug-label-rm.1
index 61b24a9a..07eacb38 100644
--- a/doc/man/git-bug-label-rm.1
+++ b/doc/man/git-bug-label-rm.1
@@ -5,7 +5,7 @@
 
 .SH NAME
 .PP
-git\-bug\-label\-rm \- Remove a label.
+git\-bug\-label\-rm \- Remove a label from a bug.
 
 
 .SH SYNOPSIS
@@ -15,7 +15,7 @@ git\-bug\-label\-rm \- Remove a label.
 
 .SH DESCRIPTION
 .PP
-Remove a label.
+Remove a label from a bug.
 
 
 .SH OPTIONS
diff --git a/doc/man/git-bug-label.1 b/doc/man/git-bug-label.1
index 2c005603..768787fa 100644
--- a/doc/man/git-bug-label.1
+++ b/doc/man/git-bug-label.1
@@ -5,7 +5,7 @@
 
 .SH NAME
 .PP
-git\-bug\-label \- Display, add or remove labels.
+git\-bug\-label \- Display, add or remove labels to/from a bug.
 
 
 .SH SYNOPSIS
@@ -15,7 +15,7 @@ git\-bug\-label \- Display, add or remove labels.
 
 .SH DESCRIPTION
 .PP
-Display, add or remove labels.
+Display, add or remove labels to/from a bug.
 
 
 .SH OPTIONS
diff --git a/doc/man/git-bug-select.1 b/doc/man/git-bug-select.1
index 677795c3..ab0bd421 100644
--- a/doc/man/git-bug-select.1
+++ b/doc/man/git-bug-select.1
@@ -17,6 +17,15 @@ git\-bug\-select \- Select a bug for implicit use in future commands.
 .PP
 Select a bug for implicit use in future commands.
 
+.PP
+This command allows you to omit any bug <id> argument, for example:
+  git bug show
+instead of
+  git bug show 2f153ca
+
+.PP
+The complementary command is "git bug deselect" performing the opposite operation.
+
 
 .SH OPTIONS
 .PP
diff --git a/doc/man/git-bug-title-edit.1 b/doc/man/git-bug-title-edit.1
index 642f7baa..0ba23307 100644
--- a/doc/man/git-bug-title-edit.1
+++ b/doc/man/git-bug-title-edit.1
@@ -5,7 +5,7 @@
 
 .SH NAME
 .PP
-git\-bug\-title\-edit \- Edit a title.
+git\-bug\-title\-edit \- Edit a title of a bug.
 
 
 .SH SYNOPSIS
@@ -15,7 +15,7 @@ git\-bug\-title\-edit \- Edit a title.
 
 .SH DESCRIPTION
 .PP
-Edit a title.
+Edit a title of a bug.
 
 
 .SH OPTIONS
diff --git a/doc/man/git-bug-title.1 b/doc/man/git-bug-title.1
index 9dd2c346..a46cf88a 100644
--- a/doc/man/git-bug-title.1
+++ b/doc/man/git-bug-title.1
@@ -5,7 +5,7 @@
 
 .SH NAME
 .PP
-git\-bug\-title \- Display or change a title.
+git\-bug\-title \- Display or change a title of a bug.
 
 
 .SH SYNOPSIS
@@ -15,7 +15,7 @@ git\-bug\-title \- Display or change a title.
 
 .SH DESCRIPTION
 .PP
-Display or change a title.
+Display or change a title of a bug.
 
 
 .SH OPTIONS
diff --git a/doc/man/git-bug-user-adopt.1 b/doc/man/git-bug-user-adopt.1
index 55e5f62f..83699060 100644
--- a/doc/man/git-bug-user-adopt.1
+++ b/doc/man/git-bug-user-adopt.1
@@ -10,7 +10,7 @@ git\-bug\-user\-adopt \- Adopt an existing identity as your own.
 
 .SH SYNOPSIS
 .PP
-\fBgit\-bug user adopt <id> [flags]\fP
+\fBgit\-bug user adopt <user-id> [flags]\fP
 
 
 .SH DESCRIPTION
diff --git a/doc/man/git-bug-user.1 b/doc/man/git-bug-user.1
index 083db84c..279aa62d 100644
--- a/doc/man/git-bug-user.1
+++ b/doc/man/git-bug-user.1
@@ -10,7 +10,7 @@ git\-bug\-user \- Display or change the user identity.
 
 .SH SYNOPSIS
 .PP
-\fBgit\-bug user [<id>] [flags]\fP
+\fBgit\-bug user [<user-id>] [flags]\fP
 
 
 .SH DESCRIPTION