docs - support for special characters in schema/table names (#7003)

* docs - support for special characters in schema/table names for --include-table option.

* docs - support for special characters in schema/table names for --include-table-file option.

* docs - remove misplaced word "support"

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

@@ -178,10 +178,12 @@
           <pd>Optional. Specifies a table to include in the backup. The table must be in the format
               <codeph>&lt;schema-name>.&lt;table-name></codeph>. If a table or schema name uses any
             character other than a lowercase letter, number, or an underscore character, then you
-            must include that name in double quotes. You can specify this option multiple times. You
-            cannot combine this option with a schema filtering option such as
-              <codeph>--include-schema</codeph>, or another table filtering option such as
-              <codeph>--exclude-table-file</codeph>.</pd>
+            must include that name single quotes. See <xref href="#topic1/table_names" format="dita"
+              >Schema and Table Names</xref> for information about characters that are supported in
+            schema and table names.</pd>
+          <pd>You can specify this option multiple times. You cannot combine this option with a
+            schema filtering option such as <codeph>--include-schema</codeph>, or another table
+            filtering option such as <codeph>--exclude-table-file</codeph>.</pd>
           <pd>You can also specify the qualified name of a sequence or a view. </pd>
           <pd>If you specify this option, the utility does not automatically back up dependent
             objects. You must also explicitly specify dependent objects that are required. For
@@ -200,9 +202,9 @@
           <pd>Optional. Specifies a text file containing a list of tables to include in the backup.
             Each line in the text file must define a single table using the format
               <codeph>&lt;schema-name>.&lt;table-name></codeph>. The file must not include trailing
-            lines. If a table or schema name uses any character other than a lowercase letter,
-            number, or an underscore character, then you must include that name in double quotes.
-            Any tables not listed in this file are omitted from the backup set. You cannot combine
+            lines. See <xref href="#topic1/table_names" format="dita">Schema and Table Names</xref>
+            for information about characters that are supported in schema and table names. </pd>
+          <pd>Any tables not listed in this file are omitted from the backup set. You cannot combine
             this option with a schema filtering option such as <codeph>--include-schema</codeph>, or
             another table filtering option such as <codeph>--exclude-table-file</codeph>.</pd>
           <pd>You can also specify the qualified name of a sequence or a view. </pd>
@@ -343,6 +345,27 @@
           <li><b>2</b> – Backup failed with a fatal error. See log file for more information.</li>
         </ul></p>
     </section>
+    <section id="table_names">
+      <title>Schema and Table Names</title>
+      <p>When specifying the table filtering option <codeph>--include-table</codeph> or
+          <codeph>--include-table-file</codeph> to list tables to be backed up, the
+          <codeph>gpbackup</codeph> utility supports backing up schemas or tables when the name
+        contains upper-case characters or these special characters. </p>
+      <p><codeph> ~ # $ % ^ &amp; * ( ) _ - + [ ] { } > &lt; \ | ; : / ? ! ,</codeph>
+      </p>
+      <p>If a name contains an upper-case or special character and is specified on the command line
+        with <codeph>--include-table</codeph>, the name must be enclosed in single quotes.
+        <codeblock>gpbackup --dbname test --include-table 'my#1schema'.'my_$42_Table'</codeblock></p>
+      <p>When the table is listed in a file for use with <codeph>--include-table-file</codeph>,
+        single quotes are not required. For example, this is the contents of a text file that is
+        used with <codeph>--include-table-file</codeph> to back up two
+        tables.<codeblock>my#1schema.my_$42_Table
+my#1schema.my_$590_Table</codeblock></p>
+      <note>The <codeph>--include-table</codeph> and <codeph>--include-table-file</codeph> options
+        do not support schema or table names that contain the character double quote
+          (<codeph>"</codeph>), period (<codeph>.</codeph>) , newline (<codeph>\n</codeph>), or
+        space (<codeph> </codeph>).</note>
+    </section>
     <section>
       <title>Examples</title>
       <p>Backup all schemas and tables in the "demo" database, including global Greenplum Database