From: Ian Beckwith Date: Wed, 12 May 2010 00:07:24 +0000 (+0100) Subject: rearrange patch names X-Git-Tag: 211-14~19 X-Git-Url: http://erislabs.net/gitweb/?p=ckermit.git;a=commitdiff_plain;h=7dd57e901a88e5a8f45ec28b954d6034481c04a3 rearrange patch names --- diff --git a/debian/patches/010_makefile-destdir-support.patch b/debian/patches/010_makefile-destdir-support.patch new file mode 100644 index 0000000..d3d2854 --- /dev/null +++ b/debian/patches/010_makefile-destdir-support.patch @@ -0,0 +1,43 @@ +Patch makefile to support install to a staging area with DESTDIR +--- ckermit-211.orig/makefile ++++ ckermit-211/makefile +@@ -998,7 +998,7 @@ + echo "RmF $(DESTDIR)$(BINDIR)/kermit-sshsub" >&3;\ + echo "RmF $(DESTDIR)$(BINDIR)/kermit" >&3;\ + if test -f ckermit.ini; then\ +- echo "#!$(DESTDIR)$(BINDIR)/kermit" >\ ++ echo "#!$(BINDIR)/kermit" >\ + $(DESTDIR)$(BINDIR)/_tmp.ini;\ + cat ckermit.ini >> $(DESTDIR)$(BINDIR)/_tmp.ini;\ + mv $(DESTDIR)$(BINDIR)/_tmp.ini\ +@@ -1019,20 +1019,20 @@ + echo " for details.";\ + echo;\ + echo MANDIR=$(MANDIR);\ +- if test -n "$(MANDIR)"; then\ +- if test -d $(MANDIR); then\ +- echo "$(MANDIR) exists...";\ ++ if test -n "$(DESTDIR)$(MANDIR)"; then\ ++ if test -d $(DESTDIR)$(MANDIR); then\ ++ echo "$(DESTDIR)$(MANDIR) exists...";\ + else\ +- echo "Creating $(MANDIR)...";\ +- mkdir $(MANDIR) || exit 1;\ +- chmod 755 $(MANDIR) || exit 1;\ ++ echo "Creating $(DESTDIR)$(MANDIR)...";\ ++ mkdir $(DESTDIR)$(MANDIR) || exit 1;\ ++ chmod 755 $(DESTDIR)$(MANDIR) || exit 1;\ + fi;\ + echo "Installing man page...";\ +- rm -f $(MANDIR)/kermit.$(MANEXT);\ +- cp ckuker.nr $(MANDIR)/kermit.$(MANEXT) || exit 1;\ +- chmod 644 $(MANDIR)/kermit.$(MANEXT) || exit 1;\ ++ rm -f $(DESTDIR)$(MANDIR)/kermit.$(MANEXT);\ ++ cp ckuker.nr $(DESTDIR)$(MANDIR)/kermit.$(MANEXT) || exit 1;\ ++ chmod 644 $(DESTDIR)$(MANDIR)/kermit.$(MANEXT) || exit 1;\ + echo 'set flag=f\nPrC Removing man pages' >&3;\ +- echo "RmF $(MANDIR)/kermit.$(MANEXT)" >&3;\ ++ echo "RmF $(DESTDIR)$(MANDIR)/kermit.$(MANEXT)" >&3;\ + echo 'EfM' >&3;\ + echo;\ + else\ diff --git a/debian/patches/01_makefile-destdir-support b/debian/patches/01_makefile-destdir-support deleted file mode 100644 index d3d2854..0000000 --- a/debian/patches/01_makefile-destdir-support +++ /dev/null @@ -1,43 +0,0 @@ -Patch makefile to support install to a staging area with DESTDIR ---- ckermit-211.orig/makefile -+++ ckermit-211/makefile -@@ -998,7 +998,7 @@ - echo "RmF $(DESTDIR)$(BINDIR)/kermit-sshsub" >&3;\ - echo "RmF $(DESTDIR)$(BINDIR)/kermit" >&3;\ - if test -f ckermit.ini; then\ -- echo "#!$(DESTDIR)$(BINDIR)/kermit" >\ -+ echo "#!$(BINDIR)/kermit" >\ - $(DESTDIR)$(BINDIR)/_tmp.ini;\ - cat ckermit.ini >> $(DESTDIR)$(BINDIR)/_tmp.ini;\ - mv $(DESTDIR)$(BINDIR)/_tmp.ini\ -@@ -1019,20 +1019,20 @@ - echo " for details.";\ - echo;\ - echo MANDIR=$(MANDIR);\ -- if test -n "$(MANDIR)"; then\ -- if test -d $(MANDIR); then\ -- echo "$(MANDIR) exists...";\ -+ if test -n "$(DESTDIR)$(MANDIR)"; then\ -+ if test -d $(DESTDIR)$(MANDIR); then\ -+ echo "$(DESTDIR)$(MANDIR) exists...";\ - else\ -- echo "Creating $(MANDIR)...";\ -- mkdir $(MANDIR) || exit 1;\ -- chmod 755 $(MANDIR) || exit 1;\ -+ echo "Creating $(DESTDIR)$(MANDIR)...";\ -+ mkdir $(DESTDIR)$(MANDIR) || exit 1;\ -+ chmod 755 $(DESTDIR)$(MANDIR) || exit 1;\ - fi;\ - echo "Installing man page...";\ -- rm -f $(MANDIR)/kermit.$(MANEXT);\ -- cp ckuker.nr $(MANDIR)/kermit.$(MANEXT) || exit 1;\ -- chmod 644 $(MANDIR)/kermit.$(MANEXT) || exit 1;\ -+ rm -f $(DESTDIR)$(MANDIR)/kermit.$(MANEXT);\ -+ cp ckuker.nr $(DESTDIR)$(MANDIR)/kermit.$(MANEXT) || exit 1;\ -+ chmod 644 $(DESTDIR)$(MANDIR)/kermit.$(MANEXT) || exit 1;\ - echo 'set flag=f\nPrC Removing man pages' >&3;\ -- echo "RmF $(MANDIR)/kermit.$(MANEXT)" >&3;\ -+ echo "RmF $(DESTDIR)$(MANDIR)/kermit.$(MANEXT)" >&3;\ - echo 'EfM' >&3;\ - echo;\ - else\ diff --git a/debian/patches/020_man-hyphen-quoting.patch b/debian/patches/020_man-hyphen-quoting.patch new file mode 100644 index 0000000..84a7f82 --- /dev/null +++ b/debian/patches/020_man-hyphen-quoting.patch @@ -0,0 +1,1613 @@ +Correctly escape hyphens in man page +--- ckermit-211.orig/ckuker.nr ++++ ckermit-211/ckuker.nr +@@ -3,17 +3,17 @@ + .na + .SH NAME + kermit \- +-.B C-Kermit 8.0: +-transport- and platform-independent ++.B C\(hyKermit 8.0: ++transport\(hy and platform\(hyindependent + interactive and scriptable communications software. + .IP + + This document is intended to give the beginner sufficient information to make +-basic (if not advanced) use of C-Kermit 8.0. Although it might be rather long +-for a Unix manual page, it's still far shorter than the C-Kermit manual, which +-should be consulted for advanced topics such as customization, character-sets, ++basic (if not advanced) use of C\(hyKermit 8.0. Although it might be rather long ++for a Unix manual page, it's still far shorter than the C\(hyKermit manual, which ++should be consulted for advanced topics such as customization, character\(hysets, + scripting, etc. We also attempt to provide a clear structural overview of +-C-Kermit's many capabilities, functional areas, states, and modes and their ++C\(hyKermit's many capabilities, functional areas, states, and modes and their + interrelation, that should be helpful to beginners and veterans alike, as well + as to those upgrading to version 8.0 from earlier releases. + .PP +@@ -21,11 +21,11 @@ + .IP + http://www.columbia.edu/kermit/ckututor.html + .SH DESCRIPTION +-C-Kermit is an all-purpose communications software package from the Kermit ++C\(hyKermit is an all\(hypurpose communications software package from the Kermit + Project at Columbia University that: + .PP + .nf +-\(bu Is portable to many platforms, Unix and non-Unix alike. ++\(bu Is portable to many platforms, Unix and non\(hyUnix alike. + .br + \(bu Can make both serial and network connections. + .br +@@ -35,39 +35,39 @@ + .br + \(bu Can convert character sets in the terminal session. + .br +-\(bu Can convert character sets during text-file file transfer. ++\(bu Can convert character sets during text\(hyfile file transfer. + .br + \(bu Is customizable in every aspect of its operation. + .fi + .PP +-C-Kermit is a modem program, a Telnet client, an Rlogin client, an FTP ++C\(hyKermit is a modem program, a Telnet client, an Rlogin client, an FTP + client, an HTTP client, and on selected platforms, also an X.25 client. It +-can make its own secure Internet connections using IETF-approved security ++can make its own secure Internet connections using IETF\(hyapproved security + methods including Kerberos IV, Kerberos V, SSL/TLS, and SRP and it can also + make SSH connections through your external SSH client application. It can +-be the far-end file-transfer or client/server partner of your desktop ++be the far\(hyend file\(hytransfer or client/server partner of your desktop + Kermit client. It can also accept incoming dialed and network connections. + It can even be installed as an Internet service on its own standard TCP + socket, 1649 [RFC2839, RFC2840]. + .PP + And perhaps most important, everything you can do "by hand" (interactively) +-with C-Kermit, can be "scripted" (automated) using its built-in +-cross-platform transport-independent script programming language, which ++with C\(hyKermit, can be "scripted" (automated) using its built\(hyin ++cross\(hyplatform transport\(hyindependent script programming language, which + happens to be identical to its interactive command language. + .PP +-This manual page offers an overview of C-Kermit 8.0 for Unix ("Unix" is an +-operating system family that includes AIX, DG/UX, FreeBSD, HP-UX, IRIX, ++This manual page offers an overview of C\(hyKermit 8.0 for Unix ("Unix" is an ++operating system family that includes AIX, DG/UX, FreeBSD, HP\(hyUX, IRIX, + Linux, Mac OS X, NetBSD, OpenBSD, Open Server, Open Unix, QNX, Solaris, + SunOS, System V R3, System V R4, Tru64 Unix, Unixware, Xenix, and many +-others). For thorough coverage, please consult the published C-Kermit ++others). For thorough coverage, please consult the published C\(hyKermit + manual and supplements (see DOCUMENTATION below). For further information +-about C-Kermit, Kermit software for other platforms, and Kermit manuals, ++about C\(hyKermit, Kermit software for other platforms, and Kermit manuals, + visit the Kermit Project website: + .PP + http://www.columbia.edu/kermit/ + .PP +-This is a longer-than-average manual page, and yet it barely scratches the +-surface. Don't be daunted. C-Kermit is a large and complex package, ++This is a longer\(hythan\(hyaverage manual page, and yet it barely scratches the ++surface. Don't be daunted. C\(hyKermit is a large and complex package, + evolving over decades of practice and experience, but that doesn't mean + it's hard to learn or use. Its most commonly used functions are explained + here with pointers to additional information elsewhere. +@@ -76,7 +76,7 @@ + .I filename + .B ] [ + .I options +-.B ] [ {=,--,+} ++.B ] [ {=,\-\-,+} + .I text + .B ] ] + .PP +@@ -85,12 +85,12 @@ + .B kermit + .I URL + .PP +-If the first command-line argument is the name of a file, interactive-mode +-commands are executed from the file. The '=' (or "--") argument tells ++If the first command\(hyline argument is the name of a file, interactive\(hymode ++commands are executed from the file. The '=' (or "\-\-") argument tells + Kermit not to parse the remainder of the command line, but to make the + words following '=' available as \e%1, \e%2, ... \e%9. The "+" argument is + like "=" but for use in "kerbang scripts" (explained below). A second +-command-line format allows the one and only argument to be a Telnet, FTP, ++command\(hyline format allows the one and only argument to be a Telnet, FTP, + HTTP, or IKSD URL. + .PP + Order of execution: +@@ -100,338 +100,338 @@ + .TP + .nf + 2. +-The initialization file, if any, unless suppressed with -Y. ++The initialization file, if any, unless suppressed with \-Y. + .fi + .TP + 3. + The customization file (if it is executed by the initialization file). + .TP + 4. +-The command-line URL (if any, and if so, execution stops here). ++The command\(hyline URL (if any, and if so, execution stops here). + .TP + 5. +-Command-line options (if any). ++Command\(hyline options (if any). + .TP + 6. + Interactive commands. + .PP +-Some command-line options can cause actions (such as -s to send a file); ++Some command\(hyline options can cause actions (such as \-s to send a file); + others just set parameters. If any action options are included on the +-command line, Kermit exits when finished unless also given the -S ("stay") ++command line, Kermit exits when finished unless also given the \-S ("stay") + option. If no action options are given, no initialization or command files + contained an EXIT or QUIT command, and no fatal errors occurred, Kermit + issues its prompt and waits for you to type commands. + .IP +-Bear in mind that C-Kermit can be built with selected features ++Bear in mind that C\(hyKermit can be built with selected features + disabled, and also that certain features are not available on all +-platforms. For example, C-Kermit can't be built with TCP/IP ++platforms. For example, C\(hyKermit can't be built with TCP/IP + support on a platform that does not have TCP/IP header files and + libraries (and even if Kermit does include TCP/IP support, it + can't be used to make TCP/IP connections on a computer that does + not have a TCP/IP stack installed). If your version of lacks +-C-Kermit a feature mentioned here, use its SHOW FEATURES command to ++C\(hyKermit a feature mentioned here, use its SHOW FEATURES command to + see what might have been excluded. + .PP +-C-Kermit has three kinds of commands: regular single-letter command-line +-options, extended-format command-line options, and interactive commands. ++C\(hyKermit has three kinds of commands: regular single\(hyletter command\(hyline ++options, extended\(hyformat command\(hyline options, and interactive commands. + .PP +-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 commands +-composed of words, which are more intuitive than cryptic command-line ++Like most Unix commands, C\(hyKermit can be be given options on the command ++line. But C\(hyKermit also can be used interactively by giving it commands ++composed of words, which are more intuitive than cryptic command\(hyline + 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 -- ++C\(hyKermit's command\(hyline options, but they are available if you want to. (By ++the same token, you don't have to use its interactive commands either \(hy\(hy + you can use either or both in any combination.) + .PP +-C-Kermit is generally installed in the PATH as "kermit", and therefore is ++C\(hyKermit 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 ++then pressing the Return or Enter key. If you wish to include command\(hyline + options, put them after the word "kermit" but before pressing Return or + Enter, separated by spaces, for example: + .PP +- $ kermit -s ckermit.tar.gz ++ $ kermit \-s ckermit.tar.gz + .PP +-('$' is the shell prompt; "kermit -s ckermit.tar.gz" is what you type, ++('$' is the shell prompt; "kermit \-s ckermit.tar.gz" is what you type, + followed by Return or Enter.) + .SH OPTIONS +-Here is a list of C-Kermit's single-letter command-line options, which +-start with a single dash (-), in ASCII ("alphabetical") order. Alphabetic +-case is significant (-A is not the same as -a). Action options are ++Here is a list of C\(hyKermit's single\(hyletter command\(hyline options, which ++start with a single dash (\-), in ASCII ("alphabetical") order. Alphabetic ++case is significant (\-A is not the same as \-a). Action options are + tagged "ACTION". + .TP +--0 ++\-0 + (digit zero) 100% transparent Connect state for +-"in-the-middle" operation: 8 bits, no parity, no ++"in\(hythe\(hymiddle" operation: 8 bits, no parity, no + escape character, everything passes through. + .TP +--8 +-(digit eight) Connection is 8-bit clean (this is the +-default in C-Kermit 8.0). Equivalent to the EIGHTBIT ++\-8 ++(digit eight) Connection is 8\(hybit clean (this is the ++default in C\(hyKermit 8.0). Equivalent to the EIGHTBIT + command, which in turn is a shortcut for SET TERMINAL + BYTESIZE 8, SET COMMAND BYTESIZE 8, SET PARITY NONE. + .TP +--9 arg ++\-9 arg + (digit nine) Make a connection to an FTP server. + Equivalent to the FTP OPEN command. +-Argument: IP-address-or-hostname[:optional-TCP-port]. +-NOTE: C-Kermit also has a separate FTP command-line +-personality, with regular FTP-like command-line ++Argument: IP\(hyaddress\(hyor\(hyhostname[:optional\(hyTCP\(hyport]. ++NOTE: C\(hyKermit also has a separate FTP command\(hyline ++personality, with regular FTP\(hylike command\(hyline + syntax. More about this below. + .TP +--A ++\-A + Kermit is to be started as an Internet service (IKSD) + (only from inetd.conf). + .TP +--B ++\-B + Kermit is running in Batch or Background (no + controlling terminal). To be used in case Kermit + doesn't automatically sense its background status. + Equivalent to the SET BACKGROUND ON command. + .TP +--C arg +-Interactive-mode Commands to be executed. ++\-C arg ++Interactive\(hymode Commands to be executed. + Argument: Commands separated by commas, list in + doublequotes. + .TP +--D arg ++\-D arg + Delay before starting to send in Remote mode. + Equivalent to the SET DELAY command. + Argument: Number of seconds. + .TP +--E ++\-E + Exit automatically when connection closes. Equivalent +-to SET EXIT ON-DISCONNECT ON. ++to SET EXIT ON\-DISCONNECT ON. + .TP +--F arg ++\-F arg + Use an open TCP connection. + Argument: Numeric file descriptor of open TCP + connection. +-Also see: -j, -J. ++Also see: \-j, \-J. + .TP +--G arg ++\-G arg + (ACTION) Get file(s) from server, send contents to standard + output, which normally would be piped to another + process. + Argument: Remote file specification, in quotes if it + contains metacharacters. +-Also see: -g, -k. ++Also see: \-g, \-k. + .TP +--H ++\-H + Suppress program startup Herald and greeting. + .TP +--I ++\-I + Tell Kermit it has a reliable connection, to force streaming to be used where + it normally would not be. Equivalent to the SET RELIABLE ON command. + .TP +--J arg +-(ACTION) "Be like Telnet." Like -j but implies -E. Argument: IP +-hostname/address optionally followed by service. NOTE: C-Kermit also has a +-separate Telnet command-line personality, with regular Telnet-like +-command-line syntax. More about this below. ++\-J arg ++(ACTION) "Be like Telnet." Like \-j but implies \-E. Argument: IP ++hostname/address optionally followed by service. NOTE: C\(hyKermit also has a ++separate Telnet command\(hyline personality, with regular Telnet\(hylike ++command\(hyline syntax. More about this below. + .TP +--L +-Recursive directory descent for files in -s option. ++\-L ++Recursive directory descent for files in \-s option. + .TP +--M arg ++\-M arg + My user name (for use with Telnet, Rlogin, FTP, etc). + Equivalent to the SET LOGIN USER command. + Argument: Username string. + .TP +--O ++\-O + (ACTION) (Uppercase letter O) Be a server for One command only. +-Also see: -x. ++Also see: \-x. + .TP +--P ++\-P + Don't convert file (Path) names of transferred files. + Equivalent to SET FILE NAMES LITERAL. + .TP +--Q ++\-Q + Quick Kermit protocol settings. Equivalent to the FAST +-command. This is the default in C-Kermit 7.0 and later. ++command. This is the default in C\(hyKermit 7.0 and later. + .TP +--R +-Remote-only (this just makes IF REMOTE true). ++\-R ++Remote\(hyonly (this just makes IF REMOTE true). + .TP +--S ++\-S + Stay (enter command parser after action options). + .TP +--T +-Force Text mode for file transfer; implies -V. ++\-T ++Force Text mode for file transfer; implies \-V. + Equivalent to SET TRANSFER MODE MANUAL, SET FILE TYPE TEXT. + .TP +--V +-Disable automatic per-file text/binary switching. ++\-V ++Disable automatic per\(hyfile text/binary switching. + Equivalent to SET TRANSFER MODE MANUAL. + .TP +--Y ++\-Y + Skip (don't execute) the initialization file. + .TP +--a arg +-As-name for file(s) in -s, -r, or -g. +-Argument: As-name string (alternative filename). When ++\-a arg ++As\(hyname for file(s) in \-s, \-r, or \-g. ++Argument: As\(hyname string (alternative filename). When + receiving files, this can be a directory name. + .TP +--b arg ++\-b arg + Speed for serial device. Equivalent to SET SPEED. + Argument: Numeric Bits per second for serial + connections. + .TP +--c ++\-c + (ACTION) Enter Connect state before transferring files. + .TP +--d ++\-d + Create a debug.log file with detailed debugging +-information (a second -d adds timestamps). Equivalent ++information (a second \-d adds timestamps). Equivalent + to LOG DEBUG but takes effect sooner. + .TP +--e arg +-Maximum length for incoming Kermit file-transfer +-packets. Equivalent to SET RECEIVE PACKET-LENGTH. ++\-e arg ++Maximum length for incoming Kermit file\(hytransfer ++packets. Equivalent to SET RECEIVE PACKET\-LENGTH. + Argument: Length in bytes. + .TP +--f ++\-f + (ACTION) Send a FINISH command to a Kermit server. + .TP +--g arg ++\-g arg + Get file(s) from a Kermit server. + Argument: File specification on other computer, in + quotes if it contains metacharacters. Equivalent to +-GET. Also see: -a, -G, -r. ++GET. Also see: \-a, \-G, \-r. + .TP +--h +-(ACTION) Print Help text for single-letter command-line options ++\-h ++(ACTION) Print Help text for single\(hyletter command\(hyline options + (pipe thru 'more' to prevent scrolling). + .TP +--i ++\-i + Force binary (Image) mode for file transfer; implies +--V. Equivalent to SET TRANSFER MODE MANUAL, SET FILE ++\-V. Equivalent to SET TRANSFER MODE MANUAL, SET FILE + TYPE BINARY. + .TP +--j arg ++\-j arg + Make a TCP/IP connection. + Argument: IP host name/address and optional service + name or number. Equivalent to the TELNET command. +-Also see: -J, -F. ++Also see: \-J, \-F. + .TP +--k ++\-k + (ACTION) Receive file(s) to standard output, which normally + would be piped to another process. +-Also see: -r, -G. ++Also see: \-r, \-G. + .TP +--l arg ++\-l arg + (Lowercase letter L) Make a connection on the given + serial communications device. Equivalent to the SET + LINE (SET PORT) command. + Argument: Serial device name, e.g. /dev/ttyS0. + .TP +--m arg +-Modem type for use with the -l device. Equivalent to ++\-m arg ++Modem type for use with the \-l device. Equivalent to + the SET MODEM TYPE command. + Argument: Modem name as in SET MODEM TYPE command, + e.g. "usrobotics". + .TP +--n ++\-n + (ACTION) Enter Connect state after transferring files (historical). + .TP +--p arg ++\-p arg + Parity. Equivalent to the SET PARITY command. + Argument: One of the following: e(ven), o(dd), m(ark), + n(one), s(pace). + .TP +--q ++\-q + Quiet (suppress most messages). Equivalent to SET QUIET ON. + .TP +--r ++\-r + (ACTION) Receive file(s). Equivalent to the RECEIVE command. +-Argument: (none, but see -a) ++Argument: (none, but see \-a) + .TP +--s arg ++\-s arg + Send file(s). + Argument: One or more local file specifications. + Equivalent to the SEND command. +-Also see: -a. ++Also see: \-a. + .TP +--t +-(Historical) Xon (Ctrl-Q) Turnaround character for +-half-duplex connections (used on serial linemode ++\-t ++(Historical) Xon (Ctrl\-Q) Turnaround character for ++half\(hyduplex connections (used on serial linemode + connections to old mainframes). Equivalent to SET + DUPLEX HALF, SET HANDSHAKE XON. + .TP +--v arg ++\-v arg + Window size for Kermit protocol (ignored when +-streaming). Equivalanet to SET WINDOW-SIZE. ++streaming). Equivalanet to SET WINDOW\-SIZE. + Argument: Number, 1 to 32. + .TP +--w ++\-w + Incoming files Write over existing files. Equivalent + to SET FILE COLLISION OVERWRITE. + .TP +--x ++\-x + (ACTION) Enter server mode. Equivalent to the SERVER command. +-Also see: -O. ++Also see: \-O. + .TP +--y arg ++\-y arg + Alternative initialization file. + Argument: Filename. + .TP +--z ++\-z + Force foreground behavior. To be used in case Kermit + doesn't automatically sense its foreground status. + Equivalent to the SET BACKGROUND OFF command. + .PP +-Extended command-line options (necessary because single-letter ones are +-about used up) start with two dashes (--), with words rather than single ++Extended command\(hyline options (necessary because single\(hyletter ones are ++about used up) start with two dashes (\-\-), with words rather than single + letters as option names. If an extended option takes an argument, it is + separated from the option word by a colon (:). Extended options include: + + .TP +- --bannerfile:filename ++ \-\-bannerfile:filename + File to display upon startup or IKSD login. + .TP +- --cdfile:filename ++ \-\-cdfile:filename + File to be sent for display to the client when + server changes directory (filename is relative to +-the changed-to directory). ++the changed\(hyto directory). + .TP +- --cdmessage:{on,off} ++ \-\-cdmessage:{on,off} + Enable/disable the server CD message feature. + .TP +- --help ++ \-\-help + Prints usage message for extended options. + .TP +- --helpfile:filename ++ \-\-helpfile:filename + Designates a file containing custom text to +-replace the top-level HELP command. ++replace the top\(hylevel HELP command. + .TP +- --nointerrupts ++ \-\-nointerrupts + Disables keyboard interrupts. + .TP +- --noperms ++ \-\-noperms + Disables the Kermit protocol file Permissions + attribute, to prevent transmission of file + permissions (protection) from sender to receiver. + .TP +- --version +-(ACTION) C-Kermit prints its version number. ++ \-\-version ++(ACTION) C\(hyKermit prints its version number. + .PP +-Plus several other IKSD-Only options described at: ++Plus several other IKSD\(hyOnly options described at: + .PP + http://www.columbia.edu/kermit/iksd.html + .PP +-See the file-transfer section for examples of command-line invocation. ++See the file\(hytransfer section for examples of command\(hyline invocation. + .SH COMMAND LANGUAGE +-C-Kermit's interactive command language is the subject of a 622-page book ++C\(hyKermit's interactive command language is the subject of a 622\(hypage book + and another several hundred pages of updates, far too much for a manual + page. But it's not hard to get started. At the shell prompt, just type +-"kermit" to get C-Kermit's interactive command prompt: ++"kermit" to get C\(hyKermit's interactive command prompt: + .PP + .nf + $ kermit +- (/current/directory) C-Kermit> ++ (/current/directory) C\-Kermit> + .fi + .PP + Begin by typing "help" (and then press the Return or Enter key) for a +-top-level overview, read it, and go from there. Your second command should ++top\(hylevel overview, read it, and go from there. Your second command should + probably be "intro" (introduction). Note the prompt shows your current + directory (unless you tell Kermit to prompt you with something else). + .PP +@@ -448,11 +448,11 @@ + .PP + While typing commands, you can abbreviate, ask for help (by pressing the + "?" key anywhere in a command), complete keywords or filenames (with the +-Tab or Esc key), and edit your typing with Backspace or Delete, Ctrl-W, +-Ctrl-U, etc. You can also recall previous commands, save your command ++Tab or Esc key), and edit your typing with Backspace or Delete, Ctrl\-W, ++Ctrl\-U, etc. You can also recall previous commands, save your command + history, and who knows what else. Give the INTRO command for details. + .PP +-C-Kermit has hundreds of commands, and they can be issued in infinite ++C\(hyKermit has hundreds of commands, and they can be issued in infinite + variety and combinations, including commands for: + .nf + .PP +@@ -485,15 +485,15 @@ + .fi + And of course QUIT or EXIT to get out and HELP to get help, and for + programmers: loops, decision making, variables, arrays, associative arrays, +-integer and floating point arithmetic, macros, built-in and user-defined ++integer and floating point arithmetic, macros, built\(hyin and user\(hydefined + functions, string manipulation, pattern matching, block structure, scoping, +-recursion, and all the rest. To get a list of all C-Kermit's commands, type ++recursion, and all the rest. To get a list of all C\(hyKermit's commands, type + a question mark (?) at the prompt. To get a description of any command, + type HELP followed by the name of the command, for example: + .PP + help send + .PP +-The command interruption character is Ctrl-C (hold down the Ctrl key and ++The command interruption character is Ctrl\-C (hold down the Ctrl key and + press the C key). + .PP + The command language "escape character", used to introduce variable names, +@@ -505,7 +505,7 @@ + A file containing Kermit commands is called a Kermit command file or Kermit + script. It can be executed with Kermit's TAKE command: + .PP +- (/current/dir) C-Kermit> take commandfile ++ (/current/dir) C\-Kermit> take commandfile + .PP + (where "commandfile" is the name of the command file). Please don't pipe a + command file into Kermit's standard input (which might or might not work); +@@ -599,16 +599,16 @@ + .PP + take \ev(home).kermrc + .PP +-at the desired spot in the script. By the way, \ev(xxx) is a built-in ++at the desired spot in the script. By the way, \ev(xxx) is a built\(hyin + variable (xxx is the variable name, "home" in this case). To see what +-built-in variables are available, type "show variables" at the C-Kermit ++built\(hyin variables are available, type "show variables" at the C\(hyKermit + prompt. To see what else you can show, type "show ?". \em(xxx) is a user + defined variable (strictly speaking, it is a macro used as a variable). + .SS Command List +-C-Kermit has more than 200 top-level commands, and some of these, such as ++C\(hyKermit has more than 200 top\(hylevel commands, and some of these, such as + SET, branch off into hundreds of subcommands of their own, so it's not + practical to describe them all here. Instead, here's a concise list of the +-most commonly used top-level commands, grouped by category. To learn about ++most commonly used top\(hylevel commands, grouped by category. To learn about + each command, type "help" followed by the command name, e.g. "help set". + Terms such as Command state and Connect state are explained in subsequent + sections. +@@ -620,7 +620,7 @@ + HELP text for each command. Example: + .PP + .nf +- send /recursive /larger:10000 /after:-1week /except:*.txt * ++ send /recursive /larger:10000 /after:\-1week /except:*.txt * + .fi + .PP + which can be read as "send all the files in this directory and all the ones +@@ -631,19 +631,19 @@ + .RS + .TP + HELP +-Requests top-level help. ++Requests top\(hylevel help. + .TP + HELP command + Requests help about the given command. + .TP + INTRODUCTION +-Requests a brief introduction to C-Kermit. ++Requests a brief introduction to C\(hyKermit. + .TP + LICENSE +-Displays the C-Kermit software copyright and license. ++Displays the C\(hyKermit software copyright and license. + .TP + VERSION +-Displays C-Kermit's version number. ++Displays C\(hyKermit's version number. + .TP + EXIT [ number ] + Exits from Kermit with the given +@@ -667,13 +667,13 @@ + STATUS + Tells whether previous command succeeded or failed. + .TP +-DATE [ date-and/or-time ] +-Shows current date-time or interprets given date-time. ++DATE [ date\(hyand/or\(hytime ] ++Shows current date\(hytime or interprets given date\(hytime. + .TP +-RUN [ extern-command [ parameters... ] ++RUN [ extern\(hycommand [ parameters... ] + Runs the given external command. Synonym: !. + .TP +-EXEC [ extern-command [ params... ] ++EXEC [ extern\(hycommand [ params... ] + Kermit overlays itself with the given command. + .TP + SUSPEND +@@ -703,7 +703,7 @@ + the pattern. Synonym: FIND. + .TP + DIRECTORY [ options ] [filespec ] +-Lists files (built-in, many options). ++Lists files (built\(hyin, many options). + .TP + LS [ options ] [ filespec ] + Lists files (runs external "ls" command). +@@ -799,10 +799,10 @@ + HTTP [ options ] OPEN host + Opens an HTTP connection to the host. + .TP +-PTY external-command ++PTY external\(hycommand + Runs the command on a pseudoterminal as if it were a connection. + .TP +-PIPE external-command ++PIPE external\(hycommand + Runs the command through a pipe as if it were a connection. + .RE + .SS +@@ -818,24 +818,24 @@ + TELOPT command + Sends a Telnet protocol command (Telnet connections only). + .TP +-Ctrl-\eC ++Ctrl\-\eC + "Escapes back" from Connect state to Command state. + .TP +-Ctrl-\eB ++Ctrl\-\eB + (In Connect state) Sends a BREAK signal (serial or Telnet). + .TP +-Ctrl-\e! ++Ctrl\-\e! + (In Connect state) Enters inferior shell; "exit" to return. + .TP +-Ctrl-\e? +-(In Connect state) Shows a menu of other escape-level options. ++Ctrl\-\e? ++(In Connect state) Shows a menu of other escape\(hylevel options. + .TP +-Ctrl-\eCtrl-\e ++Ctrl\-\eCtrl\-\e + (In Connect state) Type two +-Ctrl-Backslashes to send one of them. ++Ctrl\-Backslashes to send one of them. + .TP + SET ESCAPE [ character ] +-Changes Kermit's Connect-state escape character. ++Changes Kermit's Connect\(hystate escape character. + .RE + .SS + Closing Connections +@@ -843,18 +843,18 @@ + .TP + HANGUP + Hangs up the currently open +-serial-port or network connection. ++serial\(hyport or network connection. + .TP + CLOSE + Closes the currently open +-serial-port or network connection. ++serial\(hyport or network connection. + .TP + SET LINE (with no devicename) + Closes the currently open +-serial-port or network connection. ++serial\(hyport or network connection. + .TP + SET HOST (with no hostname) +-Closes the currently open serial-port or network connection. ++Closes the currently open serial\(hyport or network connection. + .TP + FTP CLOSE + Closes the currently open FTP connection. +@@ -872,7 +872,7 @@ + File Transfer + .RS + .TP +-SEND [ options ] filename [ as-name ] ++SEND [ options ] filename [ as\(hyname ] + Sends the given file. Synonym: S. + .TP + SEND [ options ] filespec +@@ -881,20 +881,20 @@ + RESEND [ options ] filespec + Resumes an interupted SEND from the point of failure. + .TP +-RECEIVE [ options ] [ as-name ] ++RECEIVE [ options ] [ as\(hyname ] + Waits passively for files to arrive. Synonym: R. + .TP + LOG TRANSACTIONS [ filename ] + Keeps a record of file transfers. + .TP + FAST +-Use fast file-transfer settings (default). ++Use fast file\(hytransfer settings (default). + .TP + CAUTIOUS +-Use cautious and less fast file-transfer settings. ++Use cautious and less fast file\(hytransfer settings. + .TP + ROBUST +-Use ultra-conservative and slow file-transfer settings. ++Use ultra\(hyconservative and slow file\(hytransfer settings. + .TP + STATISTICS [ options ] + Gives statistics about the most recent file transfer. +@@ -909,7 +909,7 @@ + Captures remote text or files without protocol. + .TP + SET PROTOCOL [ name... ] +-Tells Kermit to use an external file-transfer protocol. ++Tells Kermit to use an external file\(hytransfer protocol. + .TP + FTP { PUT, MPUT, GET, MGET, ... } + FTP client commands. +@@ -940,7 +940,7 @@ + [ REMOTE ] LOGOUT + Logs out from a Kermit server or IKSD. + .TP +-SEND [ options ] filename [ as-name ] ++SEND [ options ] filename [ as\(hyname ] + Sends the given file to the server. Synonyms: S, PUT. + .TP + SEND [ options ] filespec +@@ -949,10 +949,10 @@ + RESEND [ options ] filespec + Resumes an interupted SEND from the point of failure. + .TP +-GET [ options ] remote-filespec ++GET [ options ] remote\(hyfilespec + Asks the server to send the given files. Synonym: G. + .TP +-REGET [ options ] remote-filespec ++REGET [ options ] remote\(hyfilespec + Resumes an interrupted GET from the point of failure. + .TP + REMOTE CD [ directory ] +@@ -972,7 +972,7 @@ + (Many other commands: "remote ?" for a list). + .TP + MAIL [ options ] filespec +-Sends file(s) to be delivered as e-mail (Kermit only). ++Sends file(s) to be delivered as e\(hymail (Kermit only). + .TP + FINISH + Asks the server to exit server state (Kermit only). +@@ -1005,21 +1005,21 @@ + this example: + .PP + .nf +- C-Kermit> remote ? One of the following: ++ C\-Kermit> remote ? One of the following: + assign directory kermit print rmdir + cd exit login pwd set + copy help logout query space + delete host mkdir rename type +- C-Kermit> remote set ? One of the following: ++ C\-Kermit> remote set ? One of the following: + attributes file retry transfer +- block-check receive server window +- C-Kermit> remote set file ? One of the following: +- character-set incomplete record-length ++ block\-check receive server window ++ C\-Kermit> remote set file ? One of the following: ++ character\-set incomplete record\-length + collision names type +- C-Kermit> remote set file names ? One of the following: ++ C\-Kermit> remote set file names ? One of the following: + converted literal +- C-Kermit> remote set file names literal +- C-Kermit> ++ C\-Kermit> remote set file names literal ++ C\-Kermit> + .PP + .fi + This is called menu on demand: you get a menu when you want one, but menus +@@ -1030,25 +1030,25 @@ + example, "send x?" lists all the files in the current directory whose names + start with 'x'. + .SH INITIALIZATION FILE +-In its default configuration, C-Kermit executes commands from a file ++In its default configuration, C\(hyKermit 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 ++\-Y or \-y command\(hyline option. Custom configurations might substitute a shared ++system\(hywide 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. + .PP + 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 ++makes C\(hyKermit 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 ++configuration is well attuned to modern computing and networking \(hy\(hy 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 ++definitions, and/or scripted actions they contain, and invoke C\(hyKermit + directly when you don't. + .PP + To put it another way... We still distribute the standard initialization +@@ -1068,7 +1068,7 @@ + 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 ++the file\(hytransfer partner to the local Kermit and communicates only through + its standard input and output. + .PP + At any moment, a Kermit program can be in any of the following states. It's +@@ -1091,7 +1091,7 @@ + and execute commands from a file. The (perhaps implied) DO command + tells Kermit to read and execute commands from a macro definition. + While in Command state, you can interrupt any command, macro, or +-command file by typing Ctrl-C (hold down the Ctrl key and press the C ++command file by typing Ctrl\-C (hold down the Ctrl key and press the C + key); this normally brings you back to the prompt. + .TP + Shell state +@@ -1111,24 +1111,24 @@ + return to command state by logging out of the remote computer, or by + typing: + .sp +- Ctrl-\ec ++ Ctrl\-\ec + .sp + That is: Hold down the Ctrl key and press the backslash key, then let + go of the Ctrl key and press the C key. This is called escaping back. +-Certain other escape-level commands are also provided; type Ctrl-\e? ++Certain other escape\(hylevel commands are also provided; type Ctrl\-\e? + for a list. For example, you can enter Shell state with: + .sp +- Ctrl-\e! ++ Ctrl\-\e! + .sp +-To send a Ctrl-\e to the host while in Connect state, type two of them ++To send a Ctrl\-\e to the host while in Connect state, type two of them + in a row. See HELP CONNECT and HELP SET ESCAPE for more info. + .TP +-Local file-transfer state ++Local file\(hytransfer 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 its progress ++file\(hyrelated task. And at the same time, it is displaying its progress + on your screen and watching your keyboard for interruptions. In this +-state, the following single-keystroke commands are accepted: ++state, the following single\(hykeystroke commands are accepted: + .sp + .RS + .TP +@@ -1141,61 +1141,61 @@ + E + Like Z but uses a "stronger" protocol (use if X or Z don't work). + .TP +-Ctrl-C +-Interrupt file-transfer mode (use if Z or E don't work). ++Ctrl\-C ++Interrupt file\(hytransfer mode (use if Z or E don't work). + .sp + .RE + Kermit returns to its previous state (Command or Connect) when the + transfer is complete or when interrupted successfully by X, Z, E, or +-Ctrl-C (hold down the Ctrl key and press the C key). ++Ctrl\-C (hold down the Ctrl key and press the C key). + .TP +-Remote file-transfer state +-In this state, Kermit is exchanging file-transfer packets with its ++Remote file\(hytransfer state ++In this state, Kermit is exchanging file\(hytransfer packets with its + local partner over its standard i/o. It leaves this state + automatically when the transfer is complete. In case you find your +-local Kermit in Connect state and the remote one in File-transfer ++local Kermit in Connect state and the remote one in File\(hytransfer + state (in which it seems to ignore your keystrokes), you can usually +-return it to command state by typing three Ctrl-C's in a row. If that +-doesn't work, return your local Kermit to Command state (Ctrl-\e C) and +-type "e-packet" and then press the Return or Enter key; this forces a ++return it to command state by typing three Ctrl\-C's in a row. If that ++doesn't work, return your local Kermit to Command state (Ctrl\-\e C) and ++type "e\(hypacket" and then press the Return or Enter key; this forces a + fatal Kermit protocol error. + .TP + Remote Server state +-This is like Remote File-transfer state, except it never returns ++This is like Remote File\(hytransfer state, except it never returns + automatically to Command state. Rather, it awaits further instructions + from the client program; that is, from your Local Kermit program. You + can return the Remote Server to its previous state by issuing a + "finish" command to the client, or if you are in Connect state, by +-typing three Ctrl-C's in a row. You can tell the server job to log out ++typing three Ctrl\-C's in a row. You can tell the server job to log out + and break the connection by issuing a "bye" command to the client. + .TP + 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 ++Like Remote\(hyServer state, but in local mode, and therefore with its ++file\(hytransfer display showing, and listening for single\(hykey commands, ++as in Local File\(hytransfer state. Usually this state is entered + automatically when a remote Kermit program gives a GET command. + .sp +-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 ++C\(hyKermit, Kermit 95, and MS\(hyDOS Kermit all can switch automatically from ++Connect state to Local File\(hytransfer 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. + .sp +-Note that C-Kermit is not a terminal emulator. It is a communications ++Note that C\(hyKermit 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? CLICK HERE to read about it. ++provided by the terminal window in which you are running C\(hyKermit. Kermit ++95 and MS\(hyDOS Kermit, on the other hand, are true terminal emulators. Why ++is C\(hyKermit not a terminal emulator? CLICK HERE to read about it. + .SH MAKING CONNECTIONS + Here is how to make different kinds of connections using interactive Kermit +-commands (as noted above, you can also make connections with command-line ++commands (as noted above, you can also make connections with command\(hyline + 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. + .TP + Making a Telnet Connection +-At the C-Kermit command prompt, simply type: ++At the C\(hyKermit command prompt, simply type: + .sp + .nf + telnet foo.bar.com +@@ -1224,10 +1224,10 @@ + More info: HELP RLOGIN. + .TP + Making an SSH Connection +-Unlike Telnet and Rlogin, SSH connections are not built-in, but ++Unlike Telnet and Rlogin, SSH connections are not built\(hyin, but + handled by running your external SSH client through a pseudoterminal. +-Using C-Kermit to control the SSH client gives you all of Kermit's +-features (file transfer, character-set conversion, scripting, etc) ++Using C\(hyKermit to control the SSH client gives you all of Kermit's ++features (file transfer, character\(hyset conversion, scripting, etc) + over SSH. + .sp + ssh foo.bar.com +@@ -1236,7 +1236,7 @@ + .TP + 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) modem ++serial port on your computer with a regular (straight\(hythrough) modem + cable, and to the telephone jack with a telephone cable, and that it's + turned on. Then use these commands: + .sp +@@ -1251,7 +1251,7 @@ + .sp + Type "set modem type ?" for a list of supported modem types. If you + omit the SET MODEM TYPE command, the default type is +-"generic-high-speed", which should work for most modern AT-command-set ++"generic\(hyhigh\(hyspeed", which should work for most modern AT\(hycommand\(hyset + modems. If the line is busy, Kermit redials automatically. If the call + does not succeed, use "set dial display on" and try it again to watch + what happens. If the call succeeds, Kermit enters Connect state +@@ -1262,34 +1262,34 @@ + reverse terminal server. In this case the command sequence is: + .sp + .nf +- set host ts.xxx.com 2000 ; Terminal-server and port ++ set host ts.xxx.com 2000 ; Terminal\(hyserver and port + set modem type usrobotics ; Or other supported type + set dial method tone ; (or pulse) + dial 7654321 ; Dial the desired number + .fi + .sp + If the terminal server supports the Telnet Com Port Option, RFC 2217, +-you can also give serial-port related commands such as SET SPEED, SET ++you can also give serial\(hyport related commands such as SET SPEED, SET + PARITY, and so on, and Kermit relays them to the terminal server using + the protocol specified in the RFC. + .sp + More info: HELP SET MODEM, HELP SET LINE, HELP SET SPEED, HELP SET + FLOW, HELP DIAL, HELP SET DIAL, HELP SET MODEM, HELP SET +-CARRIER-WATCH, SHOW COMMUNICATIONS, SHOW MODEM, SHOW DIAL. ++CARRIER\-WATCH, SHOW COMMUNICATIONS, SHOW MODEM, SHOW DIAL. + .TP + Direct Serial Port + Connect the two computers, A and B, with a null modem cable (or two +-modem cables interconnected with a null-modem adapter or modem ++modem cables interconnected with a null\(hymodem adapter or modem + eliminator). From Computer A: + .sp + .nf + set modem type none ; There is no modem + set line /dev/ttyS0 ; Specify device name +- set carrier-watch off ; If DTR CD are not cross-connected ++ set carrier\-watch off ; If DTR CD are not cross\(hyconnected + set speed 57600 ; Or other desired speed +- set flow rts/cts ; If RTS and CTS are cross-connected ++ set flow rts/cts ; If RTS and CTS are cross\(hyconnected + set parity even ; (or "mark" or "space", if necessary) +- set stop-bits 2 ; (rarely necessary) ++ set stop\-bits 2 ; (rarely necessary) + set flow xon/xoff ; If you can't use RTS/CTS + connect ; Enter Connect (terminal) state + .fi +@@ -1299,25 +1299,25 @@ + same directions. More info: As above plus HELP CONNECT. + .PP + 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. ++parity even" (or "mark" or "space") if it's a 7\(hybit connection. + .PP + 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 FTP or HTTP + session. Each connection type can be customized to any desired degree, + scripted, logged, you name it. See the manual. + .PP +-NOTE: On selected platforms, C-Kermit also can make X.25 connections. See ++NOTE: On selected platforms, C\(hyKermit also can make X.25 connections. See + the manual for details. + .SH TRANSFERRING FILES WITH KERMIT + There is a 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 C-Kermit (7.0 or later) and Kermit 95. +-These combinations work well and they work fast by default. MS-DOS Kermit ++overloaded the connection. Some extra commands (or command\(hyline 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\(hyKermit\(hyProject Kermit ++protocol implementations really ARE slow. The best file\(hytransfer partners ++for C\(hyKermit are: another copy of C\(hyKermit (7.0 or later) and Kermit 95. ++These combinations work well and they work fast by default. MS\(hyDOS Kermit + is good too, but you have to tell it to go fast (by giving it the FAST + command). + .PP +@@ -1326,50 +1326,50 @@ + packet comes in from the remote, they automatically switch into file + transfer mode. + .PP +-And plus, C-Kermit and K95 also switch automatically between text and ++And plus, C\(hyKermit 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. + .PP +-What all of these words add up to is that now, when you use up-to-date ++What all of these words add up to is that now, when you use up\(hyto\(hydate + 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. + .TP + Downloading Files +-Let's say you have Kermit 95, C-Kermit, or MS-DOS Kermit on your ++Let's say you have Kermit 95, C\(hyKermit, or MS\(hyDOS Kermit on your + desktop computer, with a connection to a Unix computer that has +-C-Kermit installed as "kermit". To download a file (send it from Unix ++C\(hyKermit installed as "kermit". To download a file (send it from Unix + to your desktop computer), just type the following command at your + Unix shell prompt: + .sp +- kermit -s oofa.txt ++ kermit \-s oofa.txt + .sp + (where oofa.txt is the filename). If you want to send more than one + file, you can put as many filenames as you want on the command line, + and they can be any combination of text and binary: + .sp +- kermit -s oofa.txt oofa.zip oofa.html oofa.tar.gz ++ kermit \-s oofa.txt oofa.zip oofa.html oofa.tar.gz + .sp + and/or you can use wildcards to send groups of files: + .sp +- kermit -s oofa.* ++ kermit \-s oofa.* + .sp + If you want to send a file under an assumed name, use: + .sp +- kermit -s friday.txt -a today.txt ++ kermit \-s friday.txt \-a today.txt + .sp + This sends the file friday.txt but tells the receiving Kermit that its + name is today.txt. In all cases, as noted, when the file transfer is + finished, your desktop Kermit returns automatically to Connect state. +-No worries about escaping back, re-connecting, text/binary mode ++No worries about escaping back, re\(hyconnecting, text/binary mode + switching. Almost too easy, right? + .TP + 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: ++Unix computer) do the same thing, but use the \-g (GET) option instead ++of \-s: + .sp +- kermit -g oofa.txt ++ kermit \-g oofa.txt + .sp + This causes your local Kermit to enter server mode; then the remote + Kermit program requests the named file and the local Kermit sends it +@@ -1379,27 +1379,27 @@ + rules, since these aren't local files: + .sp + .nf +- kermit -g "oofa.txt oofa.zip oofa.html oofa.tar.gz" +- kermit -g "oofa.*" ++ kermit \-g "oofa.txt oofa.zip oofa.html oofa.tar.gz" ++ kermit \-g "oofa.*" + .fi + .sp + If you want to upload a file but store it under a different name, use: + .sp +- kermit -g friday.txt -a today.txt ++ kermit \-g friday.txt \-a today.txt + .TP +-Kermit Transfers the Old-Fashioned Way ++Kermit Transfers the Old\(hyFashioned 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. + .sp + To download a file, type: + .sp +- kermit -s filename ++ kermit \-s filename + .sp + on the host as before, but if nothing happens automatically in + response to this command, you have to switch your desktop + communications software into Kermit Receive state. This might be done +-by escaping back using keyboard characters or hot keys (Alt-x is ++by escaping back using keyboard characters or hot keys (Alt\-x is + typical) and/or with a command (like RECEIVE) or a menu. When the file + transfer is complete, you have to go back to Connect state, Terminal + emulation, or whatever terminology applies to your desktop +@@ -1407,11 +1407,11 @@ + .sp + To upload a file, type: + .sp +- kermit -r ++ kermit \-r + .sp +-on the host (rather than "kermit -g"). This tells C-Kermit to wait ++on the host (rather than "kermit \-g"). This tells C\(hyKermit to wait + passively for a file to start arriving. Then regain the attention of +-your desktop software (Alt-x or whatever) and instruct it to send the ++your desktop software (Alt\-x or whatever) and instruct it to send the + desired file(s) with Kermit protocol. When the transfer is finished, + return to the Connect or Terminal screen. + .TP +@@ -1422,8 +1422,8 @@ + .RS + .TP + FAST +-Use fast file-transfer settings. This has been the default since +-C-Kermit 7.0 now that most modern computers and connections ++Use fast file\(hytransfer settings. This has been the default since ++C\(hyKermit 7.0 now that most modern computers and connections + support it. If transfers fail with fast settings, try . . . + .TP + CAUTIOUS +@@ -1434,21 +1434,21 @@ + Use the most robust, resilient, conservative, safe, and reliable + settings. File transfers will almost certainly work, but they + will be quite slow (of course this is a classic tradeoff; ROBUST +-was C-Kermit's default tuning in versions 6.0 and earlier, which ++was C\(hyKermit's default tuning in versions 6.0 and earlier, which + made everybody think Kermit protocol was slow). If ROBUST doesn't + do the trick, try again with SET PARITY SPACE first in case it's +-not an 8-bit connection. ++not an 8\(hybit connection. + .RE + .sp + Obviously the success and performance of a file transfer also depends +-on C-Kermit's file transfer partner. Up-to-date, real Kermit Project ++on C\(hyKermit's file transfer partner. Up\(hyto\(hydate, real Kermit Project + partners are recommended because they contain the best Kermit protocol + implementations and because we can support them in case of trouble. + .sp +-If you still have trouble, consult Chapter 10 of Using C-Kermit, or +-send email to kermit-support@columbia.edu. ++If you still have trouble, consult Chapter 10 of Using C\(hyKermit, or ++send email to kermit\(hysupport@columbia.edu. + .TP +-Advanced Kermit File-Transfer Features ++Advanced Kermit File\(hyTransfer 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 imagine but +@@ -1460,10 +1460,10 @@ + Logging transfers: + LOG TRANSACTIONS (HELP LOG) + .TP +-Automatic per-file text/binary mode switching: ++Automatic per\(hyfile text/binary mode switching: + SET TRANSFER MODE { AUTOMATIC, MANUAL } (HELP SET TRANSFER). + .TP +-Cross-platform recursive directory tree transfer: ++Cross\(hyplatform recursive directory tree transfer: + SEND /RECURSIVE, GET /RECURSIVE (HELP SEND, HELP GET). + .TP + File collision options: +@@ -1478,14 +1478,14 @@ + Flexible file selection: + SEND (or GET) /BEFORE /AFTER /LARGER /SMALLER /TYPE /EXCEPT, ... + .TP +-Character-set conversion: +-SET { FILE, TRANSFER } CHARACTER-SET, ASSOCIATE, ... ++Character\(hyset conversion: ++SET { FILE, TRANSFER } CHARACTER\-SET, ASSOCIATE, ... + .TP + File/Pathname control: + SET { SEND, RECEIVE } PATHNAMES, SET FILE NAMES. + .TP + Atomic file movement: +-SEND (or GET) /DELETE /RENAME /MOVE-TO ++SEND (or GET) /DELETE /RENAME /MOVE\-TO + .TP + Transferring to/from standard i/o of other commands: + SEND (or GET) /COMMAND +@@ -1494,8 +1494,8 @@ + RESEND, REGET (HELP RESEND, HELP REGET). + .RE + .TP +-Non-Kermit File Transfer +-You can also use C-Kermit to transfer files with FTP or HTTP Internet ++Non\(hyKermit File Transfer ++You can also use C\(hyKermit to transfer files with FTP or HTTP Internet + protocols; see below. + .sp + On a regular serial or Telnet connection where the other computer +@@ -1510,10 +1510,10 @@ + details. + .sp + You can also capture "raw" data streams from the other computer with +-LOG SESSION (HELP LOG and HELP SET SESSION-LOG for details), and you ++LOG SESSION (HELP LOG and HELP SET SESSION\-LOG for details), and you + can upload files without any protocol at all with TRANSMIT (HELP + TRANSMIT, HELP SET TRANSMIT). +-.SH KERMIT'S BUILT-IN FTP AND HTTP CLIENTS ++.SH KERMIT'S BUILT\(hyIN FTP AND HTTP CLIENTS + Kermit's FTP client is like the regular Unix FTP client that you're used + to, but with some differences: + .TP +@@ -1542,7 +1542,7 @@ + http://www.columbia.edu/kermit/ftpclient.html + .sp + You also can use HELP FTP and HELP SET FTP to get descriptions of Kermit's +-FTP-related commands. ++FTP\(hyrelated commands. + .PP + The HTTP client is similar to the FTP one, except you prefix each command + with HTTP instead of FTP: HTTP OPEN, HTTP GET, HTTP PUT, HTTP CLOSE, etc. +@@ -1551,12 +1551,12 @@ + connections and FTP connections. So Kermit can manage up to three types + connections simultaneously. + .SH INTERNET KERMIT SERVICE +-C-Kermit can be configured and run as an Internet service (called IKSD), ++C\(hyKermit 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 ++port for IKSD is 1649. It uses Telnet protocol. C\(hyKermit 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: ++from C\(hyKermit to an IKSD with any of the following commands: + .sp + .nf + telnet foo.bar.edu 1649 +@@ -1574,8 +1574,8 @@ + .sp + http://www.columbia.edu/kermit/iksd.html + .SH SECURITY +-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 ++All of C\(hyKermit's built\(hyin TCP/IP networking methods (Telnet, Rlogin, IKSD, ++FTP, and HTTP) can be secured by one or more of the following IETF\(hyapproved + methods: + .PP + \(bu MIT Kerberos IV +@@ -1590,43 +1590,43 @@ + .PP + http://www.columbia.edu/kermit/security.html + .PP +-And as noted previously, you can also make SSH connections with C-Kermit if ++And as noted previously, you can also make SSH connections with C\(hyKermit if + you already have an SSH client installed. +-.SH ALTERNATIVE COMMAND-LINE PERSONALITIES ++.SH ALTERNATIVE COMMAND\(hyLINE PERSONALITIES + When invoked as "kermit" or any other name besides "ftp" or "telnet", +-C-Kermit has the command-line options described above in the OPTIONS +-section. However, if you invoke C-Kermit as "telnet" or "ftp", it changes +-its command-line personality to match. This can be done (among other ways) +-with symbolic links (symlinks). For example, if you want C-Kermit to be ++C\(hyKermit has the command\(hyline options described above in the OPTIONS ++section. However, if you invoke C\(hyKermit as "telnet" or "ftp", it changes ++its command\(hyline personality to match. This can be done (among other ways) ++with symbolic links (symlinks). For example, if you want C\(hyKermit 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: + .sp +- ln -s /usr/local/bin/kermit telnet ++ ln \-s /usr/local/bin/kermit telnet + .sp + Now when you give a "telnet" command, you are invoking Kermit instead, but +-with its Telnet command-line personality so, for example: ++with its Telnet command\(hyline personality so, for example: + .sp + telnet xyzcorp.com + .sp + Makes a Telnet connection to xyzcorp.com, and Kermit exits automatically + when the connection is closed (just like the regular Telnet client). Type +-"telnet -h" to get a list of Kermit's Telnet-personality command-line ++"telnet \-h" to get a list of Kermit's Telnet\(hypersonality command\(hyline + options, which are intended to be as compatible as possible with the + regular Telnet client. + .PP + Similarly for FTP: + .sp +- ln -s /usr/local/bin/kermit ftp ++ ln \-s /usr/local/bin/kermit ftp + .sp +-And now type "ftp -h" to see its command-line options, and command lines ++And now type "ftp \-h" to see its command\(hyline options, and command lines + just like you would give your regular FTP client: + .sp + ftp xyzcorp.com + .sp + but with additional options allowing an entire session to be specified on + the command line. Finally, if Kermit's +-first command-line option is a Telnet, FTP, IKSD, or HTTP URL, Kermit ++first command\(hyline option is a Telnet, FTP, IKSD, or HTTP URL, Kermit + automatically makes the appropriate kind of connection and, if indicated by + the URL, takes the desired action: + .TP +@@ -1649,19 +1649,19 @@ + Grabs a web page + .fi + .SH LICENSE +-C-Kermit has an unusual license, but a fair and sensible one since the ++C\(hyKermit has an unusual license, but a fair and sensible one since the + Kermit Project must support itself out of revenue: it's not a BSD license, + not GPL, not Artistic, not commercial, not shareware, not freeware. It can +-be summed up like this: if you want C-Kermit for your own use, you can ++be summed up like this: if you want C\(hyKermit for your own use, you can + download and use it without cost or license (but we'd appreciate it if you +-would purchase the manual). But if you want to sell C-Kermit or bundle it ++would purchase the manual). But if you want to sell C\(hyKermit or bundle it + with a product or otherwise distribute it in a commercial setting EXCEPT +-WITH AN OPEN-SOURCE OPERATING SYSTEM DISTRIBUTION such as Linux, FreeBSD, ++WITH AN OPEN\(hySOURCE OPERATING SYSTEM DISTRIBUTION such as Linux, FreeBSD, + NetBSD, or OpenBSD, you must license it. To see the complete license, give + the LICENSE command at the prompt, or see the COPYING.TXT file distributed +-with C-Kermit 7.0 or later, or download it from ++with C\(hyKermit 7.0 or later, or download it from + .sp +- ftp://kermit.columbia.edu/kermit/c-kermit/COPYING.TXT ++ ftp://kermit.columbia.edu/kermit/c\-kermit/COPYING.TXT + .sp + Send licensing inquiries to kermit@columbia.edu. + .SH BUGS +@@ -1669,27 +1669,27 @@ + workarounds, hints and tips: + .TP + ckcbwr.txt +-General C-Kermit bugs, hints, tips. ++General C\(hyKermit bugs, hints, tips. + .TP + ckubwr.txt +-Unix-specific C-Kermit bugs, hints, tips. ++Unix\(hyspecific C\(hyKermit bugs, hints, tips. + .PP + Report bugs and problems by email to: + .sp +- kermit-support@columbia.edu. ++ kermit\-support@columbia.edu. + .sp + Before requesting technical support, please read the hints here: + .sp + http://www.columbia.edu/kermit/support.html + .sp +-and also read the C-Kermit Frequently Asked Questions: ++and also read the C\(hyKermit Frequently Asked Questions: + .sp + http://www.columbia.edu/kermit/ckfaq.html + .SH OTHER TOPICS +-There's way more to C-Kermit than we've touched on here -- troubleshooting, ++There's way more to C\(hyKermit than we've touched on here \(hy\(hy 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 ++and supplements. For the most up\(hyto\(hydate information on documentation (or + updated documentation itself) visit the Kermit Project website: + .sp + http://www.columbia.edu/kermit/ +@@ -1698,21 +1698,21 @@ + different Unix varieties, Windows, DOS, VMS, IBM mainframes, and many + others: 20+ years' worth. + .SH DOCUMENTATION AND UPDATES +-The manual for C-Kermit is: ++The manual for C\(hyKermit is: + .TP + .I +-Using C-Kermit ++Using C\(hyKermit + Frank da Cruz and Christine M. Gianone, +-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. ++Second Edition, Digital Press / Butterworth\(hyHeinemann, Woburn, MA, 1997, 622 ++pages, ISBN 1\-55558\-164\-1. This is a printed book. It covers C\(hyKermit 6.0. + .TP +-The C-Kermit 7.0 Supplement ++The C\(hyKermit 7.0 Supplement + http://www.columbia.edu/kermit/ckermit2.html + .TP +-The C-Kermit 8.0 Supplement ++The C\(hyKermit 8.0 Supplement + http://www.columbia.edu/kermit/ckermit3.html + .PP +-Visit C-Kermit home page: ++Visit C\(hyKermit home page: + .sp + http://www.columbia.edu/kermit/ckermit.html + .sp +@@ -1727,13 +1727,13 @@ + The Kermit FAQ (Frequently Asked Questions about Kermit) + .TP + http://www.columbia.edu/kermit/ckfaq.html +-The C-Kermit FAQ (Frequently Asked Questions about C-Kermit) ++The C\(hyKermit FAQ (Frequently Asked Questions about C\(hyKermit) + .TP + http://www.columbia.edu/kermit/telnet.html +-C-Kermit Telnet client documentation ++C\(hyKermit Telnet client documentation + .TP + http://www.columbia.edu/kermit/security.html +-C-Kermit security documentation (Kerberos, SSL/TLS, etc) ++C\(hyKermit security documentation (Kerberos, SSL/TLS, etc) + .TP + http://www.columbia.edu/kermit/cuiksd.html + Internet Kermit Service user documentation +@@ -1755,7 +1755,7 @@ + .SH FILES + .TP + COPYING.TXT +-C-Kermit license. ++C\(hyKermit license. + .TP + ~/.kermrc + Initialization file. +@@ -1780,16 +1780,16 @@ + http://www.columbia.edu/kermit/ckuins.html. + .TP + ckcbwr.txt +-General C-Kermit bugs, hints, tips. ++General C\(hyKermit bugs, hints, tips. + .TP + ckubwr.txt +-Unix-specific C-Kermit bugs, hints, tips. ++Unix\(hyspecific C\(hyKermit bugs, hints, tips. + .TP + ckcplm.txt +-C-Kermit program logic manual. ++C\(hyKermit program logic manual. + .TP + ckccfg.txt +-C-Kermit compile-time configuration options. ++C\(hyKermit compile\(hytime configuration options. + .TP + ssh + (in your PATH) SSH connection helper. +@@ -1804,7 +1804,7 @@ + Software + Frank da Cruz and Jeffrey E Altman, + .br +-1985-present, with contributions from hundreds of others all over the ++1985\(hypresent, with contributions from hundreds of others all over the + world. + .TP + Documentation +@@ -1812,13 +1812,13 @@ + .TP + Address + .nf +-The Kermit Project - Columbia Univerity ++The Kermit Project \(hy Columbia Univerity + 612 West 115th Street +-New York NY 10025-7799 ++New York NY 10025\-7799 + USA + .fi + .TP +-E-Mail ++E\(hyMail + kermit@columbia.edu + .TP + Web diff --git a/debian/patches/02_man-hyphen-quoting b/debian/patches/02_man-hyphen-quoting deleted file mode 100644 index 84a7f82..0000000 --- a/debian/patches/02_man-hyphen-quoting +++ /dev/null @@ -1,1613 +0,0 @@ -Correctly escape hyphens in man page ---- ckermit-211.orig/ckuker.nr -+++ ckermit-211/ckuker.nr -@@ -3,17 +3,17 @@ - .na - .SH NAME - kermit \- --.B C-Kermit 8.0: --transport- and platform-independent -+.B C\(hyKermit 8.0: -+transport\(hy and platform\(hyindependent - interactive and scriptable communications software. - .IP - - This document is intended to give the beginner sufficient information to make --basic (if not advanced) use of C-Kermit 8.0. Although it might be rather long --for a Unix manual page, it's still far shorter than the C-Kermit manual, which --should be consulted for advanced topics such as customization, character-sets, -+basic (if not advanced) use of C\(hyKermit 8.0. Although it might be rather long -+for a Unix manual page, it's still far shorter than the C\(hyKermit manual, which -+should be consulted for advanced topics such as customization, character\(hysets, - scripting, etc. We also attempt to provide a clear structural overview of --C-Kermit's many capabilities, functional areas, states, and modes and their -+C\(hyKermit's many capabilities, functional areas, states, and modes and their - interrelation, that should be helpful to beginners and veterans alike, as well - as to those upgrading to version 8.0 from earlier releases. - .PP -@@ -21,11 +21,11 @@ - .IP - http://www.columbia.edu/kermit/ckututor.html - .SH DESCRIPTION --C-Kermit is an all-purpose communications software package from the Kermit -+C\(hyKermit is an all\(hypurpose communications software package from the Kermit - Project at Columbia University that: - .PP - .nf --\(bu Is portable to many platforms, Unix and non-Unix alike. -+\(bu Is portable to many platforms, Unix and non\(hyUnix alike. - .br - \(bu Can make both serial and network connections. - .br -@@ -35,39 +35,39 @@ - .br - \(bu Can convert character sets in the terminal session. - .br --\(bu Can convert character sets during text-file file transfer. -+\(bu Can convert character sets during text\(hyfile file transfer. - .br - \(bu Is customizable in every aspect of its operation. - .fi - .PP --C-Kermit is a modem program, a Telnet client, an Rlogin client, an FTP -+C\(hyKermit is a modem program, a Telnet client, an Rlogin client, an FTP - client, an HTTP client, and on selected platforms, also an X.25 client. It --can make its own secure Internet connections using IETF-approved security -+can make its own secure Internet connections using IETF\(hyapproved security - methods including Kerberos IV, Kerberos V, SSL/TLS, and SRP and it can also - make SSH connections through your external SSH client application. It can --be the far-end file-transfer or client/server partner of your desktop -+be the far\(hyend file\(hytransfer or client/server partner of your desktop - Kermit client. It can also accept incoming dialed and network connections. - It can even be installed as an Internet service on its own standard TCP - socket, 1649 [RFC2839, RFC2840]. - .PP - And perhaps most important, everything you can do "by hand" (interactively) --with C-Kermit, can be "scripted" (automated) using its built-in --cross-platform transport-independent script programming language, which -+with C\(hyKermit, can be "scripted" (automated) using its built\(hyin -+cross\(hyplatform transport\(hyindependent script programming language, which - happens to be identical to its interactive command language. - .PP --This manual page offers an overview of C-Kermit 8.0 for Unix ("Unix" is an --operating system family that includes AIX, DG/UX, FreeBSD, HP-UX, IRIX, -+This manual page offers an overview of C\(hyKermit 8.0 for Unix ("Unix" is an -+operating system family that includes AIX, DG/UX, FreeBSD, HP\(hyUX, IRIX, - Linux, Mac OS X, NetBSD, OpenBSD, Open Server, Open Unix, QNX, Solaris, - SunOS, System V R3, System V R4, Tru64 Unix, Unixware, Xenix, and many --others). For thorough coverage, please consult the published C-Kermit -+others). For thorough coverage, please consult the published C\(hyKermit - manual and supplements (see DOCUMENTATION below). For further information --about C-Kermit, Kermit software for other platforms, and Kermit manuals, -+about C\(hyKermit, Kermit software for other platforms, and Kermit manuals, - visit the Kermit Project website: - .PP - http://www.columbia.edu/kermit/ - .PP --This is a longer-than-average manual page, and yet it barely scratches the --surface. Don't be daunted. C-Kermit is a large and complex package, -+This is a longer\(hythan\(hyaverage manual page, and yet it barely scratches the -+surface. Don't be daunted. C\(hyKermit is a large and complex package, - evolving over decades of practice and experience, but that doesn't mean - it's hard to learn or use. Its most commonly used functions are explained - here with pointers to additional information elsewhere. -@@ -76,7 +76,7 @@ - .I filename - .B ] [ - .I options --.B ] [ {=,--,+} -+.B ] [ {=,\-\-,+} - .I text - .B ] ] - .PP -@@ -85,12 +85,12 @@ - .B kermit - .I URL - .PP --If the first command-line argument is the name of a file, interactive-mode --commands are executed from the file. The '=' (or "--") argument tells -+If the first command\(hyline argument is the name of a file, interactive\(hymode -+commands are executed from the file. The '=' (or "\-\-") argument tells - Kermit not to parse the remainder of the command line, but to make the - words following '=' available as \e%1, \e%2, ... \e%9. The "+" argument is - like "=" but for use in "kerbang scripts" (explained below). A second --command-line format allows the one and only argument to be a Telnet, FTP, -+command\(hyline format allows the one and only argument to be a Telnet, FTP, - HTTP, or IKSD URL. - .PP - Order of execution: -@@ -100,338 +100,338 @@ - .TP - .nf - 2. --The initialization file, if any, unless suppressed with -Y. -+The initialization file, if any, unless suppressed with \-Y. - .fi - .TP - 3. - The customization file (if it is executed by the initialization file). - .TP - 4. --The command-line URL (if any, and if so, execution stops here). -+The command\(hyline URL (if any, and if so, execution stops here). - .TP - 5. --Command-line options (if any). -+Command\(hyline options (if any). - .TP - 6. - Interactive commands. - .PP --Some command-line options can cause actions (such as -s to send a file); -+Some command\(hyline options can cause actions (such as \-s to send a file); - others just set parameters. If any action options are included on the --command line, Kermit exits when finished unless also given the -S ("stay") -+command line, Kermit exits when finished unless also given the \-S ("stay") - option. If no action options are given, no initialization or command files - contained an EXIT or QUIT command, and no fatal errors occurred, Kermit - issues its prompt and waits for you to type commands. - .IP --Bear in mind that C-Kermit can be built with selected features -+Bear in mind that C\(hyKermit can be built with selected features - disabled, and also that certain features are not available on all --platforms. For example, C-Kermit can't be built with TCP/IP -+platforms. For example, C\(hyKermit can't be built with TCP/IP - support on a platform that does not have TCP/IP header files and - libraries (and even if Kermit does include TCP/IP support, it - can't be used to make TCP/IP connections on a computer that does - not have a TCP/IP stack installed). If your version of lacks --C-Kermit a feature mentioned here, use its SHOW FEATURES command to -+C\(hyKermit a feature mentioned here, use its SHOW FEATURES command to - see what might have been excluded. - .PP --C-Kermit has three kinds of commands: regular single-letter command-line --options, extended-format command-line options, and interactive commands. -+C\(hyKermit has three kinds of commands: regular single\(hyletter command\(hyline -+options, extended\(hyformat command\(hyline options, and interactive commands. - .PP --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 commands --composed of words, which are more intuitive than cryptic command-line -+Like most Unix commands, C\(hyKermit can be be given options on the command -+line. But C\(hyKermit also can be used interactively by giving it commands -+composed of words, which are more intuitive than cryptic command\(hyline - 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 -- -+C\(hyKermit's command\(hyline options, but they are available if you want to. (By -+the same token, you don't have to use its interactive commands either \(hy\(hy - you can use either or both in any combination.) - .PP --C-Kermit is generally installed in the PATH as "kermit", and therefore is -+C\(hyKermit 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 -+then pressing the Return or Enter key. If you wish to include command\(hyline - options, put them after the word "kermit" but before pressing Return or - Enter, separated by spaces, for example: - .PP -- $ kermit -s ckermit.tar.gz -+ $ kermit \-s ckermit.tar.gz - .PP --('$' is the shell prompt; "kermit -s ckermit.tar.gz" is what you type, -+('$' is the shell prompt; "kermit \-s ckermit.tar.gz" is what you type, - followed by Return or Enter.) - .SH OPTIONS --Here is a list of C-Kermit's single-letter command-line options, which --start with a single dash (-), in ASCII ("alphabetical") order. Alphabetic --case is significant (-A is not the same as -a). Action options are -+Here is a list of C\(hyKermit's single\(hyletter command\(hyline options, which -+start with a single dash (\-), in ASCII ("alphabetical") order. Alphabetic -+case is significant (\-A is not the same as \-a). Action options are - tagged "ACTION". - .TP ---0 -+\-0 - (digit zero) 100% transparent Connect state for --"in-the-middle" operation: 8 bits, no parity, no -+"in\(hythe\(hymiddle" operation: 8 bits, no parity, no - escape character, everything passes through. - .TP ---8 --(digit eight) Connection is 8-bit clean (this is the --default in C-Kermit 8.0). Equivalent to the EIGHTBIT -+\-8 -+(digit eight) Connection is 8\(hybit clean (this is the -+default in C\(hyKermit 8.0). Equivalent to the EIGHTBIT - command, which in turn is a shortcut for SET TERMINAL - BYTESIZE 8, SET COMMAND BYTESIZE 8, SET PARITY NONE. - .TP ---9 arg -+\-9 arg - (digit nine) Make a connection to an FTP server. - Equivalent to the FTP OPEN command. --Argument: IP-address-or-hostname[:optional-TCP-port]. --NOTE: C-Kermit also has a separate FTP command-line --personality, with regular FTP-like command-line -+Argument: IP\(hyaddress\(hyor\(hyhostname[:optional\(hyTCP\(hyport]. -+NOTE: C\(hyKermit also has a separate FTP command\(hyline -+personality, with regular FTP\(hylike command\(hyline - syntax. More about this below. - .TP ---A -+\-A - Kermit is to be started as an Internet service (IKSD) - (only from inetd.conf). - .TP ---B -+\-B - Kermit is running in Batch or Background (no - controlling terminal). To be used in case Kermit - doesn't automatically sense its background status. - Equivalent to the SET BACKGROUND ON command. - .TP ---C arg --Interactive-mode Commands to be executed. -+\-C arg -+Interactive\(hymode Commands to be executed. - Argument: Commands separated by commas, list in - doublequotes. - .TP ---D arg -+\-D arg - Delay before starting to send in Remote mode. - Equivalent to the SET DELAY command. - Argument: Number of seconds. - .TP ---E -+\-E - Exit automatically when connection closes. Equivalent --to SET EXIT ON-DISCONNECT ON. -+to SET EXIT ON\-DISCONNECT ON. - .TP ---F arg -+\-F arg - Use an open TCP connection. - Argument: Numeric file descriptor of open TCP - connection. --Also see: -j, -J. -+Also see: \-j, \-J. - .TP ---G arg -+\-G arg - (ACTION) Get file(s) from server, send contents to standard - output, which normally would be piped to another - process. - Argument: Remote file specification, in quotes if it - contains metacharacters. --Also see: -g, -k. -+Also see: \-g, \-k. - .TP ---H -+\-H - Suppress program startup Herald and greeting. - .TP ---I -+\-I - Tell Kermit it has a reliable connection, to force streaming to be used where - it normally would not be. Equivalent to the SET RELIABLE ON command. - .TP ---J arg --(ACTION) "Be like Telnet." Like -j but implies -E. Argument: IP --hostname/address optionally followed by service. NOTE: C-Kermit also has a --separate Telnet command-line personality, with regular Telnet-like --command-line syntax. More about this below. -+\-J arg -+(ACTION) "Be like Telnet." Like \-j but implies \-E. Argument: IP -+hostname/address optionally followed by service. NOTE: C\(hyKermit also has a -+separate Telnet command\(hyline personality, with regular Telnet\(hylike -+command\(hyline syntax. More about this below. - .TP ---L --Recursive directory descent for files in -s option. -+\-L -+Recursive directory descent for files in \-s option. - .TP ---M arg -+\-M arg - My user name (for use with Telnet, Rlogin, FTP, etc). - Equivalent to the SET LOGIN USER command. - Argument: Username string. - .TP ---O -+\-O - (ACTION) (Uppercase letter O) Be a server for One command only. --Also see: -x. -+Also see: \-x. - .TP ---P -+\-P - Don't convert file (Path) names of transferred files. - Equivalent to SET FILE NAMES LITERAL. - .TP ---Q -+\-Q - Quick Kermit protocol settings. Equivalent to the FAST --command. This is the default in C-Kermit 7.0 and later. -+command. This is the default in C\(hyKermit 7.0 and later. - .TP ---R --Remote-only (this just makes IF REMOTE true). -+\-R -+Remote\(hyonly (this just makes IF REMOTE true). - .TP ---S -+\-S - Stay (enter command parser after action options). - .TP ---T --Force Text mode for file transfer; implies -V. -+\-T -+Force Text mode for file transfer; implies \-V. - Equivalent to SET TRANSFER MODE MANUAL, SET FILE TYPE TEXT. - .TP ---V --Disable automatic per-file text/binary switching. -+\-V -+Disable automatic per\(hyfile text/binary switching. - Equivalent to SET TRANSFER MODE MANUAL. - .TP ---Y -+\-Y - Skip (don't execute) the initialization file. - .TP ---a arg --As-name for file(s) in -s, -r, or -g. --Argument: As-name string (alternative filename). When -+\-a arg -+As\(hyname for file(s) in \-s, \-r, or \-g. -+Argument: As\(hyname string (alternative filename). When - receiving files, this can be a directory name. - .TP ---b arg -+\-b arg - Speed for serial device. Equivalent to SET SPEED. - Argument: Numeric Bits per second for serial - connections. - .TP ---c -+\-c - (ACTION) Enter Connect state before transferring files. - .TP ---d -+\-d - Create a debug.log file with detailed debugging --information (a second -d adds timestamps). Equivalent -+information (a second \-d adds timestamps). Equivalent - to LOG DEBUG but takes effect sooner. - .TP ---e arg --Maximum length for incoming Kermit file-transfer --packets. Equivalent to SET RECEIVE PACKET-LENGTH. -+\-e arg -+Maximum length for incoming Kermit file\(hytransfer -+packets. Equivalent to SET RECEIVE PACKET\-LENGTH. - Argument: Length in bytes. - .TP ---f -+\-f - (ACTION) Send a FINISH command to a Kermit server. - .TP ---g arg -+\-g arg - Get file(s) from a Kermit server. - Argument: File specification on other computer, in - quotes if it contains metacharacters. Equivalent to --GET. Also see: -a, -G, -r. -+GET. Also see: \-a, \-G, \-r. - .TP ---h --(ACTION) Print Help text for single-letter command-line options -+\-h -+(ACTION) Print Help text for single\(hyletter command\(hyline options - (pipe thru 'more' to prevent scrolling). - .TP ---i -+\-i - Force binary (Image) mode for file transfer; implies ---V. Equivalent to SET TRANSFER MODE MANUAL, SET FILE -+\-V. Equivalent to SET TRANSFER MODE MANUAL, SET FILE - TYPE BINARY. - .TP ---j arg -+\-j arg - Make a TCP/IP connection. - Argument: IP host name/address and optional service - name or number. Equivalent to the TELNET command. --Also see: -J, -F. -+Also see: \-J, \-F. - .TP ---k -+\-k - (ACTION) Receive file(s) to standard output, which normally - would be piped to another process. --Also see: -r, -G. -+Also see: \-r, \-G. - .TP ---l arg -+\-l arg - (Lowercase letter L) Make a connection on the given - serial communications device. Equivalent to the SET - LINE (SET PORT) command. - Argument: Serial device name, e.g. /dev/ttyS0. - .TP ---m arg --Modem type for use with the -l device. Equivalent to -+\-m arg -+Modem type for use with the \-l device. Equivalent to - the SET MODEM TYPE command. - Argument: Modem name as in SET MODEM TYPE command, - e.g. "usrobotics". - .TP ---n -+\-n - (ACTION) Enter Connect state after transferring files (historical). - .TP ---p arg -+\-p arg - Parity. Equivalent to the SET PARITY command. - Argument: One of the following: e(ven), o(dd), m(ark), - n(one), s(pace). - .TP ---q -+\-q - Quiet (suppress most messages). Equivalent to SET QUIET ON. - .TP ---r -+\-r - (ACTION) Receive file(s). Equivalent to the RECEIVE command. --Argument: (none, but see -a) -+Argument: (none, but see \-a) - .TP ---s arg -+\-s arg - Send file(s). - Argument: One or more local file specifications. - Equivalent to the SEND command. --Also see: -a. -+Also see: \-a. - .TP ---t --(Historical) Xon (Ctrl-Q) Turnaround character for --half-duplex connections (used on serial linemode -+\-t -+(Historical) Xon (Ctrl\-Q) Turnaround character for -+half\(hyduplex connections (used on serial linemode - connections to old mainframes). Equivalent to SET - DUPLEX HALF, SET HANDSHAKE XON. - .TP ---v arg -+\-v arg - Window size for Kermit protocol (ignored when --streaming). Equivalanet to SET WINDOW-SIZE. -+streaming). Equivalanet to SET WINDOW\-SIZE. - Argument: Number, 1 to 32. - .TP ---w -+\-w - Incoming files Write over existing files. Equivalent - to SET FILE COLLISION OVERWRITE. - .TP ---x -+\-x - (ACTION) Enter server mode. Equivalent to the SERVER command. --Also see: -O. -+Also see: \-O. - .TP ---y arg -+\-y arg - Alternative initialization file. - Argument: Filename. - .TP ---z -+\-z - Force foreground behavior. To be used in case Kermit - doesn't automatically sense its foreground status. - Equivalent to the SET BACKGROUND OFF command. - .PP --Extended command-line options (necessary because single-letter ones are --about used up) start with two dashes (--), with words rather than single -+Extended command\(hyline options (necessary because single\(hyletter ones are -+about used up) start with two dashes (\-\-), with words rather than single - letters as option names. If an extended option takes an argument, it is - separated from the option word by a colon (:). Extended options include: - - .TP -- --bannerfile:filename -+ \-\-bannerfile:filename - File to display upon startup or IKSD login. - .TP -- --cdfile:filename -+ \-\-cdfile:filename - File to be sent for display to the client when - server changes directory (filename is relative to --the changed-to directory). -+the changed\(hyto directory). - .TP -- --cdmessage:{on,off} -+ \-\-cdmessage:{on,off} - Enable/disable the server CD message feature. - .TP -- --help -+ \-\-help - Prints usage message for extended options. - .TP -- --helpfile:filename -+ \-\-helpfile:filename - Designates a file containing custom text to --replace the top-level HELP command. -+replace the top\(hylevel HELP command. - .TP -- --nointerrupts -+ \-\-nointerrupts - Disables keyboard interrupts. - .TP -- --noperms -+ \-\-noperms - Disables the Kermit protocol file Permissions - attribute, to prevent transmission of file - permissions (protection) from sender to receiver. - .TP -- --version --(ACTION) C-Kermit prints its version number. -+ \-\-version -+(ACTION) C\(hyKermit prints its version number. - .PP --Plus several other IKSD-Only options described at: -+Plus several other IKSD\(hyOnly options described at: - .PP - http://www.columbia.edu/kermit/iksd.html - .PP --See the file-transfer section for examples of command-line invocation. -+See the file\(hytransfer section for examples of command\(hyline invocation. - .SH COMMAND LANGUAGE --C-Kermit's interactive command language is the subject of a 622-page book -+C\(hyKermit's interactive command language is the subject of a 622\(hypage book - and another several hundred pages of updates, far too much for a manual - page. But it's not hard to get started. At the shell prompt, just type --"kermit" to get C-Kermit's interactive command prompt: -+"kermit" to get C\(hyKermit's interactive command prompt: - .PP - .nf - $ kermit -- (/current/directory) C-Kermit> -+ (/current/directory) C\-Kermit> - .fi - .PP - Begin by typing "help" (and then press the Return or Enter key) for a --top-level overview, read it, and go from there. Your second command should -+top\(hylevel overview, read it, and go from there. Your second command should - probably be "intro" (introduction). Note the prompt shows your current - directory (unless you tell Kermit to prompt you with something else). - .PP -@@ -448,11 +448,11 @@ - .PP - While typing commands, you can abbreviate, ask for help (by pressing the - "?" key anywhere in a command), complete keywords or filenames (with the --Tab or Esc key), and edit your typing with Backspace or Delete, Ctrl-W, --Ctrl-U, etc. You can also recall previous commands, save your command -+Tab or Esc key), and edit your typing with Backspace or Delete, Ctrl\-W, -+Ctrl\-U, etc. You can also recall previous commands, save your command - history, and who knows what else. Give the INTRO command for details. - .PP --C-Kermit has hundreds of commands, and they can be issued in infinite -+C\(hyKermit has hundreds of commands, and they can be issued in infinite - variety and combinations, including commands for: - .nf - .PP -@@ -485,15 +485,15 @@ - .fi - And of course QUIT or EXIT to get out and HELP to get help, and for - programmers: loops, decision making, variables, arrays, associative arrays, --integer and floating point arithmetic, macros, built-in and user-defined -+integer and floating point arithmetic, macros, built\(hyin and user\(hydefined - functions, string manipulation, pattern matching, block structure, scoping, --recursion, and all the rest. To get a list of all C-Kermit's commands, type -+recursion, and all the rest. To get a list of all C\(hyKermit's commands, type - a question mark (?) at the prompt. To get a description of any command, - type HELP followed by the name of the command, for example: - .PP - help send - .PP --The command interruption character is Ctrl-C (hold down the Ctrl key and -+The command interruption character is Ctrl\-C (hold down the Ctrl key and - press the C key). - .PP - The command language "escape character", used to introduce variable names, -@@ -505,7 +505,7 @@ - A file containing Kermit commands is called a Kermit command file or Kermit - script. It can be executed with Kermit's TAKE command: - .PP -- (/current/dir) C-Kermit> take commandfile -+ (/current/dir) C\-Kermit> take commandfile - .PP - (where "commandfile" is the name of the command file). Please don't pipe a - command file into Kermit's standard input (which might or might not work); -@@ -599,16 +599,16 @@ - .PP - take \ev(home).kermrc - .PP --at the desired spot in the script. By the way, \ev(xxx) is a built-in -+at the desired spot in the script. By the way, \ev(xxx) is a built\(hyin - variable (xxx is the variable name, "home" in this case). To see what --built-in variables are available, type "show variables" at the C-Kermit -+built\(hyin variables are available, type "show variables" at the C\(hyKermit - prompt. To see what else you can show, type "show ?". \em(xxx) is a user - defined variable (strictly speaking, it is a macro used as a variable). - .SS Command List --C-Kermit has more than 200 top-level commands, and some of these, such as -+C\(hyKermit has more than 200 top\(hylevel commands, and some of these, such as - SET, branch off into hundreds of subcommands of their own, so it's not - practical to describe them all here. Instead, here's a concise list of the --most commonly used top-level commands, grouped by category. To learn about -+most commonly used top\(hylevel commands, grouped by category. To learn about - each command, type "help" followed by the command name, e.g. "help set". - Terms such as Command state and Connect state are explained in subsequent - sections. -@@ -620,7 +620,7 @@ - HELP text for each command. Example: - .PP - .nf -- send /recursive /larger:10000 /after:-1week /except:*.txt * -+ send /recursive /larger:10000 /after:\-1week /except:*.txt * - .fi - .PP - which can be read as "send all the files in this directory and all the ones -@@ -631,19 +631,19 @@ - .RS - .TP - HELP --Requests top-level help. -+Requests top\(hylevel help. - .TP - HELP command - Requests help about the given command. - .TP - INTRODUCTION --Requests a brief introduction to C-Kermit. -+Requests a brief introduction to C\(hyKermit. - .TP - LICENSE --Displays the C-Kermit software copyright and license. -+Displays the C\(hyKermit software copyright and license. - .TP - VERSION --Displays C-Kermit's version number. -+Displays C\(hyKermit's version number. - .TP - EXIT [ number ] - Exits from Kermit with the given -@@ -667,13 +667,13 @@ - STATUS - Tells whether previous command succeeded or failed. - .TP --DATE [ date-and/or-time ] --Shows current date-time or interprets given date-time. -+DATE [ date\(hyand/or\(hytime ] -+Shows current date\(hytime or interprets given date\(hytime. - .TP --RUN [ extern-command [ parameters... ] -+RUN [ extern\(hycommand [ parameters... ] - Runs the given external command. Synonym: !. - .TP --EXEC [ extern-command [ params... ] -+EXEC [ extern\(hycommand [ params... ] - Kermit overlays itself with the given command. - .TP - SUSPEND -@@ -703,7 +703,7 @@ - the pattern. Synonym: FIND. - .TP - DIRECTORY [ options ] [filespec ] --Lists files (built-in, many options). -+Lists files (built\(hyin, many options). - .TP - LS [ options ] [ filespec ] - Lists files (runs external "ls" command). -@@ -799,10 +799,10 @@ - HTTP [ options ] OPEN host - Opens an HTTP connection to the host. - .TP --PTY external-command -+PTY external\(hycommand - Runs the command on a pseudoterminal as if it were a connection. - .TP --PIPE external-command -+PIPE external\(hycommand - Runs the command through a pipe as if it were a connection. - .RE - .SS -@@ -818,24 +818,24 @@ - TELOPT command - Sends a Telnet protocol command (Telnet connections only). - .TP --Ctrl-\eC -+Ctrl\-\eC - "Escapes back" from Connect state to Command state. - .TP --Ctrl-\eB -+Ctrl\-\eB - (In Connect state) Sends a BREAK signal (serial or Telnet). - .TP --Ctrl-\e! -+Ctrl\-\e! - (In Connect state) Enters inferior shell; "exit" to return. - .TP --Ctrl-\e? --(In Connect state) Shows a menu of other escape-level options. -+Ctrl\-\e? -+(In Connect state) Shows a menu of other escape\(hylevel options. - .TP --Ctrl-\eCtrl-\e -+Ctrl\-\eCtrl\-\e - (In Connect state) Type two --Ctrl-Backslashes to send one of them. -+Ctrl\-Backslashes to send one of them. - .TP - SET ESCAPE [ character ] --Changes Kermit's Connect-state escape character. -+Changes Kermit's Connect\(hystate escape character. - .RE - .SS - Closing Connections -@@ -843,18 +843,18 @@ - .TP - HANGUP - Hangs up the currently open --serial-port or network connection. -+serial\(hyport or network connection. - .TP - CLOSE - Closes the currently open --serial-port or network connection. -+serial\(hyport or network connection. - .TP - SET LINE (with no devicename) - Closes the currently open --serial-port or network connection. -+serial\(hyport or network connection. - .TP - SET HOST (with no hostname) --Closes the currently open serial-port or network connection. -+Closes the currently open serial\(hyport or network connection. - .TP - FTP CLOSE - Closes the currently open FTP connection. -@@ -872,7 +872,7 @@ - File Transfer - .RS - .TP --SEND [ options ] filename [ as-name ] -+SEND [ options ] filename [ as\(hyname ] - Sends the given file. Synonym: S. - .TP - SEND [ options ] filespec -@@ -881,20 +881,20 @@ - RESEND [ options ] filespec - Resumes an interupted SEND from the point of failure. - .TP --RECEIVE [ options ] [ as-name ] -+RECEIVE [ options ] [ as\(hyname ] - Waits passively for files to arrive. Synonym: R. - .TP - LOG TRANSACTIONS [ filename ] - Keeps a record of file transfers. - .TP - FAST --Use fast file-transfer settings (default). -+Use fast file\(hytransfer settings (default). - .TP - CAUTIOUS --Use cautious and less fast file-transfer settings. -+Use cautious and less fast file\(hytransfer settings. - .TP - ROBUST --Use ultra-conservative and slow file-transfer settings. -+Use ultra\(hyconservative and slow file\(hytransfer settings. - .TP - STATISTICS [ options ] - Gives statistics about the most recent file transfer. -@@ -909,7 +909,7 @@ - Captures remote text or files without protocol. - .TP - SET PROTOCOL [ name... ] --Tells Kermit to use an external file-transfer protocol. -+Tells Kermit to use an external file\(hytransfer protocol. - .TP - FTP { PUT, MPUT, GET, MGET, ... } - FTP client commands. -@@ -940,7 +940,7 @@ - [ REMOTE ] LOGOUT - Logs out from a Kermit server or IKSD. - .TP --SEND [ options ] filename [ as-name ] -+SEND [ options ] filename [ as\(hyname ] - Sends the given file to the server. Synonyms: S, PUT. - .TP - SEND [ options ] filespec -@@ -949,10 +949,10 @@ - RESEND [ options ] filespec - Resumes an interupted SEND from the point of failure. - .TP --GET [ options ] remote-filespec -+GET [ options ] remote\(hyfilespec - Asks the server to send the given files. Synonym: G. - .TP --REGET [ options ] remote-filespec -+REGET [ options ] remote\(hyfilespec - Resumes an interrupted GET from the point of failure. - .TP - REMOTE CD [ directory ] -@@ -972,7 +972,7 @@ - (Many other commands: "remote ?" for a list). - .TP - MAIL [ options ] filespec --Sends file(s) to be delivered as e-mail (Kermit only). -+Sends file(s) to be delivered as e\(hymail (Kermit only). - .TP - FINISH - Asks the server to exit server state (Kermit only). -@@ -1005,21 +1005,21 @@ - this example: - .PP - .nf -- C-Kermit> remote ? One of the following: -+ C\-Kermit> remote ? One of the following: - assign directory kermit print rmdir - cd exit login pwd set - copy help logout query space - delete host mkdir rename type -- C-Kermit> remote set ? One of the following: -+ C\-Kermit> remote set ? One of the following: - attributes file retry transfer -- block-check receive server window -- C-Kermit> remote set file ? One of the following: -- character-set incomplete record-length -+ block\-check receive server window -+ C\-Kermit> remote set file ? One of the following: -+ character\-set incomplete record\-length - collision names type -- C-Kermit> remote set file names ? One of the following: -+ C\-Kermit> remote set file names ? One of the following: - converted literal -- C-Kermit> remote set file names literal -- C-Kermit> -+ C\-Kermit> remote set file names literal -+ C\-Kermit> - .PP - .fi - This is called menu on demand: you get a menu when you want one, but menus -@@ -1030,25 +1030,25 @@ - example, "send x?" lists all the files in the current directory whose names - start with 'x'. - .SH INITIALIZATION FILE --In its default configuration, C-Kermit executes commands from a file -+In its default configuration, C\(hyKermit 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 -+\-Y or \-y command\(hyline option. Custom configurations might substitute a shared -+system\(hywide 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. - .PP - 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 -+makes C\(hyKermit 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 -+configuration is well attuned to modern computing and networking \(hy\(hy 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 -+definitions, and/or scripted actions they contain, and invoke C\(hyKermit - directly when you don't. - .PP - To put it another way... We still distribute the standard initialization -@@ -1068,7 +1068,7 @@ - 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 -+the file\(hytransfer partner to the local Kermit and communicates only through - its standard input and output. - .PP - At any moment, a Kermit program can be in any of the following states. It's -@@ -1091,7 +1091,7 @@ - and execute commands from a file. The (perhaps implied) DO command - tells Kermit to read and execute commands from a macro definition. - While in Command state, you can interrupt any command, macro, or --command file by typing Ctrl-C (hold down the Ctrl key and press the C -+command file by typing Ctrl\-C (hold down the Ctrl key and press the C - key); this normally brings you back to the prompt. - .TP - Shell state -@@ -1111,24 +1111,24 @@ - return to command state by logging out of the remote computer, or by - typing: - .sp -- Ctrl-\ec -+ Ctrl\-\ec - .sp - That is: Hold down the Ctrl key and press the backslash key, then let - go of the Ctrl key and press the C key. This is called escaping back. --Certain other escape-level commands are also provided; type Ctrl-\e? -+Certain other escape\(hylevel commands are also provided; type Ctrl\-\e? - for a list. For example, you can enter Shell state with: - .sp -- Ctrl-\e! -+ Ctrl\-\e! - .sp --To send a Ctrl-\e to the host while in Connect state, type two of them -+To send a Ctrl\-\e to the host while in Connect state, type two of them - in a row. See HELP CONNECT and HELP SET ESCAPE for more info. - .TP --Local file-transfer state -+Local file\(hytransfer 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 its progress -+file\(hyrelated task. And at the same time, it is displaying its progress - on your screen and watching your keyboard for interruptions. In this --state, the following single-keystroke commands are accepted: -+state, the following single\(hykeystroke commands are accepted: - .sp - .RS - .TP -@@ -1141,61 +1141,61 @@ - E - Like Z but uses a "stronger" protocol (use if X or Z don't work). - .TP --Ctrl-C --Interrupt file-transfer mode (use if Z or E don't work). -+Ctrl\-C -+Interrupt file\(hytransfer mode (use if Z or E don't work). - .sp - .RE - Kermit returns to its previous state (Command or Connect) when the - transfer is complete or when interrupted successfully by X, Z, E, or --Ctrl-C (hold down the Ctrl key and press the C key). -+Ctrl\-C (hold down the Ctrl key and press the C key). - .TP --Remote file-transfer state --In this state, Kermit is exchanging file-transfer packets with its -+Remote file\(hytransfer state -+In this state, Kermit is exchanging file\(hytransfer packets with its - local partner over its standard i/o. It leaves this state - automatically when the transfer is complete. In case you find your --local Kermit in Connect state and the remote one in File-transfer -+local Kermit in Connect state and the remote one in File\(hytransfer - state (in which it seems to ignore your keystrokes), you can usually --return it to command state by typing three Ctrl-C's in a row. If that --doesn't work, return your local Kermit to Command state (Ctrl-\e C) and --type "e-packet" and then press the Return or Enter key; this forces a -+return it to command state by typing three Ctrl\-C's in a row. If that -+doesn't work, return your local Kermit to Command state (Ctrl\-\e C) and -+type "e\(hypacket" and then press the Return or Enter key; this forces a - fatal Kermit protocol error. - .TP - Remote Server state --This is like Remote File-transfer state, except it never returns -+This is like Remote File\(hytransfer state, except it never returns - automatically to Command state. Rather, it awaits further instructions - from the client program; that is, from your Local Kermit program. You - can return the Remote Server to its previous state by issuing a - "finish" command to the client, or if you are in Connect state, by --typing three Ctrl-C's in a row. You can tell the server job to log out -+typing three Ctrl\-C's in a row. You can tell the server job to log out - and break the connection by issuing a "bye" command to the client. - .TP - 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 -+Like Remote\(hyServer state, but in local mode, and therefore with its -+file\(hytransfer display showing, and listening for single\(hykey commands, -+as in Local File\(hytransfer state. Usually this state is entered - automatically when a remote Kermit program gives a GET command. - .sp --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 -+C\(hyKermit, Kermit 95, and MS\(hyDOS Kermit all can switch automatically from -+Connect state to Local File\(hytransfer 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. - .sp --Note that C-Kermit is not a terminal emulator. It is a communications -+Note that C\(hyKermit 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? CLICK HERE to read about it. -+provided by the terminal window in which you are running C\(hyKermit. Kermit -+95 and MS\(hyDOS Kermit, on the other hand, are true terminal emulators. Why -+is C\(hyKermit not a terminal emulator? CLICK HERE to read about it. - .SH MAKING CONNECTIONS - Here is how to make different kinds of connections using interactive Kermit --commands (as noted above, you can also make connections with command-line -+commands (as noted above, you can also make connections with command\(hyline - 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. - .TP - Making a Telnet Connection --At the C-Kermit command prompt, simply type: -+At the C\(hyKermit command prompt, simply type: - .sp - .nf - telnet foo.bar.com -@@ -1224,10 +1224,10 @@ - More info: HELP RLOGIN. - .TP - Making an SSH Connection --Unlike Telnet and Rlogin, SSH connections are not built-in, but -+Unlike Telnet and Rlogin, SSH connections are not built\(hyin, but - handled by running your external SSH client through a pseudoterminal. --Using C-Kermit to control the SSH client gives you all of Kermit's --features (file transfer, character-set conversion, scripting, etc) -+Using C\(hyKermit to control the SSH client gives you all of Kermit's -+features (file transfer, character\(hyset conversion, scripting, etc) - over SSH. - .sp - ssh foo.bar.com -@@ -1236,7 +1236,7 @@ - .TP - 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) modem -+serial port on your computer with a regular (straight\(hythrough) modem - cable, and to the telephone jack with a telephone cable, and that it's - turned on. Then use these commands: - .sp -@@ -1251,7 +1251,7 @@ - .sp - Type "set modem type ?" for a list of supported modem types. If you - omit the SET MODEM TYPE command, the default type is --"generic-high-speed", which should work for most modern AT-command-set -+"generic\(hyhigh\(hyspeed", which should work for most modern AT\(hycommand\(hyset - modems. If the line is busy, Kermit redials automatically. If the call - does not succeed, use "set dial display on" and try it again to watch - what happens. If the call succeeds, Kermit enters Connect state -@@ -1262,34 +1262,34 @@ - reverse terminal server. In this case the command sequence is: - .sp - .nf -- set host ts.xxx.com 2000 ; Terminal-server and port -+ set host ts.xxx.com 2000 ; Terminal\(hyserver and port - set modem type usrobotics ; Or other supported type - set dial method tone ; (or pulse) - dial 7654321 ; Dial the desired number - .fi - .sp - If the terminal server supports the Telnet Com Port Option, RFC 2217, --you can also give serial-port related commands such as SET SPEED, SET -+you can also give serial\(hyport related commands such as SET SPEED, SET - PARITY, and so on, and Kermit relays them to the terminal server using - the protocol specified in the RFC. - .sp - More info: HELP SET MODEM, HELP SET LINE, HELP SET SPEED, HELP SET - FLOW, HELP DIAL, HELP SET DIAL, HELP SET MODEM, HELP SET --CARRIER-WATCH, SHOW COMMUNICATIONS, SHOW MODEM, SHOW DIAL. -+CARRIER\-WATCH, SHOW COMMUNICATIONS, SHOW MODEM, SHOW DIAL. - .TP - Direct Serial Port - Connect the two computers, A and B, with a null modem cable (or two --modem cables interconnected with a null-modem adapter or modem -+modem cables interconnected with a null\(hymodem adapter or modem - eliminator). From Computer A: - .sp - .nf - set modem type none ; There is no modem - set line /dev/ttyS0 ; Specify device name -- set carrier-watch off ; If DTR CD are not cross-connected -+ set carrier\-watch off ; If DTR CD are not cross\(hyconnected - set speed 57600 ; Or other desired speed -- set flow rts/cts ; If RTS and CTS are cross-connected -+ set flow rts/cts ; If RTS and CTS are cross\(hyconnected - set parity even ; (or "mark" or "space", if necessary) -- set stop-bits 2 ; (rarely necessary) -+ set stop\-bits 2 ; (rarely necessary) - set flow xon/xoff ; If you can't use RTS/CTS - connect ; Enter Connect (terminal) state - .fi -@@ -1299,25 +1299,25 @@ - same directions. More info: As above plus HELP CONNECT. - .PP - 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. -+parity even" (or "mark" or "space") if it's a 7\(hybit connection. - .PP - 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 FTP or HTTP - session. Each connection type can be customized to any desired degree, - scripted, logged, you name it. See the manual. - .PP --NOTE: On selected platforms, C-Kermit also can make X.25 connections. See -+NOTE: On selected platforms, C\(hyKermit also can make X.25 connections. See - the manual for details. - .SH TRANSFERRING FILES WITH KERMIT - There is a 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 C-Kermit (7.0 or later) and Kermit 95. --These combinations work well and they work fast by default. MS-DOS Kermit -+overloaded the connection. Some extra commands (or command\(hyline 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\(hyKermit\(hyProject Kermit -+protocol implementations really ARE slow. The best file\(hytransfer partners -+for C\(hyKermit are: another copy of C\(hyKermit (7.0 or later) and Kermit 95. -+These combinations work well and they work fast by default. MS\(hyDOS Kermit - is good too, but you have to tell it to go fast (by giving it the FAST - command). - .PP -@@ -1326,50 +1326,50 @@ - packet comes in from the remote, they automatically switch into file - transfer mode. - .PP --And plus, C-Kermit and K95 also switch automatically between text and -+And plus, C\(hyKermit 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. - .PP --What all of these words add up to is that now, when you use up-to-date -+What all of these words add up to is that now, when you use up\(hyto\(hydate - 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. - .TP - Downloading Files --Let's say you have Kermit 95, C-Kermit, or MS-DOS Kermit on your -+Let's say you have Kermit 95, C\(hyKermit, or MS\(hyDOS Kermit on your - desktop computer, with a connection to a Unix computer that has --C-Kermit installed as "kermit". To download a file (send it from Unix -+C\(hyKermit installed as "kermit". To download a file (send it from Unix - to your desktop computer), just type the following command at your - Unix shell prompt: - .sp -- kermit -s oofa.txt -+ kermit \-s oofa.txt - .sp - (where oofa.txt is the filename). If you want to send more than one - file, you can put as many filenames as you want on the command line, - and they can be any combination of text and binary: - .sp -- kermit -s oofa.txt oofa.zip oofa.html oofa.tar.gz -+ kermit \-s oofa.txt oofa.zip oofa.html oofa.tar.gz - .sp - and/or you can use wildcards to send groups of files: - .sp -- kermit -s oofa.* -+ kermit \-s oofa.* - .sp - If you want to send a file under an assumed name, use: - .sp -- kermit -s friday.txt -a today.txt -+ kermit \-s friday.txt \-a today.txt - .sp - This sends the file friday.txt but tells the receiving Kermit that its - name is today.txt. In all cases, as noted, when the file transfer is - finished, your desktop Kermit returns automatically to Connect state. --No worries about escaping back, re-connecting, text/binary mode -+No worries about escaping back, re\(hyconnecting, text/binary mode - switching. Almost too easy, right? - .TP - 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: -+Unix computer) do the same thing, but use the \-g (GET) option instead -+of \-s: - .sp -- kermit -g oofa.txt -+ kermit \-g oofa.txt - .sp - This causes your local Kermit to enter server mode; then the remote - Kermit program requests the named file and the local Kermit sends it -@@ -1379,27 +1379,27 @@ - rules, since these aren't local files: - .sp - .nf -- kermit -g "oofa.txt oofa.zip oofa.html oofa.tar.gz" -- kermit -g "oofa.*" -+ kermit \-g "oofa.txt oofa.zip oofa.html oofa.tar.gz" -+ kermit \-g "oofa.*" - .fi - .sp - If you want to upload a file but store it under a different name, use: - .sp -- kermit -g friday.txt -a today.txt -+ kermit \-g friday.txt \-a today.txt - .TP --Kermit Transfers the Old-Fashioned Way -+Kermit Transfers the Old\(hyFashioned 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. - .sp - To download a file, type: - .sp -- kermit -s filename -+ kermit \-s filename - .sp - on the host as before, but if nothing happens automatically in - response to this command, you have to switch your desktop - communications software into Kermit Receive state. This might be done --by escaping back using keyboard characters or hot keys (Alt-x is -+by escaping back using keyboard characters or hot keys (Alt\-x is - typical) and/or with a command (like RECEIVE) or a menu. When the file - transfer is complete, you have to go back to Connect state, Terminal - emulation, or whatever terminology applies to your desktop -@@ -1407,11 +1407,11 @@ - .sp - To upload a file, type: - .sp -- kermit -r -+ kermit \-r - .sp --on the host (rather than "kermit -g"). This tells C-Kermit to wait -+on the host (rather than "kermit \-g"). This tells C\(hyKermit to wait - passively for a file to start arriving. Then regain the attention of --your desktop software (Alt-x or whatever) and instruct it to send the -+your desktop software (Alt\-x or whatever) and instruct it to send the - desired file(s) with Kermit protocol. When the transfer is finished, - return to the Connect or Terminal screen. - .TP -@@ -1422,8 +1422,8 @@ - .RS - .TP - FAST --Use fast file-transfer settings. This has been the default since --C-Kermit 7.0 now that most modern computers and connections -+Use fast file\(hytransfer settings. This has been the default since -+C\(hyKermit 7.0 now that most modern computers and connections - support it. If transfers fail with fast settings, try . . . - .TP - CAUTIOUS -@@ -1434,21 +1434,21 @@ - Use the most robust, resilient, conservative, safe, and reliable - settings. File transfers will almost certainly work, but they - will be quite slow (of course this is a classic tradeoff; ROBUST --was C-Kermit's default tuning in versions 6.0 and earlier, which -+was C\(hyKermit's default tuning in versions 6.0 and earlier, which - made everybody think Kermit protocol was slow). If ROBUST doesn't - do the trick, try again with SET PARITY SPACE first in case it's --not an 8-bit connection. -+not an 8\(hybit connection. - .RE - .sp - Obviously the success and performance of a file transfer also depends --on C-Kermit's file transfer partner. Up-to-date, real Kermit Project -+on C\(hyKermit's file transfer partner. Up\(hyto\(hydate, real Kermit Project - partners are recommended because they contain the best Kermit protocol - implementations and because we can support them in case of trouble. - .sp --If you still have trouble, consult Chapter 10 of Using C-Kermit, or --send email to kermit-support@columbia.edu. -+If you still have trouble, consult Chapter 10 of Using C\(hyKermit, or -+send email to kermit\(hysupport@columbia.edu. - .TP --Advanced Kermit File-Transfer Features -+Advanced Kermit File\(hyTransfer 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 imagine but -@@ -1460,10 +1460,10 @@ - Logging transfers: - LOG TRANSACTIONS (HELP LOG) - .TP --Automatic per-file text/binary mode switching: -+Automatic per\(hyfile text/binary mode switching: - SET TRANSFER MODE { AUTOMATIC, MANUAL } (HELP SET TRANSFER). - .TP --Cross-platform recursive directory tree transfer: -+Cross\(hyplatform recursive directory tree transfer: - SEND /RECURSIVE, GET /RECURSIVE (HELP SEND, HELP GET). - .TP - File collision options: -@@ -1478,14 +1478,14 @@ - Flexible file selection: - SEND (or GET) /BEFORE /AFTER /LARGER /SMALLER /TYPE /EXCEPT, ... - .TP --Character-set conversion: --SET { FILE, TRANSFER } CHARACTER-SET, ASSOCIATE, ... -+Character\(hyset conversion: -+SET { FILE, TRANSFER } CHARACTER\-SET, ASSOCIATE, ... - .TP - File/Pathname control: - SET { SEND, RECEIVE } PATHNAMES, SET FILE NAMES. - .TP - Atomic file movement: --SEND (or GET) /DELETE /RENAME /MOVE-TO -+SEND (or GET) /DELETE /RENAME /MOVE\-TO - .TP - Transferring to/from standard i/o of other commands: - SEND (or GET) /COMMAND -@@ -1494,8 +1494,8 @@ - RESEND, REGET (HELP RESEND, HELP REGET). - .RE - .TP --Non-Kermit File Transfer --You can also use C-Kermit to transfer files with FTP or HTTP Internet -+Non\(hyKermit File Transfer -+You can also use C\(hyKermit to transfer files with FTP or HTTP Internet - protocols; see below. - .sp - On a regular serial or Telnet connection where the other computer -@@ -1510,10 +1510,10 @@ - details. - .sp - You can also capture "raw" data streams from the other computer with --LOG SESSION (HELP LOG and HELP SET SESSION-LOG for details), and you -+LOG SESSION (HELP LOG and HELP SET SESSION\-LOG for details), and you - can upload files without any protocol at all with TRANSMIT (HELP - TRANSMIT, HELP SET TRANSMIT). --.SH KERMIT'S BUILT-IN FTP AND HTTP CLIENTS -+.SH KERMIT'S BUILT\(hyIN FTP AND HTTP CLIENTS - Kermit's FTP client is like the regular Unix FTP client that you're used - to, but with some differences: - .TP -@@ -1542,7 +1542,7 @@ - http://www.columbia.edu/kermit/ftpclient.html - .sp - You also can use HELP FTP and HELP SET FTP to get descriptions of Kermit's --FTP-related commands. -+FTP\(hyrelated commands. - .PP - The HTTP client is similar to the FTP one, except you prefix each command - with HTTP instead of FTP: HTTP OPEN, HTTP GET, HTTP PUT, HTTP CLOSE, etc. -@@ -1551,12 +1551,12 @@ - connections and FTP connections. So Kermit can manage up to three types - connections simultaneously. - .SH INTERNET KERMIT SERVICE --C-Kermit can be configured and run as an Internet service (called IKSD), -+C\(hyKermit 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 -+port for IKSD is 1649. It uses Telnet protocol. C\(hyKermit 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: -+from C\(hyKermit to an IKSD with any of the following commands: - .sp - .nf - telnet foo.bar.edu 1649 -@@ -1574,8 +1574,8 @@ - .sp - http://www.columbia.edu/kermit/iksd.html - .SH SECURITY --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 -+All of C\(hyKermit's built\(hyin TCP/IP networking methods (Telnet, Rlogin, IKSD, -+FTP, and HTTP) can be secured by one or more of the following IETF\(hyapproved - methods: - .PP - \(bu MIT Kerberos IV -@@ -1590,43 +1590,43 @@ - .PP - http://www.columbia.edu/kermit/security.html - .PP --And as noted previously, you can also make SSH connections with C-Kermit if -+And as noted previously, you can also make SSH connections with C\(hyKermit if - you already have an SSH client installed. --.SH ALTERNATIVE COMMAND-LINE PERSONALITIES -+.SH ALTERNATIVE COMMAND\(hyLINE PERSONALITIES - When invoked as "kermit" or any other name besides "ftp" or "telnet", --C-Kermit has the command-line options described above in the OPTIONS --section. However, if you invoke C-Kermit as "telnet" or "ftp", it changes --its command-line personality to match. This can be done (among other ways) --with symbolic links (symlinks). For example, if you want C-Kermit to be -+C\(hyKermit has the command\(hyline options described above in the OPTIONS -+section. However, if you invoke C\(hyKermit as "telnet" or "ftp", it changes -+its command\(hyline personality to match. This can be done (among other ways) -+with symbolic links (symlinks). For example, if you want C\(hyKermit 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: - .sp -- ln -s /usr/local/bin/kermit telnet -+ ln \-s /usr/local/bin/kermit telnet - .sp - Now when you give a "telnet" command, you are invoking Kermit instead, but --with its Telnet command-line personality so, for example: -+with its Telnet command\(hyline personality so, for example: - .sp - telnet xyzcorp.com - .sp - Makes a Telnet connection to xyzcorp.com, and Kermit exits automatically - when the connection is closed (just like the regular Telnet client). Type --"telnet -h" to get a list of Kermit's Telnet-personality command-line -+"telnet \-h" to get a list of Kermit's Telnet\(hypersonality command\(hyline - options, which are intended to be as compatible as possible with the - regular Telnet client. - .PP - Similarly for FTP: - .sp -- ln -s /usr/local/bin/kermit ftp -+ ln \-s /usr/local/bin/kermit ftp - .sp --And now type "ftp -h" to see its command-line options, and command lines -+And now type "ftp \-h" to see its command\(hyline options, and command lines - just like you would give your regular FTP client: - .sp - ftp xyzcorp.com - .sp - but with additional options allowing an entire session to be specified on - the command line. Finally, if Kermit's --first command-line option is a Telnet, FTP, IKSD, or HTTP URL, Kermit -+first command\(hyline option is a Telnet, FTP, IKSD, or HTTP URL, Kermit - automatically makes the appropriate kind of connection and, if indicated by - the URL, takes the desired action: - .TP -@@ -1649,19 +1649,19 @@ - Grabs a web page - .fi - .SH LICENSE --C-Kermit has an unusual license, but a fair and sensible one since the -+C\(hyKermit has an unusual license, but a fair and sensible one since the - Kermit Project must support itself out of revenue: it's not a BSD license, - not GPL, not Artistic, not commercial, not shareware, not freeware. It can --be summed up like this: if you want C-Kermit for your own use, you can -+be summed up like this: if you want C\(hyKermit for your own use, you can - download and use it without cost or license (but we'd appreciate it if you --would purchase the manual). But if you want to sell C-Kermit or bundle it -+would purchase the manual). But if you want to sell C\(hyKermit or bundle it - with a product or otherwise distribute it in a commercial setting EXCEPT --WITH AN OPEN-SOURCE OPERATING SYSTEM DISTRIBUTION such as Linux, FreeBSD, -+WITH AN OPEN\(hySOURCE OPERATING SYSTEM DISTRIBUTION such as Linux, FreeBSD, - NetBSD, or OpenBSD, you must license it. To see the complete license, give - the LICENSE command at the prompt, or see the COPYING.TXT file distributed --with C-Kermit 7.0 or later, or download it from -+with C\(hyKermit 7.0 or later, or download it from - .sp -- ftp://kermit.columbia.edu/kermit/c-kermit/COPYING.TXT -+ ftp://kermit.columbia.edu/kermit/c\-kermit/COPYING.TXT - .sp - Send licensing inquiries to kermit@columbia.edu. - .SH BUGS -@@ -1669,27 +1669,27 @@ - workarounds, hints and tips: - .TP - ckcbwr.txt --General C-Kermit bugs, hints, tips. -+General C\(hyKermit bugs, hints, tips. - .TP - ckubwr.txt --Unix-specific C-Kermit bugs, hints, tips. -+Unix\(hyspecific C\(hyKermit bugs, hints, tips. - .PP - Report bugs and problems by email to: - .sp -- kermit-support@columbia.edu. -+ kermit\-support@columbia.edu. - .sp - Before requesting technical support, please read the hints here: - .sp - http://www.columbia.edu/kermit/support.html - .sp --and also read the C-Kermit Frequently Asked Questions: -+and also read the C\(hyKermit Frequently Asked Questions: - .sp - http://www.columbia.edu/kermit/ckfaq.html - .SH OTHER TOPICS --There's way more to C-Kermit than we've touched on here -- troubleshooting, -+There's way more to C\(hyKermit than we've touched on here \(hy\(hy 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 -+and supplements. For the most up\(hyto\(hydate information on documentation (or - updated documentation itself) visit the Kermit Project website: - .sp - http://www.columbia.edu/kermit/ -@@ -1698,21 +1698,21 @@ - different Unix varieties, Windows, DOS, VMS, IBM mainframes, and many - others: 20+ years' worth. - .SH DOCUMENTATION AND UPDATES --The manual for C-Kermit is: -+The manual for C\(hyKermit is: - .TP - .I --Using C-Kermit -+Using C\(hyKermit - Frank da Cruz and Christine M. Gianone, --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. -+Second Edition, Digital Press / Butterworth\(hyHeinemann, Woburn, MA, 1997, 622 -+pages, ISBN 1\-55558\-164\-1. This is a printed book. It covers C\(hyKermit 6.0. - .TP --The C-Kermit 7.0 Supplement -+The C\(hyKermit 7.0 Supplement - http://www.columbia.edu/kermit/ckermit2.html - .TP --The C-Kermit 8.0 Supplement -+The C\(hyKermit 8.0 Supplement - http://www.columbia.edu/kermit/ckermit3.html - .PP --Visit C-Kermit home page: -+Visit C\(hyKermit home page: - .sp - http://www.columbia.edu/kermit/ckermit.html - .sp -@@ -1727,13 +1727,13 @@ - The Kermit FAQ (Frequently Asked Questions about Kermit) - .TP - http://www.columbia.edu/kermit/ckfaq.html --The C-Kermit FAQ (Frequently Asked Questions about C-Kermit) -+The C\(hyKermit FAQ (Frequently Asked Questions about C\(hyKermit) - .TP - http://www.columbia.edu/kermit/telnet.html --C-Kermit Telnet client documentation -+C\(hyKermit Telnet client documentation - .TP - http://www.columbia.edu/kermit/security.html --C-Kermit security documentation (Kerberos, SSL/TLS, etc) -+C\(hyKermit security documentation (Kerberos, SSL/TLS, etc) - .TP - http://www.columbia.edu/kermit/cuiksd.html - Internet Kermit Service user documentation -@@ -1755,7 +1755,7 @@ - .SH FILES - .TP - COPYING.TXT --C-Kermit license. -+C\(hyKermit license. - .TP - ~/.kermrc - Initialization file. -@@ -1780,16 +1780,16 @@ - http://www.columbia.edu/kermit/ckuins.html. - .TP - ckcbwr.txt --General C-Kermit bugs, hints, tips. -+General C\(hyKermit bugs, hints, tips. - .TP - ckubwr.txt --Unix-specific C-Kermit bugs, hints, tips. -+Unix\(hyspecific C\(hyKermit bugs, hints, tips. - .TP - ckcplm.txt --C-Kermit program logic manual. -+C\(hyKermit program logic manual. - .TP - ckccfg.txt --C-Kermit compile-time configuration options. -+C\(hyKermit compile\(hytime configuration options. - .TP - ssh - (in your PATH) SSH connection helper. -@@ -1804,7 +1804,7 @@ - Software - Frank da Cruz and Jeffrey E Altman, - .br --1985-present, with contributions from hundreds of others all over the -+1985\(hypresent, with contributions from hundreds of others all over the - world. - .TP - Documentation -@@ -1812,13 +1812,13 @@ - .TP - Address - .nf --The Kermit Project - Columbia Univerity -+The Kermit Project \(hy Columbia Univerity - 612 West 115th Street --New York NY 10025-7799 -+New York NY 10025\-7799 - USA - .fi - .TP --E-Mail -+E\(hyMail - kermit@columbia.edu - .TP - Web diff --git a/debian/patches/030_fix-if-else.patch b/debian/patches/030_fix-if-else.patch new file mode 100644 index 0000000..9c12683 --- /dev/null +++ b/debian/patches/030_fix-if-else.patch @@ -0,0 +1,25 @@ +Backported fix from ckdaily snapshot to fix parsing of if/else constructs +See #323510. +--- ckermit-211.orig/ckuus6.c ++++ ckermit-211/ckuus6.c +@@ -6607,7 +6607,7 @@ + if (!iftest[cmdlvl]) { /* If IF was false do ELSE part */ + if (maclvl > -1 || tlevel > -1) { /* In macro or command file */ + debug(F100,"doelse pushing","",0); +-#ifdef COMMENT ++#ifndef COMMENT + pushcmd(NULL); /* save rest of command. */ + #else + /* This fixes certain obscure problems */ +--- ckermit-211.orig/ckuusr.c ++++ ckermit-211/ckuusr.c +@@ -7983,8 +7983,7 @@ + line[k++] = SP; + line[k] = NUL; + debug(F111,"XXMACRO A",line,k); +- /* Defer evaluation of variables until the commands are exec'd */ +- if ((y = cmtxt("Braced list of commands","",&s,NULL)) < 0) ++ if ((y = cmtxt("Braced list of commands","",&s,xxstring)) < 0) + return(y); + k = ckstrncpy(line+k,s,LINBUFSIZ-k); + debug(F111,"XXMACRO B",line,k); diff --git a/debian/patches/03_fix-if-else b/debian/patches/03_fix-if-else deleted file mode 100644 index 9c12683..0000000 --- a/debian/patches/03_fix-if-else +++ /dev/null @@ -1,25 +0,0 @@ -Backported fix from ckdaily snapshot to fix parsing of if/else constructs -See #323510. ---- ckermit-211.orig/ckuus6.c -+++ ckermit-211/ckuus6.c -@@ -6607,7 +6607,7 @@ - if (!iftest[cmdlvl]) { /* If IF was false do ELSE part */ - if (maclvl > -1 || tlevel > -1) { /* In macro or command file */ - debug(F100,"doelse pushing","",0); --#ifdef COMMENT -+#ifndef COMMENT - pushcmd(NULL); /* save rest of command. */ - #else - /* This fixes certain obscure problems */ ---- ckermit-211.orig/ckuusr.c -+++ ckermit-211/ckuusr.c -@@ -7983,8 +7983,7 @@ - line[k++] = SP; - line[k] = NUL; - debug(F111,"XXMACRO A",line,k); -- /* Defer evaluation of variables until the commands are exec'd */ -- if ((y = cmtxt("Braced list of commands","",&s,NULL)) < 0) -+ if ((y = cmtxt("Braced list of commands","",&s,xxstring)) < 0) - return(y); - k = ckstrncpy(line+k,s,LINBUFSIZ-k); - debug(F111,"XXMACRO B",line,k); diff --git a/debian/patches/040_pam-password-prompting.patch b/debian/patches/040_pam-password-prompting.patch new file mode 100644 index 0000000..28d0791 --- /dev/null +++ b/debian/patches/040_pam-password-prompting.patch @@ -0,0 +1,103 @@ +Make IKSD authentication (using PAM) ask for a password when an +invalid username has been given, to avoid disclosing which account +names are valid. See #417247. +--- ckermit-211.orig/ckufio.c ++++ ckermit-211/ckufio.c +@@ -490,6 +490,9 @@ + static char guestpass[GUESTPASS] = { NUL, NUL }; /* Anonymous "password" */ + static int logged_in = 0; /* Set when user is logged in */ + static int askpasswd = 0; /* Have OK user, must ask for passwd */ ++#ifdef CK_PAM ++extern int gotemptypasswd; ++#endif /* CK_PAM */ + #endif /* CK_LOGIN */ + + #ifdef CKROOT +@@ -8043,8 +8046,12 @@ + } + } + debug(F110,"zvpass","calling pam_authenticate",0); +- if (*p) +- pam_pw = p; ++ if (*p ++#ifdef CK_LOGIN ++ || gotemptypasswd ++#endif /* CK_LOGIN */ ++ ) ++ pam_pw = p; + if ((pam_status = pam_authenticate(pamh, 0)) != PAM_SUCCESS) { + reply = pam_strerror(pamh, pam_status); + debug(F110,"zvpass PAM failure",reply,0); +--- ckermit-211.orig/ckuus7.c ++++ ckermit-211/ckuus7.c +@@ -98,6 +98,12 @@ + + extern char * k_info_dir; + ++#ifdef CK_LOGIN ++#ifdef CK_PAM ++int gotemptypasswd = 0; /* distinguish empty passwd from none given */ ++#endif /* CK_PAM */ ++#endif /* CK_LOGIN */ ++ + #ifndef NOSPL + extern int nmac; + extern struct mtab *mactab; +@@ -14656,9 +14662,9 @@ + #ifdef CK_RECALL + extern int on_recall; /* around Password prompting */ + #endif /* CK_RECALL */ +-#ifdef CK_PAM ++#ifdef COMMENT + extern int guest; +-#endif /* CK_PAM */ ++#endif /* COMMENT */ + int rprompt = 0; /* Restore prompt */ + #ifdef CKSYSLOG + int savlog; +@@ -14774,9 +14780,9 @@ + debug(F111,"ckxlogin zvuser",userid,ok); + + if (!*passwd && promptok +-#ifdef CK_PAM ++#ifdef COMMENT + && guest +-#endif /* CK_PAM */ ++#endif /* COMMENT */ + ) { + char prmpt[80]; + +@@ -14852,6 +14858,9 @@ + if (pflag) prompt(xxstring); /* Issue prompt if at top level */ + cmres(); /* Reset the parser */ + for (x = -1; x < 0;) { /* Prompt till they answer */ ++#ifdef CK_PAM ++ gotemptypasswd=0; ++#endif /* CK_PAM */ + x = cmtxt("","",&s,NULL); /* Get a literal line of text */ + if (x == -4 || x == -10) { + printf("\r\n%sLogin cancelled\n", +@@ -14861,6 +14870,10 @@ + #endif /* CKSYSLOG */ + doexit(GOOD_EXIT,0); + } ++#ifdef CK_PAM ++ if(!*s) ++ gotemptypasswd=1; ++#endif /* CK_PAM */ + if (sstate) /* In case of a Kermit packet */ + goto XCKXLOG; + cmres(); /* Reset the parser again */ +@@ -14895,6 +14908,12 @@ + if (ok) { + ok = zvpass((char *)passwd); /* Check password */ + debug(F101,"ckxlogin zvpass","",ok); ++#ifdef CK_PAM ++ } else { ++ /* Fake pam password failure for nonexistent users */ ++ sleep(1); ++ printf("Authentication failure\n"); ++#endif + } + + if (ok > 0 && isguest) { diff --git a/debian/patches/04_pam-password-prompting b/debian/patches/04_pam-password-prompting deleted file mode 100644 index 28d0791..0000000 --- a/debian/patches/04_pam-password-prompting +++ /dev/null @@ -1,103 +0,0 @@ -Make IKSD authentication (using PAM) ask for a password when an -invalid username has been given, to avoid disclosing which account -names are valid. See #417247. ---- ckermit-211.orig/ckufio.c -+++ ckermit-211/ckufio.c -@@ -490,6 +490,9 @@ - static char guestpass[GUESTPASS] = { NUL, NUL }; /* Anonymous "password" */ - static int logged_in = 0; /* Set when user is logged in */ - static int askpasswd = 0; /* Have OK user, must ask for passwd */ -+#ifdef CK_PAM -+extern int gotemptypasswd; -+#endif /* CK_PAM */ - #endif /* CK_LOGIN */ - - #ifdef CKROOT -@@ -8043,8 +8046,12 @@ - } - } - debug(F110,"zvpass","calling pam_authenticate",0); -- if (*p) -- pam_pw = p; -+ if (*p -+#ifdef CK_LOGIN -+ || gotemptypasswd -+#endif /* CK_LOGIN */ -+ ) -+ pam_pw = p; - if ((pam_status = pam_authenticate(pamh, 0)) != PAM_SUCCESS) { - reply = pam_strerror(pamh, pam_status); - debug(F110,"zvpass PAM failure",reply,0); ---- ckermit-211.orig/ckuus7.c -+++ ckermit-211/ckuus7.c -@@ -98,6 +98,12 @@ - - extern char * k_info_dir; - -+#ifdef CK_LOGIN -+#ifdef CK_PAM -+int gotemptypasswd = 0; /* distinguish empty passwd from none given */ -+#endif /* CK_PAM */ -+#endif /* CK_LOGIN */ -+ - #ifndef NOSPL - extern int nmac; - extern struct mtab *mactab; -@@ -14656,9 +14662,9 @@ - #ifdef CK_RECALL - extern int on_recall; /* around Password prompting */ - #endif /* CK_RECALL */ --#ifdef CK_PAM -+#ifdef COMMENT - extern int guest; --#endif /* CK_PAM */ -+#endif /* COMMENT */ - int rprompt = 0; /* Restore prompt */ - #ifdef CKSYSLOG - int savlog; -@@ -14774,9 +14780,9 @@ - debug(F111,"ckxlogin zvuser",userid,ok); - - if (!*passwd && promptok --#ifdef CK_PAM -+#ifdef COMMENT - && guest --#endif /* CK_PAM */ -+#endif /* COMMENT */ - ) { - char prmpt[80]; - -@@ -14852,6 +14858,9 @@ - if (pflag) prompt(xxstring); /* Issue prompt if at top level */ - cmres(); /* Reset the parser */ - for (x = -1; x < 0;) { /* Prompt till they answer */ -+#ifdef CK_PAM -+ gotemptypasswd=0; -+#endif /* CK_PAM */ - x = cmtxt("","",&s,NULL); /* Get a literal line of text */ - if (x == -4 || x == -10) { - printf("\r\n%sLogin cancelled\n", -@@ -14861,6 +14870,10 @@ - #endif /* CKSYSLOG */ - doexit(GOOD_EXIT,0); - } -+#ifdef CK_PAM -+ if(!*s) -+ gotemptypasswd=1; -+#endif /* CK_PAM */ - if (sstate) /* In case of a Kermit packet */ - goto XCKXLOG; - cmres(); /* Reset the parser again */ -@@ -14895,6 +14908,12 @@ - if (ok) { - ok = zvpass((char *)passwd); /* Check password */ - debug(F101,"ckxlogin zvpass","",ok); -+#ifdef CK_PAM -+ } else { -+ /* Fake pam password failure for nonexistent users */ -+ sleep(1); -+ printf("Authentication failure\n"); -+#endif - } - - if (ok > 0 && isguest) { diff --git a/debian/patches/050_ck_patch.patch b/debian/patches/050_ck_patch.patch new file mode 100644 index 0000000..6bcf2b0 --- /dev/null +++ b/debian/patches/050_ck_patch.patch @@ -0,0 +1,14 @@ +As requested by upstream, set ck_patch to indicate changes from upstream source. +Index: ckermit/ckcmai.c +=================================================================== +--- ckermit.orig/ckcmai.c 2009-02-26 22:41:45.000000000 +0000 ++++ ckermit/ckcmai.c 2009-02-26 22:54:52.000000000 +0000 +@@ -97,7 +97,7 @@ + #endif /* OS2 */ + + char *ck_s_who = ""; /* Where customized, "" = not. */ +-char *ck_patch = ""; /* Patch info, if any. */ ++char *ck_patch = "3"; /* Patch info, if any. */ + + #define CKVERLEN 128 + char versiox[CKVERLEN]; /* Version string buffer */ diff --git a/debian/patches/05_ck_patch b/debian/patches/05_ck_patch deleted file mode 100644 index 6bcf2b0..0000000 --- a/debian/patches/05_ck_patch +++ /dev/null @@ -1,14 +0,0 @@ -As requested by upstream, set ck_patch to indicate changes from upstream source. -Index: ckermit/ckcmai.c -=================================================================== ---- ckermit.orig/ckcmai.c 2009-02-26 22:41:45.000000000 +0000 -+++ ckermit/ckcmai.c 2009-02-26 22:54:52.000000000 +0000 -@@ -97,7 +97,7 @@ - #endif /* OS2 */ - - char *ck_s_who = ""; /* Where customized, "" = not. */ --char *ck_patch = ""; /* Patch info, if any. */ -+char *ck_patch = "3"; /* Patch info, if any. */ - - #define CKVERLEN 128 - char versiox[CKVERLEN]; /* Version string buffer */ diff --git a/debian/patches/060_speeling.patch b/debian/patches/060_speeling.patch new file mode 100644 index 0000000..946c44a --- /dev/null +++ b/debian/patches/060_speeling.patch @@ -0,0 +1,27 @@ +Fix spelling errors. +Index: ckermit/ckcftp.c +=================================================================== +--- ckermit.orig/ckcftp.c 2009-02-26 22:51:59.000000000 +0000 ++++ ckermit/ckcftp.c 2009-02-26 22:53:18.000000000 +0000 +@@ -8623,7 +8623,7 @@ + #endif /* NOCSETS */ + " /SERVER-RENAME:text", + " Each server source file is to be renamed on the server as indicated", +- " immediately after, but only if, it has arrived succesfully.", ++ " immediately after, but only if, it has arrived successfully.", + " /SMALLER-THAN:number", + " Download only those files smaller than the given number of bytes.", + " /TEXT", /* /ASCII */ +Index: ckermit/ckuus2.c +=================================================================== +--- ckermit.orig/ckuus2.c 2009-02-26 22:51:52.000000000 +0000 ++++ ckermit/ckuus2.c 2009-02-26 22:52:53.000000000 +0000 +@@ -3660,7 +3660,7 @@ + " ", + "SET DIAL RETRIES ", + " How many times to redial each number if the dialing result is busy or no", +-" no answer, until the call is succesfully answered. The default is 0", ++" no answer, until the call is successfully answered. The default is 0", + " because automatic redialing is illegal in some countries.", + " ", + "SET DIAL INTERVAL ", diff --git a/debian/patches/06_speeling b/debian/patches/06_speeling deleted file mode 100644 index 946c44a..0000000 --- a/debian/patches/06_speeling +++ /dev/null @@ -1,27 +0,0 @@ -Fix spelling errors. -Index: ckermit/ckcftp.c -=================================================================== ---- ckermit.orig/ckcftp.c 2009-02-26 22:51:59.000000000 +0000 -+++ ckermit/ckcftp.c 2009-02-26 22:53:18.000000000 +0000 -@@ -8623,7 +8623,7 @@ - #endif /* NOCSETS */ - " /SERVER-RENAME:text", - " Each server source file is to be renamed on the server as indicated", -- " immediately after, but only if, it has arrived succesfully.", -+ " immediately after, but only if, it has arrived successfully.", - " /SMALLER-THAN:number", - " Download only those files smaller than the given number of bytes.", - " /TEXT", /* /ASCII */ -Index: ckermit/ckuus2.c -=================================================================== ---- ckermit.orig/ckuus2.c 2009-02-26 22:51:52.000000000 +0000 -+++ ckermit/ckuus2.c 2009-02-26 22:52:53.000000000 +0000 -@@ -3660,7 +3660,7 @@ - " ", - "SET DIAL RETRIES ", - " How many times to redial each number if the dialing result is busy or no", --" no answer, until the call is succesfully answered. The default is 0", -+" no answer, until the call is successfully answered. The default is 0", - " because automatic redialing is illegal in some countries.", - " ", - "SET DIAL INTERVAL ", diff --git a/debian/patches/series b/debian/patches/series index ab7765d..5623377 100644 --- a/debian/patches/series +++ b/debian/patches/series @@ -1,6 +1,6 @@ -01_makefile-destdir-support -02_man-hyphen-quoting -03_fix-if-else -04_pam-password-prompting -05_ck_patch -06_speeling +010_makefile-destdir-support.patch +020_man-hyphen-quoting.patch +030_fix-if-else.patch +040_pam-password-prompting.patch +050_ck_patch.patch +060_speeling.patch