1
0
mirror of https://git.tartarus.org/simon/putty.git synced 2025-01-10 09:58:01 +00:00
putty-source/macosx
Simon Tatham f73fcb0424 Add asynchronous callback capability to the askappend() alert box.
This was harder than verify_ssh_host_key() and askalg() put
together, because:
 (a) askappend() can be called at any time, since it's a side effect
     of data-logging functions. Therefore there can be an unfinished
     askappend() alert at any time, and hence the OS X front end has
     to be prepared to _queue_ other alerts which occur during that
     time.
 (b) logging.c has to do something with data that comes in while
     it's waiting for an answer to askappend(). It buffers it until
     it knows what the user wants done with it. This involved
     something of a reorganisation of logging.c.

[originally from svn r5344]
2005-02-18 18:33:31 +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 Add asynchronous callback capability to the askappend() alert box. 2005-02-18 18:33:31 +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 Add asynchronous callback capability to the askappend() alert box. 2005-02-18 18:33:31 +00:00
osxmain.m Initial checkin of a native Mac OS X port, sharing most of its code 2005-02-15 21:45:50 +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 Add asynchronous callback capability to the askappend() alert box. 2005-02-18 18:33:31 +00:00
README.OSX Revamp interface to verify_ssh_host_key() and askalg(). Each of them 2005-02-17 18:34:24 +00:00

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. You are welcome
to use 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:

 - terminal display is horribly slow

 - fatal errors are currently output via printf, which is obviously
   wrong for a GUI application

 - 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

 - close-on-exit isn't implemented

 - warn-on-close isn't implemented

 - SessionWindow's dealloc method does nothing yet, so leaks memory

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

 - cut and paste isn't supported

 - there's no Meta key yet. (I think it will have to be Command
   rather than Option 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.)

 - there's no specials menu

 - 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

 - no Event Log

 - no mid-session Change Settings

 - no icon (surprisingly important in an OS X app!)