Update to match reality.
[u/mdw/putty] / mac / README.mac
1 $Id: README.mac,v 1.24 2003/02/02 16:02:50 ben Exp $
2
3 Information about PuTTY for the Mac OS
4 -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
5
6 Compiling it:
7
8 See ../README for generic information.
9
10 To compile PuTTY for Mac OS you will need:
11
12 MPW
13 <ftp://ftp.apple.com/developer/Tool_Chest/Core_Mac_OS_Tools/MPW_etc./
14 MPW-GM_Images/MPW-GM.img.bin>
15
16 Universal Headers (optional)
17 <ftp://ftp.apple.com/developer/Development_Kits/
18 UniversalHeaders3.4.2.img.bin>
19
20 Text Encoding Converter SDK
21 <ftp://ftp.apple.com/developer/Development_Kits/TEC_1.5.sit.hqx>
22
23 Install MPW, install the new Universal Headers (optional), then put
24 the contents of the "68K Static Libraries" directory of the Text
25 Encoding Converter SDK into "Interfaces&Libraries:Libraries:Libraries",
26 and the contents of the "Stub Libraries" directory into
27 "Interfaces&Libraries:Libraries:SharedLibraries".
28
29 The "mkputty.mpw" script does all the work, and currently producess a
30 Classic 68K build of PuTTY called "PuTTY.68k", a non-Carbon PowerPC
31 build called "PuTTY.ppc", and similar builds of PuTTYtel called
32 "PuTTYtel.68k" and "PuTTYtel.ppc". The CFM-68K build is currently
33 disabled because it overflows the global data space and I can't work
34 out how to stop this happening. The Carbon build doesn't work yet.
35
36 Runtime requirements:
37
38 The Classic 68K build of PuTTY should work on any Macintosh running
39 System 7.0 or later. It runs in the Classic environment in Mac OS X.
40
41 The CFM-68K build of PuTTY should work on any Macintosh with a 68020,
42 68030 or 68040 processor and with either the CFM-68K Runtime Enabler
43 or Mac OS 7.6.1 or later installed.
44
45 The PowerPC build of PuTTY should work on any Power Macintosh. It
46 runs in the Classic environment in Mac OS X.
47
48 The Carbon build of PuTTY (when it works) should work on any Power
49 Macintosh with CarbonLib (and Mac OS 8.1 or later), Mac OS 9 or
50 Mac OS X installed.
51
52 Known bugs:
53 * Display is far too slow.
54 * Real bold doesn't compensate for changing character widths without Color
55 QuickDraw. [MAYBE FIXED]
56 * Compiling ssh.c using SC 8.8.4 with "-opt time" causes SSH1
57 connections to fail with "Incorrect CRC received on packet". Using
58 "-opt none" works around this.
59 * When the last terminal window closes, the Edit menu doesn't get disabled
60 immediately, which it should.
61 * When using the "VT100" font, text copied to the clipboard doesn't
62 get newlines in it, because that font has a graphic character at
63 position 0x0d. Even if we did insert 0x0d manually, TextEdit
64 insists on displaying the graphic version, so I think we need a
65 font switch at this point. This can be seen as a special case of
66 the need to switch fonts to get odd characters.
67 * Pasting large blocks of text doesn't work.
68
69 Unimplemented features (should be done before release):
70 * TCP urgent data.
71 * Listening sockets.
72 * Clipping host resize requests to screen size.
73 * Changing font size in reponse to resize requests.
74 * Full screen mode.
75 * Session configuration.
76 * Host key database.
77 * Entropy collection.
78 * Private key files.
79 * Pageant and PuTTYgen.
80 * Do something with Open Application Apple Events.
81 * Warn-on-close.
82 * Close-on-exit.
83 * Warn-on-quit.
84 * Event log.
85 * Flashing things.
86 * Non-block cursors.
87
88 Wishlist (after release):
89 * SFTP client (GUI?)
90 * Carbon compatibility (requires Open Transport and Navigation Services).
91 * 'styl' paste, for script codes.
92 * Handle 'gurl' Apple Events.
93
94 Local Variables:
95 mode: text
96 End: