fixed order of tgoto args, zapped reliance on former isprint bug

[unix-history] / usr / src / usr.bin / ftp / ftp.1

diff --git a/usr/src/usr.bin/ftp/ftp.1 b/usr/src/usr.bin/ftp/ftp.1
index 03d6b00..c0071eb 100644 (file)
--- a/usr/src/usr.bin/ftp/ftp.1
+++ b/usr/src/usr.bin/ftp/ftp.1
@@ -1,10 +1,21 @@
-.\" Copyright (c) 1985 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1985 The Regents of the University of California.
+.\" All rights reserved.

 .\"
 .\"

-.\"    @(#)ftp.1       6.5 (Berkeley) %G%
+.\" Redistribution and use in source and binary forms are permitted
+.\" provided that the above copyright notice and this paragraph are
+.\" duplicated in all such forms and that any documentation,
+.\" advertising materials, and other materials related to such
+.\" distribution and use acknowledge that the software was developed
+.\" by the University of California, Berkeley.  The name of the
+.\" University may not be used to endorse or promote products derived
+.\" from this software without specific prior written permission.
+.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
+.\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+.\" WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.

 .\"
 .\"

-.TH FTP 1C "April 29, 1985"
+.\"    @(#)ftp.1       6.10 (Berkeley) %G%
+.\"
+.TH FTP 1 ""

 .UC 5
 .SH NAME
 ftp \- ARPANET file transfer program
 .UC 5
 .SH NAME
 ftp \- ARPANET file transfer program


@@ -41,7 +52,7 @@ will enter its command interpreter and await instructions
 from the user.  When 
 .I ftp
 is awaiting commands from the user the prompt \*(lqftp>\*(rq
 from the user.  When 
 .I ftp
 is awaiting commands from the user the prompt \*(lqftp>\*(rq

-is provided the user.  The following commands are recognized
+is provided to the user.  The following commands are recognized

 by
 .IR ftp :
 .TP
 by
 .IR ftp :
 .TP


@@ -157,6 +168,12 @@ directory,
 .IR remote-directory ,
 and, optionally, placing the output in
 .IR local-file .
 .IR remote-directory ,
 and, optionally, placing the output in
 .IR local-file .

+If interactive prompting is on,
+.I ftp
+will prompt the user to verify that the last argument is indeed the
+target local file for receiving
+.B dir
+output.

 If no directory is specified, the current working
 directory on the remote machine is used.  If no local
 file is specified, or \fIlocal-file\fP is \fB-\fP,
 If no directory is specified, the current working
 directory on the remote machine is used.  If no local
 file is specified, or \fIlocal-file\fP is \fB-\fP,


@@ -229,8 +246,14 @@ is specified, the user's home directory is used.
 Print an abbreviated listing of the contents of a
 directory on the remote machine.  If
 .I remote-directory
 Print an abbreviated listing of the contents of a
 directory on the remote machine.  If
 .I remote-directory

-is left unspecified, the current working directory
-is used.  If no local file is specified, or if \fIlocal-file\fR is \fB-\fR,
+is left unspecified, the current working directory is used.
+If interactive prompting is on,
+.I ftp
+will prompt the user to verify that the last argument is indeed the
+target local file for receiving
+.B ls
+output.
+If no local file is specified, or if \fIlocal-file\fR is \fB-\fR,

 the output is sent to the terminal.
 .TP
 \fBmacdef\fP \fImacro-name\fP
 the output is sent to the terminal.
 .TP
 \fBmacdef\fP \fImacro-name\fP


@@ -430,7 +453,7 @@ command should be an
 to establish the secondary control connection.
 Enter the command "proxy ?" to see other ftp commands executable on the
 secondary connection.
 to establish the secondary control connection.
 Enter the command "proxy ?" to see other ftp commands executable on the
 secondary connection.

-The following commands behave diffrently when prefaced by
+The following commands behave differently when prefaced by

 .BR proxy :
 .B open
 will not define new macros during the auto-login process,
 .BR proxy :
 .B open
 will not define new macros during the auto-login process,


@@ -603,14 +626,14 @@ A synonym for help.
 Command arguments which have embedded spaces may be quoted with
 quote (") marks.
 .SH "ABORTING A FILE TRANSFER"
 Command arguments which have embedded spaces may be quoted with
 quote (") marks.
 .SH "ABORTING A FILE TRANSFER"

-To abort a file transfer, enter the terminal interrupt key sequence
+To abort a file transfer, use the terminal interrupt key

 (usually Ctrl-C).
 Sending transfers will be immediately halted.
 Receiving transfers will be halted by sending a ftp protocol ABOR
 command to the remote server, and discarding any further data received.
 The speed at which this is accomplished depends upon the remote
 server's support for ABOR processing.
 (usually Ctrl-C).
 Sending transfers will be immediately halted.
 Receiving transfers will be halted by sending a ftp protocol ABOR
 command to the remote server, and discarding any further data received.
 The speed at which this is accomplished depends upon the remote
 server's support for ABOR processing.

-If the remote server does not support the ABOR command, a "ftp>"
+If the remote server does not support the ABOR command, an "ftp>"

 prompt will not appear until the remote server has completed
 sending the requested file.
 .PP
 prompt will not appear until the remote server has completed
 sending the requested file.
 .PP


@@ -804,12 +827,15 @@ If a macro named
 .I init
 is defined, it is automatically executed as the last step in the
 auto-login process.
 .I init
 is defined, it is automatically executed as the last step in the
 auto-login process.

+.SH "SEE ALSO"
+ftpd(8)

 .SH BUGS
 Correct execution of many commands depends upon proper behavior
 by the remote server.
 .PP
 .SH BUGS
 Correct execution of many commands depends upon proper behavior
 by the remote server.
 .PP

-A protocol violation present in the UNIX 4.2 ascii transfer code
+An error in the treatment of carriage returns
+in the 4.2BSD UNIX ascii-mode transfer code

 has been corrected.
 This correction may result in incorrect transfers of binary files
 has been corrected.
 This correction may result in incorrect transfers of binary files

-to and from UNIX 4.2 remote servers using the ascii type.
+to and from 4.2BSD servers using the ascii type.

 Avoid this problem by using the binary image type.
 Avoid this problem by using the binary image type.