From cc425644228c732359fa44fa130b3e01bf5b4aa4 Mon Sep 17 00:00:00 2001
From: Iustin Pop <iustin@google.com>
Date: Mon, 8 Oct 2007 15:11:45 +0000
Subject: [PATCH] Update man pages for the tags operations

This adds documentation on the {list,add,remove}-tags commands to the
gnt-{cluster,node,instance} man pages.

Reviewed-by: imsnah
---
 man/gnt-cluster.sgml  |   40 ++++++++++++++++++++++++++++++++++++++++
 man/gnt-instance.sgml |   47 +++++++++++++++++++++++++++++++++++++++++++++++
 man/gnt-node.sgml     |   42 ++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 129 insertions(+)

diff --git a/man/gnt-cluster.sgml b/man/gnt-cluster.sgml
index 6b0cc71..ef9e58f 100644
--- a/man/gnt-cluster.sgml
+++ b/man/gnt-cluster.sgml
@@ -56,6 +56,21 @@
     <title>COMMANDS</title>
 
     <refsect2>
+      <title>ADD-TAGS</title>
+
+      <cmdsynopsis>
+        <command>add-tags</command>
+        <arg choice="req"
+        rep="repeat"><replaceable>tag</replaceable></arg>
+      </cmdsynopsis>
+
+      <para>
+        Add tags to the cluster. If any of the tags contains invalid
+        characters, the entire operation will abort.
+      </para>
+    </refsect2>
+
+    <refsect2>
       <title>COMMAND</title>
 
       <cmdsynopsis>
@@ -209,6 +224,16 @@
     </refsect2>
 
     <refsect2>
+      <title>LIST-TAGS</title>
+
+      <cmdsynopsis>
+        <command>list-tags</command>
+      </cmdsynopsis>
+
+      <para>List the tags of the cluster.</para>
+    </refsect2>
+
+    <refsect2>
       <title>MASTERFAILOVER</title>
 
       <cmdsynopsis>
@@ -221,6 +246,21 @@
     </refsect2>
 
     <refsect2>
+      <title>REMOVE-TAGS</title>
+
+      <cmdsynopsis>
+        <command>remove-tags</command>
+        <arg choice="req"
+        rep="repeat"><replaceable>tag</replaceable></arg>
+      </cmdsynopsis>
+
+      <para>
+        Remove tags from the cluster. If any of the tags are not
+        existing on the cluster, the entire operation will abort.
+      </para>
+    </refsect2>
+
+    <refsect2>
       <title>RENAME</title>
 
       <cmdsynopsis>
diff --git a/man/gnt-instance.sgml b/man/gnt-instance.sgml
index fd4cf57..53885e7 100644
--- a/man/gnt-instance.sgml
+++ b/man/gnt-instance.sgml
@@ -750,6 +750,53 @@ node1.example.com:sdb:/dev/md1
 
     </refsect2>
 
+    <refsect2>
+      <title>TAGS</title>
+
+    <refsect3>
+        <title>ADD-TAGS</title>
+
+        <cmdsynopsis>
+          <command>add-tags</command>
+          <arg choice="req"><replaceable>instancename</replaceable></arg>
+          <arg choice="req"
+            rep="repeat"><replaceable>tag</replaceable></arg>
+        </cmdsynopsis>
+
+        <para>
+          Add tags to the given instance. If any of the tags contains
+          invalid characters, the entire operation will abort.
+        </para>
+      </refsect3>
+
+      <refsect3>
+        <title>LIST-TAGS</title>
+
+        <cmdsynopsis>
+          <command>list-tags</command>
+          <arg choice="req"><replaceable>instancename</replaceable></arg>
+        </cmdsynopsis>
+
+        <para>List the tags of the given instance.</para>
+      </refsect3>
+
+      <refsect3>
+        <title>REMOVE-TAGS</title>
+        <cmdsynopsis>
+          <command>remove-tags</command>
+          <arg choice="req"><replaceable>instancename</replaceable></arg>
+          <arg choice="req"
+            rep="repeat"><replaceable>tag</replaceable></arg>
+        </cmdsynopsis>
+
+        <para>
+          Remove tags from the given instance. If any of the tags are
+          not existing on the node, the entire operation will abort.
+        </para>
+      </refsect3>
+
+    </refsect2>
+
   </refsect1>
 
   &footer;
diff --git a/man/gnt-node.sgml b/man/gnt-node.sgml
index 7341f13..1b71e59 100644
--- a/man/gnt-node.sgml
+++ b/man/gnt-node.sgml
@@ -101,6 +101,22 @@
     </refsect2>
 
     <refsect2>
+      <title>ADD-TAGS</title>
+
+      <cmdsynopsis>
+        <command>add-tags</command>
+        <arg choice="req"><replaceable>nodename</replaceable></arg>
+        <arg choice="req"
+        rep="repeat"><replaceable>tag</replaceable></arg>
+      </cmdsynopsis>
+
+      <para>
+        Add tags to the given node. If any of the tags contains
+        invalid characters, the entire operation will abort.
+      </para>
+    </refsect2>
+
+    <refsect2>
       <title>INFO</title>
 
       <cmdsynopsis>
@@ -241,6 +257,17 @@
     </refsect2>
 
     <refsect2>
+      <title>LIST-TAGS</title>
+
+      <cmdsynopsis>
+        <command>list-tags</command>
+        <arg choice="req"><replaceable>nodename</replaceable></arg>
+      </cmdsynopsis>
+
+      <para>List the tags of the given node.</para>
+    </refsect2>
+
+    <refsect2>
       <title>REMOVE</title>
 
       <cmdsynopsis>
@@ -262,6 +289,21 @@
     </refsect2>
 
     <refsect2>
+      <title>REMOVE-TAGS</title>
+      <cmdsynopsis>
+        <command>remove-tags</command>
+        <arg choice="req"><replaceable>nodename</replaceable></arg>
+        <arg choice="req"
+        rep="repeat"><replaceable>tag</replaceable></arg>
+      </cmdsynopsis>
+
+      <para>
+        Remove tags from the given node. If any of the tags are not
+        existing on the node, the entire operation will abort.
+      </para>
+    </refsect2>
+
+    <refsect2>
       <title>VOLUMES</title>
 
       <cmdsynopsis>
-- 
1.7.10.4