path: root/net/ztelnet/files/patch-ba

--- ../ztelnet/telnet/telnet.1.orig	Wed Mar 18 10:54:02 1998
+++ ../ztelnet/telnet/telnet.1	Wed Mar 18 10:59:53 1998
@@ -18,15 +18,15 @@
 .\"     @(#)telnet.1	6.13 (Berkeley) 7/28/90
 .\"
 .Dd July 28, 1990
-.Dt TELNET 1
+.Dt ZTELNET 1
 .Os BSD 4.2
 .Sh NAME
-.Nm telnet
+.Nm ztelnet
 .Nd User interface to the 
 .Li TELNET
-protocol
+protocol, with support for Zmodem file transfers.
 .Sh SYNOPSIS
-.Nm telnet
+.Nm ztelnet
 .Op Fl 8
 .Op Fl E
 .Op Fl K
@@ -47,23 +47,32 @@
 .Oe
 .Sh DESCRIPTION
 The
-.Nm telnet
+.Nm ztelnet
 command
 is used to communicate with another host using the 
 .Li TELNET
 protocol.
 If
-.Nm telnet
+.Nm ztelnet
 is invoked without the
 .Ar host
 argument, it enters command mode,
 indicated by its prompt
-.Pq Nm telnet\&> .
+.Pq Nm ztelnet\&> .
 In this mode, it accepts and executes the commands listed below.
 If it is invoked with arguments, it performs an
 .Ic open
 command with those arguments.
 .Pp
+To perform Zmodem file transfers, issue the appropriate Zmodem command on
+the remote host.  Then hit the
+.Nm
+command line escape key (^]) and issue the appropriate Zmodem command for
+the local host.  Typically these commands would be
+.Nm sz
+and 
+.Nm rz .
+.Pp
 Options:
 .Tw Fl
 .Tp Fl 8
@@ -116,7 +125,7 @@
 .Cx
 Sets the initial
 .Nm
-.B telnet
+.B ztelnet
 escape character to
 .Ar escape char.
 If
@@ -130,7 +139,7 @@
 If Kerberos authentication is being used, the
 .Fl k
 option requests that
-.Nm telnet
+.Nm ztelnet
 obtain tickets for the remote host in realm
 .Ar realm
 instead of the remote host's
@@ -175,13 +184,13 @@
 .Tp Ar port
 Indicates a port number (address of an application) or name.  If a number is
 not specified, the default
-.Nm telnet
+.Nm ztelnet
 port is used.
 Port names are mapped to port numbers via the
 /etc/services
 file.
 Normally when a port number is specified,
-.Nm telnet
+.Nm ztelnet
 will not send out any initial
 .Li TELNET
 option negotiation.
@@ -199,19 +208,19 @@
 .Nm
 escape character.
 Similarly, the line ``~^Z'' will suspend the
-.Nm telnet
+.Nm ztelnet
 session.
 The line ``~^]'' will escape to the normal
-.Nm telnet
+.Nm ztelnet
 escape prompt.
 .Pp
 Once a connection has been opened,
-.Nm telnet
+.Nm ztelnet
 will attempt to enable the
 .Li TELNET LINEMODE
 option.
 If this fails, then
