git.distorted.org.uk Git - u/mdw/putty/blob - mac/README.mac

   1 $Id$
   2
   3 Information about PuTTY for the Mac OS
   4 -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
   5
   6 This is a port of PuTTY to the Classic Mac OS.  It is a work in
   7 progress and should be considered unfinished and insecure.  It is
   8 not considered to be of release quality, even if you found it (and
   9 you're reading this) in a PuTTY release source archive.  Unless you
  10 know what you're doing, don't use it.
  11
  12 Compiling it:
  13
  14  See ../README for generic information.
  15
  16  To compile PuTTY for Mac OS you will need:
  17
  18  MPW
  19   <ftp://ftp.apple.com/developer/Tool_Chest/Core_Mac_OS_Tools/MPW_etc./
  20    MPW-GM_Images/MPW-GM.img.bin>
  21   Install this in the usual way.
  22
  23  Universal Headers
  24   <ftp://ftp.apple.com/developer/Development_Kits/
  25    UniversalHeaders3.4.2.img.bin>
  26   Install using the script in "Documentation:MPW Users - ReadMe".
  27
  28  Text Encoding Converter SDK
  29   <ftp://ftp.apple.com/developer/Development_Kits/TEC_1.5.sit.hqx>
  30   Copy contents of "68K Static Libraries" to
  31    "Interfaces&Libraries:Libraries:Libraries".
  32   Copy contents of "Stub Libraries" to
  33    "Interfaces&Libraries:Libraries:SharedLibraries".
  34
  35  CarbonStdCLib.o
  36   <ftp://ftp.apple.com/developer/Tool_Chest/Core_Mac_OS_Tools/
  37    MPW_Website_Downloads/CarbonStdCLib.o-3.8d3.hqx>
  38   Copy contents of "CIncludes" to
  39    "Interfaces&Libraries:Interfaces:CIncludes".
  40   Copy contents of "PPCLibraries" to
  41    "Interfaces&Libraries:Libraries:PPCLibraries".
  42
  43  The "mkputty.mpw" script does all the work, and currently producess a
  44  Classic 68K build of PuTTY called "PuTTY.68k", a non-Carbon PowerPC
  45  build called "PuTTY.ppc", and similar builds of PuTTYtel called
  46  "PuTTYtel.68k" and "PuTTYtel.ppc".  The CFM-68K build is currently
  47  disabled because it overflows the global data space and I can't work
  48  out how to stop this happening.  The Carbon build doesn't work yet.
  49
  50 Runtime requirements:
  51
  52  The Classic 68K build of PuTTY should work on any Macintosh running
  53  System 7.0 or later.  It runs in the Classic environment in Mac OS X.
  54
  55  The CFM-68K build of PuTTY should work on any Macintosh with a 68020,
  56  68030 or 68040 processor and with either the CFM-68K Runtime Enabler
  57  or Mac OS 7.6.1 or later installed.
  58
  59  The PowerPC build of PuTTY should work on any Power Macintosh.  It
  60  runs in the Classic environment in Mac OS X.
  61
  62  The Carbon build of PuTTY (when it works) should work on any Power
  63  Macintosh with CarbonLib (and Mac OS 8.1 or later), Mac OS 9 or
  64  Mac OS X installed.
  65
  66 Known bugs:
  67  * Display is far too slow.
  68  * Real bold doesn't compensate for changing character widths without Color
  69    QuickDraw. [MAYBE FIXED]
  70  * When the last terminal window closes, the Edit menu doesn't get disabled
  71    immediately, which it should.
  72  * When using the "VT100" font, text copied to the clipboard doesn't
  73    get newlines in it, because that font has a graphic character at
  74    position 0x0d.  Even if we did insert 0x0d manually, TextEdit
  75    insists on displaying the graphic version, so I think we need a
  76    font switch at this point.  This can be seen as a special case of
  77    the need to switch fonts to get odd characters.
  78  * Pasting large blocks of text doesn't work.
  79  * The host key database is currently limited by its implementation to
  80    2727 host keys.
  81
  82 Unimplemented features (should be done before release):
  83  * TCP urgent data.
  84  * Listening sockets.
  85  * Changing font size in reponse to resize requests.
  86  * Full screen mode.
  87  * Session configuration.
  88  * Entropy collection.
  89  * Private key files.
  90  * Pageant and PuTTYgen.
  91  * Do something with Open Application Apple Events.
  92  * Close-on-exit.
  93  * Warn-on-quit.
  94  * Non-block cursors.
  95
  96 Wishlist (after release):
  97  * SFTP client (GUI?)
  98  * Carbon compatibility (requires Open Transport and Navigation Services).
  99  * 'styl' paste, for script codes.
 100  * Handle 'gurl' Apple Events.
 101
 102 Local Variables:
 103 mode: text
 104 End: