[tor-bugs] #8165 [Tor]: torspec: Document the new "flag-thresholds" item in votes

[Tor Bug Tracker & Wiki]

#8165: torspec: Document the new "flag-thresholds" item in votes
---------------------+------------------------------------------------------
 Reporter:  asn      |          Owner:              
     Type:  defect   |         Status:  needs_review
 Priority:  normal   |      Milestone:              
Component:  Tor      |        Version:              
 Keywords:  torspec  |         Parent:  #8151       
   Points:           |   Actualpoints:              
---------------------+------------------------------------------------------

Comment(by atagar):

 Please add a formal description of the Thresholds attribute. At present
 there's not enough information to know what the line has. My first thought
 was 'oh, they're probably just space separated flags', then 'hm, maybe
 they're key=<int> mappings?' - both were wrong so I was lucky that Karsten
 had an example on #8164.

 Something like the following might work...

 {{{
 "flag-thresholds" SP THRESHOLDS NL

 [At most once for votes; does not occur in consensuses.]

 THRESHOLDS = THRESHOLD | THRESHOLD SP THRESHOLDS
 THRESHOLD = THRESHOLD_KEY "=" THRESHOLD_VALUE
 THRESHOLD_KEY = [A-Za-z0-9]+
 THRESHOLD_VALUE = [A-Za-z0-9%]+
 }}}

 I suspect that what we really want for THRESHOLD_VALUE is 'ArgumentChar
 except WS' though I'm not entirely sure how we'd define that.

 Also, can there be duplicate THRESHOLD_KEYs? If so then what does it mean?

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