aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorNick Mathewson <nickm@torproject.org>2011-03-16 15:00:36 -0400
committerNick Mathewson <nickm@torproject.org>2011-03-16 15:00:36 -0400
commit6c6914c646c4ade95dd737788b30ffde871c9661 (patch)
tree78ef88bd52f32081dc475357ac210e776cecb8aa
parentab2e389479d5db84f9a7de5f0e2cf279934d19c6 (diff)
downloadtorspec-6c6914c646c4ade95dd737788b30ffde871c9661.tar.gz
torspec-6c6914c646c4ade95dd737788b30ffde871c9661.zip
Clarify what "alphabetical" and "lexical" mean to us.
Spotted by Robert Ransom
-rw-r--r--dir-spec.txt16
-rw-r--r--version-spec.txt2
2 files changed, 9 insertions, 9 deletions
diff --git a/dir-spec.txt b/dir-spec.txt
index 63e0be9..3b8465f 100644
--- a/dir-spec.txt
+++ b/dir-spec.txt
@@ -1160,8 +1160,8 @@
Parameters ::= Parameter | Parameters SP Parameter
The parameters list, if present, contains a space-separated list of
- case-sensitive key-value pairs, sorted in lexical order by
- their keyword. Each parameter has its own meaning.
+ case-sensitive key-value pairs, sorted in lexical order by their
+ keyword (as ASCII byte strings). Each parameter has its own meaning.
(Only included when the vote is generated with consensus-method 7 or
later.)
@@ -1286,8 +1286,8 @@
[At most once.]
- A series of space-separated status flags, in alphabetical order.
- Currently documented flags are:
+ A series of space-separated status flags, in lexical order (as ASCII
+ byte strings). Currently documented flags are:
"Authority" if the router is a directory authority.
"BadExit" if the router is believed to be useless as an exit node
@@ -1375,10 +1375,10 @@
"Wgb=" INT SP "Wgd=" INT SP "Wgg=" INT SP "Wgm=" INT SP
"Wmb=" INT SP "Wmd=" INT SP "Wme=" INT SP "Wmg=" INT SP "Wmm=" INT NL
- These values represent the weights to apply to router bandwidths during
- path selection. They are sorted in alphabetical order in the list. The
- integer values are divided by BW_WEIGHT_SCALE=10000 or the consensus
- param "bwweightscale". They are:
+ These values represent the weights to apply to router bandwidths
+ during path selection. They are sorted in lexical order (as ASCII byte
+ strings). The integer values are divided by BW_WEIGHT_SCALE=10000 or
+ the consensus param "bwweightscale". They are:
Wgg - Weight for Guard-flagged nodes in the guard position
Wgm - Weight for non-flagged nodes in the guard Position
diff --git a/version-spec.txt b/version-spec.txt
index 265717f..b017335 100644
--- a/version-spec.txt
+++ b/version-spec.txt
@@ -31,7 +31,7 @@
release. If the tag ends with "-cvs" or "-dev", you're looking at a
development snapshot that came after a given release. If we *do*
encounter two versions that differ only by status tag, we compare them
- lexically.
+ lexically as ASCII byte strings.
Now, we start each development branch with (say) 0.1.1.1-alpha. The
patchlevel increments consistently as the status tag changes, for