[tor-commits] [onionoo/master] Clarify protocol spec based on Norman's questions.
karsten at torproject.org
karsten at torproject.org
Sat Aug 4 06:21:48 UTC 2012
Author: Karsten Loesing <karsten.loesing at gmx.net>
Date: Sat Aug 4 07:56:16 2012 +0200
Clarify protocol spec based on Norman's questions.
web/index.html | 20 +++++++++++++-------
1 files changed, 13 insertions(+), 7 deletions(-)
diff --git a/web/index.html b/web/index.html
index a74feac..384bfd4 100755
@@ -782,7 +782,11 @@ running or that have been running in the past week.
<p>Each of the methods above can be parameterized to select only a subset
-of relay and/or bridge documents to be included in the response.</p>
+of relay and/or bridge documents to be included in the response.
+If multiple parameters are specified, they are combined using a logical
+AND operation, meaning that only the intersection of relays and bridges
+matching all parameters is returned.
<table border="0" cellpadding="4" cellspacing="0" summary="">
@@ -797,9 +801,9 @@ of relay and/or bridge documents to be included in the response.</p>
<tr><td><b>search</b></td><td>Return only relays with the parameter value
-matching the beginning of a nickname, (possibly $-prefixed) fingerprint,
-or IP address, and bridges with the nickname or (possibly $-prefixed)
+matching the beginning of a nickname, (possibly $-prefixed) beginning of a
+fingerprint, or beginning of an IP address, and bridges with the beginning
+of a nickname or (possibly $-prefixed) beginning of a hashed fingerprint.
Searches are case-insensitive.
If multiple search terms are given, separated by spaces, the intersection
of all relays and bridges matching all search terms will be returned.
@@ -827,13 +831,15 @@ limited by providing further parameters.</p>
<tr><td><b>order</b></td><td>Re-order results by a comma-separated list
of fields in ascending or descening order.
-Results are first ordered by the second list element, then by the second,
+Results are first ordered by the first list element, then by the second,
and so on.
Possible fields for ordering are: <b>consensus_weight</b>.
Ascending order is the default; descending order is selected by prepending
fields with a minus sign (<b>-</b>).
-Relays which don't have any value for a field to be ordered by are always
-appended to the end, regardless or sorting order.
+Relays or bridges which don't have any value for a field to be ordered by
+are always appended to the end, regardless or sorting order.
+The ordering is defined independent of the requested document type and
+does not require the ordering field to be contained in the document.
If no <b>order</b> parameter is given, ordering of results is
More information about the tor-commits