From 6c6914c646c4ade95dd737788b30ffde871c9661 Mon Sep 17 00:00:00 2001 From: Nick Mathewson Date: Wed, 16 Mar 2011 15:00:36 -0400 Subject: Clarify what "alphabetical" and "lexical" mean to us. Spotted by Robert Ransom --- dir-spec.txt | 16 ++++++++-------- version-spec.txt | 2 +- 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 -- cgit v1.2.3-54-g00ecf