| 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 |