gbp-pull: Better document --force and --redo-pq

2 files changed, 12 insertions, 9 deletions

diff --git a/docs/manpages/gbp-pull.sgml b/docs/manpages/gbp-pull.sgml
index 2f2b30ee..bc1e97c3 100644
--- a/docs/manpages/gbp-pull.sgml
+++ b/docs/manpages/gbp-pull.sgml
@@ -22,8 +22,8 @@
       &gbp-pull;
 
       <arg><option>--verbose</option></arg>
-      <arg><option>--redo-pq</option></arg>
       <arg><option>--force</option></arg>
+      <arg><option>--redo-pq</option></arg>
       <arg><option>--[no-]pristine-tar</option></arg>
       <arg><option>--debian-branch=</option><replaceable>branch_name</replaceable></arg>
       <arg><option>--upstream-branch=</option><replaceable>branch_name</replaceable></arg>
@@ -45,13 +45,16 @@
       <varlistentry>
         <term><option>--force</option></term>
         <listitem>
-	  <para>force update even if this results in a non fast forward update</para>
+	  <para>force a branch update even if this results in a non fast
+	  forward update. <warning><para>Forcing a branch updates
+	  makes you lose your modifications.</para></warning></para>
         </listitem>
       </varlistentry>
       <varlistentry>
         <term><option>--redo-pq</option></term>
         <listitem>
-	  <para>also rebuild the corresponding patch-queue using &gbp-pq;</para>
+	  <para>also rebuild the corresponding patch-queue using &gbp-pq;.
+	  <warning><para>This drops the patch-queue branch if it exists.</para></warning></para>
         </listitem>
       </varlistentry>
       <varlistentry>
@@ -81,7 +84,7 @@
         <term><option>--pristine-tar</option>
         </term>
         <listitem>
-          <para>generate pristine-tar delta file</para>
+          <para>Wheter to update the pristine-tar branch too.</para>
         </listitem>
       </varlistentry>
     </variablelist>
diff --git a/gbp-pull b/gbp-pull
index 4f814b24..f8aa9c85 100755
--- a/gbp-pull
+++ b/gbp-pull
@@ -70,15 +70,15 @@ def main(argv):
 
     parser = GbpOptionParser(command=os.path.basename(argv[0]), prefix='',
                              usage='%prog [options] - safely update a repository from remote')
-    branch_group = GbpOptionGroup(parser, "branch options", "branch layout options")
+    branch_group = GbpOptionGroup(parser, "branch options", "branch update and layout options")
     parser.add_option_group(branch_group)
+    branch_group.add_option("--force", action="store_true", dest="force", default=False,
+                      help="force a branch update even if can't be fast forwarded")
+    branch_group.add_option("--redo-pq", action="store_true", dest="redo_pq", default=False,
+                      help="redo the patch queue branch after a pull. Warning: this drops the old patch-queue branch")
     branch_group.add_config_file_option(option_name="upstream-branch", dest="upstream_branch")
     branch_group.add_config_file_option(option_name="debian-branch", dest="debian_branch")
     branch_group.add_boolean_config_file_option(option_name="pristine-tar", dest="pristine_tar")
-    parser.add_option("--force", action="store_true", dest="force", default=False,
-                      help="force update even if not fast forward")
-    parser.add_option("--redo-pq", action="store_true", dest="redo_pq", default=False,
-                      help="Redo the patch queue branch after a pull. Warning: this drops the old patch-queue branch")
     parser.add_option("-v", "--verbose", action="store_true", dest="verbose", default=False,
                       help="verbose command execution")
     parser.add_config_file_option(option_name="color", dest="color")