diff --git a/README.md b/README.md
index c0560220..d6183f66 100644
--- a/README.md
+++ b/README.md
@@ -87,9 +87,9 @@ We repeat similar steps on $HOST2...
 The only difference, apart from the choice of IP addresses for the
 weave router and the application container, is that we tell our weave
 that it should peer with the weave on $HOST1 (specified as the IP
-address or hostname by which $HOST2 can reach it). NB: if there is a
-firewall between $HOST1 and $HOST2, you must open port 6783 for TCP
-and UDP.
+address or hostname, and optional `:port`, by which $HOST2 can reach
+it). NB: if there is a firewall between $HOST1 and $HOST2, you must
+open port 6783 for TCP and UDP.
 
 Note that we could instead have told the weave on $HOST1 to connect to
 $HOST2, or told both about each other. Order does not matter here;
diff --git a/weave b/weave
index f0bde4a1..8b9ca3a6 100755
--- a/weave
+++ b/weave
@@ -3,7 +3,7 @@ set -e
 
 usage() {
     echo "Usage:"
-    echo "weave launch <cidr> [-password <password>] <peer_host> ..."
+    echo "weave launch <cidr> [-password <password>] <peer> ..."
     echo "weave run    <cidr> <docker run args> ..."
     echo "weave start  <cidr> <container_id>"
     echo "weave attach <cidr> <container_id>"
@@ -15,7 +15,8 @@ usage() {
     echo "weave stop"
     echo "weave reset"
     echo
-    echo "where <cidr> is of the form <ip_address>/<routing_prefix_length>"
+    echo "where <cidr> is of the form <ip_address>/<routing_prefix_length>, and"
+    echo "      <peer> is of the form <ip_address_or_fqdn>[:<port>]"
     exit 1
 }