dh_installchangelogs: adjust to use ckc301.txt. changelog: explain -O1 usage
[ckermit.git] / ckututor.txt
index 450ab89..b54942d 100644 (file)
@@ -24,7 +24,7 @@
      upgrading to the new release. Thanks to Christine Gianone for her
      work on this document before she was laid off in 2005.
 
-   Most recent update: Tue Jun 28 09:02:45 2011
+   Most recent update: Fri Jul 1 14:12:31 2011
 
 CONTENTS
 
@@ -48,10 +48,12 @@ CONTENTS
      * [32]FILES
      * [33]AUTHORS
 
-DESCRIPTION [34]Top   [35]Contents   [36]Next
+DESCRIPTION
 
-[37]C-Kermit is an all-purpose communications software package from the
-[38]Kermit Project at [39]Columbia University that:
+   [34]Top   [35]Contents   [36]Next
+
+   [37]C-Kermit is an all-purpose communications software package from the
+   [38]Kermit Project at [39]Columbia University that:
 
      * Is portable to many platforms, Unix and non-Unix alike.
      * Can make both serial and network connections.
@@ -97,10 +99,13 @@ DESCRIPTION [34]Top   [35]Contents   [36]Next
 
    [44]Kermit Home [45]C-Kermit Home [46]C-Kermit FAQ
 
-SYNOPSIS [47]Top [48]Contents [49]Next [50]Previous
+SYNOPSIS
+
+   [47]Top [48]Contents [49]Next [50]Previous
 
-Usage:  kermit [filename] [-x arg [-x arg]...[-yyy]..] [ {=,--,+} text ] ]
-Or:    kermit URL
+   Usage:  kermit [filename] [-x arg [-x arg]...[-yyy]..] [ {=,--,+} text
+   ] ]
+   Or:    kermit URL
 
      * -x is an option requiring an argument;
      * -y is an option with no argument.
@@ -146,22 +151,24 @@ Or:    kermit URL
 
    [59]Kermit Home [60]C-Kermit Home [61]C-Kermit FAQ
 
-OPTIONS [62]Top [63]Contents [64]Next [65]Previous  <- (Most people should
-click Next to skip around this section...)
+OPTIONS
+
+   [62]Top [63]Contents [64]Next [65]Previous  <- (Most people should
+   click Next to skip around this section...)
 
-Like most Unix commands, C-Kermit can be be given options on the command
-line. But C-Kermit also can be used interactively by giving it [66]commands
-composed of words, which are more intuitive than cryptic command-line
-options, and more flexible too. In other words, you don't have to use
-C-Kermit's command-line options, but they are available if you want to. (By
-the same token, you don't have to use its interactive commands either -- you
-can use either or both in any combination.)
+   Like most Unix commands, C-Kermit can be be given options on the
+   command line. But C-Kermit also can be used interactively by giving it
+   [66]commands composed of words, which are more intuitive than cryptic
+   command-line options, and more flexible too. In other words, you don't
+   have to use C-Kermit's command-line options, but they are available if
+   you want to. (By the same token, you don't have to use its interactive
+   commands either -- you can use either or both in any combination.)
 
-C-Kermit is generally installed in the PATH as "kermit", and therefore is
-invoked by typing the word "kermit" (lowercase) at the shell prompt, and then
-pressing the Return or Enter key. If you wish to include command-line
-options, put them after the word "kermit" but before pressing Return or
-Enter, separated by spaces, for example:
+   C-Kermit is generally installed in the PATH as "kermit", and therefore
+   is invoked by typing the word "kermit" (lowercase) at the shell prompt,
+   and then pressing the Return or Enter key. If you wish to include
+   command-line options, put them after the word "kermit" but before
+   pressing Return or Enter, separated by spaces, for example:
 
   $ kermit -s ckermit.tar.gz
 
@@ -280,7 +287,7 @@ Enter, separated by spaces, for example:
    connections (used on serial linemode connections to old mainframes).
    Equivalent to SET DUPLEX HALF, SET HANDSHAKE XON.
    -v arg N Window size for Kermit protocol (ignored when streaming).
-   Equivalanet to SET WINDOW-SIZE.
+   Equivalent to SET WINDOW-SIZE.
    Argument: Number, 1 to 32.
    -w N Incoming files Write over existing files. Equivalent to SET FILE
    COLLISION OVERWRITE.
@@ -297,9 +304,7 @@ Enter, separated by spaces, for example:
    argument, it is separated from the option word by a colon (:). Extended
    options include:
 
-   Option
-   Description
-
+   Option Description
    --bannerfile:filename File to display upon startup or IKSD login.
    --cdfile:filename File to be sent for display to the client when server
    changes directory (filename is relative to the changed-to directory).
@@ -317,7 +322,9 @@ Enter, separated by spaces, for example:
    See the [70]file-transfer section for examples of command-line
    invocation.
 
-  COMMAND LANGUAGE [71]Top [72]Contents [73]Next [74]Previous
+COMMAND LANGUAGE
+
+   [71]Top [72]Contents [73]Next [74]Previous
 
      * [75]Command Files, Macros, and Scripts
      * [76]Command List
@@ -395,7 +402,7 @@ Enter, separated by spaces, for example:
 
   get c:\\k95\\k95custom.ini
 
-  Command Files, Macros, and Scripts
+Command Files, Macros, and Scripts
 
    A file containing Kermit commands is called a Kermit command file or
    Kermit script. It can be executed with Kermit's TAKE command:
@@ -527,7 +534,7 @@ Enter, separated by spaces, for example:
    prompt. To see what else you can show, type "show ?". \m(xxx) is a user
    defined variable (strictly speaking, it is a macro used as a variable).
 
-  Command List
+Command List
 
    C-Kermit has more than 200 top-level commands, and some of these, such
    as SET, branch off into hundreds of subcommands of their own, so it's
@@ -610,8 +617,7 @@ Enter, separated by spaces, for example:
    DIAL [ number ] Tells Kermit to dial the given phone number with the
    modem.
    REDIAL Redials the most recently dialed phone number.
-   ANSWER
-   Waits for and answers an incoming call on the modem.
+   ANSWER Waits for and answers an incoming call on the modem.
    AUTHENTICATE [ parameters... ] Performs secure authentication on a
    TCP/IP connection.
    SET NETWORK TYPE { TCP/IP, X.25, ... } Selects network type for
@@ -670,7 +676,7 @@ Enter, separated by spaces, for example:
    SEND [ options ] filename [ as-name ]  Sends the given file. Synonym:
    S.
    SEND [ options ] filespec Sends all files that match.
-   RESEND [ options ] filespec Resumes an interupted SEND from the point
+   RESEND [ options ] filespec Resumes an interrupted SEND from the point
    of failure.
    RECEIVE [ options ] [ as-name ] Waits passively for files to arrive.
    Synonym: R.
@@ -705,7 +711,7 @@ Enter, separated by spaces, for example:
    SEND [ options ] filename [ as-name ]  Sends the given file to the
    server. Synonyms: S, PUT.
    SEND [ options ] filespec Sends all files that match.
-   RESEND [ options ] filespec Resumes an interupted SEND from the point
+   RESEND [ options ] filespec Resumes an interrupted SEND from the point
    of failure.
    GET [ options ] remote-filespec Asks the server to send the given
    files. Synonym: G.
@@ -772,55 +778,63 @@ Enter, separated by spaces, for example:
 
    [82]Kermit Home [83]C-Kermit Home [84]C-Kermit FAQ
 
-  INITIALIZATION FILE [85]Top [86]Contents [87]Next [88]Previous
-
-  In its default configuration, C-Kermit executes commands from a file called
-  .kermrc in your home directory when it starts, unless it is given the -Y or -y
-  command-line option. Custom configurations might substitute a shared
-  system-wide initialization file. The SHOW FILE command tells what
-  initialization file, if any, was used. The standard initialization file
-  "chains" to an individual customization file, .mykermc, in the home directory,
-  in which each user can establish her/his own preferences, define macros, and
-  so on.
-
-  Since execution of the initialization file (at least the standard one) makes
-  C-Kermit take longer to start, it might be better not to have an
-  initialization file, especially now that Kermit's default startup
-  configuration is well attuned to modern computing and networking -- in other
-  words, you no longer have do anything special to make Kermit transfers go
-  fast. So instead of having an initialization file that is executed every time
-  Kermit starts, you might consider making one or more kerbang scripts (with
-  names other that .kermrc) that do NOT include an "exit" command, and invoke
-  those when you need the settings, macro definitions, and/or scripted actions
-  they contain, and invoke C-Kermit directly when you don't.
-
-  To put it another way... We still distribute the standard initialization file
-  since it's featured in the manual and backwards compatibility is important to
-  us. But there's no harm in not using it if you don't need the stuff that's in
-  it (services directory, dialing directory, network directory, and associated
-  macro definitions). On the other hand, if there are settings or macros you
-  want in effect EVERY time you use Kermit, the initialization file (or the
-  customization file it chains to) is the place to put them, because that's the
-  only place Kermit looks for them automatically each time you start it.
-
-  [89]Kermit Home [90]C-Kermit Home [91]C-Kermit FAQ
-  MODES OF OPERATION [92]Top [93]Contents [94]Next [95]Previous
-
-  Kermit is said to be in Local mode if it has made a connection to another
-  computer, e.g. by dialing it or establishing a Telnet connection to it. The
-  other computer is remote, so if you start another copy of Kermit on the remote
-  computer, it is said to be in Remote mode (as long as it has not made any
-  connections of its own). The local Kermit communicates over the communications
-  device or network connection, acting as a conduit between the the remote
-  computer and your keyboard and screen. The remote Kermit is the file-transfer
-  partner to the local Kermit and communicates only through its standard input
-  and output.
-
-  At any moment, a Kermit program can be in any of the following states. It's
-  important to know what they are and how to change from one to the other.
+INITIALIZATION FILE
+
+   [85]Top [86]Contents [87]Next [88]Previous
+
+   In its default configuration, C-Kermit executes commands from a file
+   called .kermrc in your home directory when it starts, unless it is
+   given the -Y or -y command-line option. Custom configurations might
+   substitute a shared system-wide initialization file. The SHOW FILE
+   command tells what initialization file, if any, was used. The standard
+   initialization file "chains" to an individual customization file,
+   .mykermc, in the home directory, in which each user can establish
+   her/his own preferences, define macros, and so on.
+
+   Since execution of the initialization file (at least the standard one)
+   makes C-Kermit take longer to start, it might be better not to have an
+   initialization file, especially now that Kermit's default startup
+   configuration is well attuned to modern computing and networking -- in
+   other words, you no longer have do anything special to make Kermit
+   transfers go fast. So instead of having an initialization file that is
+   executed every time Kermit starts, you might consider making one or
+   more kerbang scripts (with names other that .kermrc) that do NOT
+   include an "exit" command, and invoke those when you need the settings,
+   macro definitions, and/or scripted actions they contain, and invoke
+   C-Kermit directly when you don't.
+
+   To put it another way... We still distribute the standard
+   initialization file since it's featured in the manual and backwards
+   compatibility is important to us. But there's no harm in not using it
+   if you don't need the stuff that's in it (services directory, dialing
+   directory, network directory, and associated macro definitions). On the
+   other hand, if there are settings or macros you want in effect EVERY
+   time you use Kermit, the initialization file (or the customization file
+   it chains to) is the place to put them, because that's the only place
+   Kermit looks for them automatically each time you start it.
+
+   [89]Kermit Home [90]C-Kermit Home [91]C-Kermit FAQ
+
+MODES OF OPERATION
+
+   [92]Top [93]Contents [94]Next [95]Previous
+
+   Kermit is said to be in Local mode if it has made a connection to
+   another computer, e.g. by dialing it or establishing a Telnet
+   connection to it. The other computer is remote, so if you start another
+   copy of Kermit on the remote computer, it is said to be in Remote mode
+   (as long as it has not made any connections of its own). The local
+   Kermit communicates over the communications device or network
+   connection, acting as a conduit between the the remote computer and
+   your keyboard and screen. The remote Kermit is the file-transfer
+   partner to the local Kermit and communicates only through its standard
+   input and output.
+
+   At any moment, a Kermit program can be in any of the following states.
+   It's important to know what they are and how to change from one to the
+   other.
 
    Command state
