Thanks to D H Becker for sending in an icon. I'd have liked to have
[u/mdw/putty] / macosx / README.OSX
CommitLineData
1ddda1ca 1This directory contains a Mac OS X port of PuTTY/pterm, running as a
2native Aqua GUI application.
3
4THIS PORT IS CURRENTLY UNFINISHED AND EXPERIMENTAL. You are welcome
5to use it, but don't be surprised at unexpected behaviour. I'm not
6kidding.
7
8In particular, I have not yet decided where OS X PuTTY should store
9its configuration data. Options include storing it in ~/.putty to be
10compatible with Unix PuTTY, storing it wherever is compatible with
11Mac Classic PuTTY, storing it in a natively OS X location, or
12sorting out the `config-locations' wishlist item and doing all
13three. Therefore, if you start using this port and create a whole
14load of saved sessions, you should not be surprised if a future
15version of the port decides to look somewhere completely different
16for the data and therefore loses them all. If that happens, don't
17say you weren't warned!
18
1ddda1ca 19Other ways in which the port is currently unfinished include:
20
ec5da310 21Missing terminal window features
22--------------------------------
1ddda1ca 23
ec5da310 24 - terminal display is horribly slow
1ddda1ca 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
ec5da310 41Missing alert box features
42--------------------------
1ddda1ca 43
44 - warn-on-close isn't implemented
45
ec5da310 46Missing input features
47----------------------
1ddda1ca 48
49 - use of Alt+numberpad to enter arbitrary numeric character codes
50 is not yet supported
51
ec5da310 52 - there's no Meta key yet. (I'd like to at least have the
53 possibility of using Command rather than Option as the Meta key,
54 since the latter is necessary to send some characters, including
55 the rather important # on Apple UK keyboards; but trapping
56 Command-<key> and sending it to the window rather than the
57 application menu requires me to make a positive effort of some
58 sort and I haven't got round to it yet. For those Mac users who
59 consider their Command key sacrosanct, don't worry, this option
60 _will_ be configurable and _will_ be off by default.)
1ddda1ca 61
62 - there's no specials menu
63
2ac5ea1e 64 - mouse activity isn't supported (neither cut-and-paste nor xterm
65 mouse tracking)
66
ec5da310 67Missing terminal emulation features
68-----------------------------------
69
1ddda1ca 70 - currently no support for server-side window management requests
71 (i.e. escape sequences to minimise or maximise the window,
72 request or change its position and size, change its title etc)
73
74 - window title is currently fixed
75
ec5da310 76Other missing features
77----------------------
78
1ddda1ca 79 - no Event Log
80
81 - no mid-session Change Settings