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