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