-
           In this state, Kermit reads commands from:
 
           + Your keyboard; or:
@@ -840,7 +854,6 @@ Enter, separated by spaces, for example:
           normally brings you back to the prompt.
 
    Shell state
-
           You can invoke an inferior shell or external command from the
           Kermit command prompt by using the PUSH, RUN (!), EDIT, or
           BROWSE command. While the inferior shell or command is active,
@@ -848,7 +861,6 @@ Enter, separated by spaces, for example:
           state by exiting from the inferior shell or application.
 
    Connect state
-
           In this state, which can be entered only when in Local mode
           (i.e. when Kermit has made a connection to another computer),
           Kermit is acting as a terminal to the remote computer. Your
@@ -873,7 +885,6 @@ Enter, separated by spaces, for example:
           info.
 
    Local file-transfer state
-
           In this state, Kermit is sending packets back and forth with the
           other computer in order to transfer a file or accomplish some
           other file-related task. And at the same time, it is displaying
@@ -891,7 +902,6 @@ Enter, separated by spaces, for example:
           Z, E, or Ctrl-C (hold down the Ctrl key and press the C key).
 
    Remote file-transfer state
-
           In this state, Kermit is exchanging file-transfer packets with
           its local partner over its standard i/o. It leaves this state
           automatically when the transfer is complete. In case you find
@@ -904,7 +914,6 @@ Enter, separated by spaces, for example:
           fatal Kermit protocol error.
 
    Remote Server state
-
           This is like Remote File-transfer state, except it never returns
           automatically to Command state. Rather, it awaits further
           instructions from the client program; that is, from your Local
@@ -915,50 +924,52 @@ Enter, separated by spaces, for example:
           issuing a "bye" command to the client.
 
    Local Server state
-
           Like Remote-Server state, but in local mode, and therefore with
           its file-transfer display showing, and listening for single-key
           commands, as in Local File-transfer state. Usually this state is
           entered automatically when a remote Kermit program gives a GET
           command.
 
-  C-Kermit, Kermit 95, and MS-DOS Kermit all can switch automatically from
-  Connect state to Local File-transfer state when you initiate a file transfer
-  from the remote computer by starting Kermit and telling it to send or get a
-  file, in which case, Connect state is automatically resumed after the file
-  transfer is finished.
+   C-Kermit, Kermit 95, and MS-DOS Kermit all can switch automatically
+   from Connect state to Local File-transfer state when you initiate a
+   file transfer from the remote computer by starting Kermit and telling
+   it to send or get a file, in which case, Connect state is automatically
+   resumed after the file transfer is finished.
 
-  Note that C-Kermit is not a terminal emulator. It is a communications
-  application that you run in a terminal window (e.g. console or Xterm). The
-  specific emulation, such as VT100, VT220, Linux Console, or Xterm, is provided
-  by the terminal window in which you are running C-Kermit. Kermit 95 and MS-DOS
-  Kermit, on the other hand, are true terminal emulators. Why is C-Kermit not a
-  terminal emulator? [96]CLICK HERE to read about it.
+   Note that C-Kermit is not a terminal emulator. It is a communications
+   application that you run in a terminal window (e.g. console or Xterm).
+   The specific emulation, such as VT100, VT220, Linux Console, or Xterm,
+   is provided by the terminal window in which you are running C-Kermit.
+   Kermit 95 and MS-DOS Kermit, on the other hand, are true terminal
+   emulators. Why is C-Kermit not a terminal emulator? [96]CLICK HERE to
+   read about it.
 
-  [97]Kermit Home [98]C-Kermit Home [99]C-Kermit FAQ
-  MAKING CONNECTIONS [100]Top [101]Contents [102]Next [103]Previous
+   [97]Kermit Home [98]C-Kermit Home [99]C-Kermit FAQ
 
-  Here is how to make different kinds of connections using interactive Kermit
-  commands (as noted above, you can also make connections with command-line
-  options). Note that you don't have to make connections with Kermit. It can
-  also be used on the far end of a connection as the remote file transfer and
-  management partner of your local communications software.
+MAKING CONNECTIONS
 
-   Making a Telnet Connection
+   [100]Top [101]Contents [102]Next [103]Previous
 
+   Here is how to make different kinds of connections using interactive
+   Kermit commands (as noted above, you can also make connections with
+   command-line options). Note that you don't have to make connections
+   with Kermit. It can also be used on the far end of a connection as the
+   remote file transfer and management partner of your local
+   communications software.
+
+   Making a Telnet Connection
           At the C-Kermit command prompt, simply type:
 
   telnet foo.bar.com         ; Substitute desired host name or address.
   telnet xyzcorp.com 3000    ; You can also include a port number.
 
-          If the connection is successful, Kermit automically enters
+          If the connection is successful, Kermit automatically enters
           Connect state. When you logout from the remote host, Kermit
           automatically returns to its prompt. More info: HELP TELNET,
           HELP SET TELNET, HELP SET TELOPT. Also see the [104]IKSD section
           below.
 
    Making an Rlogin connection
-
           This is just like Telnet, except you have to be root to do it
           because Rlogin uses a privileged TCP port:
 
@@ -967,7 +978,6 @@ Enter, separated by spaces, for example:
           More info: HELP RLOGIN.
 
    Making an SSH Connection
-
           Unlike Telnet and Rlogin, SSH connections are not built-in, but
           handled by running your external SSH client through a
           pseudoterminal. Using C-Kermit to control the SSH client gives
@@ -979,7 +989,6 @@ Enter, separated by spaces, for example:
           More info: HELP SSH, HELP SET SSH.
 
    Dialing with a Modem
-
           If it's an external modem, make sure it is connected to a usable
           serial port on your computer with a regular (straight-through)
           [105]modem cable, and to the telephone jack with a telephone
@@ -1002,7 +1011,7 @@ Enter, separated by spaces, for example:
           to its prompt automatically when you log out from the remote
           computer or the connection is otherwise lost.
 
-          You can also dial from a modem that is accessible by Telnet,
+          You can also dial from a modem that is accesssible by Telnet,
           e.g. to a reverse terminal server. In this case the command
           sequence is:
 
@@ -1021,7 +1030,6 @@ Enter, separated by spaces, for example:
           CARRIER-WATCH, SHOW COMMUNICATIONS, SHOW MODEM, SHOW DIAL.
 
    Direct Serial Port
-
           Connect the two computers, A and B, with a [107]null modem cable
           (or two modem cables interconnected with a null-modem adapter or
           modem eliminator). From Computer A:
@@ -1041,19 +1049,22 @@ Enter, separated by spaces, for example:
           approximately the same directions. More info: As above plus HELP
           CONNECT.
 
-  With modems or direct serial connections, you might also have to "set parity
-  even" (or "mark" or "space") if it's a 7-bit connection.
+   With modems or direct serial connections, you might also have to "set
+   parity even" (or "mark" or "space") if it's a 7-bit connection.
+
+   Of the connection types listed above, only one can be open at a time.
+   However, any one of these can be open concurrently with an [108]FTP or
+   HTTP session. Each connection type can be customized to any desired
+   degree, scripted, logged, you name it. See the manual.
 
-  Of the connection types listed above, only one can be open at a time. However,
-  any one of these can be open concurrently with an [108]FTP or HTTP session.
-  Each connection type can be customized to any desired degree, scripted,
-  logged, you name it. See the manual.
+   NOTE: On selected platforms, C-Kermit also can make X.25 connections.
+   See the manual for details.
 
-  NOTE: On selected platforms, C-Kermit also can make X.25 connections. See the
-  manual for details.
+   [109]Kermit Home [110]C-Kermit Home [111]C-Kermit FAQ
 
-  [109]Kermit Home [110]C-Kermit Home [111]C-Kermit FAQ
-  TRANSFERRING FILES WITH KERMIT [112]Top [113]Contents [114]Next [115]Previous
+TRANSFERRING FILES WITH KERMIT
+
+   [112]Top [113]Contents [114]Next [115]Previous
 
      * [116]Downloading Files
      * [117]Uploading Files
@@ -1062,32 +1073,34 @@ Enter, separated by spaces, for example:
      * [120]Advanced Kermit File Transfer Features
      * [121]Non-Kermit File Transfer
 
-  There is a [122]widespread and persistent belief that Kermit is a slow
-  protocol. This is because, until recently, it used conservative tuning by
-  default to make sure file transfers succeeded, rather than failing because
-  they overloaded the connection. Some extra commands (or command-line options,
-  like -Q) were needed to make it go fast, but nobody bothered to find out about
-  them. Also, it takes two to tango: most non-Kermit-Project Kermit protocol
-  implementations really ARE slow. The best file-transfer partners for C-Kermit
-  are: another copy of [123]C-Kermit (7.0 or later) and [124]Kermit 95. These
-  combinations work well and they work fast by default. MS-DOS Kermit is good
-  too, but you have to tell it to go fast (by giving it the FAST command).
-
-  Furthermore, all three of these Kermit programs support "autodownload" and
-  "autoupload", meaning that when they are in Connect state and a Kermit packet
-  comes in from the remote, they automatically switch into file transfer mode.
-
-  And plus, C-Kermit and K95 also switch automatically between text and binary
-  mode for each file, so there is no need to "set file type binary" or "set file
-  type text", or to worry about files being corrupted because they were
-  transferred in the wrong mode.
-
-  What all of these words add up to is that now, when you use up-to-date Kermit
-  software from the Kermit Project, file transfer is not only fast, it's
-  ridiculously easy. You barely have to give any commands at all.
+   There is a [122]widespread and persistent belief that Kermit is a slow
+   protocol. This is because, until recently, it used conservative tuning
+   by default to make sure file transfers succeeded, rather than failing
+   because they overloaded the connection. Some extra commands (or
+   command-line options, like -Q) were needed to make it go fast, but
+   nobody bothered to find out about them. Also, it takes two to tango:
+   most non-Kermit-Project Kermit protocol implementations really ARE
+   slow. The best file-transfer partners for C-Kermit are: another copy of
+   [123]C-Kermit (7.0 or later) and [124]Kermit 95. These combinations
+   work well and they work fast by default. MS-DOS Kermit is good too, but
+   you have to tell it to go fast (by giving it the FAST command).
+
+   Furthermore, all three of these Kermit programs support "autodownload"
+   and "autoupload", meaning that when they are in Connect state and a
+   Kermit packet comes in from the remote, they automatically switch into
+   file transfer mode.
+
+   And plus, C-Kermit and K95 also switch automatically between text and
+   binary mode for each file, so there is no need to "set file type
+   binary" or "set file type text", or to worry about files being
+   corrupted because they were transferred in the wrong mode.
+
+   What all of these words add up to is that now, when you use up-to-date
+   Kermit software from the Kermit Project, file transfer is not only
+   fast, it's ridiculously easy. You barely have to give any commands at
+   all.
 
    Downloading Files
-
           Let's say you have [125]Kermit 95, [126]C-Kermit, or [127]MS-DOS
           Kermit on your desktop computer, with a connection to a Unix
           computer that has C-Kermit installed as "kermit". To download a
@@ -1119,7 +1132,6 @@ Enter, separated by spaces, for example:
           right?
 
    Uploading Files
-
           To upload files (send them from your desktop computer to the
           remote Unix computer) do the same thing, but use the -g (GET)
           option instead of -s:
@@ -1143,7 +1155,6 @@ Enter, separated by spaces, for example:
   kermit -g friday.txt -a today.txt
 
    Kermit Transfers the Old-Fashioned Way
-
           If your desktop communications software does not support
           autoupload or autodownload, or it does not include Kermit server
           mode, the procedure requires more steps.
@@ -1173,7 +1184,6 @@ Enter, separated by spaces, for example:
           screen.
 
    If File Transfer Fails
-
           Although every aspect of Kermit's operation can be finely tuned,
           there are also three short and simple "omnibus tuning" commands
           you can use for troubleshooting:
@@ -1208,7 +1218,6 @@ Enter, separated by spaces, for example:
           C-Kermit, or send email to [131]kermit-support@columbia.edu.
 
    Advanced Kermit File-Transfer Features
