Doc: Improve -R option added in e5aeed4b80.

Author: Reviewed-by: Peter Smith <[email protected]>
Reviewed-by: vignesh C <[email protected]>
Discussion: https://postgr.es/m/CAHut+PvJPnaL=70SbBe3fYg2nq74Z=Yv4X=zRpUWYfOi-q6=2w@mail.gmail.com

diff --git a/doc/src/sgml/ref/pg_createsubscriber.sgml b/doc/src/sgml/ref/pg_createsubscriber.sgml
index 1f0ddd7f9f2c7623501692853345e01eea1993e7..73377aa6a6edb3b4e1dd6f3b73788c230989c482 100644 (file)
--- a/doc/src/sgml/ref/pg_createsubscriber.sgml
+++ b/doc/src/sgml/ref/pg_createsubscriber.sgml
@@ -167,24 +167,31 @@ PostgreSQL documentation
     </varlistentry>
 
     <varlistentry>
-     <term><option>-R</option></term>
-     <term><option>--remove</option></term>
+     <term><option>-R <replaceable class="parameter">objtype</replaceable></option></term>
+     <term><option>--remove=<replaceable class="parameter">objtype</replaceable></option></term>
      <listitem>
       <para>
        Remove all objects of the specified type from specified databases on the
        target server.
       </para>
       <para>
-       publications: The "all tables" publications established for this
-       subscriber are always removed; specifying this object type causes all
-       other publications replicated from the source server to be dropped as
-       well.
+       <itemizedlist>
+        <listitem>
+         <para>
+          <literal>publications</literal>:
+          The <literal>FOR ALL TABLES</literal> publications established for this
+          subscriber are always removed; specifying this object type causes all
+          other publications replicated from the source server to be dropped as
+          well.
+         </para>
+        </listitem>
+       </itemizedlist>
       </para>
       <para>
-       The objects selected to be dropped are individually logged and do show
-       up in a --dry-run.  There is no opportunity to affect or stop the
-       dropping of the selected objects so consider taking a backup of them
-       using pg_dump.
+       The objects selected to be dropped are individually logged, including during
+       a <option>--dry-run</option>.  There is no opportunity to affect or stop the
+       dropping of the selected objects, so consider taking a backup of them
+       using <application>pg_dump</application>.
       </para>
      </listitem>
     </varlistentry>