scp.1

[Andrew Stribblehill]

A few people have commented that the synopsis in 'man 1 scp' is a
bit difficult for humans to parse. I attach a diff between the
distributed version and mine:

(I suppose this should really go to the OpenBSD maintainers, but I
wanted a little feedback about whether this was better or not.)

Thanks,

Andrew Stribblehill
Systems Programmer, IT Service, University of Durham
-------------- next part --------------
--- scp.1-	Mon Sep 18 09:29:19 2000
+++ scp.1	Thu Sep 14 17:23:45 2000
@@ -23,22 +23,26 @@
 .Op Fl P Ar port
 .Op Fl c Ar cipher
 .Op Fl i Ar identity_file
-.Sm off
+.Ar src1
 .Oo
-.Op Ar user@
-.Ar host1 No :
-.Oc Ns Ar file1
-.Sm on
-.Op Ar ...
+.Ar ...
+.Ar srcN
+.Oc
+.Ar dest
+.Sh DESCRIPTION 
+.Nm
+copies files between hosts on a network.  Each
+.Ar src
+or
+.Ar dest
+argument is of the form
 .Sm off
 .Oo
 .Op Ar user@
-.Ar host2 No :
-.Oc Ar file2
-.Sm on
-.Sh DESCRIPTION 
-.Nm
-copies files between hosts on a network.  It uses
+.Ar host No :
+.Oc Ar file
+.Sm on .
+It uses
 .Xr ssh 1
 for data transfer, and uses the same authentication and provides the
 same security as
@@ -101,6 +105,41 @@
 Forces
 .Nm
 to use IPv6 addresses only.
+.Sh EXAMPLES
+Copy file
+.Ar src
+from the current directory to become file
+.Ar dest
+on host
+.Ar remotehost
+.Ns :
+.Dl % scp src remotehost:dest
+.Pp
+Copy files
+.Ar src1
+and
+.Ar src2
+from hosts
+.Ar alpha
+and
+.Ar beta
+(respectively), using your own username, into directory
+.Ar dir
+on
+.Ar omega
+.Ns :
+.Dl % scp alpha:src1 beta:src2 omega:dir
+.Pp
+Copy
+.Ar src
+from account
+.Ar ken
+on machine
+.Ar gamma
+into
+.Ar dest
+in the current working directory:
+.Dl % scp ken at gamma:src dest
 .Sh AUTHORS
 Timo Rinne <tri at iki.fi> and Tatu Ylonen <ylo at cs.hut.fi>
 .Sh HISTORY