From 358816af75430953f2b40a5666060410f71b2ba1 Mon Sep 17 00:00:00 2001 From: Michael R Sweet Date: Tue, 20 May 2003 19:16:26 +0000 Subject: Update documentation. git-svn-id: file:///fltk/svn/fltk/branches/branch-1.1@2989 ea41ed52-d2ee-0310-a9c1-e6b18d33e121 --- documentation/osissues.html | 59 ++++++++++++++++++++++++--------------------- 1 file changed, 32 insertions(+), 27 deletions(-) (limited to 'documentation/osissues.html') diff --git a/documentation/osissues.html b/documentation/osissues.html index 6c1720f84..692a2ac38 100644 --- a/documentation/osissues.html +++ b/documentation/osissues.html @@ -584,21 +584,19 @@ version of FLTK:

The MacOS Interface

-

FLTK supports MacOS 8.6, MacOS 9 and MacOS X using the Apple -Carbon library. When compiled with MPW or MetroWerks' -CodeWarrior, application binaries in CFM format will run on all -the above systems without changes. The OS X GNU (gcc) compiler, -however, creates Mach-O binaries which are not supported by -MacOS 9 and earlier. - -

control, option and command modifier keys

- -

FLTK maps the Mac 'control' key to FL_CTRL, the 'option' key -to FL_ALT and the 'Apple' key to FL_META. Keyboard events return -the key name in Fl::event_key and the keystroke translation in -Fl::event_text. For example, typing Option-Y on a Mac keyboard -will set FL_ALT in Fl::event_state, set Fl::event_key to 'y' -and return the Yen symbol in Fl::event_text. +

FLTK supports MacOS X using the Apple Carbon library. Older +versions of MacOS are not supported. + +

Control, Option, and Command Modifier Keys

+ +

FLTK maps the Mac 'control' key to FL_CTRL, the +'option' key to FL_ALT and the 'Apple' key to +FL_META. Keyboard events return the key name in +Fl::event_key() and the keystroke translation in +Fl::event_text(). For example, typing Option-Y on a Mac +keyboard will set FL_ALT in Fl::event_state(), +set Fl::event_key() to 'y' and return the Yen symbol in +Fl::event_text().

WindowRef fl_xid(const Fl_Window *)

@@ -619,7 +617,7 @@ called, FLTK has prepared the Window and CGrafPort for drawing. Clipping and offsets are prepared to allow correct subwindow drawing. -

OS X doublebuffers all windows automatically. On OS X, +

OS X double-buffers all windows automatically. On OS X, Fl_Window and Fl_Double_Window are handled internally in the same way. @@ -628,17 +626,24 @@ internally in the same way.

Resource Forks

FLTK does not access the resource fork of an application. -However, a minimal resource fork must be created for OS 8 and OS -X applications +However, a minimal resource fork must be created for OS X +applications -

Caution: when using Unix commands to copy or move executables, -OS X will NOT copy any resource forks! For copying and moving use CpMac -and MvMac respectively. For creating a tar archive, all executables -need to be stripped from their Resource Fork before packing (DeRez fluid >fluid.r). -After unpacking the Resource Fok needs to be reattached (Rez fluid.r -o fluid). +

+
Caution: -

It is advisable to use the Finder for moving and copying and Mac archiving -tools like Sit for distribution as they will handle the Resource Fork correctly. +

When using UNIX commands to copy or move executables, OS X +will NOT copy any resource forks! For copying and moving use +CpMac and MvMac respectively. For creating a tar archive, all +executables need to be stripped from their Resource Fork before +packing, e.g. "DeRez fluid >fluid.r". After unpacking the +Resource Fork needs to be reattached, e.g. "Rez fluid.r -o +fluid". +

+ +

It is advisable to use the Finder for moving and copying and +Mac archiving tools like Sit for distribution as they will +handle the Resource Fork correctly.

Mac File Paths

@@ -646,8 +651,8 @@ tools like Sit for distribution as they will handle the Resource Fork correctly.

Known MacOS Bugs and Problems

-

The following is a list of known bugs and problems in the MacOS -version of FLTK: +

The following is a list of known bugs and problems in the +MacOS version of FLTK: