1 Correctly escape hyphens in man page
2 --- ckermit-211.orig/ckuker.nr
3 +++ ckermit-211/ckuker.nr
9 -transport- and platform-independent
11 +transport\(hy and platform\(hyindependent
12 interactive and scriptable communications software.
15 This document is intended to give the beginner sufficient information to make
16 -basic (if not advanced) use of C-Kermit 8.0. Although it might be rather long
17 -for a Unix manual page, it's still far shorter than the C-Kermit manual, which
18 -should be consulted for advanced topics such as customization, character-sets,
19 +basic (if not advanced) use of C\(hyKermit 8.0. Although it might be rather long
20 +for a Unix manual page, it's still far shorter than the C\(hyKermit manual, which
21 +should be consulted for advanced topics such as customization, character\(hysets,
22 scripting, etc. We also attempt to provide a clear structural overview of
23 -C-Kermit's many capabilities, functional areas, states, and modes and their
24 +C\(hyKermit's many capabilities, functional areas, states, and modes and their
25 interrelation, that should be helpful to beginners and veterans alike, as well
26 as to those upgrading to version 8.0 from earlier releases.
30 http://www.columbia.edu/kermit/ckututor.html
32 -C-Kermit is an all-purpose communications software package from the Kermit
33 +C\(hyKermit is an all\(hypurpose communications software package from the Kermit
34 Project at Columbia University that:
37 -\(bu Is portable to many platforms, Unix and non-Unix alike.
38 +\(bu Is portable to many platforms, Unix and non\(hyUnix alike.
40 \(bu Can make both serial and network connections.
44 \(bu Can convert character sets in the terminal session.
46 -\(bu Can convert character sets during text-file file transfer.
47 +\(bu Can convert character sets during text\(hyfile file transfer.
49 \(bu Is customizable in every aspect of its operation.
52 -C-Kermit is a modem program, a Telnet client, an Rlogin client, an FTP
53 +C\(hyKermit is a modem program, a Telnet client, an Rlogin client, an FTP
54 client, an HTTP client, and on selected platforms, also an X.25 client. It
55 -can make its own secure Internet connections using IETF-approved security
56 +can make its own secure Internet connections using IETF\(hyapproved security
57 methods including Kerberos IV, Kerberos V, SSL/TLS, and SRP and it can also
58 make SSH connections through your external SSH client application. It can
59 -be the far-end file-transfer or client/server partner of your desktop
60 +be the far\(hyend file\(hytransfer or client/server partner of your desktop
61 Kermit client. It can also accept incoming dialed and network connections.
62 It can even be installed as an Internet service on its own standard TCP
63 socket, 1649 [RFC2839, RFC2840].
65 And perhaps most important, everything you can do "by hand" (interactively)
66 -with C-Kermit, can be "scripted" (automated) using its built-in
67 -cross-platform transport-independent script programming language, which
68 +with C\(hyKermit, can be "scripted" (automated) using its built\(hyin
69 +cross\(hyplatform transport\(hyindependent script programming language, which
70 happens to be identical to its interactive command language.
72 -This manual page offers an overview of C-Kermit 8.0 for Unix ("Unix" is an
73 -operating system family that includes AIX, DG/UX, FreeBSD, HP-UX, IRIX,
74 +This manual page offers an overview of C\(hyKermit 8.0 for Unix ("Unix" is an
75 +operating system family that includes AIX, DG/UX, FreeBSD, HP\(hyUX, IRIX,
76 Linux, Mac OS X, NetBSD, OpenBSD, Open Server, Open Unix, QNX, Solaris,
77 SunOS, System V R3, System V R4, Tru64 Unix, Unixware, Xenix, and many
78 -others). For thorough coverage, please consult the published C-Kermit
79 +others). For thorough coverage, please consult the published C\(hyKermit
80 manual and supplements (see DOCUMENTATION below). For further information
81 -about C-Kermit, Kermit software for other platforms, and Kermit manuals,
82 +about C\(hyKermit, Kermit software for other platforms, and Kermit manuals,
83 visit the Kermit Project website:
85 http://www.columbia.edu/kermit/
87 -This is a longer-than-average manual page, and yet it barely scratches the
88 -surface. Don't be daunted. C-Kermit is a large and complex package,
89 +This is a longer\(hythan\(hyaverage manual page, and yet it barely scratches the
90 +surface. Don't be daunted. C\(hyKermit is a large and complex package,
91 evolving over decades of practice and experience, but that doesn't mean
92 it's hard to learn or use. Its most commonly used functions are explained
93 here with pointers to additional information elsewhere.
107 -If the first command-line argument is the name of a file, interactive-mode
108 -commands are executed from the file. The '=' (or "--") argument tells
109 +If the first command\(hyline argument is the name of a file, interactive\(hymode
110 +commands are executed from the file. The '=' (or "\-\-") argument tells
111 Kermit not to parse the remainder of the command line, but to make the
112 words following '=' available as \e%1, \e%2, ... \e%9. The "+" argument is
113 like "=" but for use in "kerbang scripts" (explained below). A second
114 -command-line format allows the one and only argument to be a Telnet, FTP,
115 +command\(hyline format allows the one and only argument to be a Telnet, FTP,
119 @@ -100,338 +100,338 @@
123 -The initialization file, if any, unless suppressed with -Y.
124 +The initialization file, if any, unless suppressed with \-Y.
128 The customization file (if it is executed by the initialization file).
131 -The command-line URL (if any, and if so, execution stops here).
132 +The command\(hyline URL (if any, and if so, execution stops here).
135 -Command-line options (if any).
136 +Command\(hyline options (if any).
139 Interactive commands.
141 -Some command-line options can cause actions (such as -s to send a file);
142 +Some command\(hyline options can cause actions (such as \-s to send a file);
143 others just set parameters. If any action options are included on the
144 -command line, Kermit exits when finished unless also given the -S ("stay")
145 +command line, Kermit exits when finished unless also given the \-S ("stay")
146 option. If no action options are given, no initialization or command files
147 contained an EXIT or QUIT command, and no fatal errors occurred, Kermit
148 issues its prompt and waits for you to type commands.
150 -Bear in mind that C-Kermit can be built with selected features
151 +Bear in mind that C\(hyKermit can be built with selected features
152 disabled, and also that certain features are not available on all
153 -platforms. For example, C-Kermit can't be built with TCP/IP
154 +platforms. For example, C\(hyKermit can't be built with TCP/IP
155 support on a platform that does not have TCP/IP header files and
156 libraries (and even if Kermit does include TCP/IP support, it
157 can't be used to make TCP/IP connections on a computer that does
158 not have a TCP/IP stack installed). If your version of lacks
159 -C-Kermit a feature mentioned here, use its SHOW FEATURES command to
160 +C\(hyKermit a feature mentioned here, use its SHOW FEATURES command to
161 see what might have been excluded.
163 -C-Kermit has three kinds of commands: regular single-letter command-line
164 -options, extended-format command-line options, and interactive commands.
165 +C\(hyKermit has three kinds of commands: regular single\(hyletter command\(hyline
166 +options, extended\(hyformat command\(hyline options, and interactive commands.
168 -Like most Unix commands, C-Kermit can be be given options on the command
169 -line. But C-Kermit also can be used interactively by giving it commands
170 -composed of words, which are more intuitive than cryptic command-line
171 +Like most Unix commands, C\(hyKermit can be be given options on the command
172 +line. But C\(hyKermit also can be used interactively by giving it commands
173 +composed of words, which are more intuitive than cryptic command\(hyline
174 options, and more flexible too. In other words, you don't have to use
175 -C-Kermit's command-line options, but they are available if you want to. (By
176 -the same token, you don't have to use its interactive commands either --
177 +C\(hyKermit's command\(hyline options, but they are available if you want to. (By
178 +the same token, you don't have to use its interactive commands either \(hy\(hy
179 you can use either or both in any combination.)
181 -C-Kermit is generally installed in the PATH as "kermit", and therefore is
182 +C\(hyKermit is generally installed in the PATH as "kermit", and therefore is
183 invoked by typing the word "kermit" (lowercase) at the shell prompt, and
184 -then pressing the Return or Enter key. If you wish to include command-line
185 +then pressing the Return or Enter key. If you wish to include command\(hyline
186 options, put them after the word "kermit" but before pressing Return or
187 Enter, separated by spaces, for example:
189 - $ kermit -s ckermit.tar.gz
190 + $ kermit \-s ckermit.tar.gz
192 -('$' is the shell prompt; "kermit -s ckermit.tar.gz" is what you type,
193 +('$' is the shell prompt; "kermit \-s ckermit.tar.gz" is what you type,
194 followed by Return or Enter.)
196 -Here is a list of C-Kermit's single-letter command-line options, which
197 -start with a single dash (-), in ASCII ("alphabetical") order. Alphabetic
198 -case is significant (-A is not the same as -a). Action options are
199 +Here is a list of C\(hyKermit's single\(hyletter command\(hyline options, which
200 +start with a single dash (\-), in ASCII ("alphabetical") order. Alphabetic
201 +case is significant (\-A is not the same as \-a). Action options are
206 (digit zero) 100% transparent Connect state for
207 -"in-the-middle" operation: 8 bits, no parity, no
208 +"in\(hythe\(hymiddle" operation: 8 bits, no parity, no
209 escape character, everything passes through.
212 -(digit eight) Connection is 8-bit clean (this is the
213 -default in C-Kermit 8.0). Equivalent to the EIGHTBIT
215 +(digit eight) Connection is 8\(hybit clean (this is the
216 +default in C\(hyKermit 8.0). Equivalent to the EIGHTBIT
217 command, which in turn is a shortcut for SET TERMINAL
218 BYTESIZE 8, SET COMMAND BYTESIZE 8, SET PARITY NONE.
222 (digit nine) Make a connection to an FTP server.
223 Equivalent to the FTP OPEN command.
224 -Argument: IP-address-or-hostname[:optional-TCP-port].
225 -NOTE: C-Kermit also has a separate FTP command-line
226 -personality, with regular FTP-like command-line
227 +Argument: IP\(hyaddress\(hyor\(hyhostname[:optional\(hyTCP\(hyport].
228 +NOTE: C\(hyKermit also has a separate FTP command\(hyline
229 +personality, with regular FTP\(hylike command\(hyline
230 syntax. More about this below.
234 Kermit is to be started as an Internet service (IKSD)
235 (only from inetd.conf).
239 Kermit is running in Batch or Background (no
240 controlling terminal). To be used in case Kermit
241 doesn't automatically sense its background status.
242 Equivalent to the SET BACKGROUND ON command.
245 -Interactive-mode Commands to be executed.
247 +Interactive\(hymode Commands to be executed.
248 Argument: Commands separated by commas, list in
253 Delay before starting to send in Remote mode.
254 Equivalent to the SET DELAY command.
255 Argument: Number of seconds.
259 Exit automatically when connection closes. Equivalent
260 -to SET EXIT ON-DISCONNECT ON.
261 +to SET EXIT ON\-DISCONNECT ON.
265 Use an open TCP connection.
266 Argument: Numeric file descriptor of open TCP
273 (ACTION) Get file(s) from server, send contents to standard
274 output, which normally would be piped to another
276 Argument: Remote file specification, in quotes if it
277 contains metacharacters.
283 Suppress program startup Herald and greeting.
287 Tell Kermit it has a reliable connection, to force streaming to be used where
288 it normally would not be. Equivalent to the SET RELIABLE ON command.
291 -(ACTION) "Be like Telnet." Like -j but implies -E. Argument: IP
292 -hostname/address optionally followed by service. NOTE: C-Kermit also has a
293 -separate Telnet command-line personality, with regular Telnet-like
294 -command-line syntax. More about this below.
296 +(ACTION) "Be like Telnet." Like \-j but implies \-E. Argument: IP
297 +hostname/address optionally followed by service. NOTE: C\(hyKermit also has a
298 +separate Telnet command\(hyline personality, with regular Telnet\(hylike
299 +command\(hyline syntax. More about this below.
302 -Recursive directory descent for files in -s option.
304 +Recursive directory descent for files in \-s option.
308 My user name (for use with Telnet, Rlogin, FTP, etc).
309 Equivalent to the SET LOGIN USER command.
310 Argument: Username string.
314 (ACTION) (Uppercase letter O) Be a server for One command only.
320 Don't convert file (Path) names of transferred files.
321 Equivalent to SET FILE NAMES LITERAL.
325 Quick Kermit protocol settings. Equivalent to the FAST
326 -command. This is the default in C-Kermit 7.0 and later.
327 +command. This is the default in C\(hyKermit 7.0 and later.
330 -Remote-only (this just makes IF REMOTE true).
332 +Remote\(hyonly (this just makes IF REMOTE true).
336 Stay (enter command parser after action options).
339 -Force Text mode for file transfer; implies -V.
341 +Force Text mode for file transfer; implies \-V.
342 Equivalent to SET TRANSFER MODE MANUAL, SET FILE TYPE TEXT.
345 -Disable automatic per-file text/binary switching.
347 +Disable automatic per\(hyfile text/binary switching.
348 Equivalent to SET TRANSFER MODE MANUAL.
352 Skip (don't execute) the initialization file.
355 -As-name for file(s) in -s, -r, or -g.
356 -Argument: As-name string (alternative filename). When
358 +As\(hyname for file(s) in \-s, \-r, or \-g.
359 +Argument: As\(hyname string (alternative filename). When
360 receiving files, this can be a directory name.
364 Speed for serial device. Equivalent to SET SPEED.
365 Argument: Numeric Bits per second for serial
370 (ACTION) Enter Connect state before transferring files.
374 Create a debug.log file with detailed debugging
375 -information (a second -d adds timestamps). Equivalent
376 +information (a second \-d adds timestamps). Equivalent
377 to LOG DEBUG but takes effect sooner.
380 -Maximum length for incoming Kermit file-transfer
381 -packets. Equivalent to SET RECEIVE PACKET-LENGTH.
383 +Maximum length for incoming Kermit file\(hytransfer
384 +packets. Equivalent to SET RECEIVE PACKET\-LENGTH.
385 Argument: Length in bytes.
389 (ACTION) Send a FINISH command to a Kermit server.
393 Get file(s) from a Kermit server.
394 Argument: File specification on other computer, in
395 quotes if it contains metacharacters. Equivalent to
396 -GET. Also see: -a, -G, -r.
397 +GET. Also see: \-a, \-G, \-r.
400 -(ACTION) Print Help text for single-letter command-line options
402 +(ACTION) Print Help text for single\(hyletter command\(hyline options
403 (pipe thru 'more' to prevent scrolling).
407 Force binary (Image) mode for file transfer; implies
408 --V. Equivalent to SET TRANSFER MODE MANUAL, SET FILE
409 +\-V. Equivalent to SET TRANSFER MODE MANUAL, SET FILE
414 Make a TCP/IP connection.
415 Argument: IP host name/address and optional service
416 name or number. Equivalent to the TELNET command.
422 (ACTION) Receive file(s) to standard output, which normally
423 would be piped to another process.
429 (Lowercase letter L) Make a connection on the given
430 serial communications device. Equivalent to the SET
431 LINE (SET PORT) command.
432 Argument: Serial device name, e.g. /dev/ttyS0.
435 -Modem type for use with the -l device. Equivalent to
437 +Modem type for use with the \-l device. Equivalent to
438 the SET MODEM TYPE command.
439 Argument: Modem name as in SET MODEM TYPE command,
444 (ACTION) Enter Connect state after transferring files (historical).
448 Parity. Equivalent to the SET PARITY command.
449 Argument: One of the following: e(ven), o(dd), m(ark),
454 Quiet (suppress most messages). Equivalent to SET QUIET ON.
458 (ACTION) Receive file(s). Equivalent to the RECEIVE command.
459 -Argument: (none, but see -a)
460 +Argument: (none, but see \-a)
465 Argument: One or more local file specifications.
466 Equivalent to the SEND command.
471 -(Historical) Xon (Ctrl-Q) Turnaround character for
472 -half-duplex connections (used on serial linemode
474 +(Historical) Xon (Ctrl\-Q) Turnaround character for
475 +half\(hyduplex connections (used on serial linemode
476 connections to old mainframes). Equivalent to SET
477 DUPLEX HALF, SET HANDSHAKE XON.
481 Window size for Kermit protocol (ignored when
482 -streaming). Equivalanet to SET WINDOW-SIZE.
483 +streaming). Equivalanet to SET WINDOW\-SIZE.
484 Argument: Number, 1 to 32.
488 Incoming files Write over existing files. Equivalent
489 to SET FILE COLLISION OVERWRITE.
493 (ACTION) Enter server mode. Equivalent to the SERVER command.
499 Alternative initialization file.
504 Force foreground behavior. To be used in case Kermit
505 doesn't automatically sense its foreground status.
506 Equivalent to the SET BACKGROUND OFF command.
508 -Extended command-line options (necessary because single-letter ones are
509 -about used up) start with two dashes (--), with words rather than single
510 +Extended command\(hyline options (necessary because single\(hyletter ones are
511 +about used up) start with two dashes (\-\-), with words rather than single
512 letters as option names. If an extended option takes an argument, it is
513 separated from the option word by a colon (:). Extended options include:
516 - --bannerfile:filename
517 + \-\-bannerfile:filename
518 File to display upon startup or IKSD login.
521 + \-\-cdfile:filename
522 File to be sent for display to the client when
523 server changes directory (filename is relative to
524 -the changed-to directory).
525 +the changed\(hyto directory).
527 - --cdmessage:{on,off}
528 + \-\-cdmessage:{on,off}
529 Enable/disable the server CD message feature.
533 Prints usage message for extended options.
535 - --helpfile:filename
536 + \-\-helpfile:filename
537 Designates a file containing custom text to
538 -replace the top-level HELP command.
539 +replace the top\(hylevel HELP command.
543 Disables keyboard interrupts.
547 Disables the Kermit protocol file Permissions
548 attribute, to prevent transmission of file
549 permissions (protection) from sender to receiver.
552 -(ACTION) C-Kermit prints its version number.
554 +(ACTION) C\(hyKermit prints its version number.
556 -Plus several other IKSD-Only options described at:
557 +Plus several other IKSD\(hyOnly options described at:
559 http://www.columbia.edu/kermit/iksd.html
561 -See the file-transfer section for examples of command-line invocation.
562 +See the file\(hytransfer section for examples of command\(hyline invocation.
564 -C-Kermit's interactive command language is the subject of a 622-page book
565 +C\(hyKermit's interactive command language is the subject of a 622\(hypage book
566 and another several hundred pages of updates, far too much for a manual
567 page. But it's not hard to get started. At the shell prompt, just type
568 -"kermit" to get C-Kermit's interactive command prompt:
569 +"kermit" to get C\(hyKermit's interactive command prompt:
573 - (/current/directory) C-Kermit>
574 + (/current/directory) C\-Kermit>
577 Begin by typing "help" (and then press the Return or Enter key) for a
578 -top-level overview, read it, and go from there. Your second command should
579 +top\(hylevel overview, read it, and go from there. Your second command should
580 probably be "intro" (introduction). Note the prompt shows your current
581 directory (unless you tell Kermit to prompt you with something else).
583 @@ -448,11 +448,11 @@
585 While typing commands, you can abbreviate, ask for help (by pressing the
586 "?" key anywhere in a command), complete keywords or filenames (with the
587 -Tab or Esc key), and edit your typing with Backspace or Delete, Ctrl-W,
588 -Ctrl-U, etc. You can also recall previous commands, save your command
589 +Tab or Esc key), and edit your typing with Backspace or Delete, Ctrl\-W,
590 +Ctrl\-U, etc. You can also recall previous commands, save your command
591 history, and who knows what else. Give the INTRO command for details.
593 -C-Kermit has hundreds of commands, and they can be issued in infinite
594 +C\(hyKermit has hundreds of commands, and they can be issued in infinite
595 variety and combinations, including commands for:
598 @@ -485,15 +485,15 @@
600 And of course QUIT or EXIT to get out and HELP to get help, and for
601 programmers: loops, decision making, variables, arrays, associative arrays,
602 -integer and floating point arithmetic, macros, built-in and user-defined
603 +integer and floating point arithmetic, macros, built\(hyin and user\(hydefined
604 functions, string manipulation, pattern matching, block structure, scoping,
605 -recursion, and all the rest. To get a list of all C-Kermit's commands, type
606 +recursion, and all the rest. To get a list of all C\(hyKermit's commands, type
607 a question mark (?) at the prompt. To get a description of any command,
608 type HELP followed by the name of the command, for example:
612 -The command interruption character is Ctrl-C (hold down the Ctrl key and
613 +The command interruption character is Ctrl\-C (hold down the Ctrl key and
616 The command language "escape character", used to introduce variable names,
618 A file containing Kermit commands is called a Kermit command file or Kermit
619 script. It can be executed with Kermit's TAKE command:
621 - (/current/dir) C-Kermit> take commandfile
622 + (/current/dir) C\-Kermit> take commandfile
624 (where "commandfile" is the name of the command file). Please don't pipe a
625 command file into Kermit's standard input (which might or might not work);
626 @@ -599,16 +599,16 @@
628 take \ev(home).kermrc
630 -at the desired spot in the script. By the way, \ev(xxx) is a built-in
631 +at the desired spot in the script. By the way, \ev(xxx) is a built\(hyin
632 variable (xxx is the variable name, "home" in this case). To see what
633 -built-in variables are available, type "show variables" at the C-Kermit
634 +built\(hyin variables are available, type "show variables" at the C\(hyKermit
635 prompt. To see what else you can show, type "show ?". \em(xxx) is a user
636 defined variable (strictly speaking, it is a macro used as a variable).
638 -C-Kermit has more than 200 top-level commands, and some of these, such as
639 +C\(hyKermit has more than 200 top\(hylevel commands, and some of these, such as
640 SET, branch off into hundreds of subcommands of their own, so it's not
641 practical to describe them all here. Instead, here's a concise list of the
642 -most commonly used top-level commands, grouped by category. To learn about
643 +most commonly used top\(hylevel commands, grouped by category. To learn about
644 each command, type "help" followed by the command name, e.g. "help set".
645 Terms such as Command state and Connect state are explained in subsequent
648 HELP text for each command. Example:
651 - send /recursive /larger:10000 /after:-1week /except:*.txt *
652 + send /recursive /larger:10000 /after:\-1week /except:*.txt *
655 which can be read as "send all the files in this directory and all the ones
656 @@ -631,19 +631,19 @@
660 -Requests top-level help.
661 +Requests top\(hylevel help.
664 Requests help about the given command.
667 -Requests a brief introduction to C-Kermit.
668 +Requests a brief introduction to C\(hyKermit.
671 -Displays the C-Kermit software copyright and license.
672 +Displays the C\(hyKermit software copyright and license.
675 -Displays C-Kermit's version number.
676 +Displays C\(hyKermit's version number.
679 Exits from Kermit with the given
680 @@ -667,13 +667,13 @@
682 Tells whether previous command succeeded or failed.
684 -DATE [ date-and/or-time ]
685 -Shows current date-time or interprets given date-time.
686 +DATE [ date\(hyand/or\(hytime ]
687 +Shows current date\(hytime or interprets given date\(hytime.
689 -RUN [ extern-command [ parameters... ]
690 +RUN [ extern\(hycommand [ parameters... ]
691 Runs the given external command. Synonym: !.
693 -EXEC [ extern-command [ params... ]
694 +EXEC [ extern\(hycommand [ params... ]
695 Kermit overlays itself with the given command.
699 the pattern. Synonym: FIND.
701 DIRECTORY [ options ] [filespec ]
702 -Lists files (built-in, many options).
703 +Lists files (built\(hyin, many options).
705 LS [ options ] [ filespec ]
706 Lists files (runs external "ls" command).
707 @@ -799,10 +799,10 @@
708 HTTP [ options ] OPEN host
709 Opens an HTTP connection to the host.
711 -PTY external-command
712 +PTY external\(hycommand
713 Runs the command on a pseudoterminal as if it were a connection.
715 -PIPE external-command
716 +PIPE external\(hycommand
717 Runs the command through a pipe as if it were a connection.
720 @@ -818,24 +818,24 @@
722 Sends a Telnet protocol command (Telnet connections only).
726 "Escapes back" from Connect state to Command state.
730 (In Connect state) Sends a BREAK signal (serial or Telnet).
734 (In Connect state) Enters inferior shell; "exit" to return.
737 -(In Connect state) Shows a menu of other escape-level options.
739 +(In Connect state) Shows a menu of other escape\(hylevel options.
743 (In Connect state) Type two
744 -Ctrl-Backslashes to send one of them.
745 +Ctrl\-Backslashes to send one of them.
747 SET ESCAPE [ character ]
748 -Changes Kermit's Connect-state escape character.
749 +Changes Kermit's Connect\(hystate escape character.
753 @@ -843,18 +843,18 @@
756 Hangs up the currently open
757 -serial-port or network connection.
758 +serial\(hyport or network connection.
761 Closes the currently open
762 -serial-port or network connection.
763 +serial\(hyport or network connection.
765 SET LINE (with no devicename)
766 Closes the currently open
767 -serial-port or network connection.
768 +serial\(hyport or network connection.
770 SET HOST (with no hostname)
771 -Closes the currently open serial-port or network connection.
772 +Closes the currently open serial\(hyport or network connection.
775 Closes the currently open FTP connection.
780 -SEND [ options ] filename [ as-name ]
781 +SEND [ options ] filename [ as\(hyname ]
782 Sends the given file. Synonym: S.
784 SEND [ options ] filespec
785 @@ -881,20 +881,20 @@
786 RESEND [ options ] filespec
787 Resumes an interupted SEND from the point of failure.
789 -RECEIVE [ options ] [ as-name ]
790 +RECEIVE [ options ] [ as\(hyname ]
791 Waits passively for files to arrive. Synonym: R.
793 LOG TRANSACTIONS [ filename ]
794 Keeps a record of file transfers.
797 -Use fast file-transfer settings (default).
798 +Use fast file\(hytransfer settings (default).
801 -Use cautious and less fast file-transfer settings.
802 +Use cautious and less fast file\(hytransfer settings.
805 -Use ultra-conservative and slow file-transfer settings.
806 +Use ultra\(hyconservative and slow file\(hytransfer settings.
808 STATISTICS [ options ]
809 Gives statistics about the most recent file transfer.
811 Captures remote text or files without protocol.
813 SET PROTOCOL [ name... ]
814 -Tells Kermit to use an external file-transfer protocol.
815 +Tells Kermit to use an external file\(hytransfer protocol.
817 FTP { PUT, MPUT, GET, MGET, ... }
821 Logs out from a Kermit server or IKSD.
823 -SEND [ options ] filename [ as-name ]
824 +SEND [ options ] filename [ as\(hyname ]
825 Sends the given file to the server. Synonyms: S, PUT.
827 SEND [ options ] filespec
828 @@ -949,10 +949,10 @@
829 RESEND [ options ] filespec
830 Resumes an interupted SEND from the point of failure.
832 -GET [ options ] remote-filespec
833 +GET [ options ] remote\(hyfilespec
834 Asks the server to send the given files. Synonym: G.
836 -REGET [ options ] remote-filespec
837 +REGET [ options ] remote\(hyfilespec
838 Resumes an interrupted GET from the point of failure.
840 REMOTE CD [ directory ]
842 (Many other commands: "remote ?" for a list).
844 MAIL [ options ] filespec
845 -Sends file(s) to be delivered as e-mail (Kermit only).
846 +Sends file(s) to be delivered as e\(hymail (Kermit only).
849 Asks the server to exit server state (Kermit only).
850 @@ -1005,21 +1005,21 @@
854 - C-Kermit> remote ? One of the following:
855 + C\-Kermit> remote ? One of the following:
856 assign directory kermit print rmdir
857 cd exit login pwd set
858 copy help logout query space
859 delete host mkdir rename type
860 - C-Kermit> remote set ? One of the following:
861 + C\-Kermit> remote set ? One of the following:
862 attributes file retry transfer
863 - block-check receive server window
864 - C-Kermit> remote set file ? One of the following:
865 - character-set incomplete record-length
866 + block\-check receive server window
867 + C\-Kermit> remote set file ? One of the following:
868 + character\-set incomplete record\-length
870 - C-Kermit> remote set file names ? One of the following:
871 + C\-Kermit> remote set file names ? One of the following:
873 - C-Kermit> remote set file names literal
875 + C\-Kermit> remote set file names literal
879 This is called menu on demand: you get a menu when you want one, but menus
880 @@ -1030,25 +1030,25 @@
881 example, "send x?" lists all the files in the current directory whose names
883 .SH INITIALIZATION FILE
884 -In its default configuration, C-Kermit executes commands from a file
885 +In its default configuration, C\(hyKermit executes commands from a file
886 called .kermrc in your home directory when it starts, unless it is given the
887 --Y or -y command-line option. Custom configurations might substitute a shared
888 -system-wide initialization file. The SHOW FILE command tells what
889 +\-Y or \-y command\(hyline option. Custom configurations might substitute a shared
890 +system\(hywide initialization file. The SHOW FILE command tells what
891 initialization file, if any, was used. The standard initialization file
892 "chains" to an individual customization file, .mykermc, in the home directory,
893 in which each user can establish her/his own preferences, define macros, and
896 Since execution of the initialization file (at least the standard one)
897 -makes C-Kermit take longer to start, it might be better not to have an
898 +makes C\(hyKermit take longer to start, it might be better not to have an
899 initialization file, especially now that Kermit's default startup
900 -configuration is well attuned to modern computing and networking -- in
901 +configuration is well attuned to modern computing and networking \(hy\(hy in
902 other words, you no longer have do anything special to make Kermit
903 transfers go fast. So instead of having an initialization file that is
904 executed every time Kermit starts, you might consider making one or more
905 kerbang scripts (with names other that .kermrc) that do NOT include an
906 "exit" command, and invoke those when you need the settings, macro
907 -definitions, and/or scripted actions they contain, and invoke C-Kermit
908 +definitions, and/or scripted actions they contain, and invoke C\(hyKermit
909 directly when you don't.
911 To put it another way... We still distribute the standard initialization
912 @@ -1068,7 +1068,7 @@
913 made any connections of its own). The local Kermit communicates over the
914 communications device or network connection, acting as a conduit between
915 the the remote computer and your keyboard and screen. The remote Kermit is
916 -the file-transfer partner to the local Kermit and communicates only through
917 +the file\(hytransfer partner to the local Kermit and communicates only through
918 its standard input and output.
920 At any moment, a Kermit program can be in any of the following states. It's
921 @@ -1091,7 +1091,7 @@
922 and execute commands from a file. The (perhaps implied) DO command
923 tells Kermit to read and execute commands from a macro definition.
924 While in Command state, you can interrupt any command, macro, or
925 -command file by typing Ctrl-C (hold down the Ctrl key and press the C
926 +command file by typing Ctrl\-C (hold down the Ctrl key and press the C
927 key); this normally brings you back to the prompt.
930 @@ -1111,24 +1111,24 @@
931 return to command state by logging out of the remote computer, or by
937 That is: Hold down the Ctrl key and press the backslash key, then let
938 go of the Ctrl key and press the C key. This is called escaping back.
939 -Certain other escape-level commands are also provided; type Ctrl-\e?
940 +Certain other escape\(hylevel commands are also provided; type Ctrl\-\e?
941 for a list. For example, you can enter Shell state with:
946 -To send a Ctrl-\e to the host while in Connect state, type two of them
947 +To send a Ctrl\-\e to the host while in Connect state, type two of them
948 in a row. See HELP CONNECT and HELP SET ESCAPE for more info.
950 -Local file-transfer state
951 +Local file\(hytransfer state
952 In this state, Kermit is sending packets back and forth with the other
953 computer in order to transfer a file or accomplish some other
954 -file-related task. And at the same time, it is displaying its progress
955 +file\(hyrelated task. And at the same time, it is displaying its progress
956 on your screen and watching your keyboard for interruptions. In this
957 -state, the following single-keystroke commands are accepted:
958 +state, the following single\(hykeystroke commands are accepted:
962 @@ -1141,61 +1141,61 @@
964 Like Z but uses a "stronger" protocol (use if X or Z don't work).
967 -Interrupt file-transfer mode (use if Z or E don't work).
969 +Interrupt file\(hytransfer mode (use if Z or E don't work).
972 Kermit returns to its previous state (Command or Connect) when the
973 transfer is complete or when interrupted successfully by X, Z, E, or
974 -Ctrl-C (hold down the Ctrl key and press the C key).
975 +Ctrl\-C (hold down the Ctrl key and press the C key).
977 -Remote file-transfer state
978 -In this state, Kermit is exchanging file-transfer packets with its
979 +Remote file\(hytransfer state
980 +In this state, Kermit is exchanging file\(hytransfer packets with its
981 local partner over its standard i/o. It leaves this state
982 automatically when the transfer is complete. In case you find your
983 -local Kermit in Connect state and the remote one in File-transfer
984 +local Kermit in Connect state and the remote one in File\(hytransfer
985 state (in which it seems to ignore your keystrokes), you can usually
986 -return it to command state by typing three Ctrl-C's in a row. If that
987 -doesn't work, return your local Kermit to Command state (Ctrl-\e C) and
988 -type "e-packet" and then press the Return or Enter key; this forces a
989 +return it to command state by typing three Ctrl\-C's in a row. If that
990 +doesn't work, return your local Kermit to Command state (Ctrl\-\e C) and
991 +type "e\(hypacket" and then press the Return or Enter key; this forces a
992 fatal Kermit protocol error.
995 -This is like Remote File-transfer state, except it never returns
996 +This is like Remote File\(hytransfer state, except it never returns
997 automatically to Command state. Rather, it awaits further instructions
998 from the client program; that is, from your Local Kermit program. You
999 can return the Remote Server to its previous state by issuing a
1000 "finish" command to the client, or if you are in Connect state, by
1001 -typing three Ctrl-C's in a row. You can tell the server job to log out
1002 +typing three Ctrl\-C's in a row. You can tell the server job to log out
1003 and break the connection by issuing a "bye" command to the client.
1006 -Like Remote-Server state, but in local mode, and therefore with its
1007 -file-transfer display showing, and listening for single-key commands,
1008 -as in Local File-transfer state. Usually this state is entered
1009 +Like Remote\(hyServer state, but in local mode, and therefore with its
1010 +file\(hytransfer display showing, and listening for single\(hykey commands,
1011 +as in Local File\(hytransfer state. Usually this state is entered
1012 automatically when a remote Kermit program gives a GET command.
1014 -C-Kermit, Kermit 95, and MS-DOS Kermit all can switch automatically from
1015 -Connect state to Local File-transfer state when you initiate a file
1016 +C\(hyKermit, Kermit 95, and MS\(hyDOS Kermit all can switch automatically from
1017 +Connect state to Local File\(hytransfer state when you initiate a file
1018 transfer from the remote computer by starting Kermit and telling it to send
1019 or get a file, in which case, Connect state is automatically resumed after
1020 the file transfer is finished.
1022 -Note that C-Kermit is not a terminal emulator. It is a communications
1023 +Note that C\(hyKermit is not a terminal emulator. It is a communications
1024 application that you run in a terminal window (e.g. console or Xterm). The
1025 specific emulation, such as VT100, VT220, Linux Console, or Xterm, is
1026 -provided by the terminal window in which you are running C-Kermit. Kermit
1027 -95 and MS-DOS Kermit, on the other hand, are true terminal emulators. Why
1028 -is C-Kermit not a terminal emulator? CLICK HERE to read about it.
1029 +provided by the terminal window in which you are running C\(hyKermit. Kermit
1030 +95 and MS\(hyDOS Kermit, on the other hand, are true terminal emulators. Why
1031 +is C\(hyKermit not a terminal emulator? CLICK HERE to read about it.
1032 .SH MAKING CONNECTIONS
1033 Here is how to make different kinds of connections using interactive Kermit
1034 -commands (as noted above, you can also make connections with command-line
1035 +commands (as noted above, you can also make connections with command\(hyline
1036 options). Note that you don't have to make connections with Kermit. It can
1037 also be used on the far end of a connection as the remote file transfer and
1038 management partner of your local communications software.
1040 Making a Telnet Connection
1041 -At the C-Kermit command prompt, simply type:
1042 +At the C\(hyKermit command prompt, simply type:
1046 @@ -1224,10 +1224,10 @@
1047 More info: HELP RLOGIN.
1049 Making an SSH Connection
1050 -Unlike Telnet and Rlogin, SSH connections are not built-in, but
1051 +Unlike Telnet and Rlogin, SSH connections are not built\(hyin, but
1052 handled by running your external SSH client through a pseudoterminal.
1053 -Using C-Kermit to control the SSH client gives you all of Kermit's
1054 -features (file transfer, character-set conversion, scripting, etc)
1055 +Using C\(hyKermit to control the SSH client gives you all of Kermit's
1056 +features (file transfer, character\(hyset conversion, scripting, etc)
1060 @@ -1236,7 +1236,7 @@
1062 Dialing with a Modem
1063 If it's an external modem, make sure it is connected to a usable
1064 -serial port on your computer with a regular (straight-through) modem
1065 +serial port on your computer with a regular (straight\(hythrough) modem
1066 cable, and to the telephone jack with a telephone cable, and that it's
1067 turned on. Then use these commands:
1069 @@ -1251,7 +1251,7 @@
1071 Type "set modem type ?" for a list of supported modem types. If you
1072 omit the SET MODEM TYPE command, the default type is
1073 -"generic-high-speed", which should work for most modern AT-command-set
1074 +"generic\(hyhigh\(hyspeed", which should work for most modern AT\(hycommand\(hyset
1075 modems. If the line is busy, Kermit redials automatically. If the call
1076 does not succeed, use "set dial display on" and try it again to watch
1077 what happens. If the call succeeds, Kermit enters Connect state
1078 @@ -1262,34 +1262,34 @@
1079 reverse terminal server. In this case the command sequence is:
1082 - set host ts.xxx.com 2000 ; Terminal-server and port
1083 + set host ts.xxx.com 2000 ; Terminal\(hyserver and port
1084 set modem type usrobotics ; Or other supported type
1085 set dial method tone ; (or pulse)
1086 dial 7654321 ; Dial the desired number
1089 If the terminal server supports the Telnet Com Port Option, RFC 2217,
1090 -you can also give serial-port related commands such as SET SPEED, SET
1091 +you can also give serial\(hyport related commands such as SET SPEED, SET
1092 PARITY, and so on, and Kermit relays them to the terminal server using
1093 the protocol specified in the RFC.
1095 More info: HELP SET MODEM, HELP SET LINE, HELP SET SPEED, HELP SET
1096 FLOW, HELP DIAL, HELP SET DIAL, HELP SET MODEM, HELP SET
1097 -CARRIER-WATCH, SHOW COMMUNICATIONS, SHOW MODEM, SHOW DIAL.
1098 +CARRIER\-WATCH, SHOW COMMUNICATIONS, SHOW MODEM, SHOW DIAL.
1101 Connect the two computers, A and B, with a null modem cable (or two
1102 -modem cables interconnected with a null-modem adapter or modem
1103 +modem cables interconnected with a null\(hymodem adapter or modem
1104 eliminator). From Computer A:
1107 set modem type none ; There is no modem
1108 set line /dev/ttyS0 ; Specify device name
1109 - set carrier-watch off ; If DTR CD are not cross-connected
1110 + set carrier\-watch off ; If DTR CD are not cross\(hyconnected
1111 set speed 57600 ; Or other desired speed
1112 - set flow rts/cts ; If RTS and CTS are cross-connected
1113 + set flow rts/cts ; If RTS and CTS are cross\(hyconnected
1114 set parity even ; (or "mark" or "space", if necessary)
1115 - set stop-bits 2 ; (rarely necessary)
1116 + set stop\-bits 2 ; (rarely necessary)
1117 set flow xon/xoff ; If you can't use RTS/CTS
1118 connect ; Enter Connect (terminal) state
1120 @@ -1299,25 +1299,25 @@
1121 same directions. More info: As above plus HELP CONNECT.
1123 With modems or direct serial connections, you might also have to "set
1124 -parity even" (or "mark" or "space") if it's a 7-bit connection.
1125 +parity even" (or "mark" or "space") if it's a 7\(hybit connection.
1127 Of the connection types listed above, only one can be open at a time.
1128 However, any one of these can be open concurrently with an FTP or HTTP
1129 session. Each connection type can be customized to any desired degree,
1130 scripted, logged, you name it. See the manual.
1132 -NOTE: On selected platforms, C-Kermit also can make X.25 connections. See
1133 +NOTE: On selected platforms, C\(hyKermit also can make X.25 connections. See
1134 the manual for details.
1135 .SH TRANSFERRING FILES WITH KERMIT
1136 There is a widespread and persistent belief that Kermit is a slow protocol.
1137 This is because, until recently, it used conservative tuning by default to
1138 make sure file transfers succeeded, rather than failing because they
1139 -overloaded the connection. Some extra commands (or command-line options,
1140 -like -Q) were needed to make it go fast, but nobody bothered to find out
1141 -about them. Also, it takes two to tango: most non-Kermit-Project Kermit
1142 -protocol implementations really ARE slow. The best file-transfer partners
1143 -for C-Kermit are: another copy of C-Kermit (7.0 or later) and Kermit 95.
1144 -These combinations work well and they work fast by default. MS-DOS Kermit
1145 +overloaded the connection. Some extra commands (or command\(hyline options,
1146 +like \-Q) were needed to make it go fast, but nobody bothered to find out
1147 +about them. Also, it takes two to tango: most non\(hyKermit\(hyProject Kermit
1148 +protocol implementations really ARE slow. The best file\(hytransfer partners
1149 +for C\(hyKermit are: another copy of C\(hyKermit (7.0 or later) and Kermit 95.
1150 +These combinations work well and they work fast by default. MS\(hyDOS Kermit
1151 is good too, but you have to tell it to go fast (by giving it the FAST
1154 @@ -1326,50 +1326,50 @@
1155 packet comes in from the remote, they automatically switch into file
1158 -And plus, C-Kermit and K95 also switch automatically between text and
1159 +And plus, C\(hyKermit and K95 also switch automatically between text and
1160 binary mode for each file, so there is no need to "set file type binary" or
1161 "set file type text", or to worry about files being corrupted because they
1162 were transferred in the wrong mode.
1164 -What all of these words add up to is that now, when you use up-to-date
1165 +What all of these words add up to is that now, when you use up\(hyto\(hydate
1166 Kermit software from the Kermit Project, file transfer is not only fast,
1167 it's ridiculously easy. You barely have to give any commands at all.
1170 -Let's say you have Kermit 95, C-Kermit, or MS-DOS Kermit on your
1171 +Let's say you have Kermit 95, C\(hyKermit, or MS\(hyDOS Kermit on your
1172 desktop computer, with a connection to a Unix computer that has
1173 -C-Kermit installed as "kermit". To download a file (send it from Unix
1174 +C\(hyKermit installed as "kermit". To download a file (send it from Unix
1175 to your desktop computer), just type the following command at your
1178 - kermit -s oofa.txt
1179 + kermit \-s oofa.txt
1181 (where oofa.txt is the filename). If you want to send more than one
1182 file, you can put as many filenames as you want on the command line,
1183 and they can be any combination of text and binary:
1185 - kermit -s oofa.txt oofa.zip oofa.html oofa.tar.gz
1186 + kermit \-s oofa.txt oofa.zip oofa.html oofa.tar.gz
1188 and/or you can use wildcards to send groups of files:
1193 If you want to send a file under an assumed name, use:
1195 - kermit -s friday.txt -a today.txt
1196 + kermit \-s friday.txt \-a today.txt
1198 This sends the file friday.txt but tells the receiving Kermit that its
1199 name is today.txt. In all cases, as noted, when the file transfer is
1200 finished, your desktop Kermit returns automatically to Connect state.
1201 -No worries about escaping back, re-connecting, text/binary mode
1202 +No worries about escaping back, re\(hyconnecting, text/binary mode
1203 switching. Almost too easy, right?
1206 To upload files (send them from your desktop computer to the remote
1207 -Unix computer) do the same thing, but use the -g (GET) option instead
1209 +Unix computer) do the same thing, but use the \-g (GET) option instead
1212 - kermit -g oofa.txt
1213 + kermit \-g oofa.txt
1215 This causes your local Kermit to enter server mode; then the remote
1216 Kermit program requests the named file and the local Kermit sends it
1217 @@ -1379,27 +1379,27 @@
1218 rules, since these aren't local files:
1221 - kermit -g "oofa.txt oofa.zip oofa.html oofa.tar.gz"
1222 - kermit -g "oofa.*"
1223 + kermit \-g "oofa.txt oofa.zip oofa.html oofa.tar.gz"
1224 + kermit \-g "oofa.*"
1227 If you want to upload a file but store it under a different name, use:
1229 - kermit -g friday.txt -a today.txt
1230 + kermit \-g friday.txt \-a today.txt
1232 -Kermit Transfers the Old-Fashioned Way
1233 +Kermit Transfers the Old\(hyFashioned Way
1234 If your desktop communications software does not support autoupload or
1235 autodownload, or it does not include Kermit server mode, the procedure
1236 requires more steps.
1238 To download a file, type:
1240 - kermit -s filename
1241 + kermit \-s filename
1243 on the host as before, but if nothing happens automatically in
1244 response to this command, you have to switch your desktop
1245 communications software into Kermit Receive state. This might be done
1246 -by escaping back using keyboard characters or hot keys (Alt-x is
1247 +by escaping back using keyboard characters or hot keys (Alt\-x is
1248 typical) and/or with a command (like RECEIVE) or a menu. When the file
1249 transfer is complete, you have to go back to Connect state, Terminal
1250 emulation, or whatever terminology applies to your desktop
1251 @@ -1407,11 +1407,11 @@
1253 To upload a file, type:
1258 -on the host (rather than "kermit -g"). This tells C-Kermit to wait
1259 +on the host (rather than "kermit \-g"). This tells C\(hyKermit to wait
1260 passively for a file to start arriving. Then regain the attention of
1261 -your desktop software (Alt-x or whatever) and instruct it to send the
1262 +your desktop software (Alt\-x or whatever) and instruct it to send the
1263 desired file(s) with Kermit protocol. When the transfer is finished,
1264 return to the Connect or Terminal screen.
1266 @@ -1422,8 +1422,8 @@
1270 -Use fast file-transfer settings. This has been the default since
1271 -C-Kermit 7.0 now that most modern computers and connections
1272 +Use fast file\(hytransfer settings. This has been the default since
1273 +C\(hyKermit 7.0 now that most modern computers and connections
1274 support it. If transfers fail with fast settings, try . . .
1277 @@ -1434,21 +1434,21 @@
1278 Use the most robust, resilient, conservative, safe, and reliable
1279 settings. File transfers will almost certainly work, but they
1280 will be quite slow (of course this is a classic tradeoff; ROBUST
1281 -was C-Kermit's default tuning in versions 6.0 and earlier, which
1282 +was C\(hyKermit's default tuning in versions 6.0 and earlier, which
1283 made everybody think Kermit protocol was slow). If ROBUST doesn't
1284 do the trick, try again with SET PARITY SPACE first in case it's
1285 -not an 8-bit connection.
1286 +not an 8\(hybit connection.
1289 Obviously the success and performance of a file transfer also depends
1290 -on C-Kermit's file transfer partner. Up-to-date, real Kermit Project
1291 +on C\(hyKermit's file transfer partner. Up\(hyto\(hydate, real Kermit Project
1292 partners are recommended because they contain the best Kermit protocol
1293 implementations and because we can support them in case of trouble.
1295 -If you still have trouble, consult Chapter 10 of Using C-Kermit, or
1296 -send email to kermit-support@columbia.edu.
1297 +If you still have trouble, consult Chapter 10 of Using C\(hyKermit, or
1298 +send email to kermit\(hysupport@columbia.edu.
1300 -Advanced Kermit File-Transfer Features
1301 +Advanced Kermit File\(hyTransfer Features
1302 Obviously there is a lot more to Kermit file transfer, including all
1303 sorts of interactive commands, preferences, options, logging,
1304 debugging, troubleshooting, and anything else you can imagine but
1305 @@ -1460,10 +1460,10 @@
1307 LOG TRANSACTIONS (HELP LOG)
1309 -Automatic per-file text/binary mode switching:
1310 +Automatic per\(hyfile text/binary mode switching:
1311 SET TRANSFER MODE { AUTOMATIC, MANUAL } (HELP SET TRANSFER).
1313 -Cross-platform recursive directory tree transfer:
1314 +Cross\(hyplatform recursive directory tree transfer:
1315 SEND /RECURSIVE, GET /RECURSIVE (HELP SEND, HELP GET).
1317 File collision options:
1318 @@ -1478,14 +1478,14 @@
1319 Flexible file selection:
1320 SEND (or GET) /BEFORE /AFTER /LARGER /SMALLER /TYPE /EXCEPT, ...
1322 -Character-set conversion:
1323 -SET { FILE, TRANSFER } CHARACTER-SET, ASSOCIATE, ...
1324 +Character\(hyset conversion:
1325 +SET { FILE, TRANSFER } CHARACTER\-SET, ASSOCIATE, ...
1327 File/Pathname control:
1328 SET { SEND, RECEIVE } PATHNAMES, SET FILE NAMES.
1330 Atomic file movement:
1331 -SEND (or GET) /DELETE /RENAME /MOVE-TO
1332 +SEND (or GET) /DELETE /RENAME /MOVE\-TO
1334 Transferring to/from standard i/o of other commands:
1335 SEND (or GET) /COMMAND
1336 @@ -1494,8 +1494,8 @@
1337 RESEND, REGET (HELP RESEND, HELP REGET).
1340 -Non-Kermit File Transfer
1341 -You can also use C-Kermit to transfer files with FTP or HTTP Internet
1342 +Non\(hyKermit File Transfer
1343 +You can also use C\(hyKermit to transfer files with FTP or HTTP Internet
1344 protocols; see below.
1346 On a regular serial or Telnet connection where the other computer
1347 @@ -1510,10 +1510,10 @@
1350 You can also capture "raw" data streams from the other computer with
1351 -LOG SESSION (HELP LOG and HELP SET SESSION-LOG for details), and you
1352 +LOG SESSION (HELP LOG and HELP SET SESSION\-LOG for details), and you
1353 can upload files without any protocol at all with TRANSMIT (HELP
1354 TRANSMIT, HELP SET TRANSMIT).
1355 -.SH KERMIT'S BUILT-IN FTP AND HTTP CLIENTS
1356 +.SH KERMIT'S BUILT\(hyIN FTP AND HTTP CLIENTS
1357 Kermit's FTP client is like the regular Unix FTP client that you're used
1358 to, but with some differences:
1360 @@ -1542,7 +1542,7 @@
1361 http://www.columbia.edu/kermit/ftpclient.html
1363 You also can use HELP FTP and HELP SET FTP to get descriptions of Kermit's
1364 -FTP-related commands.
1365 +FTP\(hyrelated commands.
1367 The HTTP client is similar to the FTP one, except you prefix each command
1368 with HTTP instead of FTP: HTTP OPEN, HTTP GET, HTTP PUT, HTTP CLOSE, etc.
1369 @@ -1551,12 +1551,12 @@
1370 connections and FTP connections. So Kermit can manage up to three types
1371 connections simultaneously.
1372 .SH INTERNET KERMIT SERVICE
1373 -C-Kermit can be configured and run as an Internet service (called IKSD),
1374 +C\(hyKermit can be configured and run as an Internet service (called IKSD),
1375 similar to an FTP server (FTPD) except you can (but need not) interact with
1376 it directly, plus it does a lot more than an FTP server can do. The TCP
1377 -port for IKSD is 1649. It uses Telnet protocol. C-Kermit can be an Internet
1378 +port for IKSD is 1649. It uses Telnet protocol. C\(hyKermit can be an Internet
1379 Kermit Server, or it can be a client of an IKSD. You can make connections
1380 -from C-Kermit to an IKSD with any of the following commands:
1381 +from C\(hyKermit to an IKSD with any of the following commands:
1384 telnet foo.bar.edu 1649
1385 @@ -1574,8 +1574,8 @@
1387 http://www.columbia.edu/kermit/iksd.html
1389 -All of C-Kermit's built-in TCP/IP networking methods (Telnet, Rlogin, IKSD,
1390 -FTP, and HTTP) can be secured by one or more of the following IETF-approved
1391 +All of C\(hyKermit's built\(hyin TCP/IP networking methods (Telnet, Rlogin, IKSD,
1392 +FTP, and HTTP) can be secured by one or more of the following IETF\(hyapproved
1395 \(bu MIT Kerberos IV
1396 @@ -1590,43 +1590,43 @@
1398 http://www.columbia.edu/kermit/security.html
1400 -And as noted previously, you can also make SSH connections with C-Kermit if
1401 +And as noted previously, you can also make SSH connections with C\(hyKermit if
1402 you already have an SSH client installed.
1403 -.SH ALTERNATIVE COMMAND-LINE PERSONALITIES
1404 +.SH ALTERNATIVE COMMAND\(hyLINE PERSONALITIES
1405 When invoked as "kermit" or any other name besides "ftp" or "telnet",
1406 -C-Kermit has the command-line options described above in the OPTIONS
1407 -section. However, if you invoke C-Kermit as "telnet" or "ftp", it changes
1408 -its command-line personality to match. This can be done (among other ways)
1409 -with symbolic links (symlinks). For example, if you want C-Kermit to be
1410 +C\(hyKermit has the command\(hyline options described above in the OPTIONS
1411 +section. However, if you invoke C\(hyKermit as "telnet" or "ftp", it changes
1412 +its command\(hyline personality to match. This can be done (among other ways)
1413 +with symbolic links (symlinks). For example, if you want C\(hyKermit to be
1414 your regular Telnet client, or the Telnet helper of your Web browser, you
1415 can create a link like the following in a directory that lies in your PATH
1416 ahead of the regular telnet program:
1418 - ln -s /usr/local/bin/kermit telnet
1419 + ln \-s /usr/local/bin/kermit telnet
1421 Now when you give a "telnet" command, you are invoking Kermit instead, but
1422 -with its Telnet command-line personality so, for example:
1423 +with its Telnet command\(hyline personality so, for example:
1427 Makes a Telnet connection to xyzcorp.com, and Kermit exits automatically
1428 when the connection is closed (just like the regular Telnet client). Type
1429 -"telnet -h" to get a list of Kermit's Telnet-personality command-line
1430 +"telnet \-h" to get a list of Kermit's Telnet\(hypersonality command\(hyline
1431 options, which are intended to be as compatible as possible with the
1432 regular Telnet client.
1436 - ln -s /usr/local/bin/kermit ftp
1437 + ln \-s /usr/local/bin/kermit ftp
1439 -And now type "ftp -h" to see its command-line options, and command lines
1440 +And now type "ftp \-h" to see its command\(hyline options, and command lines
1441 just like you would give your regular FTP client:
1445 but with additional options allowing an entire session to be specified on
1446 the command line. Finally, if Kermit's
1447 -first command-line option is a Telnet, FTP, IKSD, or HTTP URL, Kermit
1448 +first command\(hyline option is a Telnet, FTP, IKSD, or HTTP URL, Kermit
1449 automatically makes the appropriate kind of connection and, if indicated by
1450 the URL, takes the desired action:
1452 @@ -1649,19 +1649,19 @@
1456 -C-Kermit has an unusual license, but a fair and sensible one since the
1457 +C\(hyKermit has an unusual license, but a fair and sensible one since the
1458 Kermit Project must support itself out of revenue: it's not a BSD license,
1459 not GPL, not Artistic, not commercial, not shareware, not freeware. It can
1460 -be summed up like this: if you want C-Kermit for your own use, you can
1461 +be summed up like this: if you want C\(hyKermit for your own use, you can
1462 download and use it without cost or license (but we'd appreciate it if you
1463 -would purchase the manual). But if you want to sell C-Kermit or bundle it
1464 +would purchase the manual). But if you want to sell C\(hyKermit or bundle it
1465 with a product or otherwise distribute it in a commercial setting EXCEPT
1466 -WITH AN OPEN-SOURCE OPERATING SYSTEM DISTRIBUTION such as Linux, FreeBSD,
1467 +WITH AN OPEN\(hySOURCE OPERATING SYSTEM DISTRIBUTION such as Linux, FreeBSD,
1468 NetBSD, or OpenBSD, you must license it. To see the complete license, give
1469 the LICENSE command at the prompt, or see the COPYING.TXT file distributed
1470 -with C-Kermit 7.0 or later, or download it from
1471 +with C\(hyKermit 7.0 or later, or download it from
1473 - ftp://kermit.columbia.edu/kermit/c-kermit/COPYING.TXT
1474 + ftp://kermit.columbia.edu/kermit/c\-kermit/COPYING.TXT
1476 Send licensing inquiries to kermit@columbia.edu.
1478 @@ -1669,27 +1669,27 @@
1479 workarounds, hints and tips:
1482 -General C-Kermit bugs, hints, tips.
1483 +General C\(hyKermit bugs, hints, tips.
1486 -Unix-specific C-Kermit bugs, hints, tips.
1487 +Unix\(hyspecific C\(hyKermit bugs, hints, tips.
1489 Report bugs and problems by email to:
1491 - kermit-support@columbia.edu.
1492 + kermit\-support@columbia.edu.
1494 Before requesting technical support, please read the hints here:
1496 http://www.columbia.edu/kermit/support.html
1498 -and also read the C-Kermit Frequently Asked Questions:
1499 +and also read the C\(hyKermit Frequently Asked Questions:
1501 http://www.columbia.edu/kermit/ckfaq.html
1503 -There's way more to C-Kermit than we've touched on here -- troubleshooting,
1504 +There's way more to C\(hyKermit than we've touched on here \(hy\(hy troubleshooting,
1505 customization, character sets, dialing directories, sending pages, script
1506 writing, and on and on, all of which are covered in the manual and updates
1507 -and supplements. For the most up-to-date information on documentation (or
1508 +and supplements. For the most up\(hyto\(hydate information on documentation (or
1509 updated documentation itself) visit the Kermit Project website:
1511 http://www.columbia.edu/kermit/
1512 @@ -1698,21 +1698,21 @@
1513 different Unix varieties, Windows, DOS, VMS, IBM mainframes, and many
1514 others: 20+ years' worth.
1515 .SH DOCUMENTATION AND UPDATES
1516 -The manual for C-Kermit is:
1517 +The manual for C\(hyKermit is:
1522 Frank da Cruz and Christine M. Gianone,
1523 -Second Edition, Digital Press / Butterworth-Heinemann, Woburn, MA, 1997, 622
1524 -pages, ISBN 1-55558-164-1. This is a printed book. It covers C-Kermit 6.0.
1525 +Second Edition, Digital Press / Butterworth\(hyHeinemann, Woburn, MA, 1997, 622
1526 +pages, ISBN 1\-55558\-164\-1. This is a printed book. It covers C\(hyKermit 6.0.
1528 -The C-Kermit 7.0 Supplement
1529 +The C\(hyKermit 7.0 Supplement
1530 http://www.columbia.edu/kermit/ckermit2.html
1532 -The C-Kermit 8.0 Supplement
1533 +The C\(hyKermit 8.0 Supplement
1534 http://www.columbia.edu/kermit/ckermit3.html
1536 -Visit C-Kermit home page:
1537 +Visit C\(hyKermit home page:
1539 http://www.columbia.edu/kermit/ckermit.html
1541 @@ -1727,13 +1727,13 @@
1542 The Kermit FAQ (Frequently Asked Questions about Kermit)
1544 http://www.columbia.edu/kermit/ckfaq.html
1545 -The C-Kermit FAQ (Frequently Asked Questions about C-Kermit)
1546 +The C\(hyKermit FAQ (Frequently Asked Questions about C\(hyKermit)
1548 http://www.columbia.edu/kermit/telnet.html
1549 -C-Kermit Telnet client documentation
1550 +C\(hyKermit Telnet client documentation
1552 http://www.columbia.edu/kermit/security.html
1553 -C-Kermit security documentation (Kerberos, SSL/TLS, etc)
1554 +C\(hyKermit security documentation (Kerberos, SSL/TLS, etc)
1556 http://www.columbia.edu/kermit/cuiksd.html
1557 Internet Kermit Service user documentation
1558 @@ -1755,7 +1755,7 @@
1563 +C\(hyKermit license.
1566 Initialization file.
1567 @@ -1780,16 +1780,16 @@
1568 http://www.columbia.edu/kermit/ckuins.html.
1571 -General C-Kermit bugs, hints, tips.
1572 +General C\(hyKermit bugs, hints, tips.
1575 -Unix-specific C-Kermit bugs, hints, tips.
1576 +Unix\(hyspecific C\(hyKermit bugs, hints, tips.
1579 -C-Kermit program logic manual.
1580 +C\(hyKermit program logic manual.
1583 -C-Kermit compile-time configuration options.
1584 +C\(hyKermit compile\(hytime configuration options.
1587 (in your PATH) SSH connection helper.
1588 @@ -1804,7 +1804,7 @@
1590 Frank da Cruz and Jeffrey E Altman,
1592 -1985-present, with contributions from hundreds of others all over the
1593 +1985\(hypresent, with contributions from hundreds of others all over the
1597 @@ -1812,13 +1812,13 @@
1601 -The Kermit Project - Columbia Univerity
1602 +The Kermit Project \(hy Columbia Univerity
1603 612 West 115th Street
1604 -New York NY 10025-7799
1605 +New York NY 10025\-7799