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

$Id: README.mac,v 1.4 2002/12/29 15:44:15 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".

 The "mkputty.mpw" script does most of the work, but currently needs
 you to run "Rez -append -o PuTTY.68k mac_res.r", and the same for
 PuTTY.ppc to get the resources compiled in.

 The current Makefile producess a Classic 68K build of PuTTY called
 "PuTTY.68k" 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
f8422c0b	1	$Id: README.mac,v 1.4 2002/12/29 15:44:15 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
	25	Encoding Converter SDK into "Interfaces&Libraries:Libraries:Libraries".
	26
	27	The "mkputty.mpw" script does most of the work, but currently needs
f8422c0b	28	you to run "Rez -append -o PuTTY.68k mac_res.r", and the same for
	29	PuTTY.ppc to get the resources compiled in.
	30
	31	The current Makefile producess a Classic 68K build of PuTTY called
	32	"PuTTY.68k" and a non-Carbon PowerPC build called "PuTTY.ppc".
2d8c9dcc	33
	34	Runtime requirements:
	35
	36	PuTTY should run on any Macintosh running System 7.0 or later. The
	37	Classic 68K build seems not to run under Mac OS X (even with
	38	Classic.app).
	39
	40	Known bugs:
	41
	42	* PowerPC and fat versions fail to start on systems without AppearanceLib (ie
	43	most System 7 ones). The 68k version works fine. [MAYBE FIXED]
	44	* Display is far too slow.
	45	* Real bold doesn't compensate for changing character widths without Color
	46	QuickDraw. [MAYBE FIXED]
	47	* sshsha.c and sshmd5.c cause a stack overflow in Apple's PowerPC C compiler
	48	unless optimisation is entirely disabled.
	49
	50	Features we need (and aren't entirely obvious):
	51
	52	* Scroll-conflation -- scroll_display should change the in-memory
	53	display and remember the scroll, then do_scroll should be called
	54	only when scroll_display gets called for a different rectangle or
	55	term_paint happens.
	56
	57	Local Variables:
	58	mode: text
	59	End: