From c232a7403c305195de7f87e6a6cc63ce3fb3f5c1 Mon Sep 17 00:00:00 2001
From: Craig Ringer <craig@2ndquadrant.com>
Date: Tue, 24 Mar 2015 15:02:34 +0800
Subject: [PATCH] doc: Examples of node removal

---
 doc/manual-node-management.sgml | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/doc/manual-node-management.sgml b/doc/manual-node-management.sgml
index d1f73df55b..b20ac7b6dc 100644
--- a/doc/manual-node-management.sgml
+++ b/doc/manual-node-management.sgml
@@ -209,7 +209,22 @@
   <para>
    A node is removed with the <xref linkend="function-bdr-part-by-node-names">
    function. You must specify the node name (as passed during node creation)
-   to remove a node.
+   to remove a node. You can call <literal>bdr.bdr_part_by_node_names</literal>
+   on the node to be removed (if it is up) or on any other node. Multiple
+   nodes may be removed at once. No value is returned; the removal status may
+   be seen by checking the <literal>status</literal> field in
+   <literal>bdr.bdr_nodes</literal> for that node.
+  </para>
+
+  <para>
+   To remove <literal>node1</literal>:
+   <programlisting>
+    SELECT bdr.bdr_part_by_node_names(ARRAY['node-1']);
+   </programlisting>
+   or to remove multiple nodes at once:
+   <programlisting>
+    SELECT bdr.bdr_part_by_node_names(ARRAY['node-1', 'node-2', 'node-3']);
+   </programlisting>
   </para>
 
   <para>
-- 
2.39.5