macosx/README.OSX

   1 This directory contains a Mac OS X port of PuTTY/pterm, running as a
   2 native Aqua GUI application.
   3
   4 THIS PORT IS CURRENTLY UNFINISHED AND EXPERIMENTAL. It is _not_
   5 considered to be of release quality, even if you've found it (and
   6 are reading this) in a PuTTY release source archive. You are welcome
   7 to try using it, but don't be surprised at unexpected behaviour. I'm
   8 not kidding.
   9
  10 In particular, I have not yet decided where OS X PuTTY should store
  11 its configuration data. Options include storing it in ~/.putty to be
  12 compatible with Unix PuTTY, storing it wherever is compatible with
  13 Mac Classic PuTTY, storing it in a natively OS X location, or
  14 sorting out the `config-locations' wishlist item and doing all
  15 three. Therefore, if you start using this port and create a whole
  16 load of saved sessions, you should not be surprised if a future
  17 version of the port decides to look somewhere completely different
  18 for the data and therefore loses them all. If that happens, don't
  19 say you weren't warned!
  20
  21 Other ways in which the port is currently unfinished include:
  22
  23 Bit rot
  24 -------
  25
  26  - the conversion of the old fixed-size 'Config' structure to the
  27    new dynamic 'Conf' was never applied to this directory
  28
  29  - probably other things are out of date too; it would need some
  30    work to make it compile again
  31
  32 Missing terminal window features
  33 --------------------------------
  34
  35  - terminal display is horribly slow
  36
  37  - fonts aren't configurable
  38
  39  - several features are unimplemented in the terminal display:
  40    underlining, non-solid-block cursors, double-width and
  41    double-height line attributes, bold as font rather than as
  42    colour, wide (CJK) characters, combining characters.
  43
  44  - there's no scrollbar
  45
  46  - terminal window resizing isn't implemented yet
  47
  48  - proper window placement (cascading down and right from the
  49    starting position, plus remembering previous window positions per
  50    the Apple HIG) is not implemented
  51
  52 Missing alert box features
  53 --------------------------
  54
  55  - warn-on-close isn't implemented
  56
  57 Missing input features
  58 ----------------------
  59
  60  - use of Alt+numberpad to enter arbitrary numeric character codes
  61    is not yet supported
  62
  63  - there's no Meta key yet. (I'd like to at least have the
  64    possibility of using Command rather than Option as the Meta key,
  65    since the latter is necessary to send some characters, including
  66    the rather important # on Apple UK keyboards; but trapping
  67    Command-<key> and sending it to the window rather than the
  68    application menu requires me to make a positive effort of some
  69    sort and I haven't got round to it yet. For those Mac users who
  70    consider their Command key sacrosanct, don't worry, this option
  71    _will_ be configurable and _will_ be off by default.)
  72
  73  - there's no specials menu
  74
  75  - mouse activity isn't supported (neither cut-and-paste nor xterm
  76    mouse tracking)
  77
  78 Missing terminal emulation features
  79 -----------------------------------
  80
  81  - currently no support for server-side window management requests
  82    (i.e. escape sequences to minimise or maximise the window,
  83    request or change its position and size, change its title etc)
  84
  85  - window title is currently fixed
  86
  87 Other missing features
  88 ----------------------
  89
  90  - no Event Log
  91
  92  - no mid-session Change Settings