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

$Id: README.mac,v 1.7 2003/01/02 18:09:21 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 CFM-68K build called
 "PuTTY.cfm68k", and a non-Carbon PowerPC build called "PuTTY.ppc".

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]
 * 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.

Local Variables:
mode: text
End:
Commit	Line	Data
951d14e5	1	$Id: README.mac,v 1.7 2003/01/02 18:09:21 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
	30	Classic 68K build of PuTTY called "PuTTY.68k", a CFM-68K build called
	31	"PuTTY.cfm68k", and a non-Carbon PowerPC build called "PuTTY.ppc".
2d8c9dcc	32
	33	Runtime requirements:
	34
951d14e5	35	The Classic 68K build of PuTTY should work on any Macintosh running
	36	System 7.0 or later. It runs in the Classic environment in Mac OS X.
	37
	38	The CFM-68K build of PuTTY should work on any Macintosh with a 68020,
	39	68030 or 68040 processor and with either the CFM-68K Runtime Enabler
	40	or Mac OS 7.6.1 or later installed.
	41
	42	The PowerPC build of PuTTY should work on any Power Macintosh. It
	43	runs in the Classic environment in Mac OS X.
2d8c9dcc	44
	45	Known bugs:
	46
	47	* PowerPC and fat versions fail to start on systems without AppearanceLib (ie
	48	most System 7 ones). The 68k version works fine. [MAYBE FIXED]
	49	* Display is far too slow.
	50	* Real bold doesn't compensate for changing character widths without Color
	51	QuickDraw. [MAYBE FIXED]
	52	* sshsha.c and sshmd5.c cause a stack overflow in Apple's PowerPC C compiler
	53	unless optimisation is entirely disabled.
	54
	55	Features we need (and aren't entirely obvious):
	56
	57	* Scroll-conflation -- scroll_display should change the in-memory
	58	display and remember the scroll, then do_scroll should be called
	59	only when scroll_display gets called for a different rectangle or
	60	term_paint happens.
	61
	62	Local Variables:
	63	mode: text
	64	End: