ovs-vsctl: Make the "list" format more uniform.

[openvswitch] / ovsdb / SPECS

diff --git a/ovsdb/SPECS b/ovsdb/SPECS
index e6e1ca1907342d622c0594e022cc5f4629bbadf3..7963a2adfb38f98c4bc1a5d3cd8896c707e8bbf6 100644 (file)
--- a/ovsdb/SPECS
+++ b/ovsdb/SPECS
@@ -113,9 +113,9 @@ is represented by <database-schema>, as described below.
     If "min" or "max" is not specified, each defaults to 1.  If "max"
     is specified as "unlimited", then there is no specified maximum
     number of elements, although the implementation will enforce some
-    limit.  After considering defaults, "min" must be at least 0,
-    "max" must be at least 1, and "max" must be greater than or equal
-    to "min".
+    limit.  After considering defaults, "min" must be exactly 0 or
+    exactly 1, "max" must be at least 1, and "max" must be greater
+    than or equal to "min".
 
     If "min" and "max" are both 1 and "value" is not specified, the
     type is the scalar type specified by "key".
@@ -634,8 +634,8 @@ Notation for the Wire Protocol
             <mutator> must be "insert" or "delete".
 
             If <mutator> is "insert", then each of the key-value pairs
-            in the map in <value> is added to <column> if its key is
-            not already present.  The required type of <value> is
+            in the map in <value> is added to <column> only if its key
+            is not already present.  The required type of <value> is
             slightly relaxed, in that it may have fewer than the
             minimum number of elements specified by the column's type.
 
@@ -972,3 +972,22 @@ Errors:
 
         The same "uuid-name" appeared on an earlier "insert" or
         "declare" operation within this transaction.
+
+comment
+.......
+
+
+Request object members:
+
+    "op": "comment"                    required
+    "comment": <string>                required
+
+Result object members:
+
+    none
+
+Semantics:
+
+    Provides information to a database administrator on the purpose of
+    a transaction.  The OVSDB server, for example, adds comments in
+    transactions that modify the database to the database journal.