Index: /trunk/Nebulous-Server/Changes
===================================================================
--- /trunk/Nebulous-Server/Changes	(revision 16237)
+++ /trunk/Nebulous-Server/Changes	(revision 16238)
@@ -1,3 +1,6 @@
 Revision history for Nebulous
+
+0.07
+    - add Nebulous::Keys pod
 
 0.06 Fri Jan 25 10:55:59 HST 2008
Index: /trunk/Nebulous-Server/MANIFEST
===================================================================
--- /trunk/Nebulous-Server/MANIFEST	(revision 16237)
+++ /trunk/Nebulous-Server/MANIFEST	(revision 16238)
@@ -35,4 +35,5 @@
 lib/Nebulous/Client/Log.pm
 lib/Nebulous/Client/QuickStart.pod
+lib/Nebulous/Keys.pod
 lib/Nebulous/Server.pm
 lib/Nebulous/Server.pod
Index: /trunk/Nebulous/Changes
===================================================================
--- /trunk/Nebulous/Changes	(revision 16237)
+++ /trunk/Nebulous/Changes	(revision 16238)
@@ -1,3 +1,6 @@
 Revision history for Nebulous
+
+0.07
+    - add Nebulous::Keys pod
 
 0.06 Fri Jan 25 10:55:59 HST 2008
Index: /trunk/Nebulous/MANIFEST
===================================================================
--- /trunk/Nebulous/MANIFEST	(revision 16237)
+++ /trunk/Nebulous/MANIFEST	(revision 16238)
@@ -35,4 +35,5 @@
 lib/Nebulous/Client/Log.pm
 lib/Nebulous/Client/QuickStart.pod
+lib/Nebulous/Keys.pod
 lib/Nebulous/Server.pm
 lib/Nebulous/Server.pod
Index: /trunk/Nebulous/lib/Nebulous/Keys.pod
===================================================================
--- /trunk/Nebulous/lib/Nebulous/Keys.pod	(revision 16238)
+++ /trunk/Nebulous/lib/Nebulous/Keys.pod	(revision 16238)
@@ -0,0 +1,83 @@
+# neb://<volume name>/...
+# neb:path...
+# neb:/path... (same as neb:path, leading '/' is stripped)
+# neb:///path... (same as neb:path)
+
+key:        foo/bar/baz/quix
+mangled to: foo/bar/baz/quix
+volume:     any
+
+key:        /foo/bar/baz/quix
+mangled to: foo/bar/baz/quix
+volume:     any
+
+key:        //foo/bar/baz/quix
+mangled to: foo/bar/baz/quix
+volume:     any
+
+key:        ///foo/bar/baz/quix
+mangled to: foo/bar/baz/quix
+volume:     any
+
+key:        foo////bar/baz/quix
+mangled to: foo/bar/baz/quix
+volume:     any
+
+key:        foo/bar/baz/quix/
+mangled to: foo/bar/baz/quix
+volume:     any
+
+# URI w/ volume name
+
+key:        neb://foo/bar/baz/quix
+mangled to: bar/baz/quix
+volume:     foo
+
+key:        neb://foo//bar/baz/quix
+mangled to: bar/baz/quix
+volume:     foo
+
+key:        neb://foo///bar/baz/quix
+mangled to: bar/baz/quix
+volume:     foo
+
+key:        neb://foo/bar///baz/quix
+mangled to: bar/baz/quix
+volume:     foo
+
+key:        neb://foo/bar/baz/quix/
+mangled to: bar/baz/quix
+volume:     foo
+
+# URI w/o volume name
+
+key:        neb:/foo/bar/baz/quix
+mangled to: foo/bar/baz/quix
+volume:     any
+
+key:        neb:///foo/bar/baz/quix
+mangled to: foo/bar/baz/quix
+volume:     any
+
+key:        neb://///foo/bar/baz/quix
+mangled to: foo/bar/baz/quix
+volume:     any
+
+# key w/ whitespace
+
+like( $@, qr/may not contain whitespace/, "whitespace" );
+"/ foo/bar/baz/quix"
+" /foo/bar/baz/quix"
+"/foo/bar/baz/quix "
+
+# URI w/ whitespace
+
+"neb ://foo/bar/baz/quix"
+"neb:// foo/bar/baz/quix"
+" neb://foo/bar/baz/quix"
+"neb://foo/bar/baz/quix "
+
+# URI w/o volume requires leading slash
+
+like( $@, qr/requires a leading slash/, "leading slash" );
+neb:foo/bar/baz/quix