diff --git a/README.md b/README.md
index 3f8731e..214e11e 100644
--- a/README.md
+++ b/README.md
@@ -55,6 +55,29 @@ To get help on a subcommand:
 	etherdump revisionscount --help
 
 
+Usage / cookbook
+========================
+
+Using etherdump to migrate from one etherpad instance to another
+------------------------------------------------------------------
+
+    mkdir instance1 && cd instance1
+    etherdump init
+    etherdump pull --html --meta
+
+    (cd ..)
+    mkdir instance2 && cd instance2
+    etherdump init
+    etherdump pushhtml --basepath ../instance1 ../instance1/p/*.meta.json
+
+Warning, this command indescriminantly clobbers pads in instance2 with the HTML of the dumped versions from instance1.
+
+Note: this technique can be used to "reset" the database of a pad by recreating pads (without their history or editor info/colors) in a fresh database.
+
+
+
+
+
 Change log / notes
 =======================
 
diff --git a/bin/etherdump b/bin/etherdump
index 9bdefee..679017d 100755
--- a/bin/etherdump
+++ b/bin/etherdump
@@ -7,17 +7,25 @@ usage = """Usage:
     etherdump CMD
 
 where CMD could be:
-    pull
-    index
-    dumpcsv
-    gettext
-    gethtml
+    appendmeta
     creatediffhtml
-    list
-    listauthors
-    revisionscount
-    showmeta
+    deletepad
+    dumpcsv
+    gethtml
+    gettext
     html5tidy
+    index
+    init
+    join
+    listauthors
+    list
+    pull
+    pushhtml
+    revisionscount
+    sethtml
+    settext
+    showmeta
+    status
 
 For more information on each command try:
     etherdump CMD --help