--- a/README.txt	Sun Nov 08 08:52:52 2015 +0100
+++ b/README.txt	Sun Nov 08 08:58:40 2015 +0100
@@ -1,19 +1,25 @@
 .. -*- mode: rst; compile-command: "rst2html README.txt README.html" -*-
 
+================================================
 allpaths extension
-==================
+================================================
 
-This simple extension lets you execute commands on multiple paths.
+Push or pull to many (or all) paths at once::
+
+    hg pushall
 
-For now, this is only the ``push`` command::
+(pushes to all paths defined in the ``[paths]`` config section)::
+
+    hg pullall
 
-    $ hg pushall
+(pulls from all those paths)::
 
-This will push to all paths specified in the ``[paths]`` config section.
+    hg incomingall
+    hg outgoingall
 
 You can also provide the name of a different section::
 
-    $ hg pushall -g publish
+    hg pushall -g publish
 
 This will push to all paths specified in the ``[publish]`` config
 section, which should look like this::
@@ -24,7 +30,13 @@
     other = ssh://my@own/server
     local = /some/other/place
 
-You can also provide standard ``push`` options::
+You can also provide standard options::
+
+    hg pushall -b branch
 
-    $ hg pushall -b branch
+or::
 
+    hg pullall --force
+
+etc.
+