summaryrefslogtreecommitdiffstats
path: root/mac/README
diff options
context:
space:
mode:
authorstanton <stanton>1999-04-24 01:50:46 (GMT)
committerstanton <stanton>1999-04-24 01:50:46 (GMT)
commit33b9462f0016ef41b6c303739ad7f53bc697430f (patch)
tree51fa2de010b339d9d837978fb86ce589f42a3d01 /mac/README
parent561def0a476b2905df665d317583408e48cb8ff2 (diff)
downloadtk-33b9462f0016ef41b6c303739ad7f53bc697430f.zip
tk-33b9462f0016ef41b6c303739ad7f53bc697430f.tar.gz
tk-33b9462f0016ef41b6c303739ad7f53bc697430f.tar.bz2
merged 8.1.0 changes into mainline
Diffstat (limited to 'mac/README')
-rw-r--r--mac/README181
1 files changed, 5 insertions, 176 deletions
diff --git a/mac/README b/mac/README
index 7d81595..aa70875 100644
--- a/mac/README
+++ b/mac/README
@@ -8,7 +8,7 @@ Jim Ingham
Cygnus Solutions
jingham@cygnus.com
-RCS: @(#) $Id: README,v 1.8 1999/04/16 01:51:29 stanton Exp $
+RCS: @(#) $Id: README,v 1.9 1999/04/24 01:50:50 stanton Exp $
1. Introduction
---------------
@@ -19,54 +19,13 @@ information specific to the Macintosh version of Tcl and Tk. For more
general information please read the README file in the main Tk
directory.
-2. What's new?
--------------
-
-All the widgets will now display internationalized text!
-
-The widget configuration package has been changed to support the new object
-model introduced with the 8.0 compiler. For now the old configuration
-package is retained, and in fact, only the menu and button widgets use
-the new package.
-
3. Mac specific features
------------------------
There are several features or enhancements in Tk that are unique to
-the Macintosh version of Tk. Here is a list of those features and
-pointers to where you can find more information about the feature.
-
-* The menu command has special rules for accessing the Macintosh
- Apple and Help menus. See the menu.m man page for details.
-
-* If you have the special Tcl function "tkAboutDialog" defined, it
- will be called instead of displaying the default About Box in the
- console or other parts of the Wish application. See below for
- details.
-
-* In addition to the standard X cursors, the Mac version of Tk will
- let you use any Mac cursor that is named and installed in your
- application. See the GetCursor.3 man page for details.
-
-* The wish application has a couple of hooks to know about the exit,
- "open document" and "Do Script" Mac High Level events.
- See below for details.
-
-* The command unsupported1 will allow you to set the style of new
- toplevel windows on the Macintosh. It is not really supported.
- See below for details.
-
-* In addition to the standard built-in bitmaps that Tk supports, the
- Mac version of Tk allows you to use several Mac specific icons. See
- the GetBitmap.3 man page for a complete list.
-
-* The send command works among interpreters in the same application. We hope to
- have the complete implementation available in Tk 8.1.
-
-* The -use and -container options almost work. The focus bugs that
- were in Tk8.0 final have been fixed. But there are still some
- known bugs that cause some major problems. Be careful, if you
- decide to use these features. (See bugs.doc for details.)
+the Macintosh version of Tk. The list of these features is
+maintained at
+ http://www.scriptics.com/mac/features.html
4. The Distribution
-------------------
@@ -96,46 +55,7 @@ mactk-source-8.1.sea.hqx
are included. However, you must already have the More Files
package to compile this code.
-5. Documentation
-----------------
-
-There are now many books available for Tcl. These two provide a good
-introduction to the language. It is a good way to get started
-if you haven't used the language before:
-
- Title: Tcl and the Tk Toolkit
- Author: John K. Ousterhout
- Publisher: Addison-Wesley
- ISBN: 0-201-63337-X
-
- Title: Practical Programming in Tcl and Tk
- Author: Brent Welch
- Publisher: Prentice Hall
- ISBN: 0-13-182007-9
-
-More books are listed at
- http://www.scriptics.com/resource/doc/books/
-
-The "doc" subdirectory contains reference in documentation
-in the "man" format found on most UNIX machines. Unfortunately,
-there is not a suitable way to view these pages on the Macintosh.
-A version suitable for viewing on the Macintosh has yet to be
-developed. We are working are having better documentation for
-the Macintosh platform in the future. However, if you have WWW
-access you may access the Man pages at the following URL:
-
- http://www.scriptics.com/man/tcl8.1/contents.html
-
-Other documentation and sample Tcl scripts can be found at
-the Tcl ftp site:
-
- ftp://ftp.neosoft.com/tcl/
-
-The internet news group comp.lang.tcl is also a valuable
-source of information about Tcl. A mailing list is also
-available (see below).
-
-6. Compiling Tk
+5. Compiling Tk
---------------
In order to compile Macintosh Tk you must have the
@@ -166,97 +86,6 @@ Special notes:
to rename the folder to tcl8.0, or change all the paths in the project files.
-7. About Dialog
----------------
-
-The prefered method for replacing the about dialog is to replace the
-main menubar of the application, using the -menu option for the "."
-window. Then add a cascade called .mainMenu.apple to your mainMenu,
-and you can put an about item in here WITH YOUR OWN LABEL!
-
-8. Apple Events
----------------
-
-Tcl/Tk currently doesn't have much in the way of support for Mac
-Apple Events. There is no way to send an apple event (although you
-could write an extension to do this) and no general purpose way to
-recieve apple events. However, there are a couple of hooks for
-dealing with some of the standard apple events.
-
- exit - Generally, Tcl cleans up after it self when you exit.
- However, your application may want to do application specifc
- cleanup like saving a users data. To do this you can rename
- the exit command to something else. Define your own exit
- command to do whatever clean up you like and then call the
- origional exit command. For example,
-
- rename exit __exit
- proc exit {} {
- # Do your clean up hear
- __exit
- }
-
- Both incoming quit events and hitting the Quit menu item
- will call the exit command. However, don't expect you can
- abort the exit. Tk may exit anyway if the exit command it
- calls does not actually quit the application.
-
- open - The other apple event Tk supports is the open event. The
- open event is sent to Tk if, for example, you drop a file on
- the Wish icon. If you define a Tcl procedure with the name
- "tkOpenDocument" it will be invoked on any Open Document
- events that the application receives. The a list of paths to
- the various documents will be passed to the Tcl function.
- Here is an example,
-
- proc tkOpenDocument args {
- foreach file $args {
- # Deal with passed in file path
- }
- }
-
- Note: This isn't every thing you need to do to make your
- application dropable. You must still define a FREF resource
- that makes sense for your application domain. (Out of the
- box, you will not be able to drop files on the Wish
- application. See the Inside Macintosh documentation for
- details about the FREF resource.
-
- do script - This is a way for external applications to drive MacTk, or
- to recieve information from it. From AppleScript, you can say:
-
- tell application "Wish8.0"
- do script "console hide
- pack [button .b1 -text {Hello world} -command exit]"
- end tell
-
- which will get Tk to run the canonical hello world application.
-
-8. unsupported1
----------------
-
-The unsupported1 command is a short term hack we made available to
-allow you to set the window style of a new toplevel window. It works
-much like the "wm overrideredirect" and "wm transient" commands in
-that it must be run before the window it's being applied to is mapped.
-
-The syntax of the command is as follows:
-
- unsupported1 style <window> ?style?
-
-The <window> must be a toplevel window. If the style is not given
-then the current style for the window is returned. If you want to set
-the style you must do so before the window gets mapped for the first
-time. The possible window styles include:
-
- documentProc, dBoxProc, plainDBox, altDBoxProc,
- movableDBoxProc, zoomDocProc, rDocProc, floatProc,
- floatZoomProc, floatSideProc, or floatSideZoomProc
-
-NOTE: this is an unsupported command and it WILL go away in the
-future.
-
-
If you have comments or Bug reports send them to:
Jim Ingham
jingham@cygnus.com