-
           Obviously there is a lot more to Kermit file transfer, including
           all sorts of interactive commands, preferences, options,
           logging, debugging, troubleshooting, and anything else you can
@@ -1256,7 +1265,6 @@ Enter, separated by spaces, for example:
                 RESEND, REGET (HELP RESEND, HELP REGET).
 
    Non-Kermit File Transfer
-
           You can also use C-Kermit to transfer files with FTP or HTTP
           Internet protocols; [133]see below.
 
@@ -1278,19 +1286,20 @@ Enter, separated by spaces, for example:
 
    [134]Kermit Home [135]C-Kermit Home [136]C-Kermit FAQ
 
-  KERMIT CLIENT/SERVER CONNECTIONS [137]Top [138]Contents [139]Next
-  [140]Previous
+KERMIT CLIENT/SERVER CONNECTIONS
+
+   [137]Top [138]Contents [139]Next [140]Previous
 
-  On any kind of connection you can make with Kermit -- serial, TCP/IP, X.25,
-  etc -- you can set up a convenient client/server relationship between your
-  Kermit client (the one that made the connection) and the Kermit program on the
-  far end of the connection (the remote Kermit) by putting the remote Kermit in
-  server mode. This is normally done by giving it a SERVER command, or by
-  starting it with the -x command-line option. In some cases ([141]Internet
-  Kermit Service, SSH connections to a Kermit subsystem, or specially configured
-  hosts), there is already a Kermit server waiting on the far end. Here is a
-  quick synopsis of the commands you can give to the client for interacting with
-  the server:
+   On any kind of connection you can make with Kermit -- serial, TCP/IP,
+   X.25, etc -- you can set up a convenient client/server relationship
+   between your Kermit client (the one that made the connection) and the
+   Kermit program on the far end of the connection (the remote Kermit) by
+   putting the remote Kermit in server mode. This is normally done by
+   giving it a SERVER command, or by starting it with the -x command-line
+   option. In some cases ([141]Internet Kermit Service, SSH connections to
+   a Kermit subsystem, or specially configured hosts), there is already a
+   Kermit server waiting on the far end. Here is a quick synopsis of the
+   commands you can give to the client for interacting with the server:
 
    SEND [ switches ] filename
           Sends the named file to the server. The filename can include
@@ -1322,41 +1331,46 @@ Enter, separated by spaces, for example:
           must have an R prefix: RCD, RPWD, RDIRECTORY, etc. HELP SET
           LOCUS for details. SHOW COMMAND to see current locus.
 
-  The following commands are affected by SET LOCUS:
+   The following commands are affected by SET LOCUS:
 
    CD, LCD, RCD
-   Change (working, current) directory. HELP CD for details.
+          Change (working, current) directory. HELP CD for details.
 
    CDUP, LCDUP, RCDUP
-   CD one level up.
+          CD one level up.
 
    DIRECTORY, LDIRECTORY, RDIRECTORY
-   Produce a directory listing. Many options are available for local
-   listings. HELP DIRECTORY for details.
+          Produce a directory listing. Many options are available for
+          local listings. HELP DIRECTORY for details.
 
    DELETE, LDELETE, RDELETE
-   Deletes files or directories. Many options available, HELP DELETE.
+          Deletes files or directories. Many options available, HELP
+          DELETE.
 
    RENAME, LRENAME, RRENAME
-   Renames files or directories. Many options available, HELP RENAME.
+          Renames files or directories. Many options available, HELP
+          RENAME.
 
    MKDIR, LMKDIR, RMKDIR
-   Creates a directory. HELP MKDIR.
+          Creates a directory. HELP MKDIR.
 
    RMDIR, LRMDIR, RRMDIR
-   Removes a directory. HELP RMDIR. There are dozens -- maybe hundreds --
-   of other commands, described in the built-in help, on the website,
-   and/or in the published or online manuals. But even if you don't have
-   access to documentation, you can "set locus remote" and then use pretty
-   much the same commands you would use with any FTP client.
+          Removes a directory. HELP RMDIR.
+
+   There are dozens -- maybe hundreds -- of other commands, described in
+   the built-in help, on the website, and/or in the published or online
+   manuals. But even if you don't have accesss to documentation, you can
+   "set locus remote" and then use pretty much the same commands you would
+   use with any FTP client.
 
    [142]Kermit Home [143]C-Kermit Home [144]C-Kermit FAQ
 
-  KERMIT'S BUILT-IN FTP AND HTTP CLIENTS [145]Top [146]Contents [147]Next
-  [148]Previous
+KERMIT'S BUILT-IN FTP AND HTTP CLIENTS
+
+   [145]Top [146]Contents [147]Next [148]Previous
 
-  Kermit's FTP client is like the regular Unix FTP client that you're used to,
-  but with some differences:
+   Kermit's FTP client is like the regular Unix FTP client that you're
+   used to, but with some differences:
 
      * It has lots more commands and features.
      * You can have an FTP session and a regular Kermit serial or Telnet
@@ -1395,14 +1409,17 @@ Enter, separated by spaces, for example:
    [152]Kermit Home [153]C-Kermit Home [154]C-Kermit FAQ [155]FTP Client
    [156]HTTP Client
 
-  INTERNET KERMIT SERVICE [157]Top [158]Contents [159]Next [160]Previous
+INTERNET KERMIT SERVICE
 
-  C-Kermit can be configured and run as an Internet service (called IKSD),
-  similar to an FTP server (FTPD) except you can (but need not) interact with it
-  directly, plus it does a lot more than an FTP server can do. The TCP port for
-  IKSD is 1649. It uses Telnet protocol. C-Kermit can be an Internet Kermit
-  Server, or it can be a client of an IKSD. You can make connections from
-  C-Kermit to an IKSD with any of the following commands:
+   [157]Top [158]Contents [159]Next [160]Previous
+
+   C-Kermit can be configured and run as an Internet service (called
+   IKSD), similar to an FTP server (FTPD) except you can (but need not)
+   interact with it directly, plus it does a lot more than an FTP server
+   can do. The TCP port for IKSD is 1649. It uses Telnet protocol.
+   C-Kermit can be an Internet Kermit Server, or it can be a client of an
+   IKSD. You can make connections from C-Kermit to an IKSD with any of the
+   following commands:
 
   telnet foo.bar.edu 1649
   telnet foo.bar.edu kermit   ; if "kermit" is listed in /etc/services
@@ -1421,11 +1438,13 @@ Enter, separated by spaces, for example:
 
    [163]Kermit Home [164]C-Kermit Home [165]C-Kermit FAQ
 
-  SECURITY [166]Top [167]Contents [168]Next [169]Previous
+SECURITY
+
+   [166]Top [167]Contents [168]Next [169]Previous
 
-  All of C-Kermit's built-in TCP/IP networking methods (Telnet, Rlogin, IKSD,
-  FTP, and HTTP) can be secured by one or more of the following IETF-approved
-  methods:
+   All of C-Kermit's built-in TCP/IP networking methods (Telnet, Rlogin,
+   IKSD, FTP, and HTTP) can be secured by one or more of the following
+   IETF-approved methods:
 
      * MIT Kerberos IV
      * MIT Kerberos V
@@ -1441,23 +1460,25 @@ Enter, separated by spaces, for example:
 
    [171]Kermit Home [172]C-Kermit Home [173]C-Kermit FAQ
 
-  ALTERNATIVE COMMAND-LINE PERSONALITIES [174]Top [175]Contents [176]Next
-  [177]Previous
+ALTERNATIVE COMMAND-LINE PERSONALITIES
+
+   [174]Top [175]Contents [176]Next [177]Previous
 
-  When invoked as "kermit" or any other name besides any of the special ones,
-  C-Kermit has the command-line options described above in the [178]OPTIONS
-  section. However, if you invoke C-Kermit using any of the following names:
+   When invoked as "kermit" or any other name besides any of the special
+   ones, C-Kermit has the command-line options described above in the
+   [178]OPTIONS section. However, if you invoke C-Kermit using any of the
+   following names:
 
-    telnet  Telnet client
-    ftp     FTP client
-    http    HTTP client
-    https   Secure HTTP client
+     telnet  Telnet client
+     ftp     FTP client
+     http    HTTP client
+     https   Secure HTTP client
 
-  Kermit's command-line personality changes to match. This can be done (among
-  other ways) with symbolic links (symlinks). For example, if you want C-Kermit
-  to be your regular Telnet client, or the Telnet helper of your Web browser,
-  you can create a link like the following in a directory that lies in your PATH
-  ahead of the regular telnet program:
+   Kermit's command-line personality changes to match. This can be done
+   (among other ways) with symbolic links (symlinks). For example, if you
+   want C-Kermit to be your regular Telnet client, or the Telnet helper of
+   your Web browser, you can create a link like the following in a
+   directory that lies in your PATH ahead of the regular telnet program:
 
   ln -s /usr/local/bin/kermit telnet
 
@@ -1505,107 +1526,119 @@ Enter, separated by spaces, for example:
 
    [180]Kermit Home [181]C-Kermit Home [182]C-Kermit FAQ
 
-  LICENSE [183]Top [184]Contents [185]Next [186]Previous
+LICENSE
+
+   [183]Top [184]Contents [185]Next [186]Previous
+
+   On or before 30 June 2011, barring unforeseen circumstances,
+   [187]C-Kermit 9.0 will be released with the [188]Revised 3-Clause BSD
+   License. This is a certified [189]Open Source license, and it means
+   that C-Kermit no longer needs to be licensed for commercial
+   redistribution. Technical support for Kermit software will not be
+   available from Columbia University after June 30th.
 
-  On or before 30 June 2011, barring unforeseen circumstances, [187]C-Kermit 9.0
-  will be released with the [188]Revised 3-Clause BSD License. This is a
-  certifed [189]Open Source license, and it means that C-Kermit no longer needs
-  to be licensed for commercial redistribution. Technical support for Kermit
-  software will not be available from Columbia University after June 30th.
+   [190]Kermit Home [191]C-Kermit Home [192]C-Kermit FAQ
 
-  [190]Kermit Home [191]C-Kermit Home [192]C-Kermit FAQ
-  OTHER TOPICS [193]Top [194]Contents [195]Next [196]Previous
+OTHER TOPICS
 
-  There's way more to C-Kermit than we've touched on here -- troubleshooting,
-  customization, character sets, dialing directories, sending pages, script
-  writing, and on and on, all of which are covered in the manual and updates and
-  supplements. For the most up-to-date information on documentation (or updated
-  documentation itself) visit the Kermit Project website:
+   [193]Top [194]Contents [195]Next [196]Previous
+
+   There's way more to C-Kermit than we've touched on here --
+   troubleshooting, customization, character sets, dialing directories,
+   sending pages, script writing, and on and on, all of which are covered
+   in the manual and updates and supplements. For the most up-to-date
+   information on documentation (or updated documentation itself) visit
+   the Kermit Project website:
 
   [197]http://www.columbia.edu/kermit/
 
-  There you will also find [198]Kermit software packages for other platforms:
-  different Unix varieties, Windows, DOS, VMS, IBM mainframes, and many others:
-  20+ years' worth.
+   There you will also find [198]Kermit software packages for other
+   platforms: different Unix varieties, Windows, DOS, VMS, IBM mainframes,
+   and many others: 20+ years' worth.
+
+   [199]Kermit Home [200]C-Kermit Home [201]C-Kermit FAQ
+
+DOCUMENTATION AND UPDATES
 
-  [199]Kermit Home [200]C-Kermit Home [201]C-Kermit FAQ
-  DOCUMENTATION AND UPDATES [202]Top [203]Contents [204]Next [205]Previous
+   [202]Top [203]Contents [204]Next [205]Previous
 
-  The manual for C-Kermit is:
+   The manual for C-Kermit is:
 
     1. Frank da Cruz and Christine M. Gianone, [206]Using C-Kermit, Second
        Edition, Digital Press / Butterworth-Heinemann, Woburn, MA, 1997,
-       622 pages, ISBN 1-55558-164-1. This is a printed book. It covers
-       C-Kermit 6.0.
+       622 pages, ISBN 1-55558-164-1. This is a printed book, now also
+       available as a [207]Kindle E-Book. It covers C-Kermit 6.0.
     2. The C-Kermit 7.0 Supplement:
-       [207]http://www.columbia.edu/kermit/ckermit70.html
+       [208]http://www.columbia.edu/kermit/ckermit70.html
     3. The C-Kermit 8.0 Supplement:
-       [208]http://www.columbia.edu/kermit/ckermit80.html
+       [209]http://www.columbia.edu/kermit/ckermit80.html
     4. The C-Kermit 9.0 Supplement:
-       [209]http://www.columbia.edu/kermit/ckermit90.html
+       [210]http://www.columbia.edu/kermit/ckermit90.html
 
-  The C-Kermit home page is here:
+   The C-Kermit home page is here:
 
-  [210]http://www.columbia.edu/kermit/ckermit.html
+  [211]http://www.columbia.edu/kermit/ckermit.html
 
    Visit this page to learn about new versions, Beta tests, and other
    news; to read case studies and tutorials; to download source code,
-   install packages, and [211]prebuilt binaries for many platforms. Also
+   install packages, and [212]prebuilt binaries for many platforms. Also
    visit:
 
-   [212]http://www.columbia.edu/kermit/scriptlib.html
+   [213]http://www.columbia.edu/kermit/scriptlib.html
           The Kermit script library and tutorial
 
-   [213]http://www.columbia.edu/kermit/newfaq.html
+   [214]http://www.columbia.edu/kermit/newfaq.html
           The Kermit FAQ (Frequently Asked Questions about Kermit)
 
-   [214]http://www.columbia.edu/kermit/ckfaq.html
+   [215]http://www.columbia.edu/kermit/ckfaq.html
           The C-Kermit FAQ (Frequently Asked Questions about C-Kermit)
 
-   [215]http://www.columbia.edu/kermit/security.html
+   [216]http://www.columbia.edu/kermit/security.html
           The Kermit security reference.
 
-   [216]http://www.columbia.edu/kermit/telnet.html
+   [217]http://www.columbia.edu/kermit/telnet.html
           C-Kermit Telnet client documentation.
 
-   [217]http://www.columbia.edu/kermit/studies.html
+   [218]http://www.columbia.edu/kermit/studies.html
           Case studies.
 
-   [218]http://www.columbia.edu/kermit/ckcbwr.html
+   [219]http://www.columbia.edu/kermit/ckcbwr.html
           General C-Kermit Hints and Tips.
 
-   [219]http://www.columbia.edu/kermit/ckubwr.html
+   [220]http://www.columbia.edu/kermit/ckubwr.html
           Unix C-Kermit Hints and Tips.
 
-   [220]http://www.columbia.edu/kermit/ckvbwr.html
+   [221]http://www.columbia.edu/kermit/ckvbwr.html
           VMS C-Kermit Hints and Tips.
 
-   [221]http://www.columbia.edu/kermit/ckuins.html
+   [222]http://www.columbia.edu/kermit/ckuins.html
           Unix C-Kermit Installation Instructions
 
-   [222]http://www.columbia.edu/kermit/ckvins.html
+   [223]http://www.columbia.edu/kermit/ckvins.html
           VMS C-Kermit Installation Instructions
 
-   [223]http://www.columbia.edu/kermit/support.html
+   [224]http://www.columbia.edu/kermit/support.html
           Technical support.
 
-   [224]http://www.columbia.edu/kermit/k95tutorial.html
+   [225]http://www.columbia.edu/kermit/k95tutorial.html
           Kermit 95 tutorial (this document).
 
-   [225]comp.protocols.kermit.misc
+   [226]comp.protocols.kermit.misc
           The Kermit newsgroup (unmoderated).
 
-   [226]Kermit Home [227]C-Kermit Home [228]C-Kermit FAQ
+   [227]Kermit Home [228]C-Kermit Home [229]C-Kermit FAQ
 
-  FILES [229]Top [230]Contents [231]Next [232]Previous
+FILES
 
-   [233]The Revised 3-Clause License
+   [230]Top [231]Contents [232]Next [233]Previous
+
+          [234]The Revised 3-Clause License
           C-Kermit license.
 
-   [234]~/.kermrc
+   [235]~/.kermrc
           Initialization file.
 
-   [235]~/.mykermrc
+   [236]~/.mykermrc
           Customization file.
 
    ~/.kdd
@@ -1617,19 +1650,19 @@ Enter, separated by spaces, for example:
    ~/.ksd
           Kermit services directory (see manual).
 
-   [236]ckuins.html
+   [237]ckuins.html
           Installation instructions for Unix.
 
-   [237]ckcbwr.html
+   [238]ckcbwr.html
           General C-Kermit bugs, hints, tips.
 
-   [238]ckubwr.html
+   [239]ckubwr.html
           Unix-specific C-Kermit bugs, hints, tips.
 
-   [239]ckcplm.html
+   [240]ckcplm.html
           C-Kermit program logic manual.
 
-   [240]ckccfg.html
+   [241]ckccfg.html
           C-Kermit compile-time configuration options.
 
    ssh
@@ -1639,12 +1672,14 @@ Enter, separated by spaces, for example:
           (in your PATH) external protocols for XYZmodem.
 
    /var/spool/locks (or whatever)
