commands: cleanup the command's usage to avoid warnings when generating the doc

52 files changed, 102 insertions, 51 deletions

diff --git a/doc/man/git-bug-bridge-auth-add-token.1 b/doc/man/git-bug-bridge-auth-add-token.1
index fe4750b4..d522f0c7 100644
--- a/doc/man/git-bug-bridge-auth-add-token.1
+++ b/doc/man/git-bug-bridge-auth-add-token.1
@@ -9,7 +9,7 @@ git\-bug\-bridge\-auth\-add\-token \- Store a new token
 
 .SH SYNOPSIS
 .PP
-\fBgit\-bug bridge auth add\-token [] [flags]\fP
+\fBgit\-bug bridge auth add\-token [TOKEN] [flags]\fP
 
 
 .SH DESCRIPTION
diff --git a/doc/man/git-bug-bridge-auth-rm.1 b/doc/man/git-bug-bridge-auth-rm.1
index 9ddac3f2..f2a9408a 100644
--- a/doc/man/git-bug-bridge-auth-rm.1
+++ b/doc/man/git-bug-bridge-auth-rm.1
@@ -9,7 +9,7 @@ git\-bug\-bridge\-auth\-rm \- Remove a credential.
 
 .SH SYNOPSIS
 .PP
-\fBgit\-bug bridge auth rm  [flags]\fP
+\fBgit\-bug bridge auth rm ID [flags]\fP
 
 
 .SH DESCRIPTION
diff --git a/doc/man/git-bug-bridge-pull.1 b/doc/man/git-bug-bridge-pull.1
index 4a9e78db..12d12438 100644
--- a/doc/man/git-bug-bridge-pull.1
+++ b/doc/man/git-bug-bridge-pull.1
@@ -9,7 +9,7 @@ git\-bug\-bridge\-pull \- Pull updates.
 
 .SH SYNOPSIS
 .PP
-\fBgit\-bug bridge pull [] [flags]\fP
+\fBgit\-bug bridge pull [NAME] [flags]\fP
 
 
 .SH DESCRIPTION
diff --git a/doc/man/git-bug-bridge-push.1 b/doc/man/git-bug-bridge-push.1
index 59e60bdf..c15cce60 100644
--- a/doc/man/git-bug-bridge-push.1
+++ b/doc/man/git-bug-bridge-push.1
@@ -9,7 +9,7 @@ git\-bug\-bridge\-push \- Push updates.
 
 .SH SYNOPSIS
 .PP
-\fBgit\-bug bridge push [] [flags]\fP
+\fBgit\-bug bridge push [NAME] [flags]\fP
 
 
 .SH DESCRIPTION
diff --git a/doc/man/git-bug-bridge-rm.1 b/doc/man/git-bug-bridge-rm.1
index 8cfa925a..70ca410f 100644
--- a/doc/man/git-bug-bridge-rm.1
+++ b/doc/man/git-bug-bridge-rm.1
@@ -9,7 +9,7 @@ git\-bug\-bridge\-rm \- Delete a configured bridge.
 
 .SH SYNOPSIS
 .PP
-\fBgit\-bug bridge rm  [flags]\fP
+\fBgit\-bug bridge rm NAME [flags]\fP
 
 
 .SH DESCRIPTION
diff --git a/doc/man/git-bug-commands.1 b/doc/man/git-bug-commands.1
index b7c1e214..28fabca5 100644
--- a/doc/man/git-bug-commands.1
+++ b/doc/man/git-bug-commands.1
@@ -9,7 +9,7 @@ git\-bug\-commands \- Display available commands.
 
 .SH SYNOPSIS
 .PP
-\fBgit\-bug commands [\&...] [flags]\fP
+\fBgit\-bug commands [flags]\fP
 
 
 .SH DESCRIPTION
diff --git a/doc/man/git-bug-comment-add.1 b/doc/man/git-bug-comment-add.1
index 530101b8..c1d13aa2 100644
--- a/doc/man/git-bug-comment-add.1
+++ b/doc/man/git-bug-comment-add.1
@@ -9,7 +9,7 @@ git\-bug\-comment\-add \- Add a new comment to a bug.
 
 .SH SYNOPSIS
 .PP
-\fBgit\-bug comment add [] [flags]\fP
+\fBgit\-bug comment add [ID] [flags]\fP
 
 
 .SH DESCRIPTION
diff --git a/doc/man/git-bug-comment.1 b/doc/man/git-bug-comment.1
index 9beb7a06..7d46258d 100644
--- a/doc/man/git-bug-comment.1
+++ b/doc/man/git-bug-comment.1
@@ -9,7 +9,7 @@ git\-bug\-comment \- Display or add comments to a bug.
 
 .SH SYNOPSIS
 .PP
-\fBgit\-bug comment [] [flags]\fP
+\fBgit\-bug comment [ID] [flags]\fP
 
 
 .SH DESCRIPTION
diff --git a/doc/man/git-bug-label-add.1 b/doc/man/git-bug-label-add.1
index 86a4bb24..a11cdbe7 100644
--- a/doc/man/git-bug-label-add.1
+++ b/doc/man/git-bug-label-add.1
@@ -9,7 +9,7 @@ git\-bug\-label\-add \- Add a label to a bug.
 
 .SH SYNOPSIS
 .PP
-\fBgit\-bug label add [] [...] [flags]\fP
+\fBgit\-bug label add [ID] LABEL... [flags]\fP
 
 
 .SH DESCRIPTION
diff --git a/doc/man/git-bug-label-rm.1 b/doc/man/git-bug-label-rm.1
index e7e912ea..58dcccec 100644
--- a/doc/man/git-bug-label-rm.1
+++ b/doc/man/git-bug-label-rm.1
@@ -9,7 +9,7 @@ git\-bug\-label\-rm \- Remove a label from a bug.
 
 .SH SYNOPSIS
 .PP
-\fBgit\-bug label rm [] [...] [flags]\fP
+\fBgit\-bug label rm [ID] LABEL... [flags]\fP
 
 
 .SH DESCRIPTION
diff --git a/doc/man/git-bug-label.1 b/doc/man/git-bug-label.1
index 23fc0047..f5a47c5c 100644
--- a/doc/man/git-bug-label.1
+++ b/doc/man/git-bug-label.1
@@ -9,7 +9,7 @@ git\-bug\-label \- Display, add or remove labels to/from a bug.
 
 .SH SYNOPSIS
 .PP
-\fBgit\-bug label [] [flags]\fP
+\fBgit\-bug label [ID] [flags]\fP
 
 
 .SH DESCRIPTION
diff --git a/doc/man/git-bug-ls-id.1 b/doc/man/git-bug-ls-id.1
index c7b40114..d35415b4 100644
--- a/doc/man/git-bug-ls-id.1
+++ b/doc/man/git-bug-ls-id.1
@@ -9,7 +9,7 @@ git\-bug\-ls\-id \- List bug identifiers.
 
 .SH SYNOPSIS
 .PP
-\fBgit\-bug ls\-id [] [flags]\fP
+\fBgit\-bug ls\-id [PREFIX] [flags]\fP
 
 
 .SH DESCRIPTION
diff --git a/doc/man/git-bug-ls.1 b/doc/man/git-bug-ls.1
index 54a64cd2..2e6e0b63 100644
--- a/doc/man/git-bug-ls.1
+++ b/doc/man/git-bug-ls.1
@@ -9,7 +9,7 @@ git\-bug\-ls \- List bugs.
 
 .SH SYNOPSIS
 .PP
-\fBgit\-bug ls [] [flags]\fP
+\fBgit\-bug ls [QUERY] [flags]\fP
 
 
 .SH DESCRIPTION
diff --git a/doc/man/git-bug-pull.1 b/doc/man/git-bug-pull.1
index 82b741ed..aed5a844 100644
--- a/doc/man/git-bug-pull.1
+++ b/doc/man/git-bug-pull.1
@@ -9,7 +9,7 @@ git\-bug\-pull \- Pull bugs update from a git remote.
 
 .SH SYNOPSIS
 .PP
-\fBgit\-bug pull [] [flags]\fP
+\fBgit\-bug pull [REMOTE] [flags]\fP
 
 
 .SH DESCRIPTION
diff --git a/doc/man/git-bug-push.1 b/doc/man/git-bug-push.1
index dc694258..19a90cfc 100644
--- a/doc/man/git-bug-push.1
+++ b/doc/man/git-bug-push.1
@@ -9,7 +9,7 @@ git\-bug\-push \- Push bugs update to a git remote.
 
 .SH SYNOPSIS
 .PP
-\fBgit\-bug push [] [flags]\fP
+\fBgit\-bug push [REMOTE] [flags]\fP
 
 
 .SH DESCRIPTION
