[or-cvs] r10568: Clarify what we mean by digest, for people who ignore "as si (in tor/trunk: . doc/spec)

[nickm at seul.org]

Author: nickm
Date: 2007-06-11 20:38:44 -0400 (Mon, 11 Jun 2007)
New Revision: 10568

Modified:
   tor/trunk/
   tor/trunk/doc/spec/dir-spec.txt
Log:
 r13366 at catbus:  nickm | 2007-06-11 20:38:38 -0400
 Clarify what we mean by digest, for people who ignore "as signed" and who don't read section 1.3.



Property changes on: tor/trunk
___________________________________________________________________
 svk:merge ticket from /tor/trunk [r13366] on 8246c3cf-6607-4228-993b-4d95d33730f1

Modified: tor/trunk/doc/spec/dir-spec.txt
===================================================================
--- tor/trunk/doc/spec/dir-spec.txt	2007-06-12 00:15:55 UTC (rev 10567)
+++ tor/trunk/doc/spec/dir-spec.txt	2007-06-12 00:38:44 UTC (rev 10568)
@@ -504,10 +504,10 @@
 
        [At most once]
 
-       "Digest" is a hex-encoded digest (using upper-case characters)
-       of the router's extra-info document, as signed in the router's
-       extra-info.  (If this field is absent, the router is not uploading
-       a corresponding extra-info document.)
+       "Digest" is a hex-encoded digest (using upper-case characters) of the
+       router's extra-info document, as signed in the router's extra-info
+       (that is, not including the signature).  (If this field is absent, the
+       router is not uploading a corresponding extra-info document.)
 
        [Versions before 0.2.0.1-alpha don't recognize this, and versions
         before 0.1.2.5-alpha will reject descriptors containing it unless
@@ -793,7 +793,8 @@
         [Exactly once.]
 
         A digest of the vote from the authority that contributed to this
-        consensus. (Hex, upper-case.)
+        consensus, as signed (that is, not including the signature).
+        (Hex, upper-case.)
 
    Each router status entry contains the following items.  Router status
    entries are sorted in ascending order by identity digest.
@@ -805,8 +806,9 @@
 
         "Nickname" is the OR's nickname.  "Identity" is a hash of its
         identity key, encoded in base64, with trailing equals sign(s)
-        removed.  "Digest" is a hash of its most recent descriptor (as
-        signed), encoded in base64 as "identity".  "Publication" is the
+        removed.  "Digest" is a hash of its most recent descriptor as
+        signed (that is, not including the signature), encoded in base64 as
+        "identity".  "Publication" is the
         publication time of its most recent descriptor, in the form
         YYYY-MM-DD HH:MM:SS, in GMT.  "IP" is its current IP address;
         ORPort is its current OR port, "DirPort" is it's current directory