-.Nm telnet
+.Nm ztelnet
 will revert to one of two input modes:
 either \*(Lqcharacter at a time\*(Rq
 or \*(Lqold line by line\*(Rq
@@ -281,15 +290,15 @@
 .Ic intr  ) .
 .Pp
 While connected to a remote host,
-.Nm telnet
+.Nm ztelnet
 command mode may be entered by typing the
-.Nm telnet
+.Nm ztelnet
 \*(Lqescape character\*(Rq (initially \*(Lq^
 \*(Rq).
 When in command mode, the normal terminal editing conventions are available.
 .Pp
 The following
-.Nm telnet
+.Nm ztelnet
 commands are available.
 Only enough of each command to uniquely identify it need be typed
 (this is also true for most of the arguments to the
@@ -659,7 +668,7 @@
 Open a connection to the named host.
 If no port number
 is specified,
-.Nm telnet
+.Nm ztelnet
 will attempt to contact a
 .Li TELNET
 server at the default port.
@@ -674,7 +683,7 @@
 .Li ENVIRON
 option.
 When connecting to a non-standard port,
-.Nm telnet
+.Nm ztelnet
 omits any automatic initiation of
 .Li TELNET
 options.  When the port number is preceded by a minus sign,
@@ -696,10 +705,10 @@
 first thing on the line is the name of the machine that is
 being connected to.  The rest of the line, and successive
 lines that begin with whitespace are assumed to be
-.Nm telnet
+.Nm ztelnet
 commands and are processed as if they had been typed
 in manually to the
-.Nm telnet
+.Nm ztelnet
 command prompt.
 The special machine name
 .Ic DEFAULT
@@ -714,7 +723,7 @@
 Close any open
 .Li TELNET
 session and exit
-.Nm telnet  .
+.Nm ztelnet  .
 An end of file (in command mode) will also close a session and exit.
 .\" ######## END the "quit" command
 .\"
@@ -776,7 +785,7 @@
 sequence.
 .Tp Ic escape
 Sends the current
-.Nm telnet
+.Nm ztelnet
 escape character (initially \*(Lq^\*(Rq).
 .Tp Ic ga
 Sends the
@@ -833,7 +842,7 @@
 The
 .Ic set
 command will set any one of a number of
-.Nm telnet
+.Nm ztelnet
 variables to a specific value or to TRUE.
 The special value
 .Ic off
@@ -859,7 +868,7 @@
 .Tw Fl
 .Tp Ic ayt
 If
-.Nm telnet
+.Nm ztelnet
 is in
 .Ic localchars
 mode, or
@@ -884,7 +893,7 @@
 echoing of entered characters (for entering, say, a password).
 .Tp Ic eof
 If
-.Nm telnet
+.Nm ztelnet
 is operating in
 .Li LINEMODE
 or \*(Lqold line by line\*(Rq mode, entering this character
@@ -895,7 +904,7 @@
 character.
 .Tp Ic erase
 If
-.Nm telnet
+.Nm ztelnet
 is in
 .Ic localchars
 mode (see
@@ -904,7 +913,7 @@
 below),
 .Sy and
 if
-.Nm telnet
+.Nm ztelnet
 is operating in \*(Lqcharacter at a time\*(Rq mode, then when this
 character is typed, a
 .Li TELNET EC
@@ -919,14 +928,14 @@
 character.
 .Tp Ic escape
 This is the
-.Nm telnet
+.Nm ztelnet
 escape character (initially \*(Lq^[\*(Rq) which causes entry
 into
-.Nm telnet
+.Nm ztelnet
 command mode (when connected to a remote system).
 .Tp Ic flushoutput
 If
-.Nm telnet
+.Nm ztelnet
 is in
 .Ic localchars
 mode (see
@@ -949,7 +958,7 @@
 .Tp Ic forw1
 .Tp Ic forw2
 If
-.Nm telnet
+.Nm ztelnet
 is operating in
 .Li LINEMODE,
 these are the characters that, when typed,
@@ -962,7 +971,7 @@
 characters.
 .Tp Ic interrupt
 If
-.Nm telnet
+.Nm ztelnet
 is in
 .Ic localchars
 mode (see
@@ -984,7 +993,7 @@
 character.
 .Tp Ic kill
 If
-.Nm telnet
+.Nm ztelnet
 is in
 .Ic localchars
 mode (see
@@ -993,7 +1002,7 @@
 below),
 .Ic and
 if
-.Nm telnet
+.Nm ztelnet
 is operating in \*(Lqcharacter at a time\*(Rq mode, then when this
 character is typed, a
 .Li TELNET EL
@@ -1008,7 +1017,7 @@
 character.
 .Tp Ic lnext
 If
-.Nm telnet
+.Nm ztelnet
 is operating in
 .Li LINEMODE
 or \*(Lqold line by line\*(Lq mode, then this character is taken to
@@ -1021,7 +1030,7 @@
 character.
 .Tp Ic quit
 If
-.Nm telnet
+.Nm ztelnet
 is in
 .Ic localchars
 mode (see
@@ -1043,7 +1052,7 @@
 character.
 .Tp Ic reprint
 If
-.Nm telnet
+.Nm ztelnet
 is operating in
 .Li LINEMODE
 or \*(Lqold line by line\*(Lq mode, then this character is taken to
@@ -1057,14 +1066,14 @@
 .Tp Ic rlogin
 This is the rlogin escape character.
 If set, the normal
-.Nm telnet
+.Nm ztelnet
 .Ic escape
 character will be ignored unless it is preceded by this character
 at the beginning of a line.
 This character, at the beginning of a line, followed by a ``.''
 will close the connection; when followed by a ``^Z'' it will
 suspend the
-.Nm telnet
+.Nm ztelnet
 command.
 The initial state is to have the
 .Ic rlogin
@@ -1095,7 +1104,7 @@
 character.
 .Tp Ic susp
 If
-.Nm telnet
+.Nm ztelnet
 is in
 .Ic localchars
 mode, or
@@ -1124,7 +1133,7 @@
 then tracing information will be written to standard output (the default).
 .Tp Ic worderase
 If
-.Nm telnet
+.Nm ztelnet
 is operating in
 .Li LINEMODE
 or \*(Lqold line by line\*(Lq mode, then this character is taken to
@@ -1172,7 +1181,7 @@
 Switch to the local defaults for the special characters.  The
 local default characters are those of the local terminal at
 the time when
-.Nm telnet
+.Nm ztelnet
 was started.
 .Tp Ic import
 Switch to the remote defaults for the special characters.
@@ -1195,7 +1204,7 @@
 .\" ######## BEGIN the "status" command
 .Tp Ic status
 Show the current status of
-.Nm telnet  .
+.Nm ztelnet  .
 This includes the peer one is connected to, as well
 as the current mode.
 .\" ######## END the "status" command
@@ -1210,7 +1219,7 @@
 and
 FALSE)
 various flags that control how
-.Nm telnet
+.Nm ztelnet
 responds to events.
 These flags may be set explicitly to TRUE or FALSE
 using the
@@ -1242,7 +1251,7 @@
 sequences; see
 .Ic set
 above for details),
-.Nm telnet
+.Nm ztelnet
 refuses to display any data on the user's terminal
 until the remote system acknowledges (via a
 .Li TELNET TIMING MARK
@@ -1269,7 +1278,7 @@
 If the
 .Li TELNET AUTHENTICATION
 option is supported by the remote side, then
-.Nm telnet
+.Nm ztelnet
 will attempt to use it to perform automatic authentication.
 If the
 .Li AUTHENTICATION
@@ -1395,7 +1404,7 @@
 The initial value for this toggle is FALSE.
 .Tp Ic options
 Toggles the display of some internal
-.Nm telnet
+.Nm ztelnet
 protocol processing (having to do with
 .Li TELNET
 options).
@@ -1421,7 +1430,7 @@
 .Ic skiprc
 toggle
 is TRUE, then
-.Nm telnet
+.Nm ztelnet
 will skip the reading of the
 .Pa \&.telnetrc
 file in the users home directory
@@ -1434,7 +1443,7 @@
 When the
 .Ic verbose_encrypt
 toggle is TRUE, then
-.Nm telnet
+.Nm ztelnet
 will print out a message each time encryption is
 enabled or disabled.
 The initial value for this toggle is FALSE.
@@ -1448,7 +1457,7 @@
 .\" ######## BEGIN the "z" command
 .Tp Ic z
 Suspend
-.Nm telnet  .
+.Nm ztelnet  .
 This command only works when the user is using the
 .Xr csh  1  .
 .\" ######## END the "z" command
@@ -1471,10 +1480,10 @@
 .Op Ar command
 .Cx
 Get help.  With no arguments,
-.Nm telnet
+.Nm ztelnet
 prints a help summary.
 If a command is specified,
-.Nm telnet
+.Nm ztelnet
 will print the help information for just that command.
 .\" ######## END the "!" command
 .Sh ENVIRONMENT