diff --git a/doc/man/git-bug-rm.1 b/doc/man/git-bug-rm.1
new file mode 100644
index 00000000..8989c2ff
--- /dev/null
+++ b/doc/man/git-bug-rm.1
@@ -0,0 +1,28 @@
+.nh
+.TH GIT\-BUG(1)Apr 2019
+Generated from git\-bug's source code
+
+.SH NAME
+.PP
+git\-bug\-rm \- Remove an existing bug.
+
+
+.SH SYNOPSIS
+.PP
+\fBgit\-bug rm ID [flags]\fP
+
+
+.SH DESCRIPTION
+.PP
+Remove an existing bug in the local repository. Note removing bugs that were imported from bridges will not remove the bug on the remote, and will only remove the local copy of the bug.
+
+
+.SH OPTIONS
+.PP
+\fB\-h\fP, \fB\-\-help\fP[=false]
+	help for rm
+
+
+.SH SEE ALSO
+.PP
+\fBgit\-bug(1)\fP
diff --git a/doc/man/git-bug-select.1 b/doc/man/git-bug-select.1
index 4df61221..47d46fe1 100644
--- a/doc/man/git-bug-select.1
+++ b/doc/man/git-bug-select.1
@@ -9,7 +9,7 @@ git\-bug\-select \- Select a bug for implicit use in future commands.
 
 .SH SYNOPSIS
 .PP
-\fBgit\-bug select  [flags]\fP
+\fBgit\-bug select ID [flags]\fP
 
 
 .SH DESCRIPTION
@@ -17,7 +17,7 @@ git\-bug\-select \- Select a bug for implicit use in future commands.
 Select a bug for implicit use in future commands.
 
 .PP
-This command allows you to omit any bug  argument, for example:
+This command allows you to omit any bug ID argument, for example:
   git bug show
 instead of
   git bug show 2f153ca
diff --git a/doc/man/git-bug-show.1 b/doc/man/git-bug-show.1
index eb694dac..6aca9063 100644
--- a/doc/man/git-bug-show.1
+++ b/doc/man/git-bug-show.1
@@ -9,7 +9,7 @@ git\-bug\-show \- Display the details of a bug.
 
 .SH SYNOPSIS
 .PP
-\fBgit\-bug show [] [flags]\fP
+\fBgit\-bug show [ID] [flags]\fP
 
 
 .SH DESCRIPTION
diff --git a/doc/man/git-bug-status-close.1 b/doc/man/git-bug-status-close.1
index 539c5447..2caeb8f5 100644
--- a/doc/man/git-bug-status-close.1
+++ b/doc/man/git-bug-status-close.1
@@ -9,7 +9,7 @@ git\-bug\-status\-close \- Mark a bug as closed.
 
 .SH SYNOPSIS
 .PP
-\fBgit\-bug status close [] [flags]\fP
+\fBgit\-bug status close [ID] [flags]\fP
 
 
 .SH DESCRIPTION
diff --git a/doc/man/git-bug-status-open.1 b/doc/man/git-bug-status-open.1
index d7aca0d0..950574ff 100644
--- a/doc/man/git-bug-status-open.1
+++ b/doc/man/git-bug-status-open.1
@@ -9,7 +9,7 @@ git\-bug\-status\-open \- Mark a bug as open.
 
 .SH SYNOPSIS
 .PP
-\fBgit\-bug status open [] [flags]\fP
+\fBgit\-bug status open [ID] [flags]\fP
 
 
 .SH DESCRIPTION
diff --git a/doc/man/git-bug-status.1 b/doc/man/git-bug-status.1
index df013911..22c31a3a 100644
--- a/doc/man/git-bug-status.1
+++ b/doc/man/git-bug-status.1
@@ -9,7 +9,7 @@ git\-bug\-status \- Display or change a bug status.
 
 .SH SYNOPSIS
 .PP
-\fBgit\-bug status [] [flags]\fP
+\fBgit\-bug status [ID] [flags]\fP
 
 
 .SH DESCRIPTION
diff --git a/doc/man/git-bug-title-edit.1 b/doc/man/git-bug-title-edit.1
index c1903854..99f4de86 100644
--- a/doc/man/git-bug-title-edit.1
+++ b/doc/man/git-bug-title-edit.1
@@ -9,7 +9,7 @@ git\-bug\-title\-edit \- Edit a title of a bug.
 
 .SH SYNOPSIS
 .PP
-\fBgit\-bug title edit [] [flags]\fP
+\fBgit\-bug title edit [ID] [flags]\fP
 
 
 .SH DESCRIPTION
diff --git a/doc/man/git-bug-title.1 b/doc/man/git-bug-title.1
index e3345acd..9d7deb0e 100644
--- a/doc/man/git-bug-title.1
+++ b/doc/man/git-bug-title.1
@@ -9,7 +9,7 @@ git\-bug\-title \- Display or change a title of a bug.
 
 .SH SYNOPSIS
 .PP
-\fBgit\-bug title [] [flags]\fP
+\fBgit\-bug title [ID] [flags]\fP
 
 
 .SH DESCRIPTION
diff --git a/doc/man/git-bug-user-adopt.1 b/doc/man/git-bug-user-adopt.1
index 2be2afcb..6a53b36c 100644
--- a/doc/man/git-bug-user-adopt.1
+++ b/doc/man/git-bug-user-adopt.1
@@ -9,7 +9,7 @@ git\-bug\-user\-adopt \- Adopt an existing identity as your own.
 
 .SH SYNOPSIS
 .PP
-\fBgit\-bug user adopt  [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 5a4cf439..a454b56c 100644
--- a/doc/man/git-bug-user.1
+++ b/doc/man/git-bug-user.1
@@ -9,7 +9,7 @@ git\-bug\-user \- Display or change the user identity.
 
 .SH SYNOPSIS
 .PP
-\fBgit\-bug user [] [flags]\fP
+\fBgit\-bug user [USER\-ID] [flags]\fP
 
 
 .SH DESCRIPTION
diff --git a/doc/man/git-bug.1 b/doc/man/git-bug.1
index b9e5d758..ecb35feb 100644
--- a/doc/man/git-bug.1
+++ b/doc/man/git-bug.1
@@ -30,4 +30,4 @@ the same git remote you are already using to collaborate with other people.
 
 .SH SEE ALSO
 .PP
-\fBgit\-bug\-add(1)\fP, \fBgit\-bug\-bridge(1)\fP, \fBgit\-bug\-commands(1)\fP, \fBgit\-bug\-comment(1)\fP, \fBgit\-bug\-deselect(1)\fP, \fBgit\-bug\-label(1)\fP, \fBgit\-bug\-ls(1)\fP, \fBgit\-bug\-ls\-id(1)\fP, \fBgit\-bug\-ls\-label(1)\fP, \fBgit\-bug\-pull(1)\fP, \fBgit\-bug\-push(1)\fP, \fBgit\-bug\-select(1)\fP, \fBgit\-bug\-show(1)\fP, \fBgit\-bug\-status(1)\fP, \fBgit\-bug\-termui(1)\fP, \fBgit\-bug\-title(1)\fP, \fBgit\-bug\-user(1)\fP, \fBgit\-bug\-version(1)\fP, \fBgit\-bug\-webui(1)\fP
+\fBgit\-bug\-add(1)\fP, \fBgit\-bug\-bridge(1)\fP, \fBgit\-bug\-commands(1)\fP, \fBgit\-bug\-comment(1)\fP, \fBgit\-bug\-deselect(1)\fP, \fBgit\-bug\-label(1)\fP, \fBgit\-bug\-ls(1)\fP, \fBgit\-bug\-ls\-id(1)\fP, \fBgit\-bug\-ls\-label(1)\fP, \fBgit\-bug\-pull(1)\fP, \fBgit\-bug\-push(1)\fP, \fBgit\-bug\-rm(1)\fP, \fBgit\-bug\-select(1)\fP, \fBgit\-bug\-show(1)\fP, \fBgit\-bug\-status(1)\fP, \fBgit\-bug\-termui(1)\fP, \fBgit\-bug\-title(1)\fP, \fBgit\-bug\-user(1)\fP, \fBgit\-bug\-version(1)\fP, \fBgit\-bug\-webui(1)\fP
diff --git a/doc/md/git-bug.md b/doc/md/git-bug.md
index 5a736f34..99b554e2 100644
--- a/doc/md/git-bug.md
+++ b/doc/md/git-bug.md
@@ -35,6 +35,7 @@ git-bug [flags]
 * [git-bug ls-label](git-bug_ls-label.md)	 - List valid labels.
 * [git-bug pull](git-bug_pull.md)	 - Pull bugs update from a git remote.
 * [git-bug push](git-bug_push.md)	 - Push bugs update to a git remote.
+* [git-bug rm](git-bug_rm.md)	 - Remove an existing bug.
 * [git-bug select](git-bug_select.md)	 - Select a bug for implicit use in future commands.
 * [git-bug show](git-bug_show.md)	 - Display the details of a bug.
 * [git-bug status](git-bug_status.md)	 - Display or change a bug status.
diff --git a/doc/md/git-bug_bridge_auth_add-token.md b/doc/md/git-bug_bridge_auth_add-token.md
index f0f8ac72..c6466522 100644
--- a/doc/md/git-bug_bridge_auth_add-token.md
+++ b/doc/md/git-bug_bridge_auth_add-token.md
@@ -7,7 +7,7 @@ Store a new token
 Store a new token
 
 ```
-git-bug bridge auth add-token [<token>] [flags]
+git-bug bridge auth add-token [TOKEN] [flags]
 ```
 
 ### Options
diff --git a/doc/md/git-bug_bridge_auth_rm.md b/doc/md/git-bug_bridge_auth_rm.md
index 059aa43d..cf470c0c 100644
--- a/doc/md/git-bug_bridge_auth_rm.md
+++ b/doc/md/git-bug_bridge_auth_rm.md
@@ -7,7 +7,7 @@ Remove a credential.
 Remove a credential.
 
 ```
-git-bug bridge auth rm <id> [flags]
+git-bug bridge auth rm ID [flags]
 ```
 
 ### Options
diff --git a/doc/md/git-bug_bridge_pull.md b/doc/md/git-bug_bridge_pull.md
index fea92b85..784bf99c 100644
--- a/doc/md/git-bug_bridge_pull.md
+++ b/doc/md/git-bug_bridge_pull.md
@@ -7,7 +7,7 @@ Pull updates.
 Pull updates.
 
 ```
-git-bug bridge pull [<name>] [flags]
+git-bug bridge pull [NAME] [flags]
 ```
 
 ### Options
diff --git a/doc/md/git-bug_bridge_push.md b/doc/md/git-bug_bridge_push.md
index 35436dd6..387270e2 100644
--- a/doc/md/git-bug_bridge_push.md
+++ b/doc/md/git-bug_bridge_push.md
@@ -7,7 +7,7 @@ Push updates.
 Push updates.
 
 ```
-git-bug bridge push [<name>] [flags]
+git-bug bridge push [NAME] [flags]
 ```
 
 ### Options
diff --git a/doc/md/git-bug_bridge_rm.md b/doc/md/git-bug_bridge_rm.md
index 54941b2f..748011f2 100644
--- a/doc/md/git-bug_bridge_rm.md
+++ b/doc/md/git-bug_bridge_rm.md
@@ -7,7 +7,7 @@ Delete a configured bridge.
 Delete a configured bridge.
 
 ```
-git-bug bridge rm <name> [flags]
+git-bug bridge rm NAME [flags]
 ```
 
 ### Options
diff --git a/doc/md/git-bug_commands.md b/doc/md/git-bug_commands.md
index e1a409d2..00eef422 100644
--- a/doc/md/git-bug_commands.md
+++ b/doc/md/git-bug_commands.md
@@ -7,7 +7,7 @@ Display available commands.
 Display available commands.
 
 ```
-git-bug commands [<option>...] [flags]
+git-bug commands [flags]
 ```
 
 ### Options
diff --git a/doc/md/git-bug_comment.md b/doc/md/git-bug_comment.md
index 5a79cf6f..60c4ee88 100644
--- a/doc/md/git-bug_comment.md
+++ b/doc/md/git-bug_comment.md
@@ -7,7 +7,7 @@ Display or add comments to a bug.
 Display or add comments to a bug.
 
 ```
-git-bug comment [<id>] [flags]
+git-bug comment [ID] [flags]
 ```
 
 ### Options
diff --git a/doc/md/git-bug_comment_add.md b/doc/md/git-bug_comment_add.md
index 51114f7d..64bd840c 100644
--- a/doc/md/git-bug_comment_add.md
+++ b/doc/md/git-bug_comment_add.md
@@ -7,7 +7,7 @@ Add a new comment to a bug.
 Add a new comment to a bug.
 
 ```
-git-bug comment add [<id>] [flags]
+git-bug comment add [ID] [flags]
 ```
 
 ### Options
diff --git a/doc/md/git-bug_label.md b/doc/md/git-bug_label.md
index 5ac7c2e6..a847af3d 100644
--- a/doc/md/git-bug_label.md
+++ b/doc/md/git-bug_label.md
@@ -7,7 +7,7 @@ Display, add or remove labels to/from a bug.
 Display, add or remove labels to/from a bug.
 
 ```
-git-bug label [<id>] [flags]
+git-bug label [ID] [flags]
 ```
 
 ### Options
diff --git a/doc/md/git-bug_label_add.md b/doc/md/git-bug_label_add.md
index ee0a82ad..9900b52d 100644
--- a/doc/md/git-bug_label_add.md
+++ b/doc/md/git-bug_label_add.md
@@ -7,7 +7,7 @@ Add a label to a bug.
 Add a label to a bug.
 
 ```
-git-bug label add [<id>] <label>[...] [flags]
+git-bug label add [ID] LABEL... [flags]
 ```
 
 ### Options
diff --git a/doc/md/git-bug_label_rm.md b/doc/md/git-bug_label_rm.md
index b447f44d..fa6d1aa3 100644
--- a/doc/md/git-bug_label_rm.md
+++ b/doc/md/git-bug_label_rm.md
@@ -7,7 +7,7 @@ Remove a label from a bug.
 Remove a label from a bug.
 
 ```
-git-bug label rm [<id>] <label>[...] [flags]
+git-bug label rm [ID] LABEL... [flags]
 ```
 
 ### Options
diff --git a/doc/md/git-bug_ls-id.md b/doc/md/git-bug_ls-id.md
index 0117474c..134f3aec 100644
--- a/doc/md/git-bug_ls-id.md
+++ b/doc/md/git-bug_ls-id.md
@@ -7,7 +7,7 @@ List bug identifiers.
 List bug identifiers.
 
 ```
-git-bug ls-id [<prefix>] [flags]
+git-bug ls-id [PREFIX] [flags]
 ```
 
 ### Options
diff --git a/doc/md/git-bug_ls.md b/doc/md/git-bug_ls.md
index 1532efab..e2721c72 100644
--- a/doc/md/git-bug_ls.md
+++ b/doc/md/git-bug_ls.md
@@ -9,7 +9,7 @@ Display a summary of each bugs.
 You can pass an additional query to filter and order the list. This query can be expressed either with a simple query language or with flags.
 
 ```
-git-bug ls [<query>] [flags]
+git-bug ls [QUERY] [flags]
 ```
 
 ### Examples
diff --git a/doc/md/git-bug_pull.md b/doc/md/git-bug_pull.md
index 1519c87f..cf29e079 100644
--- a/doc/md/git-bug_pull.md
+++ b/doc/md/git-bug_pull.md
@@ -7,7 +7,7 @@ Pull bugs update from a git remote.
 Pull bugs update from a git remote.
 
 ```
-git-bug pull [<remote>] [flags]
+git-bug pull [REMOTE] [flags]
 ```
 
 ### Options
diff --git a/doc/md/git-bug_push.md b/doc/md/git-bug_push.md
index 5e95ea2f..226bc951 100644
--- a/doc/md/git-bug_push.md
+++ b/doc/md/git-bug_push.md
@@ -7,7 +7,7 @@ Push bugs update to a git remote.
 Push bugs update to a git remote.
 
 ```
-git-bug push [<remote>] [flags]
+git-bug push [REMOTE] [flags]
 ```
 
 ### Options
diff --git a/doc/md/git-bug_rm.md b/doc/md/git-bug_rm.md
new file mode 100644
index 00000000..3b77ce1c
--- /dev/null
+++ b/doc/md/git-bug_rm.md
@@ -0,0 +1,22 @@
+## git-bug rm
+
+Remove an existing bug.
+
+### Synopsis
+
+Remove an existing bug in the local repository. Note removing bugs that were imported from bridges will not remove the bug on the remote, and will only remove the local copy of the bug.
+
+```
+git-bug rm ID [flags]
+```
+
+### Options
+
+```
+  -h, --help   help for rm
+```
+
+### SEE ALSO
+
+* [git-bug](git-bug.md)	 - A bug tracker embedded in Git.
+
diff --git a/doc/md/git-bug_select.md b/doc/md/git-bug_select.md
index 6a851acb..b8a71120 100644
--- a/doc/md/git-bug_select.md
+++ b/doc/md/git-bug_select.md
@@ -6,7 +6,7 @@ Select a bug for implicit use in future commands.
 
 Select a bug for implicit use in future commands.
 
-This command allows you to omit any bug <id> argument, for example:
+This command allows you to omit any bug ID argument, for example:
   git bug show
 instead of
   git bug show 2f153ca
@@ -15,7 +15,7 @@ The complementary command is "git bug deselect" performing the opposite operatio
 
 
 ```
-git-bug select <id> [flags]
+git-bug select ID [flags]
 ```
 
 ### Examples
diff --git a/doc/md/git-bug_show.md b/doc/md/git-bug_show.md
index e6d2d7ba..1c6a4ab0 100644
--- a/doc/md/git-bug_show.md
+++ b/doc/md/git-bug_show.md
@@ -7,7 +7,7 @@ Display the details of a bug.
 Display the details of a bug.
 
 ```
-git-bug show [<id>] [flags]
+git-bug show [ID] [flags]
 ```
 
 ### Options
diff --git a/doc/md/git-bug_status.md b/doc/md/git-bug_status.md
index a04098e6..c2b380f3 100644
--- a/doc/md/git-bug_status.md
+++ b/doc/md/git-bug_status.md
@@ -7,7 +7,7 @@ Display or change a bug status.
 Display or change a bug status.
 
 ```
-git-bug status [<id>] [flags]
+git-bug status [ID] [flags]
 ```
 
 ### Options
diff --git a/doc/md/git-bug_status_close.md b/doc/md/git-bug_status_close.md
index 4978341f..97081b59 100644
--- a/doc/md/git-bug_status_close.md
+++ b/doc/md/git-bug_status_close.md
@@ -7,7 +7,7 @@ Mark a bug as closed.
 Mark a bug as closed.
 
 ```
-git-bug status close [<id>] [flags]
+git-bug status close [ID] [flags]
 ```
 
 ### Options
diff --git a/doc/md/git-bug_status_open.md b/doc/md/git-bug_status_open.md
index f6d03215..661508ad 100644
--- a/doc/md/git-bug_status_open.md
+++ b/doc/md/git-bug_status_open.md
@@ -7,7 +7,7 @@ Mark a bug as open.
 Mark a bug as open.
 
 ```
-git-bug status open [<id>] [flags]
+git-bug status open [ID] [flags]
 ```
 
 ### Options
diff --git a/doc/md/git-bug_title.md b/doc/md/git-bug_title.md
index cb326071..5c5698e0 100644
--- a/doc/md/git-bug_title.md
+++ b/doc/md/git-bug_title.md
@@ -7,7 +7,7 @@ Display or change a title of a bug.
 Display or change a title of a bug.
 
 ```
-git-bug title [<id>] [flags]
+git-bug title [ID] [flags]
 ```
 
 ### Options
diff --git a/doc/md/git-bug_title_edit.md b/doc/md/git-bug_title_edit.md
index edf44a1a..8119b8b5 100644
--- a/doc/md/git-bug_title_edit.md
+++ b/doc/md/git-bug_title_edit.md
@@ -7,7 +7,7 @@ Edit a title of a bug.
 Edit a title of a bug.
 
 ```
-git-bug title edit [<id>] [flags]
+git-bug title edit [ID] [flags]
 ```
 
 ### Options
diff --git a/doc/md/git-bug_user.md b/doc/md/git-bug_user.md
index f2c783af..4fc0dd54 100644
--- a/doc/md/git-bug_user.md
+++ b/doc/md/git-bug_user.md
@@ -7,7 +7,7 @@ Display or change the user identity.
 Display or change the user identity.
 
 ```
-git-bug user [<user-id>] [flags]
+git-bug user [USER-ID] [flags]
 ```
 
 ### Options
diff --git a/doc/md/git-bug_user_adopt.md b/doc/md/git-bug_user_adopt.md
index 7bedace5..86682be0 100644
--- a/doc/md/git-bug_user_adopt.md
+++ b/doc/md/git-bug_user_adopt.md
@@ -7,7 +7,7 @@ Adopt an existing identity as your own.
 Adopt an existing identity as your own.
 
 ```
-git-bug user adopt <user-id> [flags]
+git-bug user adopt USER-ID [flags]
 ```
 
 ### Options