[or-cvs] r10110: spec tweaks (in tor/trunk/doc/spec: . proposals)

[arma at seul.org]

Author: arma
Date: 2007-05-04 03:22:11 -0400 (Fri, 04 May 2007)
New Revision: 10110

Modified:
   tor/trunk/doc/spec/control-spec.txt
   tor/trunk/doc/spec/dir-spec.txt
   tor/trunk/doc/spec/proposals/103-multilevel-keys.txt
Log:
spec tweaks


Modified: tor/trunk/doc/spec/control-spec.txt
===================================================================
--- tor/trunk/doc/spec/control-spec.txt	2007-05-03 21:38:47 UTC (rev 10109)
+++ tor/trunk/doc/spec/control-spec.txt	2007-05-04 07:22:11 UTC (rev 10110)
@@ -362,18 +362,20 @@
       not necessarily those for a descriptor that Tor currently has.
       [First implemented in 0.1.2.3-alpha.]
 
-    "ns/all" -- Network status info for all ORs we have an opinion about,
-      joined by newlines. [First implemented in 0.1.2.3-alpha.]
+    "ns/all" -- Network status info (v2 directory style) for all ORs we
+      have an opinion about, joined by newlines. [First implemented
+      in 0.1.2.3-alpha.]
 
     "desc/all-recent" -- the latest server descriptor for every router that
       Tor knows about.
 
-    "network-status" -- a space-separated list of all known OR identities.
-      This is in the same format as the router-status line in directories;
-      see dir-spec-v1.txt section 3 for details.  (If VERBOSE_NAMES is
-      enabled, the output will not conform to dir-spec-v1.txt; instead, the
-      result will be a space-separated list of LongName, each preceded by a
-      "!" if it is believed to be not running.)
+    "network-status" -- a space-separated list (v1 directory style)
+      of all known OR identities. This is in the same format as the
+      router-status line in v1 directories; see dir-spec-v1.txt section
+      3 for details.  (If VERBOSE_NAMES is enabled, the output will
+      not conform to dir-spec-v1.txt; instead, the result will be a
+      space-separated list of LongName, each preceded by a "!" if it is
+      believed to be not running.)
 
     "addr-mappings/all"
     "addr-mappings/config"

Modified: tor/trunk/doc/spec/dir-spec.txt
===================================================================
--- tor/trunk/doc/spec/dir-spec.txt	2007-05-03 21:38:47 UTC (rev 10109)
+++ tor/trunk/doc/spec/dir-spec.txt	2007-05-04 07:22:11 UTC (rev 10110)
@@ -109,9 +109,9 @@
 
       * The most sensitive data in the entire network (the identity keys
         of the directory authorities) needed to be stored unencrypted so
-        that the authorities .  Now, the authorities' identity keys are
-        stored offline, and used to certify medium-term signing keys that
-        can be rotated.
+        that the authorities can sign network-status documents on the fly.
+        Now, the authorities' identity keys are stored offline, and used
+        to certify medium-term signing keys that can be rotated.
 
 0.3. Some Remaining questions
 
@@ -258,7 +258,7 @@
     "Exactly once": These items MUST occur exactly one time in every
       instance of the document type.
 
-    "At start, exactly once": These items MUST occur in every instance of
+    "At end, exactly once": These items MUST occur in every instance of
       the document type, and MUST appear exactly once, and MUST be the
       last item in their documents.
 

Modified: tor/trunk/doc/spec/proposals/103-multilevel-keys.txt
===================================================================
--- tor/trunk/doc/spec/proposals/103-multilevel-keys.txt	2007-05-03 21:38:47 UTC (rev 10109)
+++ tor/trunk/doc/spec/proposals/103-multilevel-keys.txt	2007-05-04 07:22:11 UTC (rev 10110)
@@ -175,7 +175,7 @@
       for that voter.
 
   A key certificate is invalid if any of the following hold:
-      * The version is unrecognized
+      * The version is unrecognized.
       * The fingerprint does not match the identity key.
       * The identity key or the signing key is ill-formed.
       * The published date is very far in the past or future.