[tor-bugs] #28664 [Core Tor/Tor]: Describe consensus digest calculation

[Tor Bug Tracker & Wiki]

#28664: Describe consensus digest calculation
---------------------------+------------------------------------
 Reporter:  atagar         |          Owner:  (none)
     Type:  defect         |         Status:  new
 Priority:  Medium         |      Milestone:  Tor: 0.4.0.x-final
Component:  Core Tor/Tor   |        Version:
 Severity:  Normal         |     Resolution:
 Keywords:  tor-spec, doc  |  Actual Points:
Parent ID:                 |         Points:
 Reviewer:                 |        Sponsor:
---------------------------+------------------------------------
Changes (by teor):

 * keywords:   => tor-spec, doc
 * milestone:   => Tor: 0.4.0.x-final


Comment:

 You're right, it's ambiguous, but not quite in the way you think.

 The signing documents section applies to digests, and digests can be on
 the same line as their keyword:
 https://gitweb.torproject.org/torspec.git/tree/dir-spec.txt#n276

 Here's what we can do to fix this spec issue:
 1. In section 1.3 Signing documents, clarify that the digest includes all
 characters before the digest or signature starts. If the digest or
 signature is on the same line as the keyword, the final character is a
 space. If it's on a separate line, the final character is a newline.
 2. Point to section 1.3 from elsewhere in the document.

--
Ticket URL: <https://trac.torproject.org/projects/tor/ticket/28664#comment:2>
Tor Bug Tracker & Wiki <https://trac.torproject.org/>
The Tor Project: anonymity online