git.distorted.org.uk Git - u/mdw/putty/blob - 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. You are welcome
   5 to use it, but don't be surprised at unexpected behaviour. I'm not
   6 kidding.
   7
   8 In particular, I have not yet decided where OS X PuTTY should store
   9 its configuration data. Options include storing it in ~/.putty to be
  10 compatible with Unix PuTTY, storing it wherever is compatible with
  11 Mac Classic PuTTY, storing it in a natively OS X location, or
  12 sorting out the `config-locations' wishlist item and doing all
  13 three. Therefore, if you start using this port and create a whole
  14 load of saved sessions, you should not be surprised if a future
  15 version of the port decides to look somewhere completely different
  16 for the data and therefore loses them all. If that happens, don't
  17 say you weren't warned!
  18
  19 Other ways in which the port is currently unfinished include:
  20
  21 Missing terminal window features
  22 --------------------------------
  23
  24  - terminal display is horribly slow
  25
  26  - fonts aren't configurable
  27
  28  - several features are unimplemented in the terminal display:
  29    underlining, non-solid-block cursors, double-width and
  30    double-height line attributes, bold as font rather than as
  31    colour, wide (CJK) characters, combining characters.
  32
  33  - there's no scrollbar
  34
  35  - terminal window resizing isn't implemented yet
  36
  37  - proper window placement (cascading down and right from the
  38    starting position, plus remembering previous window positions per
  39    the Apple HIG) is not implemented
  40
  41 Missing alert box features
  42 --------------------------
  43
  44  - warn-on-close isn't implemented
  45
  46 Missing input features
  47 ----------------------
  48
  49  - use of Alt+numberpad to enter arbitrary numeric character codes
  50    is not yet supported
  51
  52  - cut and paste isn't supported
  53
  54  - there's no Meta key yet. (I'd like to at least have the
  55    possibility of using Command rather than Option as the Meta key,
  56    since the latter is necessary to send some characters, including
  57    the rather important # on Apple UK keyboards; but trapping
  58    Command-<key> and sending it to the window rather than the
  59    application menu requires me to make a positive effort of some
  60    sort and I haven't got round to it yet. For those Mac users who
  61    consider their Command key sacrosanct, don't worry, this option
  62    _will_ be configurable and _will_ be off by default.)
  63
  64  - there's no specials menu
  65
  66 Missing terminal emulation features
  67 -----------------------------------
  68
  69  - currently no support for server-side window management requests
  70    (i.e. escape sequences to minimise or maximise the window,
  71    request or change its position and size, change its title etc)
  72
  73  - window title is currently fixed
  74
  75 Other missing features
  76 ----------------------
  77
  78  - SessionWindow's dealloc method does nothing yet, so leaks memory
  79
  80  - no Event Log
  81
  82  - no mid-session Change Settings
  83
  84  - no icon (surprisingly important in an OS X app!)