r12643@catbus: nickm | 2007-05-03 13:43:47 -0400

 Note that extensions to the directory protocol should begin their item keywords with "x-" or "X-".

svn:r10108

diff --git a/doc/spec/dir-spec.txt b/doc/spec/dir-spec.txt
index 0743be313db45f9648decd1bdbb8e8520c11991c..139c51162e8b2704e293188773859228b8e1da6b 100644 (file)
--- a/doc/spec/dir-spec.txt
+++ b/doc/spec/dir-spec.txt
@@ -124,6 +124,11 @@ $Id$
   Implementations MUST prefix items not recognized by older versions of Tor
   with an "opt" until those versions of Tor are obsolete.
 
+  Other implementations that want to extend Tor's directory format MAY
+  introduce their own items.  The keywords for extension items SHOULD start
+  with the characters "x-" or "X-", to guarantee that they will not conflict
+  with keywords used by future versions of Tor.
+
 2. Router operation
 
    ORs SHOULD generate a new router descriptor whenever any of the