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

$Id: README.mac,v 1.6 2002/12/30 23:15:46 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:

 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).

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
b2b8c9ca	1	$Id: README.mac,v 1.6 2002/12/30 23:15:46 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
	35	PuTTY should run on any Macintosh running System 7.0 or later. The
	36	Classic 68K build seems not to run under Mac OS X (even with
	37	Classic.app).
	38
	39	Known bugs:
	40
	41	* PowerPC and fat versions fail to start on systems without AppearanceLib (ie
	42	most System 7 ones). The 68k version works fine. [MAYBE FIXED]
	43	* Display is far too slow.
	44	* Real bold doesn't compensate for changing character widths without Color
	45	QuickDraw. [MAYBE FIXED]
	46	* sshsha.c and sshmd5.c cause a stack overflow in Apple's PowerPC C compiler
	47	unless optimisation is entirely disabled.
	48
	49	Features we need (and aren't entirely obvious):
	50
	51	* Scroll-conflation -- scroll_display should change the in-memory
	52	display and remember the scroll, then do_scroll should be called
	53	only when scroll_display gets called for a different rectangle or
	54	term_paint happens.
	55
	56	Local Variables:
	57	mode: text
	58	End: