Index: /trunk/Nebulous/bin/neb-swap
===================================================================
--- /trunk/Nebulous/bin/neb-swap	(revision 20131)
+++ /trunk/Nebulous/bin/neb-swap	(revision 20132)
@@ -3,5 +3,5 @@
 # Copyright (C) 2008  Joshua Hoblitt
 #
-# $Id: neb-swap,v 1.1 2008-10-14 01:55:41 jhoblitt Exp $
+# $Id: neb-swap,v 1.2 2008-10-14 02:13:33 jhoblitt Exp $
 
 use strict;
@@ -87,4 +87,58 @@
 =back
 
+=head1 EXAMPLE USAGE
+
+    $ neb-stat jhoblitt/foo 
+    object id:     843581
+    key:           jhoblitt/foo
+    read lock:     0
+    write lock:    
+    epoch:         2008-05-28 15:37:08
+    mtime:         0000-00-00 00:00:00
+    n instances:   6
+    instance location:
+        file:///data/ipp013.0/nebulous/61/cd/843295.jhoblitt:foo
+        file:///data/ipp019.0/nebulous/61/cd/2516498.jhoblitt:foo
+        file:///data/ipp021.0/nebulous/61/cd/2516499.jhoblitt:foo
+        file:///data/ipp009.0/nebulous/61/cd/2516500.jhoblitt:foo
+        file:///data/ipp005.0/nebulous/61/cd/2516501.jhoblitt:foo
+        file:///data/ipp020.0/nebulous/61/cd/6907875.jhoblitt:foo
+    $ neb-stat jhoblitt/bar 
+    object id:     6556951
+    key:           jhoblitt/bar
+    read lock:     0
+    write lock:    
+    epoch:         2008-10-13 16:01:41
+    mtime:         0000-00-00 00:00:00
+    n instances:   1
+    instance location:
+        file:///data/ipp028.0/nebulous/45/ce/9596298.jhoblitt:bar
+    $ neb-replicate jhoblitt/bar
+    $ neb-swap jhoblitt/foo jhoblitt/bar
+    $ neb-stat jhoblitt/foo object id:     6556951
+    key:           jhoblitt/foo
+    read lock:     0
+    write lock:    
+    epoch:         2008-10-13 16:01:41
+    mtime:         0000-00-00 00:00:00
+    n instances:   2
+    instance location:
+        file:///data/ipp028.0/nebulous/45/ce/9596298.jhoblitt:bar
+        file:///data/ipp033.0/nebulous/45/ce/9597000.jhoblitt:bar
+    $ neb-stat jhoblitt/barobject id:     843581
+    key:           jhoblitt/bar
+    read lock:     0
+    write lock:    
+    epoch:         2008-05-28 15:37:08
+    mtime:         0000-00-00 00:00:00
+    n instances:   6
+    instance location:
+        file:///data/ipp013.0/nebulous/61/cd/843295.jhoblitt:foo
+        file:///data/ipp019.0/nebulous/61/cd/2516498.jhoblitt:foo
+        file:///data/ipp021.0/nebulous/61/cd/2516499.jhoblitt:foo
+        file:///data/ipp009.0/nebulous/61/cd/2516500.jhoblitt:foo
+        file:///data/ipp005.0/nebulous/61/cd/2516501.jhoblitt:foo
+        file:///data/ipp020.0/nebulous/61/cd/6907875.jhoblitt:foo
+
 =head1 CREDITS