Add -s and --no-progress options to gprecoverseg (#7282)

gpdb-doc/dita/utility_guide/admin_utilities/gprecoverseg.xml

@@ -9,14 +9,15 @@
     <section id="section2">
       <title>Synopsis</title>
       <codeblock><b>gprecoverseg</b> [<b>-p</b> <varname>new_recover_host</varname>[,...]] | <b>-i</b> <varname>recover_config_file</varname>] [<b>-d</b> <varname>master_data_directory</varname>] 
-             [<b>-B</b> <varname>parallel_processes</varname>] [<b>-F</b>] [<b>-a</b>] [<b>-q</b>] [<b>-l</b> <varname>logfile_directory</varname>]
+             [<b>-B</b> <varname>parallel_processes</varname>] [<b>-F</b> [<b>-s</b>]] [<b>-a</b>] [<b>-q</b>] 
+             [<b>--no-progress</b>] [<b>-l</b> <varname>logfile_directory</varname>]
 
 <b>gprecoverseg</b> <b>-r</b> 
 
 <b>gprecoverseg</b> <b>-o</b> <varname>output_recover_config_file</varname> 
              [<b>-p</b> <varname>new_recover_host</varname>[,...]]
 
-<b>gprecoverseg</b> <b>-?</b> 
+<b>gprecoverseg</b> <b>-?</b> | <b>--help</b>
 
 <b>gprecoverseg</b> <b>--version</b></codeblock>
     </section>
@@ -105,6 +106,15 @@
               instance before copying the data from the active (current primary) segment instance.
               Before performing a full recovery, ensure that the segment failure did not cause data
               corruption and that any host segment disk issues have been fixed.</note></pd>
+          <pd>Full recovery can take a long time for large databases, so
+              <codeph>gprecoverseg</codeph> displays a running estimate of the completion progress
+            of the copy for each segment. Progress for each segment is updated once per second,
+            using ANSI escape codes to update the line for each segment in-place. If you are
+            redirecting the <codeph>gprecoverseg</codeph> output to a file, or if the ANSI escape
+            codes do not work correctly on your terminal, you can include the <codeph>-s</codeph>
+            option on the command line to omit the ANSI escape codes. This outputs a new line once
+            per second for each segment. Include the <codeph>--no-progress</codeph> option to
+            completely disable the progress reports.</pd>
         </plentry>
         <plentry>
           <pt>-i <varname>recover_config_file</varname></pt>
@@ -169,6 +179,17 @@ newPort:newDataDirectory</codeblock>
             synchronized before running <codeph>gprecoverseg -r</codeph>. If there are any in
             progress queries, they will be cancelled and rolled back.</pd>
         </plentry>
+        <plentry>
+          <pt>-s </pt>
+          <pd>Show <codeph>pg_basebackup</codeph> progress sequentially instead of in-place. Useful
+            when writing to a file, or if a tty does not support escape sequences. The default is to
+            show progress in-place. </pd>
+        </plentry>
+        <plentry>
+          <pt>--no-progress</pt>
+          <pd>Suppresses progress reports from the <codeph>pg_basebackup</codeph> utility. The
+            default is to display progress of base backups. </pd>
+        </plentry>
         <plentry>
           <pt>-v (verbose)</pt>
           <pd>Sets logging output to verbose.</pd>