home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / c-kermit / ckmbwr.txt < prev    next >
Text File  |  2020-01-01  |  72KB  |  1,594 lines
  1. FILE CKMKER.BWR         MACINTOSH KERMIT "BEWARE" FILE                 May 1996
  2.  
  3.  
  4.   Mac Kermit version: 0.993(192) / C-Kermit 6.0.192 Beta.029
  5.  
  6.   This last file updated: Thu Aug 22 19:20:19 1996
  7.   Author: Frank da Cruz, Columbia University
  8.   e-mail: fdc@columbia.edu
  9.  
  10. *** MACBULLETINS ***
  11.    
  12. Mac Kermit 0.993(192) dated 16 May 1996 or later uses the Communications
  13. Tool Box and so should get around bombs and other unpleasantness when trying
  14. to open or close the serial communication device, and it should also let
  15. you use communication devices other than the modem port and the printer port.
  16.  
  17.   BUT... There have been persistent reports that this version does not
  18.   work on the printer port.  Cause and cure unknown.
  19.  
  20. Mac Kermit 0.991(190) dated 8 August 1994 or later fixes the problem with
  21. downloading under newer System releases (7.1.x).  Now files can be downloaded
  22. on newer systems such as Centris 660 AV with OS 7.1, Power Mac 7100/66 with OS
  23. 7.1.2, etc, without bombs or other nasty effects.  The "0.991" designation
  24. differentiates the version that has this fix from "0.99" versions that did not
  25. have it.  Other fixes new to 0.991(190) include:
  26.  
  27.  . OPEN READ / READ / CLOSE READ fixed.
  28.  . LOG { SESSION, TRANSACTION, PACKETS } fixed, and the format of the
  29.    resulting logs is now correct and the creator of these logs is now shown as
  30.    TeachText ('ttxt') so you can click on them and get normal-looking text on
  31.    your screen.
  32.  . Downloaded text files now also are TeachText.
  33.  . Incoming files now obey the file-type attribute (text or binary) that
  34.    precedes the arriving file, unless Mac Kermit has been manually placed into
  35.    MacBinary mode, or "WHOAMI" comes into play (see ckcker.upd).
  36.  . The Command Window SET FILE TYPE command now works right, even for
  37.    MacBinary.
  38.  . The Command Window CD and PWD commands now work.
  39.  . A DIRECTORY command has been added to the Command Window, showing the 
  40.    names and sizes of all the regular files (but not folders) in the current
  41.    directory.
  42.  . The current directory is now shown in the file transfer display, and the
  43.    other items (e.g. "sending" vs "receiving"; "text" vs "binary" vs
  44.    "macbinary", etc, should now be correct.
  45.  . "Writing to console not allowed" alert boxes should be eliminated.
  46.  . The SET FILE COLLISION APPEND, UPDATE, and DISCARD commands have been 
  47.    removed, since they didn't work (or worse!).
  48.  . All \v(...) variables are now set correctly, including \v(home), \v(dir).
  49.    So if you want to set your prompt to show your current directory, you can
  50.    "set prompt [\v(dir)] Mac-Kermit>".
  51.  
  52. (But unfortunately, Version 0.991(190) now seems to lack the ability to be
  53. launched from a script program.  The result is something like "Illegal
  54. Instruction at 006E4BCC mberto+6000".  Cause & cure unknown.)
  55.  
  56. (Also, here's another bad report on this version: "I am using mackermit
  57. 0.991(190) on a Mac SE with 4 megs. memory and whenever I attempt to receive a
  58. file I get an unexpected quit with an error 15.  This is a 'segment loader
  59. error.'   If I quickly start the program again, it will download the files
  60. correctly.")
  61.  
  62. *****************
  63.  
  64. This document applies to the pre-pre-pre-pre-release of Mac Kermit 1.0.  This
  65. is a work in progress, and progress is slow due to lack of funding and of
  66. volunteer programmers with expertise in Macintosh programming, plus the
  67. neverending proliferation of Macintosh models and software.  Many features
  68. remain to be filled in, refined, fixed, or even designed before Mac Kermit is
  69. suitable for "1.0" designation.
  70.  
  71. -----------------------------------------------------------------------------
  72.  
  73. Version 0.99 is the first Mac Kermit version built with the C-Kermit 5A file
  74. transfer protocol and user-interface modules, so it incorporates all the
  75. latest protocol features of C-Kermit, including sliding windows and character
  76. set translation, plus C-Kermit's command and script programming language.
  77.  
  78. As yet, there is no documentation for Mac Kermit 1.0 except the Mac Kermit
  79. 0.9(40) user guide, this file, and the C-Kermit documentation, which describes
  80. the commands you can give at the Mac-Kermit prompt in Mac Kermit's new command
  81. window, which are useful in Mac Kermit for modem dialing, script programming,
  82. etc.  C-Kermit documentation is:
  83.  
  84.   Frank da Cruz and Christine M. Gianone, "Using C-Kermit", Digital Press /
  85.   Butterworth-Heinemann, Woburn, MA, 1993, 514 pages, ISBN 1-55558-108-0
  86.  
  87.   US single-copy price: $39.95; quantity discounts available.  Available in
  88.   computer bookstores or directly from Columbia University:
  89.  
  90.     Kermit Development and Distribution
  91.     Columbia University Academic Information Systems
  92.     612 West 115th Street
  93.     New York, NY  10025  USA
  94.     Telephone: (USA) 212 854-3703
  95.  
  96.   Domestic and overseas orders accepted.  Price: $39.95 (US, Canada, and
  97.   Mexico), $50 elsewhere.  Orders may be paid by MasterCard or Visa, or
  98.   prepaid by check in US dollars.  Add $35 bank fee for checks not drawn on
  99.   a US bank.  Price includes shipping.  Do not include sales tax.
  100.   Inquire about quantity discounts.
  101.  
  102.   You can also order by phone from the publisher, Digital Press /
  103.   Butterworth-Heinemann, with MasterCard, Visa, or American Express:
  104.  
  105.     +1 800 366-2665   (Woburn, Massachusetts office for USA & Canada)
  106.     +44 1865 314627   (Oxford, England distribution centre for UK & Europe)
  107.     +61 03 9245 7111  (Melbourne, Vic, office for Australia & NZ)
  108.     +65 356-1968      (Singapore office for Asia) 
  109.     +27 (31) 2683111  (Durban office for South Africa)
  110.  
  111.   A German-language edition is also available:
  112.  
  113.     Frank da Cruz and Christine M. Gianone, "C-Kermit - Einfuehrung und
  114.     Referenz", Verlag Heinz Heise, Hannover, Germany (1994).
  115.     ISBN 3-88229-023-4.  Deutsch von Gisbert W. Selke.  Price: DM 88,00.  
  116.     Verlag Heinz Heise GmbH & Co. KG, Helstorfer Strasse 7, D-30625 Hannover.
  117.     Tel. +49 (05 11) 53 52-0, Fax. +49 (05 11) 53 53-1 29.
  118.  
  119. This file contains information for both users and for implementors.
  120. Eventually everything will be sorted out and we'll have professionally
  121. published Mac-Kermit-specific user documentation.
  122.  
  123. Send comments, bug reports, etc, to the author at the e-mail address above.
  124.  
  125. If you are reading this file from the Mac Kermit diskette, please skip ahead
  126. to the NEW FEATURES section below.
  127.  
  128.  
  129. THE HQX FILE
  130.  
  131. The Mac Kermit program is distributed on the Internet and BITNET/EARN in
  132. printable ASCII BinHex 4.0 form.  Convert back into a runnable application
  133. using BinHex Version 4.  If you have BinHex 5.0 rather than 4.0, you will
  134. have to edit away the plain-text line:
  135.  
  136. (This file must be converted with BinHex 4.0)
  137.  
  138. and, if there is an empty line below it, the empty line too.  Then it should
  139. be convertible by BinHex 5.0.
  140.  
  141. You can also order Mac Kermit on diskette, ready to run, from Columbia
  142. University at the address above.
  143.  
  144.  
  145. NEW FEATURES
  146.  
  147. Multiple screen windows: for terminal emulation, command processing, text
  148. editing, server response, etc, managed in the normal Macintosh way, as well as
  149. with a new "Window" menu to select Mac Kermit windows explicitly.  Cutting and
  150. pasting works among most of the windows, including double click to select a
  151. word, triple click to select a line.  Material can be copied from the terminal
  152. window to other Mac Kermit windows, or to other applications.  Pasting into
  153. the terminal window sends text to the remote computer.  The terminal session
  154. can also be logged directly to a file.
  155.  
  156. The Command window runs the C-Kermit command parser, just like on UNIX, VMS,
  157. or OS/2, and similar to MS-DOS Kermit.  This gives you access to features that
  158. are not in the mouse/menu interface, most importantly the DIAL command and the
  159. script programming language, and allows the same script programs to be used by
  160. C-Kermit on UNIX, VMS, the Amiga, OS/2, etc, and by MS-DOS Kermit (with proper
  161. precautions about portability).  Text command files can be used as Mac Kermit
  162. startup files ("init files", like for C-Kermit or MS-DOS Kermit).  Filenames
  163. can be referred to by their full path names in the SEND command, etc, for
  164. example "send diskname:foldername:filename", or by relative pathnames,
  165. e.g. "send ::foldername:filename".
  166.  
  167.   An absolute pathname starts WITHOUT a colon (:).  For example:
  168.  
  169.     hd80:test:folder:oofa.txt
  170.  
  171.   The first component of an absolute pathname is the disk.  A relative
  172.   pathname begins with a colon (:), meaning "the current directory".
  173.   Two colons means "the superior directory", for example:
  174.  
  175.     cd ::
  176.  
  177.   means to set C-Kermit's working directory "up one" from its current one.
  178.  
  179. Other new features include:
  180.  
  181.  . Window sizing (vertically only) using the size box, including the terminal
  182.    emulation window.
  183.  
  184.  . Scrollback in most windows, including the terminal window.
  185.  
  186.  . Font selection in the terminal window.
  187.  
  188.  . More efficient file transfer via sliding window packet protocol and longer
  189.    packets.  The window size may be as big as 32 (the theoretical maximum) and
  190.    packets can be up to about 5000 characters long.
  191.  
  192.  . File transfer character set translation (available only via the Command
  193.    window).  The commands are SET FILE CHARACTER-SET, SET TRANSFER
  194.    CHARACTER-SET, and SET LANGUAGE.
  195.  
  196.  . Locking shift packet protocol for efficient transfer of 8-bit data over
  197.    7-bit communication channels.
  198.  
  199.  . Dynamic packet size adjustment to adapt to communication line quality.
  200.  
  201.  . File transfer thermometer.
  202.  
  203.  . Redesigned menus (but nowhere near final).
  204.  
  205.  . More advanced terminal emulation, including many (but not all) features
  206.    of the VT220 and VT320 terminals.
  207.  
  208.  . Faster terminal emulation.
  209.  
  210.  . Many bugs fixed.
  211.  
  212.  
  213. MISSING OR DESIRABLE FEATURES
  214.  
  215.  . No Tektronix or ReGis graphics emulation yet.
  216.  
  217.  . Missing VT320 features, including 132-column mode, and VT220, VT102, VT100,
  218.    and VT52 submodes, various reports.
  219.  
  220.  . Selection among VT320, 220, 102, 100, and 52 needed, with appropriate
  221.    terminal-type ID in response to "What Are You?" queries.
  222.  
  223.  . No 3270 terminal emulation.
  224.  
  225.  . No color support, e.g. ANSI color directives during terminal emulation.
  226.  
  227.  . No "Print selection" and "Print screen" options selectable by mouse clicks
  228.    (work is in progress).  Presently, printing can only be done in the terminal
  229.    window via escape sequences sent from the host.
  230.  
  231.  . No SET KEY command -- key settings are accessible only through the menu
  232.    interface.
  233.  
  234.  . No network support, especially TCP/IP TELNET.
  235.  
  236.  . No APC support for autodownload, etc.
  237.  
  238.  . No multiple sessions -- e.g. modem port in one window, printer port in
  239.    another.  The hard part here is not putting up another window, but
  240.    associating all the varied and many communication, protocol, and terminal
  241.    emulation parameters separately for each window (this is not just a
  242.    programming problem, but also a user interface design issue).
  243.  
  244.  . Internationalization of the user interface (this will be done before the
  245.    final release) (well, it was going to be done, but all the participants in
  246.    this project have vanished).
  247.  
  248.  . Operation as a server is problematic.  Dialing in to a Mac running Mac
  249.    Kermit in server mode is problematic because the needed modem signals are
  250.    not available on the Mac.  The server's response to REMOTE CD, REMOTE
  251.    DIRECTORY, REMOTE DELETE, and similar commands is either not working or
  252.    leaves much to be desired.  Server end of REMOTE LOGIN is not implemented.
  253.  
  254.  . Some of the commands in the Command Window simply do not work.  Other
  255.    essential commands are missing.
  256.  
  257.  
  258. USING MAC KERMIT WITH MODEMS
  259.  
  260. The Macintosh serial port is not an RS-232 device and does not support the
  261. full repertoire of modem signals needed for normal operation with modems.
  262. Communication with modems is accomplished using various "fakeouts", each of
  263. which sacrifices some feature in order to accomplish some other feature,
  264. since the Mac has only one modem signal to send to the modem, and reads only
  265. one modem signal from the modem.  Thus, for example, the Mac can't hang up
  266. the phone by dropping DTR and use hardware flow control at the same time.
  267.  
  268. To have the ability to hang up the phone by dropping DTR, you need a regular
  269. Macintosh modem cable that connects the Mac's "Handshake Out" signal
  270. (Mini-Din-8 Pin 1) to the modem's DTR signal (DB25 pin 20), and the modem
  271. should be configured to hang up when DTR goes down.  In Mac Kermit, you should
  272. NOT check "DTR input flow control" or "CTS output flow control".
  273.  
  274. To use hardware flow control with high-speed modems, you need:
  275.  
  276.  1. A special Macintosh hardware-flow-control-modem cable that connects the
  277.     modem's CTS signal (DB25 pin 5) to the Macintosh's "Handshake In" signal
  278.     (Mini-Din-8 Pin 2) and the Mac's "Handshake Out" signal (Mini-Din-8 Pin 1)
  279.     to the modem's RTS signal (DB25 pin 4).  This cable *might be* available
  280.     from stores or suppliers as a "Macintosh Hardware Handshake Modem Cable"
  281.     (buy at your own risk).
  282.  
  283.  2. You MUST configure your modem to ignore DTR ("&D0" on most Hayes and
  284.     compatible modems) and to use RTS/CTS flow control.  NOTE: This means
  285.     you can't hang up the phone by "dropping DTR".  Normally, it will hang
  286.     up automatically when you log out from the remote computer or service.
  287.     If it doesn't, use the escape sequence (such as +++) to get back to the
  288.     modem's command processor, and then type the modem command for hanging
  289.     up (usually ATH0).
  290.  
  291.  3. In Mac Kermit's Communications Settings menu, uncheck Xon/Xoff flow
  292.     control, and check DTR input flow control and CTS output flow control.
  293.  
  294. To use the internal modem on the Powerbook, use the Portable or PowerBook
  295. control panel (depending on if you're using System 7.0 or 7.1) to switch
  296. between the internal modem and the external modem serial port.  Reportedly,
  297. on the Duo (and perhaps other Mac models) the relevant control panel is in
  298. a subfolder within the Control Panels folder, and moving it one level up
  299. makes the modem work OK.
  300.  
  301. Similarly, other "strange" communication devices, such as the GeoPort Telecom
  302. Adapter, must be selected from the Control Panel (turn on Express Modem, and
  303. set the modem port for "Use Express Modem").
  304.  
  305. Speaking of the Geoport Express Modem, one user reports: "Using Kermit
  306. 0.99(190) released Nov,'93 I cannot transfer more than 1024 bytes of a file.
  307. I have a Quadra 660av with the Geoport Express Modem and when I put my VAX
  308. account into a kermit server mode, Kermit 0.99 can tell it to send a file, and
  309. it begins transferring it.  Then I get a system error.  Sometimes it bombs
  310. with a "Floating Point processor not installed."  Is this a bug of the GeoPort
  311. modem?  I've had several programs bomb on me with that same message once in a
  312. long while."
  313.  
  314. Reportedly, it is possible to have port-sharing (modem-sharing) on an
  315. AppleTalk network, using (for example) a Shiva Telebridge (serial port[s]
  316. on one side, AppleTalk port on the other, and appropriate drivers installed
  317. in the Macs, to make it appear to be the regular modem or printer port).
  318. It is not known whether Kermit works with such devices.
  319.  
  320. Here's a tip from a user about using external protocols: "I love your Transfer
  321. APP command. It works well to change applications before your modem even
  322. realizes you had - I needed to do a Xmodem download, but I was already logged
  323. in through MacKermit."
  324.  
  325.  
  326. PRINTING
  327.  
  328. The only kind of printing currently supported by Mac Kermit is host-directed
  329. printing, which occurs when the host sends VT100 "printer on" and "printer
  330. off" sequences.
  331.  
  332. Thus the print menu is normally dimmed.  When the host sends:
  333.  
  334.   ESC [ 5 i  (or)   ESC [ ? 5 i   --  Turn on printer
  335.   ...text...
  336.   ESC [ 4 i  (or)   ESC [ ? 4 i   --  Turn off printer
  337.  
  338. The text between these two sequences is put into the "capture buffer".  When
  339. the turn-off-printer sequence is received, the Print menu items become
  340. undimmed and you can print the captured text.  There is a limit of about 32K
  341. on the size of this text.
  342.  
  343. This type of printing is normally accomplished with a utility on the computer
  344. that you have connected with Mac Kermit, such a "pcprint" UNIX shell script.
  345.  
  346.   NOTE: As of edit 190, the Print menus have changed somewhat, but the
  347.   operation is substantially the same.  When transparent print material
  348.   arrives, a box appears on the screen saying "Capturing text to be printed",
  349.   and when the transparent print operation is complete, the "Print captured
  350.   text" menu item is activated.  There is a new "Print..." item which is
  351.   undimmed at all times, but apparently does not do anything.
  352.  
  353. Reportedly, host directed printing works better in 0.99(190) than in
  354. earlier edits, but the print buffer is never cleared.
  355.  
  356. Hopefully, future releases of Mac Kermit will have additional printing
  357. capabilities: print screen, print selection, log session to printer, etc.
  358.  
  359.  
  360. TERMINAL EMULATION
  361.  
  362. Most screen functions of the VT220 and 320 are supported, including selective
  363. control of character attributes, the DEC Technical character set, and Latin-1
  364. and other Roman-based West European character sets, but Mac Kermit identifies
  365. itself as a VT100-series in response to a host-generated Terminal ID Query
  366. (ESC Z).  Thus, to take advantage of Mac Kermit's VT220/320 features, you must
  367. manually identify your terminal type to the host software, for example in VMS:
  368.  
  369.   SET TERM /DEVICE=VT220
  370.  
  371. or in any of various ways in UNIX, such as:
  372.  
  373.   term vt220
  374.   TERM=vt220 ; export TERM
  375.   export TERM=vt220
  376.   setenv TERM vt220
  377.  
  378. You can stretch the screen to different lengths other than the default 24.
  379. Kermit responds correctly to "resize" commands from the host, which attempt
  380. to learn the terminal's (i.e. Kermit's) screen dimensions, e.g. in UNIX:
  381.  
  382.   `eval resize`
  383.  
  384. or in VMS 6.0 or later (but not earlier):
  385.  
  386.   SET TERMINAL/INQUIRE
  387.  
  388.  
  389. KEY MAPPING
  390.  
  391. Keys may be mapped as described in ckmker.doc (Mac Kermit Doc on the
  392. Mac Kermit diskette), using the Set Key Macros item in the Settings menu.
  393.  
  394. In addition, a selection of "keyboard verbs" similar to those in MS-DOS Kermit
  395. is available.  These verbs can also be assigned to any key, and they are
  396. special in that they track the VT terminal keypad and cursor mode dynamically.
  397. The "Mac Key" column shows the default assignments for these verbs.
  398.  
  399. Codes that sent by arrow keys:
  400.    
  401.                Cursor-Key Mode......    Mac Kermit
  402.   Mac Key      Cursor    Application    Keyboard Verb
  403.  
  404.   Up Arrow      ESC [ A   ESC O A        \uparrow
  405.   Down Arrow    ESC [ B   ESC O B        \downarrow
  406.   Right Arrow   ESC [ C   ESC O C        \rightarrow
  407.   Left Arrow    ESC [ D   ESC O D        \leftarrow
  408.  
  409. Note: the host application software controls the cursor key mode via the
  410. following escape sequences:
  411.    
  412.   ESC [ ? 1 h     SM        Set arrow keys to cursor mode
  413.   ESC [ ? 1 l     RM        Set arrow keys to application mode
  414.  
  415. Codes sent by Numeric Keypad keys:
  416.  
  417.   DEC           Mac     Keypad Mode:           Mac Kermit
  418.   Key           Key     Numeric Application    Notation
  419.  
  420.   PF1           clear    SS3 P   SS3 P          \pf1
  421.   PF2           kp =     SS3 Q   SS3 Q          \pf2
  422.   PF3           kp /     SS3 R   SS3 R          \pf3
  423.   PF4           kp *     SS3 S   SS3 S          \pf4
  424.   0             kp 0     0       SS3 p          \keypad0
  425.   1             kp 1     1       SS3 q          \keypad1
  426.   2             kp 2     2       SS3 r          \keypad2
  427.   3             kp 3     3       SS3 s          \keypad3
  428.   4             kp 4     4       SS3 t          \keypad4
  429.   5             kp 5     5       SS3 u          \keypad5
  430.   6             kp 6     6       SS3 v          \keypad6
  431.   7             kp 7     7       SS3 w          \keypad7
  432.   8             kp 8     8       SS3 x          \keypad8
  433.   9             kp 9     9       SS3 y          \keypad9
  434.   comma (,)     kp +     ,       SS3 l          \keypad,
  435.   minus (-)     kp -     -       SS3 m          \keypad-
  436.   period (.)    kp .     .       SS3 n          \keypad.
  437.   Enter         enter    CR or   SS3 M          \enter
  438.              CRLF (newline ON)                
  439.  
  440. Note: The host controls the keypad mode with following escape sequences:   
  441.  
  442.   ESC =        DECKPAM        Set numeric keypad to application mode
  443.   ESC >        DECKNPNM    Set numeric keypad to numeric mode
  444.  
  445. Note 2: there is no Keypad + on a DEC VT terminal.
  446.  
  447. DEC User Definable Keys (UDKs) are not supported.
  448.  
  449. There are no verbs for DEC VT220 function keys F6..F20 or editing keys, but
  450. their codes are constant.  These codes may be assigned to the keys of your
  451. choice using Set Key Macros.  The codes are as follows:
  452.  
  453.   DEC Key        Code               DEC Key           Code
  454.  
  455.    F6            ESC [ 17 ~           F17             ESC [ 31 ~
  456.    F7            ESC [ 18 ~           F18             ESC [ 32 ~
  457.    F8            ESC [ 19 ~           F19             ESC [ 33 ~
  458.    F9            ESC [ 20 ~           F20             ESC [ 34 ~
  459.    F10           ESC [ 21 ~           Find            ESC [ 1 ~
  460.    F11 (ESC)     ESC [ 23 ~           Insert Here     ESC [ 2 ~   
  461.    F12 (BS)      ESC [ 24 ~           Remove          ESC [ 3 ~
  462.    F13 (LF)      ESC [ 25 ~           Select          ESC [ 4 ~
  463.    F14           ESC [ 26 ~           Prev Screen     ESC [ 5 ~
  464.    Help          ESC [ 28 ~           Next Screen     ESC [ 6 ~
  465.    Do            ESC [ 29 ~      
  466.  
  467.  
  468. GENERAL BUGS
  469.  
  470. Mac Kermit versions past 0.9(40) are too big for 512K Macs or below.
  471. Reportedly, even attempting to start Mac Kermit on a 512K mac results in a
  472. System error that requires the Mac to be restarted.
  473.  
  474. The DIAL command, although it works mostly as intended, seems to sometimes
  475. have nasty aftereffects, such as system crashes, which might appear later on
  476. in the session, e.g. after CONNECTing, escaping back the Command Window
  477. several times, etc, and then starting a file transfer.  Approach the DIAL
  478. command with caution.
  479.  
  480. Some of Mac Kermit's settings are not saved in the "Save Settings" file.
  481. These include the communication port, certain key settings, menu-command-keys
  482. active, etc etc.  Some of these settings, however, can be saved in an ordinary
  483. text file as interactive-mode commands, such as "set port printer", etc.
  484.  
  485. The interface used by "Save Settings" is not standard for Mac apps.  It should
  486. automatically save the settings from whichever file they were loaded from and
  487. should not invoke the SPF Dialog unless Mac Kermit was launched without
  488. settings and has not loaded settings.  If any setting has changed you should be
  489. prompted whether you want to save settings upon quit or load settings.
  490.  
  491. Reportedly on a PowerBook 100 and SE30 (and perhaps other models), "put Kermit
  492. away in the finder menu by quitting using close or clicking on the close box.
  493. See the dimmed Kermit icon in the folder (normal so far).  Now try to re-enter
  494. Kermit, either by double-clicking on the icon in the folder, or by selecting
  495. it from the Finder menu.  Crash, bomb screen says "bus error" and allows you to
  496. restart.  No funny type manager INITs.  Doesn't seem to be bothered if the
  497. Kermit window is left open, only when it's closed but not Quit."
  498.  
  499. Reportedly, "On a Mac LC III, running sys 7.1 *invariably* and *ALWAYS*; every
  500. time I save a macro or macro set, Kermit Crashes, giving an error message '#1'.
  501. This is independent of any INITS or CDEVs, and always occurs."
  502.  
  503. Reportedly, "On a Mac II with System 6.0.7 with math coprocessor and Color
  504. Cursor, Dimmer, Mousekey, Programmer's key, Randomizer, and SAM Interrupt
  505. loaded, any attempt to save the settings file freezes the system."
  506.  
  507. Reportedly, "Using a Mac Plus with 45Meg Rodime but running Kermit from a
  508. floppy, doing a GET FILE from PC to Mac at 19200 bps with the PC as server:
  509. when the PC says 100% transmitted I get System Error ID=27 on the Mac.  The
  510. restart button on the error message box does not reboot."
  511.  
  512. Reportedly, "Mac Kermit gives a repeated error 28 (ioNotOpenErr) dialog which
  513. you cannot cannot escape from.  This happens after its serial port has been
  514. stolen away by some other app.  This happened to me quite innocently - I was
  515. using Mac Kermit to access a BBS.  I logged off (but left Mac Kermit
  516. running).  Then I used my address book app to dial someone.  Then I went back
  517. to Kermit and needed to use MacsBug to avoid rebooting my system."
  518.  
  519. Reportedly, "When I use "Set Key Macro" to set F14 on my extended keyboard
  520. (F14 = at&fm0td7411400\015), Mac Kermit will crash when I have Appleshare and
  521. HP Background extensions installed.  This only happened when I was also
  522. running "DiskStatus", a startup app.  All under sys 7.0.1 tuneup 1.1.1.  The
  523. crash clobbers system memory or something, because I must reboot, as 'es' in
  524. Macsbug is insufficient."
  525.  
  526. Reportedly, "When my copy of Mac Kermit 0.99(188) (running under System 7.0.1
  527. bullet on a Quadra 750) receives random garbage (either because I accidentally
  528. cause a binary file to be displayed, or because of the few garbage characters
  529. my modem always seems to spit out when the other end disconnects), Mac Kermit
  530. and the Mac occasionally hang, with roughly 10-20% probability.  (The mouse
  531. cursor tracks, but no clicks or keystrokes are honored, and other "background
  532. jobs," including an on-screen clock, all stop.)"  (This is evidently caused
  533. by reception of a Ctrl-S (Xoff) which is not followed by a Ctrl-Q...  But
  534. Mac Kermit is supposed to wake up after 8 seconds from an Xoff deadlock...)
  535.  
  536. Similarly (from another report about edit 188), "I can call the program
  537. without difficulty, but when I go to shut down the machine I get the
  538. message 'Shutdown could not be completed because the application "Kermit
  539. 0.99(188) could not quit'.  When I click OK on this it says, 'The application
  540. 0.99(188) has unexpectedly quit because an error of type 87 occurred.'"
  541.  
  542. Severe problems when running on a Mac (only under System 7?) that has
  543. SuitCase, Adobe Type Manager, TrueType, or Mac Layers Keyboard loaded, ranging
  544. from messed-up screens (bad font spacing) to Kermit or Mac bombs.  Hopefully
  545. this will clear up when the new Macintosh Extended Latin font is finished and
  546. integrated with Mac Kermit.
  547.  
  548. There also seems to be an incompatibility between Now Utilities 4.01 and
  549. MacKermit.  It worked OK with NU 4.0, but with NU 4.01, if you try to launch
  550. MacKermit from a pull-down NowMenu, the Mac (e.g. IIci, System 7.0 with
  551. TuneUp 1.1.1) freezes.
  552.  
  553. One user reports that Mac Kermit bombs unexpectedly "when trying to use key
  554. settings" unless "32-bit addressing is turned off".
  555.  
  556. Another user reports that Mac Kermit does not work at all in 32-bit mode, or
  557. with RAMDoubler, but only in 24-bit mode with no RAMDoubler: "I've tried
  558. MacKermit with 32-bit on and RAMDoubler on, with 32-bit on and RAMDoubler off,
  559. and with 32-bit off and RAMDoubler on. I had problems of freezes and keyboard
  560. locks under each scenario.  In other words, it seems on the surface that
  561. MacKermit likes neither 32-bit mode nor RAMDoubler itself.  I'm running system
  562. 7.1 on a IIsi with 5mb RAM.  Under 24-bit mode w/o RAMDoubler, MacKermit works
  563. beautifully."
  564.  
  565. Reportedly, "Sometimes, quitting a session does not release the 600K memory
  566. allocated by Kermit.  I noticed this once when I quit without closing
  567. the connection.  It may have happened on other occasions also."
  568.  
  569. Reportedly, "When I close the Kermit window (using WindowShade) the mouse arrow
  570. stays invisible until I click over to some other application (or the finder.)"
  571.  
  572. Reportedly, "The inverted screen setup somehow gets shut off when I log on to
  573. my account.  In addition, inverting the screen should also invert the mouse
  574. arrow (which is black), but it doesn't, making the arrow invisible with an
  575. inverted screen."
  576.  
  577. Kermit's ID (signature) is KR09, which hasn't changed in years, so if you have
  578. a lot of different Kermit versions on your disk, clicking on a Kermit startup
  579. file will start a random version of Kermit, not necessarily the one you want.
  580. The ID should be updated to KR10 (files ckmker.mak = kermit.make, ckmdef.h,
  581. ckmker.r, ckmkr2.r, ckmsav.c).
  582.  
  583. Starting one copy of Mac Kermit while another one is active (e.g. under
  584. MultiFinder) results in lots of errors for both Kermits.  Kermit always
  585. initializes the modem port when it starts up, and this hangs up any other
  586. version of Kermit (and who knows what other programs) that might be using the
  587. modem port.  Kermit should (a) not touch the communication device until it
  588. needs to do i/o (this would give the selection of alternate communication
  589. devices the opportunity to take effect first), and (b) should (if this is
  590. possible on the Mac) detect whether the communication device is in use
  591. already, and if so, give an appropriate error message.
  592.  
  593. Reportedly: "In the command window, I gave the command
  594.  
  595.   while = 1 1 {wait 10,output \013}
  596.  
  597. and pressed return.  In order to interrupt the loop, I pressed Cmd-., but
  598. Kermit sent "^A1 EUser cancelledS", which appears to be a Kermit protocol
  599. packet.  After a couple of Cmd-.'s, the "Mac-Kermit>" prompt appeared."
  600.  
  601.  
  602. MENUS, WINDOWS, AND DIALOG BOXES
  603.  
  604. The menus are not complete, and should be rearranged.  They must fit on a
  605. small screen, even after translation into languages like Swedish, where the
  606. words are longer than English.  See APPENDIX at the end of this file.
  607.  
  608. The File menu (English version) is too long for a small screen.
  609.  
  610. Some of the dialog boxes violate the Human Interface Guidelines (HIG) from
  611. Apple, and need redesigning also.
  612.  
  613. The edit menu Undo command doesn't work, and the Edit menu lacks a Select
  614. All command.
  615.  
  616. Typing a letter into a file dialog box tends not to scroll the file list.
  617.  
  618. If you click on Load Settings in the File menu while the command screen is
  619. foremost, the terminal screen will come to the foreground.  However, any
  620. characters you type still go into the command window.  Load Settings should
  621. either leave you in whatever window you were in before, or else fully select
  622. the terminal window.
  623.  
  624. Various items are not saved in the settings file: the communication port
  625. (modem or printer), character sets, etc.
  626.  
  627. Various confusion with cutting and pasting between windows, especially after
  628. a window that has been cut from is closed.
  629.  
  630. Pasting text into the bottom of a text window does not cause the scroll bar
  631. to update; any text below the visible region cannot be scrolled to or
  632. otherwise viewed.  (Workaround: save and reopen the file.)
  633.  
  634. Click and drag to select text doesn't scroll.  Shift-clicking should be a
  635. workaround for the above problem, but it doesn't work exactly as it should
  636. either. If the selection is scrolled out of sight, you can only shift click if
  637. the selection is >0 characters long (that is, you can extend a selection, but
  638. not from a 0-length selection).
  639.  
  640. When pasting text into the buffer, if the text is too long, the edit menu
  641. remains highlighted and Kermit appears to be out of commission.  Using MacsBug
  642. to 'es' and restart it, repainting the screen in the editor buffer on the host
  643. that was being pasting into, shows that the pasting went partway and then some
  644. characters were lost.
  645.  
  646. There is no way to select file and transfer character sets in the menus, or
  647. language rules.  Furthermore, the present character-set menu applies only to
  648. the terminal emulation character set, and it lists many sets that are not
  649. implemented.  These should be removed.  The new menus should look
  650. approximately as shown at the end of this file, in the proposed menu design
  651. appendix.
  652.  
  653.  
  654. TERMINAL EMULATION BUGS & LIMITATIONS
  655.  
  656. Various VT200/300 functions are not implemented, including the character-set
  657. related items described below, UDKs, various DECDSR, DECRQM, and other report
  658. requests (UDK status, keyboard dialect, keyboard action, insert/replace mode,
  659. newline mode, cursor key mode, numeric keypad mode, 132 column mode, smooth
  660. scroll, reverse video, autowrap, palette request, UPSS state, tab stops).
  661.  
  662. Reportedly, if you increase your terminal screen size, Mac Kermit does not
  663. use the new screen size for scrolling until the host places material in the
  664. new bottom line by direct cursor addressing.
  665.  
  666. Local echoing doesn't work very well.  Reportedly the characters are the wrong
  667. size and appear at positions that are unrelated to the cursor or mouse
  668. location.
  669.  
  670. Reportedly, "I have been using Kermit 0.99(188) on a Mac Classic with a 2400
  671. Baud Hayes modem to connect remotely to a number of machines.  When the remote
  672. text is formatted as bold, I tend to lose characters occasionally and spurious
  673. spaces are slipped in quite often.  If I do anything to refresh the screen,
  674. such as activate and then deactivate the screen save, or type control-L, the
  675. spurious spaces disappear and the missing characters reappear.  This behaviour
  676. is only observed with bold characters, and did not occur with Kermit 0.98."
  677.  
  678. If you select Mouse -> Arrow Keys in the Terminal Settings dialog, there is no
  679. way to turn off this feature.
  680.  
  681. Window height can be changed, but not width.  Thus 132-column mode is not
  682. supported.
  683.  
  684. Mac Kermit does not respond correctly to DECCOLM escape sequences from the
  685. host, i.e. ESC [ ? 3 h/l (h = 132 cols, l = 80 cols).  Aside from not changing
  686. the screen width, Mac Kermit also neglects to perform the other actions
  687. associated with these sequences: (1) clear the screen, (2) home the cursor,
  688. and (3) set scrolling region to 24 lines.
  689.  
  690. Reportedly, Mac Kermit occasionally forgets its window height.  E.g. if you
  691. set the window height to (say) 38 by dragging the corner of the terminal
  692. window, and inform the host of your new terminal dimensions, eventually (maybe
  693. after several hours of correct operation), Mac Kermit will begin to scroll
  694. within a 24-line line window, even though the window is still 38 lines long.
  695.  
  696. Keyboard handling is not independent of the keyboard driver -- it assumes the
  697. US keyboard driver.  For example, Mac Kermit doesn't handle dead-key
  698. combinations used in France, Sweden, etc.  Mac Kermit accesses the KCHR
  699. resource, which is a no-no for System 7.
  700.  
  701. Beware of the Option key.  It changes the value of any characters you use with
  702. it.  If you type Option-F, the Mac will send a D, if you type Option-B, the
  703. Mac will send a ":", etc.  If you want to use the option key as a modifier, be
  704. sure to check the "Unmodify" box.
  705.  
  706. There is no mechanism (such as SO/SI, SS2, or SS3) for sending 8-bit
  707. characters to a 7-bit host during terminal emulation.
  708.  
  709. Reportedly, trying to scroll the terminal window while data is being sent to
  710. it can crash the Mac (I can't reproduce this one, maybe it's fixed now... or
  711. maybe it only happens with SuitCase, etc, loaded).
  712.  
  713. Various obscure bugs with VT220/320 character attributes (most frequently
  714. appearing when using the UNIX "more" command).
  715.  
  716. Various failures with "vttest".
  717.  
  718. Set Key dialog box should show what a key sends if it is "unbound".
  719.  
  720. Set Key Macros should allow decimal and hex escapes as well as octal, like
  721. MS-DOS Kermit (or C-Kermit itself): \onnn = octal, \dnnn = decimal, \xnn =
  722. hex, \nnn defaults to decimal (of course changing the default will cause
  723. problems).  C-Kermit already has code to parse these forms, as well as to
  724. handle grouping, e.g \{27}2 to send ESC followed by 2.
  725.  
  726. Bad default mappings for many keys: Ctrl-1, Ctrl-2, etc, thru Ctrl-0.  (Also
  727. Shift-Ctrl-1, etc).  Ctrl-2 and Ctrl-Shift-2 should send NUL (ASCII 0).
  728. Ctrl-6 and Ctrl-Shift-6 should send Ctrl-^ (ASCII 30).  The other top-rank
  729. number keys should send nothing when pressed with Ctrl.  Reportedly, under
  730. System 7 some of these key combinations aren't even noticed.
  731.  
  732. Others too: Ctrl-+, Ctrl-; have codes when they shouldn't, etc etc.  
  733.  
  734. An option to make the cursor change size depending on whether the VT emulator
  735. is in "insert" or "replace" mode might be desirable (handy for IBM mainframe
  736. Xedit users).
  737.  
  738. A wealth of information about VT terminal emulation can be found in
  739. kermit/a/msvibm.vt (the online description of the MS-DOS Kermit terminal
  740. emulator) on kermit.columbia.edu, or (in more complete form) in Appendices I
  741. and II of "Using MS-DOS Kermit", Second Edition, by Christine M. Gianone,
  742. Digital Press, 1992.
  743.  
  744.  
  745. COMMAND BUGS AND PECULIARITIES
  746.  
  747. The command parser (in the command window) is not well-suited for dealing with
  748. Macintosh filenames.  Completion and file lists are not implemented.  Spaces
  749. within names must be entered as \32 (32 is the ASCII code for space); for
  750. example, if you want to send a file called:
  751.  
  752.   Mac Kermit Doc
  753.  
  754. you must type:
  755.  
  756.   send Mac\32Kermit\32Doc
  757.  
  758. (Note: the CD command does not have this restriction, but most other file-
  759. and directory-related commands do.)
  760.  
  761. The command window scrollback feature doesn't work until after you leave the
  762. command window and then reenter it.
  763.  
  764. No filename completion when ESC or TAB is typed within a filename, no file
  765. lists are produced when "?" is typed in a filename, and yet there is no beep
  766. to indicate these features don't work (instead, the cursor disappears).
  767.  
  768. Some SET and other commands have no effect, in particular all the SET TERMINAL
  769. commands, SET FILE NAMES, ...  These should be filled in, i.e. hooked in with
  770. the Macintosh code so that both pieces of the program (Mac menu and C-Kermit
  771. command parser) use the same variables.
  772.  
  773. The PAUSE command should wake up immediately (and fail) if the user hits
  774. a key or clicks the mouse.
  775.  
  776. SET LINE should be converted to use a keyword table (the choices are MODEM
  777. and PRINTER).  (Well, not really -- we still want them to be able to type
  778. real device names...?)
  779.  
  780. Messages displayed by the DIAL command, by script execution, etc, do not
  781. appear on the command window screen until the next prompt appears.  In fact,
  782. this seems to be true of the messages displayed by any command, but most other
  783. commands finish quickly and a prompt is issued right away, so you don't notice
  784. this effect except for DIAL, etc.
  785.  
  786. SET DIAL DISPLAY ON doesn't work at all (even though dialing itself works
  787. fine).
  788.  
  789. Reportedly, "Double clicking on a kermit script results in kermit waking up
  790. and dying with an error, at best and CHK error and reboot at worst.  Double
  791. clicking on a kermit script with kermit already running results in
  792. "Unimplemented System Trap", and the machine reboots."
  793.  
  794.  
  795. FILE TRANSFER PROBLEMS
  796.  
  797. Mac Kermit does not reject incoming files on the basis of size (the
  798. zchkspace() function in ckmfio.c is not filled in).
  799.  
  800. File-append operations are not implemented, viz. appending to logs or
  801. downloaded files.
  802.  
  803. Date-related operations, such as transmission of file dates, are not
  804. implemented.
  805.  
  806. The SET FILE COLLISION UPDATE, APPEND, and DISCARD options are not implemented.
  807.  
  808. In the file-send dialog box, an attempt to edit the "Send As" name results
  809. in a failure to display the file's name and "as-name" in the file transfer
  810. display.  However, the file is still sent the the specified name.
  811.  
  812. Similarly, when sending "the entire folder" from Mac Kermit, the file transfer
  813. display is not filled in properly, but all the files in the folder are indeed
  814. sent.
  815.  
  816. Incoming MacBinary files are not recognized automatically -- you have to
  817. click the MacBinary button beforehand.  (Not really a bug, just a desirable
  818. feature.  Apparently some other Mac communication programs can do this.)
  819.  
  820. Sometimes an incoming MacBinary file, even when when all transfer modes are
  821. set correctly, will fail to be recognized by Mac Kermit as MacBinary;
  822. reportedly this happens primarily when the files are very big.  Mac Kermit
  823. will say it is reverting to ordinary binary mode / data fork, and yet still
  824. display "MacBinary" as the transfer mode in the transfer display.
  825. (Reportedly, when this happens, the StuffIt program can be used to convert the
  826. file -- if it really is in MacBinary format -- back into an application.)
  827.  
  828. An incoming MacBinary file might have a garbage character stuck onto the
  829. beginning of its name (the spurious character will generally show up as a
  830. square on the Macintosh screen).
  831.  
  832. If Mac Kermit is told to receive a file in MacBinary mode, and the file truly
  833. is not in MacBinary format, Mac Kermit always switches to "binary mode / data
  834. fork".  There should be an option to let the user decide on the fallback
  835. transfer method (e.g. "binary / resource", needed for sound files).
  836.  
  837. If a group of MacBinary files is transferred *to* Mac Kermit (remote Kermit
  838. has been told to "set file type binary" and "send *.macbinary", Mac Kermit has
  839. MacBinary selected in the File Settings dialog), only the first arriving file
  840. is treated as MacBinary.  After that, Mac Kermit forgets that it is in
  841. MacBinary mode.  Workaround: send only one file at a time to Mac Kermit in
  842. MacBinary mode.
  843.  
  844. Sometimes (maybe always) MacBinary downloads, particularly of long MacBinary
  845. files, result in errors like:
  846.  
  847.   Zclose(): MacBinary botched: this file should NOT still be open
  848.   Resource fork size mismatch...
  849.   Data fork size mismatch...
  850.   too many NAKs
  851.  
  852. In general, the code that handles incoming MacBinary files needs a lot of work.
  853.  
  854. There is no way to set the ID signature (associated application) of an
  855. incoming file.  Text files (mode = text) all become TeachText documents.  When
  856. "binary / resource" is chosen for downloads, Mac Kermit makes the file type
  857. APPL (an application).  The ID signature is set automatically when downloading
  858. in MacBinary mode (when it works!).  There should be a way to specify the ID
  859. for an incoming file.  (NOTE: MPW C 3.2 has a new function for doing this:
  860. fsetfileinfo() -- see MPW release notes.)
  861.  
  862. If an Appleshare or Novell file server disk goes away (e.g. because the
  863. connection dropped) in the middle of a file transfer, The Mac hangs and has to
  864. be rebooted with the programmer button.
  865.  
  866. In the file-send dialog box, there is no way to mark selected files for
  867. sending (e.g. shift-click, shift-drag).  You can only send a single file, or
  868. else all the files in a folder.  (But you can use MSEND in the command window
  869. to send a selected list of files.)  However, since the Command Window
  870. DIRECTORY command is not implemented, there is no way to get a file list.
  871.  
  872. The file transfer display / dialog-box needs a button for "retransmit the
  873. last packet" to let the user wake up a transfer that seems to be stuck.
  874. Maybe also a "send XON" button to let the user try to break an XOFF deadlock
  875. (which is supposed to happen automatically after 8 seconds anyway).
  876.  
  877. SET FILE DISPLAY NONE should be able to disable the file transfer display
  878. window altogether, for "silent running", for example, for people who want
  879. to incorporate Kermit into their BBS software.
  880.  
  881. The "find a new unique filename" algorithm is not great.  It starts with
  882. the filename, if it exists, appends ".0", then ".1", etc, up to ".99".
  883. However, this doesn't guarantee that the newly created version will be
  884. higher than all the others.  If .1 and .3 exist, Mac Kermit will create .2.
  885.  
  886. The File Settings menu selection "Supersede existing files of the same name"
  887. doesn't seem to work.  But SET FILE COLLISION (in the command window) works
  888. correctly (except for APPEND, UPDATE, and DISCARD, which are not implemented).
  889.  
  890. When a REMOTE command is given from the command window, the Response window
  891. does not pop up to show the response.  However, if you select the Response
  892. window in the Window menu, you'll see the server's responses have been
  893. collected there.
  894.  
  895. You can't cut or copy from the Response Window and paste into other windows.
  896.  
  897. It would also be nice if the file transfer display showed the other info, as
  898. in C-Kermit's fullscreen file transfer display -- character sets, estimated
  899. time to completion, characters per second, etc.
  900.  
  901.  
  902. SERVER MODE
  903.  
  904. 1. Mac Kermit server mode in general (NOTE: these haven't been checked
  905.    recently, maybe they are fixed)...
  906.  
  907. Sending a text file to the Mac Kermit server works fine.  Getting a text file
  908. from the Mac Kermit server also works fine, except the status screen still
  909. says "Receiving".
  910.  
  911. REMOTE SET FILE TYPE BINARY, sent by a client to the Mac Kermit server, works.
  912. Binary file transfers in both directions work fine.
  913.  
  914. There is, of course, no way for the client to put the Mac Kermit server into
  915. MacBinary mode, because as far as the Kermit protocol is concerned, the only
  916. transfer modes are text and binary.
  917.  
  918. REMOTE DIRECTORY sent to the Mac Kermit server, doesn't work (It sends back
  919. an E-packet saying "Can't list directory").
  920.  
  921. FINISH works, the file transfer status screen disappears, but the File
  922. Transfer top-level menu item remains highlighted.
  923.  
  924. 2. MacBinary transfers with the Mac Kermit server.
  925.  
  926. OK, now we want to transfer files in MacBinary mode with a Mac Kermit server.
  927. We click on MacBinary in the File Settings menu, then put Mac Kermit in
  928. server mode.
  929.  
  930. GETting a file from the Mac Kermit server: screen display says "Receiving"
  931. (instead of sending).
  932.  
  933. Giving a REMOTE HELP command to the server apparently makes it forget it's
  934. in MacBinary mode.  A subsequent GET has Mac Kermit sending the data fork
  935. only (empty), in binary mode.
  936.  
  937. Putting it back in MacBinary mode manually, and a subsequent GET, gives
  938. checksum errors.  Then Mac Kermit forgets it's in MacBinary mode again.
  939.  
  940. In general, there seems to be a lot of problems with Mac Kermit remembering
  941. that it's in MacBinary mode.  This is no doubt because Mac Kermit keeps its
  942. own private variables (one for text / binary / macbinary, another for
  943. data / resource / both fork(s)) instead of using Kermit's built-in "binary"
  944. variable.  This needs to be reworked.
  945.  
  946.  
  947. MAC KERMIT CHARACTER SET AND FONT BUGS
  948.  
  949. An official, invertible translation between ISO Latin-1 and Apple Quickdraw
  950. does not exist.  Our own Extended Mac Latin character set is used in this
  951. version.  This set is specified in the separate file, ckmker.fon, which also
  952. discusses the other character-set and font-related issues.
  953.  
  954. Mac Kermit's terminal emulator does not respond to host-generated escape
  955. sequences to designate selected character sets to G0..G3, for example ESC - A
  956. to designate Latin-1 to G1.  Mac Kermit should support:
  957.  
  958.   ESC ( <ident>  Designates 94-byte character set <ident> to G0
  959.   ESC ) <ident>  Designates 94-byte character set <ident> to G1
  960.   ESC * <ident>  Designates 94-byte character set <ident> to G2
  961.   ESC + <ident>  Designates 94-byte character set <ident> to G3
  962.   ESC - <ident>  Designates 96-byte character set <ident> to G1
  963.   ESC . <ident>  Designates 96-byte character set <ident> to G2
  964.   ESC / <ident>  Designates 96-byte character set <ident> to G3
  965.  
  966. where the <idents> are:
  967.  
  968. <ident>    Size    Character-Set
  969.  
  970.    A        96     ISO Latin-1
  971.    B        94     ASCII (default in G0, G1)
  972.    0        94     DEC Special Graphics
  973.    1        94/96  VT100 Alternate ROM
  974.    2        94     DEC Special Graphics
  975.    %5       94     DEC Supplemental Graphics = DEC Multinational Char Set
  976.    >        94     DEC Technical
  977.  
  978. There is no mechanism for the user to explicitly designate character sets to
  979. G0..G3.  See menu design in the Appendix for how to do this.
  980.  
  981. There is presently no way for users to specify their own character-encoding
  982. translations.  The translations for file transfer and terminal emulation
  983. are built in to Kermit.
  984.  
  985. A point size of 7 is listed in the Font menu, but it can't be selected.
  986.  
  987. Mac Kermit's built-in VT100 terminal font does not scale well to any size
  988. other than 9.
  989.  
  990. Mac Kermit's VT100 font has entirely different character codes than all the
  991. other Mac fonts for the "special" (8-bit) characters.  If you switch to, say,
  992. Courier for terminal emulation, all the special characters (accented letters,
  993. etc) come out wrong.  Furthermore, Apple character encodings (like Quickdraw)
  994. lack certain characters (e.g. Icelandic Thorn and Eth) needed for Latin-1.
  995.  
  996. The VT100 font is built into Mac Kermit, which means it can't be hooked in to
  997. Key Caps, so you can never find out what keys to type in order to send special
  998. characters.  This also seems to cause some problems with SuitCase and friends.
  999. The font should be externalized, but then it becomes difficult to install Mac
  1000. Kermit -- you can't just stick in the disk and run it, you have to install
  1001. fonts first.  It would be best to keep the font defined in Mac Kermit, but
  1002. also have an external copy for the benefit of Key Caps.
  1003.  
  1004. You can use the Mac Latin font (which is supplied on the diskette) in Mac
  1005. Kermit, but it won't do any good because the software itself is not coded to
  1006. do the appropriate translations.  However, if you download text files using
  1007. the Latin-1 / MacLatin translation, then you can use the MacLatin font to look
  1008. at these files and all the characters will be right.
  1009.  
  1010. The VT100 font doesn't print correctly (accented characters, VT100 special
  1011. and technical characters, etc).  
  1012.  
  1013. See the separate file, ckmker.fon (Mac Latin Doc on the diskette), for a
  1014. detailed description of these problems and a proposed solution.
  1015.  
  1016. Proportional fonts can be selected during terminal emulation, but of course
  1017. they don't look right because terminals use fixed-width fonts.  Maybe
  1018. proportional characters could be displayed within fixed-size boxes.  Or maybe
  1019. Kermit should only allow monospace fonts in its font menu.
  1020.  
  1021. Selecting a different font in the Terminal window tends to change the font
  1022. used in other windows to a random font -- probably not the one that was there
  1023. before, and not the one you chose.
  1024.  
  1025. Selecting the Chicago font doesn't work at all (a mystery).
  1026.  
  1027. Another font anomaly...  PROBLEM:
  1028.  
  1029. [A user with] Mac Kermit 0.99(188), display is using 24 point Palatino.  I
  1030. used ResEdit and looked inside your FONT resource and found that the 9 point
  1031. VT100 font has an ID of 16393.  As it turns out, her 24 point Palatino has the
  1032. same id.  I gave the 24 point Palatino a different ID and restarted her Mac
  1033. but the problem persists.  She has a Mac IIfx running System 7.0.1.
  1034.  
  1035. This wasn't a problem until recently when someone "turned on" the password
  1036. feature of her After Dark and didn't tell her the password.  I had to crash
  1037. the Mac and reboot with extensions off and reinstalled After Dark.  Upon
  1038. restarting after the reinstall of After Dark, the Mac crashed and refused to
  1039. startup again.  I reinstalled System 7.01 and the Mac boots fine but now
  1040. we've got this font problem.
  1041.  
  1042. SUGGESTED SOLUTION:
  1043.  
  1044.  0.  Recheck Palatino to make sure the change stuck.
  1045.  1.  Drag the Palatino fonts out of the System.
  1046.  2.  Copy the vt100 font from Kermit into the System.
  1047.  3.  Drag Palatino back into the System.
  1048.      This should assign new id's to Palatino
  1049.  
  1050. RESOLUTION:
  1051.  
  1052. Oddly, that didn't work.  The Palatino did change (to ID 1777).  I trashed the
  1053. Palatino fonts, copied the VT100 font and reinstalled the Palatino fonts.  The
  1054. Palatino fonts now have id's in the 5000 range.  I still got 24 point Palatino
  1055. on the display.  I then changed the VT100 font to ID 16666 and that did the
  1056. trick.  KERMIT displays fine now.
  1057.  
  1058. USING CYRILLIC CHARACTER SETS IN TERMINAL EMULATION
  1059.  
  1060. [Note: The following user submission only addresses how to display Cyrillic
  1061. characters, not how to enter them on the keyboard.]
  1062.  
  1063. Date: Thu, 12 May 1994 15:24:44 -0400 (EDT)
  1064. From: Steven Lee Solnick <sls27@columbia.edu>
  1065.  
  1066. Several months ago we corresponded on how to read KOI-8 encoded text (from the
  1067. Relcom bulletin boards on Usenet) on a Mac with MacKermit.  Turns out the
  1068. missing link is a file (koi7-koi8.hqx, or something like that) available in
  1069. the Font directory on the Info-Mac archives.  It contains the necessary font
  1070. suitcase for KOI-7 and KOI-8 text.  With that in the system, relcom text can
  1071. be read with the following steps:
  1072.  
  1073.  - Terminal Set to "Accept 8-bit characters"
  1074.  
  1075.  - Character Set to ISO Latin 1 (won't work on the DEC setting)
  1076.  
  1077.  - Change font to KOI8-Russian, 9 pt.  This displays both English and Cyrillic
  1078.    characters.
  1079.  
  1080. This procedure works for both rn (through UNIX) AND on the Usenet menus.
  1081.  
  1082.  
  1083. APPENDIX I: Excerpts from Info-Kermit Digest V16 #4
  1084.  
  1085. Date: Sun, 18 Oct 1992 23:19:55 -0700 (PDT)
  1086. From: Les Ferch <ferch@ucs.ubc.ca>
  1087. Subject: MacKermit on Mac Plus
  1088.  
  1089. I noticed a couple of minor problems with MacKermit on a Mac Plus.
  1090.  
  1091. 1. Using "Set modifiers..." I set Option to act as Ctrl.  However, it does
  1092. not work.  To get a Ctrl key, I have to set Command to act as Ctrl and turn
  1093. off Menu Keys.  It would be nice to be able to keep Menu Keys and use
  1094. Option as Ctrl.
  1095.  
  1096. [Ed. - To use the Option key as a Ctrl key, you have to check the Opt box
  1097. on the left side of the Set Modifiers dialog, and you also have to check
  1098. both Unmodify and Ctrl on the right side, in the same row.  See ckmker.bwr.]
  1099.  
  1100. 2. The File menu is longer than the 9" screen.  This confuses beginners
  1101. looking for Quit.  If Load Settings and Save Settings were moved to the
  1102. Settings menu, the problem would be solved.
  1103.  
  1104. [Ed. - A well-known problem.  The menus need a lot of work.]
  1105.  
  1106. ------------------------------
  1107.  
  1108. Date: Tue, 20 Oct 92 10:29:40 EST
  1109. From: Howie Richburg <RICHBUHJ%SNYCENVM@CUVMB.CC.COLUMBIA.EDU>
  1110. Organization: State University of New York - Central Administration
  1111. Subject: Re: MacKermit?
  1112.  
  1113. Maybe I am doing something wrong.  Under settings I choose key settings.
  1114. The scan codes I define such as {27}3, when executed are passed through to
  1115. the terminal screen as #27'3 for example and not transmitted.  Any ideas?
  1116.  
  1117. [Ed. - Presently, the backslash notation in Mac Kermit's key definitions
  1118. only accepts octal (base 8) numbers, and no provision is made for grouping.
  1119. Suppose you want to define a key to send ESC followed by the letter A.  In
  1120. MS-DOS Kermit or C-Kermit, you would express this as \27A, \o33A, or \x1BA.
  1121. In Mac Kermit, it must be \33A.  Now suppose you want to send ESC followed
  1122. by the digit 3.  You can't write \273, because there would be no way to tell
  1123. where the backslash code ended and the literal text began.  In MS-DOS or
  1124. C-Kermit, you can write \{27}3, to separate the 27 from the 3.  Mac Kermit
  1125. doesn't support this type of notation, so you have to write \33\63 (where 63
  1126. is the octal value of the ASCII code for the character "3"), and so on until
  1127. you reach the first non-numeric character or the end of the definition.
  1128. Hopefully, a future release of Mac Kermit will support the same types of
  1129. notation as MS-DOS Kermit and C-Kermit.]
  1130.  
  1131. Do you think MacKermit is stable enough to use for a Mac Powerbook running
  1132. System 7?
  1133.  
  1134. [Ed. - We have received mixed reviews.  The main difficulty with Mac Kermit
  1135. under System 7 actually has nothing to do with System 7 per se, but rather
  1136. with the fact that Macs that have System 7 also tend to be loaded with lots
  1137. of INITs.  Macs with all their INITs are becoming even more dangerous for
  1138. communication software than PCs loaded with TSRs!  We have discovered that
  1139. most INITs that have anything to do with font management -- Adobe Type
  1140. Manager, SuitCase, TrueType, etc -- can interfere with Mac Kermit to various
  1141. degrees, ranging from fractured screens to Mac Kermit or even system bombs.
  1142. This probably happens because Mac Kermit uses its own internal font for
  1143. terminal emulation.  We know the solution to this problem -- remove the
  1144. internal font and make an external font suitable for VT320 emulation -- but
  1145. it is taking a long time to accomplish it.]
  1146.  
  1147. [Ed again - About the Powerbook.  Mac Kermit works as well on the Powerbook
  1148. as it works on any other Mac, except for one obvious limitation (bug).  The
  1149. Powerbook does not normally come with a modem port, only a printer port.
  1150. Thus you have to choose the printer port in the Communications Settings
  1151. menu, which works.  So far so good.  But the port selection is not saved
  1152. when you Save Settings.  So you always have to open the communications menu
  1153. and select the printer port every time you run Kermit on the Powerbook.
  1154. This should be fixed soon.]
  1155.  
  1156. In addition the Powerbook will be used to dial into a 3270 protocol
  1157. converter to access our IBM host.  It will therefore require that certain
  1158. key combinations submit specific codes to emulate PF keys.  The reason I ask
  1159. is because I have no luck transmitting codes to emulate the PF keys.
  1160.  
  1161. [Ed. - This is an extremely common question, but it does not have a general
  1162. answer.  Here's the story: an IBM mainframe 3270 terminal has row upon row
  1163. of "PF" keys that ordinary terminals don't have.  The operation of these
  1164. keys is internal to the IBM 3270 protocol -- they don't send characters,
  1165. they send signals or messages, or perform certain local functions, etc.  A
  1166. 3270 protocol converter -- such as an IBM 7171 -- lets ordinary ASCII
  1167. terminals (or programs, like Kermit, that emulate them) interact with
  1168. mainframe 3270 applications.  Data sent from the mainframe to the terminal
  1169. is converted into (for example) ASCII text intermixed with VT100 escape
  1170. sequences, so your screen looks right.  So far so good.  In the other
  1171. direction, certain control characters or escape sequences coming from your
  1172. keyboard are interpreted as PF keys.  The problem is, no two protocol
  1173. converters, no two protocol-converter terminal-type configurations, no two
  1174. sites, have the same idea of exactly which control characters or escape
  1175. sequences should correspond to which PF keys.  WE CAN'T ANSWER THAT
  1176. QUESTION.  You have to go to your IBM mainframe or IBM networking
  1177. administrator and find out: for a particular terminal type (say VT100), what
  1178. characters or sequences must the terminal or emulator send to simulate EACH
  1179. of: the PF1 through PF24 keys; the PA1 through PA3 keys; the newline key,
  1180. the cursor keys, backtab, the editing keys, the Attention key, etc etc.
  1181. Once you have the table of 30 keys and their values, you can decide which
  1182. keys on your Mac should correspond to which 3270 terminal keys, and then
  1183. assign the corresponding character or escape sequence to each one in a
  1184. Set Key Macros dialog -- a long and tedious exercise, which is best done
  1185. once at each site centrally.  A Mac Kermit 3270 settings file is created,
  1186. put on a file server, or copied onto diskette or and passed around.  In a
  1187. future release, we hope to support plain-text key settings files like MS-DOS
  1188. Kermit or C-Kermit.]
  1189.  
  1190. ------------------------------
  1191.  
  1192. Date: Tue, 20 Oct 92 16:57:53 +0100
  1193. From: johnen@GEI-Aachen.de (Uwe Johnen)
  1194. Subject: Kermit on Mac
  1195.  
  1196. I was very amused that I can use my Apple Powerbook as a terminal (vt100)
  1197. over the V24 modem port. 
  1198.  
  1199. But using Word Perfect on our VAX I was searching for the function keys,
  1200. which I have to use while working with WP.
  1201.  
  1202. If you have any idea where they are please let me know. I thing I tried
  1203. everything. Which one tried I not ?
  1204.  
  1205. [Ed. - Here is another case where you must go through the long and laborious
  1206. process of making many, many key assignments.  VAX WordPerfect assignments
  1207. have already been done for MS-DOS Kermit in the file kermit/a/msiwp3.ini,
  1208. which contains 126 SET KEY commands!  Unfortunately: (a) the keyboard scan
  1209. codes of the Macintosh are different from those of the PC, and (b) there is
  1210. not yet a way to import textual SET KEY commands into Mac Kermit.  As noted
  1211. above, hopefully there will be a textual SET KEY command in a forthcoming
  1212. release.]
  1213.  
  1214. ------------------------------
  1215.  
  1216. Date: Thu, 29 Oct 92 08:47:23 PST
  1217. From: John Holland <ZZHOLAND@UVVM.UVic.CA>
  1218. Subject: Re: 0.99(97) Bug Report
  1219.  
  1220. I reported some problems with Mac Kermit 0.99(97).  Since then I have
  1221. obtained 183, and later 184, from watsun.cc.columbia.edu.
  1222.  
  1223. I now use Mac Kermit as my terminal emulator of choice in my daily work,
  1224. connected to a mainframe at 9600 baud, using a Mac Plus.  Commercial
  1225. products, like Microphone and White Knight, seem to be assuming a slower
  1226. connection and do not refresh the screen as quickly as I would like.  Kermit
  1227. refreshes the screen quickly, and allows me to copy and paste and to move
  1228. the cursor around with the mouse (and type without having to wait for the
  1229. cursor to arrive at its destination).
  1230.  
  1231. One of the problems I noted before is no longer a problem.
  1232.  
  1233. I couldn't save settings without a system bomb.  No problem now.
  1234. However, if I set Mouse -> Arrow Keys in Terminal... under Settings,
  1235. I still can't turn it off.
  1236.  
  1237. [Ed. - Sure enough, it's a bug.  The X disappears from the check box, but
  1238. the feature is not turned off.  If you bring back the Terminal Settings
  1239. screen, the box is checked again.]
  1240.  
  1241. A new problem is related to fonts. I use Courier 10 point.  When the
  1242. text I am working on is bolded and I delete characters from the middle
  1243. of the line, pulling the rest of the line in, a trail of dots is sometimes
  1244. left.  I demonstrated this to myself by typing a row of bold WWWWWWs, then
  1245. deleting the leftmost one a few times. The rightmost pixel in the rightmost
  1246. character remains on the screen. This is a cosmetic bug which I am
  1247. happily living with, given the other benefits of Kermit.
  1248.  
  1249. [Ed. - Coexistence with fonts and font managers, and other font related
  1250. problems (of which the one you list is a very minor example), are perhaps
  1251. Mac Kermit's biggest problem at present.  It is described -- and a solution
  1252. proposed -- in the files kermit/sw/ckmker.bwr and kermit/sw/ckmker.fon.]
  1253.  
  1254. ------------------------------
  1255. OTHER USER REPORTS
  1256.  
  1257. From: JJSTEP00@ukcc.uky.edu (Jason Stephenson)
  1258. Newsgroups: comp.protocols.kermit.misc
  1259. Subject: Re: Hangup on receive
  1260. Date: Mon, 06 Nov 95 13:12:59 EST
  1261. Organization: The University of Kentucky
  1262.  
  1263. Answering my question (about file transfer failures)...
  1264. In article <47de00$q7a@gateway.dircsa.org.au>
  1265. arthur@gateway.dircsa.org.au (Arthur Marsh) writes:
  1266. >
  1267. >Have you tried getting your modem to ignore DTR (&D0), and consulted with Mac
  1268. >modem experts on settings, hardware-handshaking cables and the like?
  1269.  
  1270. I solved this problem over the weekend.  It involves turning off the
  1271. "Teleport" INIT that came with my modem.  Seems it does some strange things
  1272. when the serial port opens.  I still have other problems with downloading
  1273. but have narrowed that down to bad phone lines and crappy modems on the
  1274. other end of the connection.  Seems the University has some 9600 baud modems
  1275. on the verge of expiration.  Z-Modem doesn't like downloading from other
  1276. servers when I dial in to the same modem pool.  Kermit doesn't work, either,
  1277. for file transfers if I get a bad modem.  Works great in terminal emulation,
  1278. though.
  1279.  
  1280. [Ed. That's strange.  Could it be a transparency problem with the terminal
  1281. server or modem?  Are you using any control-character unprefixing?  If so, do
  1282. Kermit transfers work when you tell the file sender to "set control prefix
  1283. all"?]
  1284.  
  1285. I do have one other comment to add concerning the internals of Mac-Kermit:
  1286. I was downloading a 4 Meg file the other day (actually got a decent connection)
  1287. and when I had about ten minutes of transfer left, my machine locked up.  I
  1288. diagnosed the problem to be memory related (stack running into the heap).
  1289. This kind of thing happens when to many static variables collide with too
  1290. many calls to malloc.  The short term solution is to give MacKermit a huge
  1291. (over 1 Meg) partition when you plan to download large files.  The long term
  1292. solution is to change the memory allocation scheme in the ckc*.c file[s]
  1293. (don't remember which one) to work with the idiosyncracies of Macintosh
  1294. memory management.  But that would mean "more #ifdefs galore," to borrow a
  1295. line from our fearless leader, FDC.
  1296.  
  1297. [Ed. - Wheee.  Aren't malloc's supposed to safe with respect to stack and
  1298. heap?  Or at least guaranteed to fail if they can't get the expected memory?
  1299. Any idea what to put in the #ifdef's?]
  1300.  
  1301. ------------------------------
  1302.  
  1303.  
  1304. APPENDIX II: MENU DESIGN (DRAFT!)
  1305.  
  1306. Top-level menu:
  1307. ------------------------------------------------------------
  1308. File  Edit  Settings  Special  Transfer  Window
  1309. ------------------------------------------------------------
  1310.  
  1311. File
  1312. ------------------------------
  1313. New                           
  1314. Open...                       
  1315. Close                         
  1316. Save                          
  1317. Save As...                    
  1318. ------------------------------
  1319. Take Command File...          
  1320. Take Commands from Window      
  1321. ------------------------------
  1322. Page Setup...
  1323. Print Screen...
  1324. Print Selection...
  1325. Log Session to Printer...
  1326. Cancel Printing
  1327. (Printer buffer status?)
  1328. ------------------------------
  1329. Chain to Application...
  1330. Quit                          
  1331. ------------------------------
  1332.  
  1333. The Page Setup dialog should include a section that tells what to do
  1334. with host-initiated printing (transparent print or autoprint):
  1335. ------------------------------
  1336. (x) Send to printer
  1337. ( ) Save in Printer window
  1338. ( ) Save in file...
  1339. ( ) Discard
  1340. ------------------------------
  1341.  
  1342.  
  1343. Edit
  1344. ------------------------------
  1345. Undo
  1346. ------------------------------
  1347. Cut
  1348. Copy
  1349. Paste
  1350. Clear
  1351. Select All
  1352. ------------------------------
  1353.  
  1354.  
  1355. Settings                      
  1356. ------------------------------
  1357. Load Settings...              
  1358. Save Settings...              
  1359. ------------------------------
  1360. Communications...             
  1361. Kermit Protocol...                   
  1362. File Transfer Defaults...              
  1363. File Transfer Character Sets...
  1364. Terminal Characteristics...                   
  1365. Terminal Character Set...              
  1366. ------------------------------
  1367. *-Shift-1..*-Shift-9 Active  
  1368. Menu *-Keys Active            
  1369. Key Macros...             
  1370. Key Modifiers...              
  1371. ------------------------------
  1372.  
  1373.  
  1374. Here is the terminal character sets dialog.  It's sort of an ISO 2022
  1375. tutorial.  The first section "designates" character sets to graphics areas
  1376. G0..G3.  Only one radio button can be pushed in each column, but multiple
  1377. buttons can be pushed in a row.  A 96-byte character set (Latin-1 and DEC 
  1378. MCS are the only ones) may not be designated to G0 (ISO rule).  If Latin-1
  1379. or DEC MCS are chosen, G0 is automatically forced to ASCII.
  1380.  
  1381. The second section "invokes" the selected graphics areas to GL and GR.
  1382. Only one button can pushed in a row.
  1383. -------------------------------------------------------------------
  1384.                     Terminal Character Sets
  1385.  
  1386.                        G0   G1   G2   G3
  1387. US ASCII               (x)  ( )  ( )  ( )
  1388. ISO 8859-1 Latin-1          (x)  ( )  ( )  <-- Note: No G0 here (dim)
  1389. DEC Special Graphics   ( )  ( )  (x)  ( )
  1390. DEC Technical          ( )  ( )  ( )  (x)
  1391. DEC Multinational           ( )  ( )  ( )  <-- Note: No G0 here (dim)
  1392. British/UK             ( )  ( )  ( )  ( )
  1393. Canadian French        ( )  ( )  ( )  ( )
  1394. Dutch                  ( )  ( )  ( )  ( )
  1395. Finnish                ( )  ( )  ( )  ( )         
  1396. French                 ( )  ( )  ( )  ( )
  1397. German                 ( )  ( )  ( )  ( )
  1398. Italian                ( )  ( )  ( )  ( )
  1399. Norwegian/Danish       ( )  ( )  ( )  ( )
  1400. Portuguese             ( )  ( )  ( )  ( )
  1401. Spanish                ( )  ( )  ( )  ( )
  1402. Swedish                ( )  ( )  ( )  ( )
  1403. Swiss                  ( )  ( )  ( )  ( )
  1404. -------------------------------------------------------------------
  1405. Graphics Left  (GL):   (x)  ( )  ( )  ( )
  1406. Graphics Right (GR):   ( )  (x)  ( )  ( )
  1407. -------------------------------------------------------------------
  1408.  
  1409.  
  1410. For file transfer character sets, the "Language rules" apply only
  1411. if ASCII is checked in one (not zero or two) of the first two
  1412. columns), otherwise the language rules buttons should be dim.
  1413. -------------------------------------------------------------------
  1414.                   File Transfer Character Sets
  1415.  
  1416. File Character Set   Transfer Character Set    Language rules
  1417.  
  1418. (x) Apple Quickdraw  (x) Transparent           (x) None
  1419. ( ) ASCII            ( ) ASCII                 ( ) Dutch
  1420. ( ) ISO Latin-1      ( ) ISO Latin-1           ( ) French
  1421.                                                ( ) German
  1422.                                                ( ) Icelandic
  1423.                                                ( ) Scandinavian
  1424. -------------------------------------------------------------------
  1425.  
  1426.  
  1427. THE COMMUNICATIONS SETTINGS DIALOG
  1428.  
  1429. Here we need a couple changes in terminology:
  1430.  
  1431. 1. "Baud Rate" is "incorrect".  It should say "Transmission speed" or
  1432.    "Transmission Rate", or (if that's too long), simply "Speed".
  1433.  
  1434. 2. "Drop DTR on Quit" is obscure.  It should say "Hangup on Quit".
  1435.  
  1436.  
  1437. FILE SETTINGS DIALOG:
  1438. -------------------------------------------------------------------
  1439. ( ) Attended: dialog on each file received
  1440. (x) Unattended: with the following defaults:
  1441.  
  1442. File Names:           (x) Converted  ( ) Literal
  1443.  
  1444. Filename Collisions:  (x) Backup     ( ) Append
  1445.                       ( ) Discard    ( ) Overwrite
  1446.                       ( ) Rename     ( ) Update
  1447.  
  1448. [  ] Keep partially received files
  1449.  
  1450. Transfer Mode: (x) Text        Fork: (x) Data
  1451.                ( ) Binary            ( ) Resource
  1452.                ( ) MacBinary
  1453. -------------------------------------------------------------------
  1454.  
  1455.  
  1456. THE TERMINAL SETTINGS DIALOG
  1457.  
  1458. Change "[  ] Accept 8 Bit Characters" to:
  1459.  
  1460.   Character size: (x) 7 bits  ( ) 8 bits
  1461.  
  1462.  
  1463. THE PROTOCOL SETTINGS DIALOG (OK)
  1464.  
  1465.  
  1466. THE SPECIAL MENU:
  1467.  
  1468. Special                       
  1469. ------------------------------
  1470. Hangup
  1471. Send Break                    
  1472. Send Long Break               
  1473. Send XON                      
  1474. Reset Terminal                
  1475. ------------------------------
  1476. Log Session...                
  1477. Dump Screen...
  1478. Log Transactions...           
  1479. Log Packets...                
  1480. Log Debugging...              
  1481. Call Debugger...                 (dim if no debugger loaded)
  1482. ------------------------------
  1483.  
  1484.  
  1485. THE TRANSFER (File Transfer) MENU:
  1486.  
  1487. Transfer
  1488. ------------------------------
  1489. Send file...
  1490. Receive file...
  1491. Get file from server...
  1492. ------------------------------
  1493. Show statistics
  1494. ------------------------------
  1495. Change directory
  1496. ------------------------------
  1497. Change remote directory
  1498. Delete remote file...
  1499. List remote files...
  1500. Remote help
  1501. Remote host command...
  1502. Remote Kermit command...
  1503. Remote space...
  1504. Remote type...
  1505. Remote who...
  1506. Send file to server for printing...
  1507. ------------------------------
  1508. Finish server
  1509. Logout server
  1510. ------------------------------
  1511. Enter server mode
  1512. ------------------------------
  1513.  
  1514. THE WINDOW MENU
  1515.  
  1516. Lists the names of the windows.  It should be modified to check or
  1517. highlight the currently active window.  Assuming that font changes can
  1518. be made to work in all windows, we should move the Font item to here,
  1519. and have it invoke a submenu, applying to the current (checked) window
  1520. (the whole window?  A selection within a window?)  (We have to move
  1521. the Font menu because there isn't enough room for 7 menu items in the
  1522. top-level menu.)
  1523.  
  1524. For example: 
  1525.  
  1526.   Window
  1527.   ------------------------------
  1528. X Terminal Window                (X = checked)
  1529.   Command Window
  1530.   Response Window
  1531.   Untitled-1
  1532.   ------------------------------
  1533.   Font                        -> ------------------------------
  1534.   ------------------------------ 9-point
  1535.                  10-point
  1536.                  12-point
  1537.                  14-point
  1538.                  18-point
  1539.                  ------------------------------
  1540.                  Avant Garde
  1541.                  Bartholomew
  1542.                  Bookman
  1543.                  Chicago
  1544.                  (etc)
  1545.                  ------------------------------
  1546.  
  1547.  
  1548. APPENDIX III: SOURCE CODE
  1549.  
  1550. Macintosh Kermit is written in C.  The modules whose names start with "ckm"
  1551. are specific to the Macintosh.  These can be C source code (.c), header files
  1552. for #include (.h), or resource files (.r).  The makefile is ckmker.mak, which
  1553. you should rename to kermit.make for use in MPW.  The modules whose names
  1554. start with "ckc" or "cku" are shared with other C-Kermit implementations:
  1555. UNIX, VMS, OS/2, Amiga, OS-9, etc.
  1556.  
  1557. This version of Mac Kermit can be built using only MPW C 3.2 Final (NOT 3.0
  1558. or 3.1, and not any Beta version of 3.2) on the Macintosh.  MPW 3.2 is
  1559. required because Mac Kermit needs more than 32K of uninitialized global data
  1560. space, and the limit in MPW 3.1 and earlier is 32K.  It is probably not
  1561. possible to reduce the size of the uninitialized global data area by more than
  1562. about 3-4 more K (by converting array declarations to pointers and then
  1563. mallocing the space at runtime), so we can't get below 32K, so therefore we
  1564. must use the new MPW C 3.2 "32-bit everything" model ("-model far").
  1565.  
  1566.   NOTE TO DEVELOPERS: References to the Pattern data type have to be changed
  1567.   to fit MPW 3.2's new redefinition (which, they say, was done to eliminate
  1568.   crashes on 68000-based CPUs).  See quickdraw.h and Appendix J of the 3.2
  1569.   Release Notes.  When this is done, remove "-d dangerousPattern" from the C
  1570.   command line in the makefile.
  1571.  
  1572. As of edit 190, Mac Kermit should also be buildable under Think C 5.0; see the
  1573. ckmmak.hlp file for details.  However, there are still a few kinks to be
  1574. worked out.
  1575.  
  1576. Many of the source files contain 8-bit characters.  Make sure you have
  1577. transferred them to your Mac correctly.  Use text mode, but make sure
  1578. character translation is turned off.  Also, many of the ckm*.* files have
  1579. lines longer than 80, which can prevent them from being transferred via
  1580. certain kinds of e-mail (such as BITNET).
  1581.  
  1582.   NOTE TO DEVELOPERS: These source files need to be edited to ensure that
  1583.   all lines are less than 80 characters wide (after tab expansion), and
  1584.   8-bit characters are all converted to "\ooo" ASCII octal notation (I tried
  1585.   using the \266 (delta) line continuation character in the kermit.make file
  1586.   to break up long lines, but it didn't seem to work.)  The final release
  1587.   source code should contain only 7-bit ASCII characters, and no lines
  1588.   longer than 80.
  1589.  
  1590. Btw, there is something in the MPW 3.2 release notes that says how
  1591. signal(SIGINT,xxx) can be used to catch "Command-.".
  1592.  
  1593. (End of CKMKER.BWR)
  1594.