Synchronize mpp_execute option description and precedence rules in en… (#6734)

* Synchronize mpp_execute option description and precedence rules in end-user documentation

* describe the order of precedence in each command

* one any -> any one

* Feedback from Lisa

gpdb-doc/dita/ref_guide/sql_commands/CREATE_FOREIGN_DATA_WRAPPER.xml

@@ -10,7 +10,7 @@
             <codeblock id="sql_command_synopsis">CREATE FOREIGN DATA WRAPPER <varname>name</varname>
     [ HANDLER <varname>handler_function</varname> | NO HANDLER ]
     [ VALIDATOR <varname>validator_function</varname> | NO VALIDATOR ]
-    [ OPTIONS ( <varname>option</varname> '<varname>value</varname>' [, ... ] )  ]</codeblock>
+    [ OPTIONS ( [ mpp_execute { 'master' | 'any' | 'all segments' } [, ] ] <varname>option</varname> '<varname>value</varname>' [, ... ] ) ]</codeblock>
         </section>
         <section id="section3">
             <title>Description</title>
@@ -47,6 +47,26 @@
                         <p>The options for the new foreign-data wrapper. Option names must be unique. The option names and values are foreign-data wrapper-specific and are validated using the foreign-data wrappers' <varname>validator_function</varname>.</p>
                     </pd>
                 </plentry>
+                <plentry>
+                    <pt>mpp_execute { 'master | 'any' | 'all segments' }</pt>
+                    <pd>
+                        <p>An option that identifies the host from which the foreign data-wrapper
+                            requests data: <ul id="ul_zcg_2vd_mgb">
+                                <li><codeph>master</codeph> (the default)—Request data from the
+                                    master host.</li>
+                                <li><codeph>any</codeph>—Request data from either the master host or
+                                    any one segment, depending on which path costs less.</li>
+                                <li><codeph>all segments</codeph>—Request data from all segments. To
+                                    support this option value, the foreign data-wrapper must have a
+                                    policy that matches the segments to data.</li>
+                            </ul></p>
+                        <p>The <codeph>mpp_execute</codeph> option can be specified in multiple
+                            commands: <codeph>CREATE FOREIGN TABLE</codeph>, <codeph>CREATE
+                                SERVER</codeph>, and <codeph>CREATE FOREIGN DATA WRAPPER</codeph>.
+                            The foreign table setting takes precedence over the foreign server
+                            setting, followed by the foreign data wrapper setting.</p>
+                    </pd>
+                </plentry>
             </parml>
         </section>
         <section id="section5">

gpdb-doc/dita/ref_guide/sql_commands/CREATE_FOREIGN_TABLE.xml

@@ -98,11 +98,23 @@
                 <plentry>
                     <pt>mpp_execute { 'master | 'any' | 'all segments' }</pt>
                     <pd>
-                      <p>Option that identifies the host from which the foreign data-wrapper requests data: the
-                        master host, any (master or single segment) host, or all segment hosts. The default option value
-                       is '<codeph>master</codeph>'.</p>
-                      <p>Use of the foreign table <codeph>mpp_execute</codeph> option, and the
-                       specific modes supported, is foreign data-wrapper-specific.</p>
+                        <p>An option that identifies the host from which the foreign data-wrapper
+                            requests data: <ul id="ul_zcg_2vd_mgb">
+                                <li><codeph>master</codeph> (the default)—Request data from the
+                                    master host.</li>
+                                <li><codeph>any</codeph>—Request data from either the master host or
+                                    any one segment, depending on which path costs less.</li>
+                                <li><codeph>all segments</codeph>—Request data from all segments. To
+                                    support this option value, the foreign data-wrapper must have a
+                                    policy that matches the segments to data.</li>
+                            </ul></p>
+                        <p>Use of the foreign table <codeph>mpp_execute</codeph> option, and the
+                            specific modes supported, is foreign data-wrapper-specific.</p>
+                        <p>The <codeph>mpp_execute</codeph> option can be specified in multiple
+                            commands: <codeph>CREATE FOREIGN TABLE</codeph>, <codeph>CREATE
+                                SERVER</codeph>, and <codeph>CREATE FOREIGN DATA WRAPPER</codeph>.
+                            The foreign table setting takes precedence over the foreign server
+                            setting, followed by the foreign data wrapper setting.</p>
                     </pd>
                 </plentry>
             </parml>

gpdb-doc/dita/ref_guide/sql_commands/CREATE_SERVER.xml

@@ -9,7 +9,7 @@
             <title>Synopsis</title>
             <codeblock id="sql_command_synopsis">CREATE SERVER <varname>server_name</varname> [ TYPE '<varname>server_type</varname>' ] [ VERSION '<varname>server_version</varname>' ]
     FOREIGN DATA WRAPPER <varname>fdw_name</varname>
-    [ OPTIONS ( <varname>option</varname> '<varname>value</varname>' [, ... ] ) ]</codeblock>
+    [ OPTIONS ( [ mpp_execute { 'master' | 'any' | 'all segments' } [, ] ] <varname>option</varname> '<varname>value</varname>' [, ... ] ) ]</codeblock>
         </section>
         <section id="section3">
             <title>Description</title>
@@ -54,6 +54,26 @@
                         <p>The options for the new foreign server. The options typically define the connection details of the server, but the actual names and values are dependent upon the server's foreign-data wrapper.</p>
                     </pd>
                 </plentry>
+                <plentry>
+                    <pt>mpp_execute { 'master | 'any' | 'all segments' }</pt>
+                    <pd>
+                        <p>An option that identifies the host from which the foreign data-wrapper
+                            requests data: <ul id="ul_zcg_2vd_mgb">
+                                <li><codeph>master</codeph> (the default)—Request data from the
+                                    master host.</li>
+                                <li><codeph>any</codeph>—Request data from either the master host or
+                                    any one segment, depending on which path costs less.</li>
+                                <li><codeph>all segments</codeph>—Request data from all segments. To
+                                    support this option value, the foreign data-wrapper must have a
+                                    policy that matches the segments to data.</li>
+                            </ul></p>
+                        <p>The <codeph>mpp_execute</codeph> option can be specified in multiple
+                            commands: <codeph>CREATE FOREIGN TABLE</codeph>, <codeph>CREATE
+                                SERVER</codeph>, and <codeph>CREATE FOREIGN DATA WRAPPER</codeph>.
+                            The foreign table setting takes precedence over the foreign server
+                            setting, followed by the foreign data wrapper setting.</p>
+                    </pd>
+                </plentry>
             </parml>
         </section>
         <section id="section5">