docs - pxf [cluster] sync now supports a delete option (#9631)

* docs - pxf [cluster] sync now supports a delete option

* option and argument

* replace single dash with unicode

* misc edir

gpdb-doc/markdown/pxf/ref/pxf-cluster.html.md.erb

@@ -7,7 +7,7 @@ Manage the PXF configuration and the PXF service instance on all Greenplum Datab
 ## <a id="topic1__section2"></a>Synopsis
 
 ``` pre
-pxf cluster <command>
+pxf cluster <command> [<option>]
 ```
 
 where `<command>` is:
@@ -61,7 +61,15 @@ The `pxf cluster` utility command manages PXF on the master, standby master, and
 <dd>Stop the PXF service instance on all segment hosts.</dd>
 
 <dt>sync  </dt>
-<dd>Synchronize the PXF configuration from the master to the standby master and to all Greenplum Database segment hosts. If you have updated the PXF user configuration or added JAR files, you must also restart PXF after you synchronize the PXF configuration.</dd>
+<dd>Synchronize the PXF configuration (`$PXF_CONF`) from the master to the standby master and to all Greenplum Database segment hosts. By default, this command updates files on and copies files to the remote. You can instruct PXF to also delete files during the synchronization; see [Options](#options).</dd>
+<dd>If you have updated the PXF user configuration or added JAR files, you must also restart PXF after you synchronize the PXF configuration.</dd>
+
+## <a id="options"></a>Options
+
+The `pxf cluster sync` command takes the following option:
+
+<dt>&#8211;d | &#8211;&#8211;delete </dt>
+<dd>Delete any files in the PXF user configuration on the standby master and segment hosts that are not also present on the master host.</dd>
 
 ## <a id="topic1__section5"></a>Examples
 
@@ -71,6 +79,12 @@ Stop the PXF service instance on all segment hosts:
 $ $GPHOME/pxf/bin/pxf cluster stop
 ```
 
+Synchronize the PXF configuration to the standby and all segment hosts, deleting files that do not exist on the master host:
+
+``` shell
+$ $GPHOME/pxf/bin/pxf cluster sync --delete
+```
+
 ## <a id="topic1__section6"></a>See Also
 
 [`pxf`](pxf.html#topic1)

gpdb-doc/markdown/pxf/ref/pxf.html.md.erb

@@ -62,7 +62,7 @@ You can start, stop, or restart the PXF service instance on a specific segment h
 <dd>Stop the PXF service instance running on the segment host.</dd>
 
 <dt>sync  </dt>
-<dd>Synchronize the PXF configuration from the master to a specific Greenplum Database standby master or segment host. You must run `pxf sync` on the master host. See [Options](pxf.html#options).</dd>
+<dd>Synchronize the PXF configuration (`$PXF_CONF`) from the master to a specific Greenplum Database standby master or segment host. You must run `pxf sync` on the master host. By default, this command updates files on and copies files to the remote. You can instruct PXF to also delete files during the synchronization; see [Options](#options).</dd>
 
 <dt>version  </dt>
 <dd>Display the PXF version and then exit.</dd>
@@ -71,18 +71,21 @@ You can start, stop, or restart the PXF service instance on a specific segment h
 
 The `pxf init` command takes the following option:
 
-<dt>-y </dt>
+<dt>&#8211;y </dt>
 <dd>Do not prompt, use the default `$PXF_CONF` directory location if the environment variable is not set.</dd>
 
 The `pxf reset` command takes the following option:
 
-<dt>-f | --force </dt>
+<dt>&#8211;f | &#8211;&#8211;force </dt>
 <dd>Do not prompt before resetting the PXF service instance; reset without user interaction.</dd>
 
-The `pxf sync` command, run on the Greenplum Database master host, takes the following option:
+The `pxf sync` command, which you must run on the Greenplum Database master host, takes the following option and argument:
+
+<dt>&#8211;d | &#8211;&#8211;delete </dt>
+<dd>Delete any files in the PXF user configuration on `<gphost>` that are not also present on the master host. If you specify this option, you must provide it on the command line before `<gphost>`.</dd>
 
 <dt>\<gphost\> </dt>
-<dd>The Greenplum Database host to which to synchronize the PXF configuration. `<gphost>` must identify the standy master host or a segment host.</dd>
+<dd>The Greenplum Database host to which to synchronize the PXF configuration. Required. `<gphost>` must identify the standy master host or a segment host.</dd>
 
 ## <a id="topic1__section5"></a>Examples