diff options
Diffstat (limited to 'macosx/README')
| -rw-r--r-- | macosx/README | 47 |
1 files changed, 22 insertions, 25 deletions
diff --git a/macosx/README b/macosx/README index 59924bb..f58184c 100644 --- a/macosx/README +++ b/macosx/README @@ -1,11 +1,8 @@ Tcl/Tk Mac OS X README ---------------------- -RCS: @(#) $Id$ - This is the README file for the Mac OS X/Darwin version of Tcl/Tk. - 1. Where to go for support -------------------------- @@ -19,16 +16,11 @@ before asking on the list, many questions have already been answered). http://groups.google.com/group/comp.lang.tcl/ - The Tcl'ers Wiki also has many pages dealing with Tcl & Tk on Mac OS X, see - http://wiki.tcl.tk/references/3753! - http://wiki.tcl.tk/references/8361! + http://wiki.tcl.tk/_/ref?N=3753 + http://wiki.tcl.tk/_/ref?N=8361 - Please report bugs with Tcl or Tk on Mac OS X to the sourceforge bug trackers: - Tcl: http://sf.net/tracker/?func=add&group_id=10894&atid=110894 - Tk: http://sf.net/tracker/?func=add&group_id=12997&atid=112997 -please make sure that your report Tk specific bugs to the tktoolkit project bug -tracker rather than the tcl project bug tracker. -Mac OS X specific bugs should in general be assigned to user 'das'. - + http://tcl.sourceforge.net/ 2. Using Tcl/Tk on Mac OS X --------------------------- @@ -40,7 +32,7 @@ available as an optional or default install on recent Mac OS X). TkAqua and TkX11 can be distinguished at runtime via [tk windowingsystem]. - At a minimum, Mac OS X 10.3 is required to run Tcl and TkX11. -TkAqua requires Mac OS X 10.5 or later (starting with the Cocoa-based Tk 8.5.7). +TkAqua requires Mac OS X 10.5 or later (starting with Tk 8.6b2). - Unless weak-linking is used, Tcl/Tk built on Mac OS X 10.x will not run on 10.y with y < x; on the other hand Tcl/Tk built on 10.y will always run on 10.x @@ -113,7 +105,7 @@ normal scrollbar has a small dimension of 15, the small variant 11. Access to the small variant was added in Tk 8.4.2. - The default metrics of native buttons, radiobuttons, checkboxes and -menubuttons in the Cocoa-based Tk 8.5.7 and later preserve compatibility with +menubuttons in the Cocoa-based Tk 8.6b2 and later preserve compatibility with the older Carbon-based implementation, you can turn off the compatibility metrics to get more native-looking spacing by setting: set tk::mac::useCompatibilityMetrics 0 @@ -135,13 +127,13 @@ where -kind is one of -systemType icon for given IconServices 4-char OSType -namedImage named NSImage for given name -imageFile image at given path -This support was added with the Cocoa-based Tk 8.5.7. +This support was added with the Cocoa-based Tk 8.6b2. - TkAqua cursor names are interpred as follows (in order): - standard or platform-specific Tk cursor name (c.f. cursors.n) - @path to any image file readable by NSImage - NSImage named image name -Support for the latter two was added with the Cocoa-based Tk 8.5.7. +Support for the latter two was added with the Cocoa-based Tk 8.6b2. - The standard Tk dialog commands [tk_getOpenFile], [tk_chooseDirectory], [tk_getSaveFile] and [tk_messageBox] all take an additional optional -command @@ -150,7 +142,7 @@ the global level when the dialog closes, with the dialog command's result appended (the dialog command itself returning an emtpy result). If the -parent option is also present, the dialog is configured as a modeless (window-modal) sheet attached to the parent window and the dialog command returns immediately. -Support for -command was added with the Cocoa-based Tk 8.5.7. +Support for -command was added with the Cocoa-based Tk 8.6b2. - The TkAqua-specific [tk::mac::standardAboutPanel] command brings the standard Cocoa about panel to the front, with all its information filled in from your @@ -158,7 +150,7 @@ application bundle files (i.e. standard about panel with no options specified). See Apple Technote TN2179 and the AppKit documentation for -[NSApplication orderFrontStandardAboutPanelWithOptions:] for details on the Info.plist keys and app bundle files used by the about panel. -This support was added with the Cocoa-based Tk 8.5.7. +This support was added with the Cocoa-based Tk 8.6b2. - TkAqua has three special menu names that give access to the standard Application, Window and Help menus, see menu.n for details. @@ -168,7 +160,7 @@ application's Info.plist (or displaying an alert if no Help Book is set). This action can be customized by defining a procedure named [tk::mac::ShowHelp], if present, this procedure is invoked instead by the standard Help menu item. Support for the Window menu and [tk::mac::ShowHelp] was added with the -Cocoa-based Tk 8.5.7. +Cocoa-based Tk 8.6b2. - The TkAqua-specific command [tk::unsupported::MacWindowStyle style] is used to get and set Mac OS X-specific toplevel window class and attributes. Note that @@ -181,15 +173,18 @@ given window. The 3 argument form sets the class for the given window using the default attributes for that class. The 4 argument form sets the class and the list of attributes for the given window. Window class names: - standardDocument, standardFloating, resizable, fullZoom, horizontalZoom, + document, modal, floating, utility, toolbar, simple, help, overlay +Window attribute names: + standardDocument, standardFloating, resizable, fullZoom, horizontalZoom, verticalZoom, closeBox, collapseBox, toolbarButton, sideTitlebar, noTitleBar, unifiedTitleAndToolbar, metal, hud, noShadow, doesNotCycle, noActivates, hideOnSuspend, inWindowMenu, ignoreClicks, doesNotHide, canJoinAllSpaces, moveToActiveSpace, nonActivating, black, dark, light, gray, red, green, blue, cyan, yellow, magenta, orange, purple, brown, clear, opacity + Note that not all attributes are valid for all window classes. -Support for the 3 argument form was added with the Cocoa-based Tk 8.5.7, at the +Support for the 3 argument form was added with the Cocoa-based Tk 8.6b2, at the same time support for some legacy Carbon-specific classes and attributes was removed (they are still accepted by the command but no longer have any effect). @@ -265,9 +260,10 @@ These have the following targets: The following build configurations are available: Debug: debug build for the active architecture, with Fix & Continue enabled. - Debug gcc42: use gcc 4.2 compiler. - Debug gcc42 nogc: disable Objective-C garbage collection. - Debug llvmgcc42: use llvm-gcc 4.2 compiler. + Debug clang: use clang compiler. + Debug llvm-gcc: use llvm-gcc compiler. + Debug gcc40: use gcc 4.0 compiler. + DebugNoGC: disable Objective-C garbage collection. DebugNoFixAndContinue: disable Fix & Continue. DebugUnthreaded: disable threading. DebugNoCF: disable corefoundation (X11 only). @@ -279,8 +275,9 @@ The following build configurations are available: building on a 64bit capable processor). Release: release build for the active architecture. ReleaseUniversal: 32/64-bit universal build. - ReleaseUniversal gcc42: use gcc 4.2 compiler. - ReleaseUniversal llvmgcc42: use llvm-gcc 4.2 compiler. + ReleaseUniversal clang: use clang compiler. + ReleaseUniversal llvm-gcc: use llvm-gcc compiler. + ReleaseUniversal gcc40: use gcc 4.0 compiler. ReleaseUniversal10.5SDK: build against the 10.5 SDK (with 10.5 deployment target). Note that the non-SDK configurations have their deployment target set to |