[u/mdw/putty] / mac / README.mac

$Id: README.mac,v 1.12 2003/01/20 01:07:13 ben Exp $

Information about PuTTY for the Mac OS
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

Compiling it:

 See ../README for generic information.

 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:

 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:

 * 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]
 * 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
End:
Commit	Line	Data
311ab105	1	$Id: README.mac,v 1.12 2003/01/20 01:07:13 ben Exp $
2d8c9dcc	2
	3	Information about PuTTY for the Mac OS
	4	-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
	5
	6	Compiling it:
	7
	8	See ../README for generic information.
	9
8768ce31	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
c1324500	25	Encoding Converter SDK into "Interfaces&Libraries:Libraries:Libraries",
	26	and the contents of the "Stub Libraries" directory into
	27	"Interfaces&Libraries:Libraries:SharedLibraries".
8768ce31	28
b2b8c9ca	29	The "mkputty.mpw" script does all the work, and currently producess a
311ab105	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.
2d8c9dcc	35
	36	Runtime requirements:
	37
951d14e5	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.
2d8c9dcc	47
	48	Known bugs:
	49
	50	* PowerPC and fat versions fail to start on systems without AppearanceLib (ie
	51	most System 7 ones). The 68k version works fine. [MAYBE FIXED]
	52	* Display is far too slow.
	53	* Real bold doesn't compensate for changing character widths without Color
	54	QuickDraw. [MAYBE FIXED]
8758669b	55	* Compiling ssh.c using SC 8.8.4 with "-opt time" causes SSH1
	56	connections to fail with "Incorrect CRC received on packet". Using
	57	"-opt none" works around this.
2d8c9dcc	58
311ab105	59	Unimplemented features (should be done before release):
2d8c9dcc	60
d25f9823	61	* TCP urgent data.
19e29403	62	* Clipping host resize requests to screen size.
	63	* Changing font size in reponse to resize requests.
	64	* TEXT copy/paste.
	65	* Catching up with current keyboard mapping in other ports.
19e29403	66	* Session configuration.
311ab105	67	* Filename abstraction (we want to use alias records).
	68	* Host key database.
	69	* Entropy collection.
	70	* Private key files.
	71	* Pageant and PuTTYgen.
	72	* Apple Events.
	73
	74	Wishlist (after release):
	75	* SFTP client (GUI?)
	76	* Carbon compatibility (requires Open Transport and Navigation Services).
	77	* 'styl' copy (and paste, for script codes?).
2d8c9dcc	78
	79	Local Variables:
	80	mode: text
	81	End: