r9277@Kushana: nickm | 2006-10-19 19:03:05 -0400

 Add pragma:no-cache and expires headers so that directory lookups can work better in the presence of caching HTTP proxies. (I would have used Cache-Control, but that is an HTTP/1.1 thing.)  All timeouts are currently wild-assed guesses.


svn:r8765

1 files changed, 19 insertions, 3 deletions

diff --git a/doc/dir-spec.txt b/doc/dir-spec.txt
index 949c2f91f4..3ccba15ab9 100644
--- a/doc/dir-spec.txt
+++ b/doc/dir-spec.txt
@@ -565,7 +565,6 @@ $Id$
 
    For debugging, directories SHOULD expose non-compressed objects at URLs like
    the above, but without the final ".z".
-
    Clients MUST handle compressed concatenated information in two forms:
      - A concatenated list of zlib-compressed objects.
      - A zlib-compressed concatenated list of objects.
@@ -801,7 +800,24 @@ $Id$
 
    ...
 
-7.0 Error and return codes in the directory protocol
+7. Standards compliance
+
+   All clients and servers MUST support HTTP 1.0.
+
+7.1. HTTP headers
+
+  Servers MAY set the Content-Length header.  Servers SHOULD set
+  Content-Encoding to "deflate" or "identity".
+
+  Servers MAY include an X-Your-Address-Is: header, whose value is the
+  apparent IP address of the client connecting to them (as a dotted quad).
+
+  Servers SHOULD disable caching of multiple network statuses or multiple
+  router descriptors.  Servers MAY enable caching of single descriptors,
+  single network statuses, the list of all router descriptors, a v1
+  directory, or a v1 running routers document.  XXX mention times.
+
+7.2. HTTP status codes
 
-We should write down what return codes dirservers send in what situations.
+  XXX We should write down what return codes dirservers send in what situations.