Add minimal Apple Event support -- we handle the 'aevt'/'quit' event.
[sgt/putty] / mac / README.mac
index f7d67dd..c31e8c5 100644 (file)
@@ -1,4 +1,4 @@
-$Id: README.mac,v 1.4 2002/12/29 15:44:15 ben Exp $
+$Id: README.mac,v 1.12 2003/01/20 01:07:13 ben Exp $
 
 Information about PuTTY for the Mac OS
 -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
 
 Information about PuTTY for the Mac OS
 -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
@@ -22,20 +22,28 @@ Compiling it:
 
  Install MPW, install the new Universal Headers (optional), then put
  the contents of the "68K Static Libraries" directory of the Text
 
  Install MPW, install the new Universal Headers (optional), then put
  the contents of the "68K Static Libraries" directory of the Text
- Encoding Converter SDK into "Interfaces&Libraries:Libraries:Libraries".
+ Encoding Converter SDK into "Interfaces&Libraries:Libraries:Libraries",
+ and the contents of the "Stub Libraries" directory into
+ "Interfaces&Libraries:Libraries:SharedLibraries".
 
 
- The "mkputty.mpw" script does most of the work, but currently needs
- you to run "Rez -append -o PuTTY.68k mac_res.r", and the same for
- PuTTY.ppc to get the resources compiled in.
-
- The current Makefile producess a Classic 68K build of PuTTY called
"PuTTY.68k" and a non-Carbon PowerPC build called "PuTTY.ppc".
+ The "mkputty.mpw" script does all the work, and currently producess a
+ Classic 68K build of PuTTY called "PuTTY.68k", a non-Carbon PowerPC
+ build called "PuTTY.ppc", and similar builds of PuTTYtel called
+ "PuTTYtel.68k" and "PuTTYtel.ppc".  The CFM-68K build is currently
+ disabled because it overflows the global data space and I can't work
out how to stop this happening.
 
 Runtime requirements:
 
 
 Runtime requirements:
 
- PuTTY should run on any Macintosh running System 7.0 or later.  The
- Classic 68K build seems not to run under Mac OS X (even with
- Classic.app).
+ The Classic 68K build of PuTTY should work on any Macintosh running
+ System 7.0 or later.  It runs in the Classic environment in Mac OS X.
+
+ The CFM-68K build of PuTTY should work on any Macintosh with a 68020,
+ 68030 or 68040 processor and with either the CFM-68K Runtime Enabler
+ or Mac OS 7.6.1 or later installed.
+
+ The PowerPC build of PuTTY should work on any Power Macintosh.  It
+ runs in the Classic environment in Mac OS X.
 
 Known bugs:
 
 
 Known bugs:
 
@@ -44,15 +52,29 @@ Known bugs:
  * Display is far too slow.
  * Real bold doesn't compensate for changing character widths without Color
    QuickDraw. [MAYBE FIXED]
  * Display is far too slow.
  * Real bold doesn't compensate for changing character widths without Color
    QuickDraw. [MAYBE FIXED]
- * sshsha.c and sshmd5.c cause a stack overflow in Apple's PowerPC C compiler 
-   unless optimisation is entirely disabled.
-
-Features we need (and aren't entirely obvious):
-
- * Scroll-conflation -- scroll_display should change the in-memory
-   display and remember the scroll, then do_scroll should be called
-   only when scroll_display gets called for a different rectangle or
-   term_paint happens.
+ * Compiling ssh.c using SC 8.8.4 with "-opt time" causes SSH1
+   connections to fail with "Incorrect CRC received on packet".  Using
+   "-opt none" works around this.
+
+Unimplemented features (should be done before release):
+
+ * TCP urgent data.
+ * Clipping host resize requests to screen size.
+ * Changing font size in reponse to resize requests.
+ * TEXT copy/paste.
+ * Catching up with current keyboard mapping in other ports.
+ * Session configuration.
+ * Filename abstraction (we want to use alias records).
+ * Host key database.
+ * Entropy collection.
+ * Private key files.
+ * Pageant and PuTTYgen.
+ * Apple Events.
+
+Wishlist (after release):
+ * SFTP client (GUI?)
+ * Carbon compatibility (requires Open Transport and Navigation Services).
+ * 'styl' copy (and paste, for script codes?).
 
 Local Variables:
 mode: text
 
 Local Variables:
 mode: text