X-Git-Url: https://git.distorted.org.uk/u/mdw/putty/blobdiff_plain/2d8c9dcc0947f111780180948f7b333dbb373a7f..5211281f4c41ec7259121cfd44b476065a20dd35:/mac/README.mac

diff --git a/mac/README.mac b/mac/README.mac
index 2cf6cf0c..1b38c6e6 100644
--- a/mac/README.mac
+++ b/mac/README.mac
@@ -1,4 +1,4 @@
-$Id: README.mac,v 1.1 2002/12/11 18:34:49 ben Exp $
+$Id: README.mac,v 1.17 2003/01/25 14:07:50 ben Exp $
 
 Information about PuTTY for the Mac OS
 -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
@@ -7,34 +7,82 @@ Compiling it:
 
  See ../README for generic information.
 
- I compile PuTTY using MPW, with Universal Headers 3.4.2.  The
- "mkputty.mpw" script does most of the work, but currently needs you
- to run "Rez -append -o PuTTY mac_res.r {Includes}" to get the
- resources compiled in.  The Makefile currently only generates a
- Classic 68K application.  Other architectures will come later.
+ To compile PuTTY for Mac OS you will need:
+
+ MPW
+  <ftp://ftp.apple.com/developer/Tool_Chest/Core_Mac_OS_Tools/MPW_etc./
+   MPW-GM_Images/MPW-GM.img.bin>
+
+ Universal Headers (optional)
+  <ftp://ftp.apple.com/developer/Development_Kits/
+   UniversalHeaders3.4.2.img.bin>
+
+ Text Encoding Converter SDK
+  <ftp://ftp.apple.com/developer/Development_Kits/TEC_1.5.sit.hqx>
+
+ 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",
+ and the contents of the "Stub Libraries" directory into
+ "Interfaces&Libraries:Libraries:SharedLibraries".
+
+ 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:
 
- 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.
 
-Known bugs:
+ 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:
  * PowerPC and fat versions fail to start on systems without AppearanceLib (ie
    most System 7 ones).  The 68k version works fine. [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.
+ * 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.
+ * When the last terminal window closes, the Edit menu doesn't get disabled
+   immediately, which it should.
 
-Features we need (and aren't entirely obvious):
+Unimplemented features (should be done before release):
+ * TCP urgent data.
+ * Listening sockets.
+ * Clipping host resize requests to screen size.
+ * Changing font size in reponse to resize requests.
+ * Full screen mode.
+ * 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.
+ * Do something with Open Application Apple Events.
+ * Warn-on-close.
+ * Close-on-exit.
+ * Warn-on-quit.
+ * Event log.
+ * Duplicate session.
 
- * 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.
+Wishlist (after release):
+ * SFTP client (GUI?)
+ * Carbon compatibility (requires Open Transport and Navigation Services).
+ * 'styl' copy (and paste, for script codes?).
+ * Handle 'gurl' Apple Events.
 
 Local Variables:
 mode: text