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

$Id: README.mac,v 1.3 2002/12/13 00:50:53 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 mac_res.r" to get the
 resources compiled in.  The Makefile currently only generates a
 Classic 68K application.  Other architectures will come later.

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