3 files changed, 11 insertions, 9 deletions
diff --git a/doc/man/git-bug-comment-add.1 b/doc/man/git-bug-comment-add.1
index c8838a3f..63fe3ba8 100644
--- a/doc/man/git-bug-comment-add.1
+++ b/doc/man/git-bug-comment-add.1
@@ -20,6 +20,14 @@ Add a new comment
 
 .SH OPTIONS
 .PP
+\fB\-F\fP, \fB\-\-file\fP=""
+    Take the message from the given file. Use \- to read the message from the standard input
+
+.PP
+\fB\-m\fP, \fB\-\-message\fP=""
+    Provide the new message from the command line
+
+.PP
 \fB\-h\fP, \fB\-\-help\fP[=false]
     help for add
 
diff --git a/doc/man/git-bug-comment.1 b/doc/man/git-bug-comment.1
index 511b0851..ef10956d 100644
--- a/doc/man/git-bug-comment.1
+++ b/doc/man/git-bug-comment.1
@@ -20,14 +20,6 @@ Display or add comments
 
 .SH OPTIONS
 .PP
-\fB\-F\fP, \fB\-\-file\fP=""
-    Take the message from the given file. Use \- to read the message from the standard input
-
-.PP
-\fB\-m\fP, \fB\-\-message\fP=""
-    Provide the new message from the command line
-
-.PP
 \fB\-h\fP, \fB\-\-help\fP[=false]
     help for comment
 
diff --git a/doc/man/git-bug.1 b/doc/man/git-bug.1
index 68da9007..7583468a 100644
--- a/doc/man/git-bug.1
+++ b/doc/man/git-bug.1
@@ -18,7 +18,9 @@ git\-bug \- A bug tracker embedded in Git
 git\-bug is a bug tracker embedded in git.
 
 .PP
-It use the same internal storage so it doesn't pollute your project. As you would do with commits and branches, you can push your bugs to the same git remote your are already using to collaborate with other peoples.
+git\-bug use git objects to store the bug tracking separated from the files
+history. As bugs are regular git objects, they can be pushed and pulled from/to
+the same git remote your are already using to collaborate with other peoples.
 
 
 .SH OPTIONS