--- a/mercurial/commands.py	Tue Jul 11 22:19:49 2006 +0200
+++ b/mercurial/commands.py	Tue Jul 11 22:36:52 2006 +0200
@@ -951,6 +951,10 @@
     hardlinking.
 
     See pull for valid source format details.
+
+    It is possible to specify an ssh:// URL as the destination, but no
+    .hg/hgrc will be created on the remote side. Look at the help text
+    for the pull command for important details about ssh:// URLs.
     """
     if dest is None:
         dest = os.path.basename(os.path.normpath(source))
@@ -1960,6 +1964,10 @@
     directory does not exist, it is created.
 
     If no directory is given, the current directory is used.
+
+    It is possible to specify an ssh:// URL as the destination.
+    Look at the help text for the pull command for important details
+    about ssh:// URLs.
     """
     hg.repository(ui, dest, create=1)
 
@@ -2236,7 +2244,8 @@
     - SSH requires an accessible shell account on the destination machine
       and a copy of hg in the remote path or specified with as remotecmd.
     - path is relative to the remote user's home directory by default.
-      Use a slash at the start of a path to specify an absolute path.
+      Use an extra slash at the start of a path to specify an absolute path:
+        ssh://example.com//tmp/repository
     - Mercurial doesn't use its own compression via SSH; the right thing
       to do is to configure it in your ~/.ssh/ssh_config, e.g.:
         Host *.mylocalnetwork.example.com
@@ -2284,6 +2293,9 @@
 
     Look at the help text for the pull command for important details
     about ssh:// URLs.
+
+    Pushing to http:// and https:// URLs is possible, too, if this
+    feature is enabled on the remote Mercurial server.
     """
     dest = ui.expandpath(dest or 'default-push', dest or 'default')