Update documentation for text format

[ganeti-local] / man / htools.rst

diff --git a/man/htools.rst b/man/htools.rst
index e19ce82..b908863 100644 (file)
--- a/man/htools.rst
+++ b/man/htools.rst
@@ -151,26 +151,30 @@ support all options. Some common options are:
   Backend specification: the name of the file holding node and instance
   information (if not collecting via RAPI or LUXI). This or one of the
   other backends must be selected. The option is described in the man
-  page **htools**(1).
+  page **htools**\(1).
 
-  The file should contain text data, line-based, with two empty lines
+  The file should contain text data, line-based, with single empty lines
   separating sections. The lines themselves are column-based, with the
   pipe symbol (``|``) acting as separator.
 
-  The first section contains group data, with two columns:
+  The first section contains group data, with the following columns:
 
   - group name
   - group uuid
+  - allocation policy
+  - tags (separated by comma)
 
   The second sections contains node data, with the following columns:
 
   - node name
   - node total memory
+  - memory used by the node
   - node free memory
   - node total disk
   - node free disk
   - node physical cores
-  - offline field (as ``Y`` or ``N``)
+  - offline/role field (``Y`` for offline nodes, ``N`` for online non-master
+    nodes, and ``M`` for the master node which is always online)
   - group UUID
   - node spindle count
 
@@ -181,7 +185,7 @@ support all options. Some common options are:
   - instance disk size
   - instance vcpus
   - instance status (in Ganeti's format, e.g. ``running`` or ``ERROR_down``)
-  - instance ``auto_balance`` flag (see man page **gnt-instance** (7))
+  - instance ``auto_balance`` flag (see man page **gnt-instance**\(8))
   - instance primary node
   - instance secondary node(s), if any
   - instance disk type (e.g. ``plain`` or ``drbd``)
@@ -200,7 +204,7 @@ support all options. Some common options are:
     - cpu count
     - disk size
     - disk count
-    - nic count
+    - NIC count
   - disk templates
   - vcpu ratio
   - spindle ratio
@@ -272,7 +276,7 @@ their longer equivalents of *MB*, *GB*, *TB*, for which case doesn't
 matter).
 
 More details about the difference between the SI and binary systems can
-be read in the *units(7)* man page.
+be read in the **units**\(7) man page.
 
 ENVIRONMENT
 -----------