-          UUCP lockfile for dialing out (see [241]installation
+          UUCP lockfile for dialing out (see [242]installation
           instructions).
 
-   [242]Kermit Home [243]C-Kermit Home [244]C-Kermit FAQ
+   [243]Kermit Home [244]C-Kermit Home [245]C-Kermit FAQ
+
+AUTHORS
 
-  AUTHORS [245]Top [246]Contents [247]Previous
+   [246]Top [247]Contents [248]Previous
 
      Frank da Cruz and Jeffrey E Altman
      The Kermit Project - Columbia Univerity
@@ -1657,8 +1692,8 @@ Enter, separated by spaces, for example:
      __________________________________________________________________
 
 
-    C-Kermit 9.0 Unix Manual Page and Tutorial / [248]kermit@columbia.edu
-    / 30 June 2011
+    C-Kermit 9.0 Unix Manual Page and Tutorial / [249]kermit@columbia.edu
+    / 1 July 2011
 
 References
 
@@ -1868,45 +1903,46 @@ References
  204. http://www.columbia.edu/kermit/ckututor.html#files
  205. http://www.columbia.edu/kermit/ckututor.html#other
  206. http://www.columbia.edu/kermit/ckmanual.html
- 207. http://www.columbia.edu/kermit/ckermit70.html
- 208. http://www.columbia.edu/kermit/ckermit80.html
- 209. http://www.columbia.edu/kermit/ckermit90.html
- 210. http://www.columbia.edu/kermit/ckermit.html
- 211. http://www.columbia.edu/kermit/ck80binaries.html
- 212. http://www.columbia.edu/kermit/scriptlib.html
- 213. http://www.columbia.edu/kermit/newfaq.html
- 214. http://www.columbia.edu/kermit/ckfaq.html
- 215. http://www.columbia.edu/kermit/security.html
- 216. http://www.columbia.edu/kermit/telnet.html
- 217. http://www.columbia.edu/kermit/studies.html
- 218. http://www.columbia.edu/kermit/ckcbwr.html
- 219. http://www.columbia.edu/kermit/ckubwr.html
- 220. http://www.columbia.edu/kermit/ckvbwr.html
- 221. http://www.columbia.edu/kermit/ckuins.html
- 222. http://www.columbia.edu/kermit/ckvins.html
- 223. http://www.columbia.edu/kermit/support.html
- 224. http://www.columbia.edu/kermit/k95tutorial.html
- 225. news:comp.protocols.kermit.misc
- 226. http://www.columbia.edu/kermit/
- 227. http://www.columbia.edu/kermit/ckermit.html
- 228. http://www.columbia.edu/kermit/ckfaq.html
- 229. http://www.columbia.edu/kermit/ckututor.html#top
- 230. http://www.columbia.edu/kermit/ckututor.html#contents
- 231. http://www.columbia.edu/kermit/ckututor.html#authors
- 232. http://www.columbia.edu/kermit/ckututor.html#documentation
- 233. http://www.columbia.edu/kermit/cu-bsd-license.html
- 234. ftp://kermit.columbia.edu/kermit/c-kermit/ckermit.ini
- 235. ftp://kermit.columbia.edu/kermit/c-kermit/ckermod.ini
- 236. http://www.columbia.edu/kermit/ckuins.html
- 237. http://www.columbia.edu/kermit/ckcbwr.html
- 238. http://www.columbia.edu/kermit/ckubwr.html
- 239. http://www.columbia.edu/kermit/ckcplm.html
- 240. http://www.columbia.edu/kermit/ckccfg.html
- 241. http://www.columbia.edu/kermit/ckuins.html
- 242. http://www.columbia.edu/kermit/
- 243. http://www.columbia.edu/kermit/ckermit.html
- 244. http://www.columbia.edu/kermit/ckfaq.html
- 245. http://www.columbia.edu/kermit/ckututor.html#top
- 246. http://www.columbia.edu/kermit/ckututor.html#contents
- 247. http://www.columbia.edu/kermit/ckututor.html#files
- 248. mailto:kermit@columbia.edu
+ 207. http://www.amazon.com/gp/product/B002ACPF9M?ie=UTF8&tag=aleidmoreldom-20&linkCode=as2&camp=1789&creative=390957&creativeASIN=B002ACPF9M
+ 208. http://www.columbia.edu/kermit/ckermit70.html
+ 209. http://www.columbia.edu/kermit/ckermit80.html
+ 210. http://www.columbia.edu/kermit/ckermit90.html
+ 211. http://www.columbia.edu/kermit/ckermit.html
+ 212. http://www.columbia.edu/kermit/ck80binaries.html
+ 213. http://www.columbia.edu/kermit/scriptlib.html
+ 214. http://www.columbia.edu/kermit/newfaq.html
+ 215. http://www.columbia.edu/kermit/ckfaq.html
+ 216. http://www.columbia.edu/kermit/security.html
+ 217. http://www.columbia.edu/kermit/telnet.html
+ 218. http://www.columbia.edu/kermit/studies.html
+ 219. http://www.columbia.edu/kermit/ckcbwr.html
+ 220. http://www.columbia.edu/kermit/ckubwr.html
+ 221. http://www.columbia.edu/kermit/ckvbwr.html
+ 222. http://www.columbia.edu/kermit/ckuins.html
+ 223. http://www.columbia.edu/kermit/ckvins.html
+ 224. http://www.columbia.edu/kermit/support.html
+ 225. http://www.columbia.edu/kermit/k95tutorial.html
+ 226. news:comp.protocols.kermit.misc
+ 227. http://www.columbia.edu/kermit/
+ 228. http://www.columbia.edu/kermit/ckermit.html
+ 229. http://www.columbia.edu/kermit/ckfaq.html
+ 230. http://www.columbia.edu/kermit/ckututor.html#top
+ 231. http://www.columbia.edu/kermit/ckututor.html#contents
+ 232. http://www.columbia.edu/kermit/ckututor.html#authors
+ 233. http://www.columbia.edu/kermit/ckututor.html#documentation
+ 234. http://www.columbia.edu/kermit/cu-bsd-license.html
+ 235. ftp://kermit.columbia.edu/kermit/c-kermit/ckermit.ini
+ 236. ftp://kermit.columbia.edu/kermit/c-kermit/ckermod.ini
+ 237. http://www.columbia.edu/kermit/ckuins.html
+ 238. http://www.columbia.edu/kermit/ckcbwr.html
+ 239. http://www.columbia.edu/kermit/ckubwr.html
+ 240. http://www.columbia.edu/kermit/ckcplm.html
+ 241. http://www.columbia.edu/kermit/ckccfg.html
+ 242. http://www.columbia.edu/kermit/ckuins.html
+ 243. http://www.columbia.edu/kermit/
+ 244. http://www.columbia.edu/kermit/ckermit.html
+ 245. http://www.columbia.edu/kermit/ckfaq.html
+ 246. http://www.columbia.edu/kermit/ckututor.html#top
+ 247. http://www.columbia.edu/kermit/ckututor.html#contents
+ 248. http://www.columbia.edu/kermit/ckututor.html#files
+ 249. mailto:kermit@columbia.edu