-$Id: README.mac,v 1.1 2002/12/11 18:34:49 ben Exp $
+$Id$
Information about PuTTY for the Mac OS
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
+This is a port of PuTTY to the Classic Mac OS. It is a work in
+progress and should be considered unfinished and insecure. It is
+not considered to be of release quality, even if you found it (and
+you're reading this) in a PuTTY release source archive. Unless you
+know what you're doing, don't use it.
+
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>
+ Install this in the usual way.
+
+ Universal Headers
+ <ftp://ftp.apple.com/developer/Development_Kits/
+ UniversalHeaders3.4.2.img.bin>
+ Install using the script in "Documentation:MPW Users - ReadMe".
+
+ Text Encoding Converter SDK
+ <ftp://ftp.apple.com/developer/Development_Kits/TEC_1.5.sit.hqx>
+ Copy contents of "68K Static Libraries" to
+ "Interfaces&Libraries:Libraries:Libraries".
+ Copy contents of "Stub Libraries" to
+ "Interfaces&Libraries:Libraries:SharedLibraries".
+
+ CarbonStdCLib.o
+ <ftp://ftp.apple.com/developer/Tool_Chest/Core_Mac_OS_Tools/
+ MPW_Website_Downloads/CarbonStdCLib.o-3.8d3.hqx>
+ Copy contents of "CIncludes" to
+ "Interfaces&Libraries:Interfaces:CIncludes".
+ Copy contents of "PPCLibraries" to
+ "Interfaces&Libraries:Libraries:PPCLibraries".
+
+ 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. The Carbon build doesn't work yet.
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.
- * PowerPC and fat versions fail to start on systems without AppearanceLib (ie
- most System 7 ones). The 68k version works fine. [MAYBE FIXED]
+ The Carbon build of PuTTY (when it works) should work on any Power
+ Macintosh with CarbonLib (and Mac OS 8.1 or later), Mac OS 9 or
+ Mac OS X installed.
+
+Known bugs:
* 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.
+ * When the last terminal window closes, the Edit menu doesn't get disabled
+ immediately, which it should.
+ * When using the "VT100" font, text copied to the clipboard doesn't
+ get newlines in it, because that font has a graphic character at
+ position 0x0d. Even if we did insert 0x0d manually, TextEdit
+ insists on displaying the graphic version, so I think we need a
+ font switch at this point. This can be seen as a special case of
+ the need to switch fonts to get odd characters.
+ * Pasting large blocks of text doesn't work.
+ * The host key database is currently limited by its implementation to
+ 2727 host keys.
-Features we need (and aren't entirely obvious):
+Unimplemented features (should be done before release):
+ * TCP urgent data.
+ * Listening sockets.
+ * Changing font size in reponse to resize requests.
+ * Full screen mode.
+ * Session configuration.
+ * Entropy collection.
+ * Private key files.
+ * Pageant and PuTTYgen.
+ * Do something with Open Application Apple Events.
+ * Close-on-exit.
+ * Warn-on-quit.
+ * Non-block cursors.
- * 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' paste, for script codes.
+ * Handle 'gurl' Apple Events.
Local Variables:
mode: text