Sebastian Kuschel reports that pfd_closing can be called for a socket
[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
c4e0f0c5 4THIS PORT IS CURRENTLY UNFINISHED AND EXPERIMENTAL. It is _not_
5considered to be of release quality, even if you've found it (and
6are reading this) in a PuTTY release source archive. You are welcome
7to try using it, but don't be surprised at unexpected behaviour. I'm
8not kidding.
1ddda1ca 9
10In particular, I have not yet decided where OS X PuTTY should store
11its configuration data. Options include storing it in ~/.putty to be
12compatible with Unix PuTTY, storing it wherever is compatible with
13Mac Classic PuTTY, storing it in a natively OS X location, or
14sorting out the `config-locations' wishlist item and doing all
15three. Therefore, if you start using this port and create a whole
16load of saved sessions, you should not be surprised if a future
17version of the port decides to look somewhere completely different
18for the data and therefore loses them all. If that happens, don't
19say you weren't warned!
20
1ddda1ca 21Other ways in which the port is currently unfinished include:
22
4a693cfc 23Bit 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
ec5da310 32Missing terminal window features
33--------------------------------
1ddda1ca 34
ec5da310 35 - terminal display is horribly slow
1ddda1ca 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
ec5da310 52Missing alert box features
53--------------------------
1ddda1ca 54
55 - warn-on-close isn't implemented
56
ec5da310 57Missing input features
58----------------------
1ddda1ca 59
60 - use of Alt+numberpad to enter arbitrary numeric character codes
61 is not yet supported
62
ec5da310 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.)
1ddda1ca 72
73 - there's no specials menu
74
2ac5ea1e 75 - mouse activity isn't supported (neither cut-and-paste nor xterm
76 mouse tracking)
77
ec5da310 78Missing terminal emulation features
79-----------------------------------
80
1ddda1ca 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
ec5da310 87Other missing features
88----------------------
89
1ddda1ca 90 - no Event Log
91
92 - no mid-session Change Settings