putty/macosx
Jacob Nevins 8719f92c14 Revamp SSH authentication code so that user interaction is more
abstracted out; replace loops structured around a single interaction
per loop with less tortuous code (fixes: `ki-multiprompt-crash',
`ssh1-bad-passphrase-crash'; makes `ssh2-password-expiry' and
`proxy-password-prompt' easier).

The new interaction abstraction has a lot of fields that are unused in
the current code (things like window captions); this is groundwork for
`gui-auth'. However, ssh.c still writes directly to stderr; that may
want to be fixed.

In the GUI apps, user interaction is moved to terminal.c. This should
make it easier to fix things like UTF-8 username entry, although I
haven't attempted to do so. Also, control character filtering can be
tailored to be appropriate for individual front-ends; so far I don't
promise anything other than not having made it any worse.

I've tried to test this fairly exhaustively (although Mac stuff is
untested, as usual). It all seems to basically work, but I bet there
are new bugs. (One I know about is that you can no longer make the
PuTTY window go away with a ^D at the password prompt; this should be
fixed.)

[originally from svn r6437]
[this svn revision also touched putty-wishlist]
2005-10-30 20:24:09 +00:00
..
README.OSX Beef up the `unfinished and experimental' warnings for the two Mac 2005-03-31 12:25:48 +00:00
info.plist Thanks to D H Becker for sending in an icon. I'd have liked to have 2005-03-10 20:11:27 +00:00
osx.h Initial checkin of a native Mac OS X port, sharing most of its code 2005-02-15 21:45:50 +00:00
osxclass.h If a new session was saved from Change Settings, a side-effect on Windows was 2005-04-07 01:36:28 +00:00
osxctrls.m Initial checkin of a native Mac OS X port, sharing most of its code 2005-02-15 21:45:50 +00:00
osxdlg.m If a new session was saved from Change Settings, a side-effect on Windows was 2005-04-07 01:36:28 +00:00
osxmain.m Sort out close-on-exit, connection_fatal(), fatalbox(), and 2005-02-26 13:37:07 +00:00
osxsel.m Initial checkin of a native Mac OS X port, sharing most of its code 2005-02-15 21:45:50 +00:00
osxwin.m Revamp SSH authentication code so that user interaction is more 2005-10-30 20:24:09 +00:00
putty.icns Thanks to D H Becker for sending in an icon. I'd have liked to have 2005-03-10 20:11:27 +00:00

README.OSX

This directory contains a Mac OS X port of PuTTY/pterm, running as a
native Aqua GUI application.

THIS PORT IS CURRENTLY UNFINISHED AND EXPERIMENTAL. It is _not_
considered to be of release quality, even if you've found it (and
are reading this) in a PuTTY release source archive. You are welcome
to try using it, but don't be surprised at unexpected behaviour. I'm
not kidding.

In particular, I have not yet decided where OS X PuTTY should store
its configuration data. Options include storing it in ~/.putty to be
compatible with Unix PuTTY, storing it wherever is compatible with
Mac Classic PuTTY, storing it in a natively OS X location, or
sorting out the `config-locations' wishlist item and doing all
three. Therefore, if you start using this port and create a whole
load of saved sessions, you should not be surprised if a future
version of the port decides to look somewhere completely different
for the data and therefore loses them all. If that happens, don't
say you weren't warned!

Other ways in which the port is currently unfinished include:

Missing terminal window features
--------------------------------

 - terminal display is horribly slow

 - fonts aren't configurable

 - several features are unimplemented in the terminal display:
   underlining, non-solid-block cursors, double-width and
   double-height line attributes, bold as font rather than as
   colour, wide (CJK) characters, combining characters.

 - there's no scrollbar

 - terminal window resizing isn't implemented yet

 - proper window placement (cascading down and right from the
   starting position, plus remembering previous window positions per
   the Apple HIG) is not implemented

Missing alert box features
--------------------------

 - warn-on-close isn't implemented

Missing input features
----------------------

 - use of Alt+numberpad to enter arbitrary numeric character codes
   is not yet supported

 - there's no Meta key yet. (I'd like to at least have the
   possibility of using Command rather than Option as the Meta key,
   since the latter is necessary to send some characters, including
   the rather important # on Apple UK keyboards; but trapping
   Command-<key> and sending it to the window rather than the
   application menu requires me to make a positive effort of some
   sort and I haven't got round to it yet. For those Mac users who
   consider their Command key sacrosanct, don't worry, this option
   _will_ be configurable and _will_ be off by default.)

 - there's no specials menu

 - mouse activity isn't supported (neither cut-and-paste nor xterm
   mouse tracking)

Missing terminal emulation features
-----------------------------------

 - currently no support for server-side window management requests
   (i.e. escape sequences to minimise or maximise the window,
   request or change its position and size, change its title etc)

 - window title is currently fixed

Other missing features
----------------------

 - no Event Log

 - no mid-session Change Settings