head	1.19;
access;
symbols
	core-8-4-19:1.17.2.1
	core-8-4-18:1.17.2.1
	core-8-4-17:1.17.2.1
	core-8-4-16:1.17.2.1
	core-8-4-15:1.17.2.1
	core-8-4-14:1.17.2.1
	core-8-4-13:1.17.2.1
	core-8-4-12:1.17.2.1
	core-8-4-11:1.17
	core-8-4-10:1.17
	core-8-4-9-branch:1.17.0.4
	core-8-4-9:1.17
	core-8-4-8:1.17
	core-8-4-7:1.17
	core-8-5-a1:1.18
	core-8-4-6:1.17
	core-8-4-5:1.17
	mistachkin-dev-branch:1.18.0.2
	core-8-4-4:1.17
	core-8-4-3:1.17
	core-8-4-branch:1.17.0.2
	core-8-4-2:1.17
	core-8-4-1:1.17
	core-8-3-5:1.13.2.3
	core-8-4-0:1.17
	macosx-8-4-merge-2002-08-31-trunk:1.17
	macosx-8-4-premerge-2002-08-31-branch:1.16.2.1
	macosx-8-4-premerge-2002-08-31-trunk:1.17
	macosx-8-4-merge-2002-08-30-branch:1.16.2.1
	macosx-8-4-merge-2002-08-30-trunk:1.17
	macosx-8-4-merge-2002-08-20-branch:1.16.2.1
	macosx-8-4-merge-2002-08-20-trunk:1.17
	core-8-4-b2:1.17
	core-8-4-b1:1.17
	macosx-premerge-6-9-02:1.16
	core-8-4-a4:1.17
	core-8-3-4:1.13.2.2
	macosx-8-4-branch:1.16.0.2
	macosx-8-4-branchpoint:1.16
	core-8-4-a3:1.16
	core-8-3-3:1.13.2.1
	dgp-privates-into-namespace:1.14.0.4
	tclpro-1-5-0:1.13
	core-8-4-win-speedup:1.14.0.2
	core-8-4-a2:1.14
	tclpro-1-4-1:1.13
	tclpro-1-4-0:1.13
	core-8-3-2:1.13
	ajuba-ajuba2-2-1-base:1.13
	ajuba-ajuba2-2-0:1.13
	core-8-4-a1:1.14
	core-8-3-1-branch:1.13.0.2
	core-8-3-1:1.13
	scriptics-sc-2-0-b5:1.12
	scriptics-sc-2-0-fixed:1.12
	scriptics-sc-2-0-b2:1.12
	scriptics-sc-2-0-b1:1.12
	core-8-3-0:1.12
	core-8-3-b2:1.11
	core-8-3-b1:1.11
	scriptics-sc-1-1:1.10
	scriptics-sc-1-1-b1:1.10
	core-8-2-3:1.10
	scriptics-sc-1-1-branch:1.10.0.8
	scriptics-sc-1-1-base:1.10
	scriptics-sc-1-0:1.10
	scriptics-sc-1-0-branch:1.10.0.6
	scriptics-sc-1-0-base:1.10
	core-8-2-2:1.10
	core-8-2-1:1.10
	scriptics-bc-1-0-b1:1.10
	core-8-2-1-branch:1.10.0.4
	scriptics-tclpro-1-3-0:1.10
	core-8-2-0:1.10
	core-8-2-b3-branch:1.10.0.2
	core-8-2-b3-base:1.10
	scriptics-tclpro-1-3-b4:1.10
	core-8-2-b2:1.10
	scriptics-tclpro-1-3-b3:1.10
	core-8-2-b1:1.10
	scriptics-tclpro-1-3-b2:1.9
	merge-to-mainline-5/21/99:1.9
	scriptics-tclpro-1-3-b2-branch:1.9.0.2
	core-8-1-1:1.9
	scriptics-tclpro-1-3-b1:1.9
	core-8-1-1-base:1.9
	core-8-1-0:1.8.4.1
	merge-to-mainline-4-29-99:1.8.4.1
	merge-to-mainline-4-23-99:1.8.4.1
	core-8-1-branch-old:1.1.0.4
	core-8-0-6-branch:1.7.0.2
	core-8-0-6-base:1.7
	core-8-0-5:1.6.2.1
	core-8-1-b3:1.1.4.4
	core-8-1-b2:1.1.4.4
	dev-8-1-stubs-branch:1.1.4.4.0.2
	dev-stubs-branch:1.6.0.4
	scriptics-tclpro-1-2:1.6
	scriptics-tclpro-1-2-b2:1.6
	core-8-1-merge-2/10/99:1.6
	core-8-0-5-branch:1.6.0.2
	core-8-0-5-base:1.6
	scriptics-tclpro-1-2-b1:1.6
	scriptics-tclpro-1-2-a1:1.5
	core-8-1-b1:1.1.4.4
	core-8-0-4:1.5
	core-8-1-a2:1.1.4.1
	core-8-0-2:1.1
	core-8-0-3:1.3;
locks; strict;
comment	@# @;


1.19
date	2004.03.17.18.15.45;	author das;	state dead;
branches;
next	1.18;

1.18
date	2003.03.04.23.50.42;	author dgp;	state Exp;
branches;
next	1.17;

1.17
date	2002.03.04.23.31.45;	author hobbs;	state Exp;
branches
	1.17.2.1;
next	1.16;

1.16
date	2001.07.05.01.28.34;	author uid38172;	state Exp;
branches
	1.16.2.1;
next	1.15;

1.15
date	2001.04.02.02.08.36;	author hobbs;	state Exp;
branches;
next	1.14;

1.14
date	2000.05.03.00.18.36;	author hobbs;	state Exp;
branches
	1.14.2.1
	1.14.4.1;
next	1.13;

1.13
date	2000.04.26.17.37.35;	author hobbs;	state Exp;
branches
	1.13.2.1;
next	1.12;

1.12
date	2000.02.10.08.47.20;	author jingham;	state Exp;
branches;
next	1.11;

1.11
date	99.10.01.22.45.22;	author hobbs;	state Exp;
branches;
next	1.10;

1.10
date	99.06.25.23.30.26;	author welch;	state Exp;
branches;
next	1.9;

1.9
date	99.04.24.01.50.50;	author stanton;	state Exp;
branches;
next	1.8;

1.8
date	99.04.16.01.51.29;	author stanton;	state Exp;
branches
	1.8.4.1;
next	1.7;

1.7
date	99.04.16.01.25.54;	author stanton;	state Exp;
branches;
next	1.6;

1.6
date	99.01.04.19.25.27;	author rjohnson;	state Exp;
branches
	1.6.2.1;
next	1.5;

1.5
date	98.11.12.05.59.13;	author jingham;	state Exp;
branches;
next	1.4;

1.4
date	98.11.11.17.29.34;	author jingham;	state Exp;
branches;
next	1.3;

1.3
date	98.09.14.18.23.33;	author stanton;	state Exp;
branches;
next	1.2;

1.2
date	98.08.12.11.38.17;	author welch;	state Exp;
branches;
next	1.1;

1.1
date	98.04.01.09.56.58;	author rjohnson;	state Exp;
branches
	1.1.4.1;
next	;

1.1.4.1
date	98.09.29.00.25.36;	author stanton;	state Exp;
branches;
next	1.1.4.2;

1.1.4.2
date	98.09.30.02.17.59;	author stanton;	state Exp;
branches;
next	1.1.4.3;

1.1.4.3
date	98.11.25.21.16.35;	author stanton;	state Exp;
branches;
next	1.1.4.4;

1.1.4.4
date	98.12.04.07.21.21;	author welch;	state Exp;
branches;
next	;

1.6.2.1
date	99.03.22.06.42.59;	author jingham;	state Exp;
branches;
next	;

1.8.4.1
date	99.04.22.23.05.59;	author welch;	state Exp;
branches;
next	;

1.13.2.1
date	2001.04.04.07.57.17;	author hobbs;	state Exp;
branches;
next	1.13.2.2;

1.13.2.2
date	2001.10.03.22.04.52;	author hobbs;	state Exp;
branches;
next	1.13.2.3;

1.13.2.3
date	2002.10.16.01.05.57;	author hobbs;	state Exp;
branches;
next	;

1.14.2.1
date	2002.04.02.20.57.54;	author hobbs;	state Exp;
branches;
next	;

1.14.4.1
date	2001.07.03.20.01.09;	author dgp;	state Exp;
branches;
next	1.14.4.2;

1.14.4.2
date	2001.07.05.02.47.42;	author dgp;	state Exp;
branches;
next	;

1.16.2.1
date	2002.06.10.05.38.24;	author wolfsuit;	state Exp;
branches;
next	;

1.17.2.1
date	2005.12.04.00.51.29;	author das;	state Exp;
branches;
next	;


desc
@@


1.19
log
@Removed support for Mac OS Classic platform [Patch 918139]
@
text
@Tk 8.5 for Macintosh

Originally by Ray Johnson while at Sun Microsystems Labs
with major help from Jim Ingham while at Cygnus Solutions

RCS: @@(#) $Id: README,v 1.18 2003/03/04 23:50:42 dgp Exp $

1. Introduction
---------------

This is the README file for the Macintosh version of the Tk
extension for the Tcl scripting language.  The file consists of
information specific to the Macintosh version of Tcl and Tk.  For more
general information please read the README file in the main Tk
directory.

3. Mac specific features
------------------------

There are several features or enhancements in Tk that are unique to 
the Macintosh version of Tk.  The list of these features is
maintained at
	http://www.tcl.tk/software/mac/features.html

4. The Distribution
-------------------

Macintosh Tk is distributed in three different forms.  This should
make it easier to only download what you need.  Replace <version>
with the current version of Tk.  The packages are as follows:

mactk<version>.sea.hqx

    This distribution is a "binary" only release.  It contains an
    installer program that will install a 68k, PowerPC, or Fat
    version of the "Wish" application.  In addition, in installs
    the Tcl & Tk libraries in the Extensions folder inside your
    System Folder.  (No "INIT"'s or Control Pannels are installed.)

mactcltk-full-<version>.sea.hqx

    This release contains the full release of Tcl and Tk for the
    Macintosh plus the More Files package on which Macintosh Tcl and
    Tk rely.

mactk-source-<version>.sea.hqx

    This release contains the complete source to Tk for the Macintosh
    In addition, Metrowerks CodeWarrior libraries and project files
    are included.  However, you must already have the More Files
    package to compile this code.

5. Compiling Tk
---------------

In order to compile Macintosh Tk you must have the 
following items:

	CodeWarrior Pro 5 or higher
	Mac Tcl (source)
	  (which requires More Files 1.4.9)
	Mac Tk (source)

The project  files included with the Mac Tcl source should work 
fine.  The only thing you may need to update are the access paths.
As with Tcl, you need to upgrade to the 2.0.1 version of the C
compilers or later to build the CFM68K version of Tcl/Tk.

Special notes:

* Check out the file bugs.doc for information about known bugs.

* We are starting to support the new Appearance Manager that shipped
  with MacOS 8.0.  The Tk 8.0.3 release is the first Tk release
  that supported the Appearance Manager well.  Tk 8.0.4 extended this support
  to the menu system, though you have to have Appearance 1.0.1 or later
  installed for this to work.
  

If you have comments or Bug reports, use our on-line database at
	http://tcl.sourceforge.net/
@


1.18
log
@        * README:                               Bumped version number of
        * generic/tk.h:                         Tk to 8.5a0.
        * library/tk.tcl:
        * mac/README:
        * macosx/Wish.pbproj/project.pbxproj:
        * unix/README:
        * unix/configure.in:
        * unix/tk.spec:
        * win/README:
        * win/configure.in:
        * win/makefile.vc:
        * win/tcl.m4:

        * unix/configure:      autoconf
        * win/configure:
@
text
@d6 1
a6 1
RCS: @@(#) $Id: README,v 1.17 2002/03/04 23:31:45 hobbs Exp $
@


1.17
log
@updated to use www.tcl.tk URL
@
text
@d1 1
a1 1
Tk 8.4 for Macintosh
d6 1
a6 1
RCS: @@(#) $Id: README,v 1.16 2001/07/05 01:28:34 uid38172 Exp $
@


1.17.2.1
log
@	* mac/README: add note that mac classic port is no longer supported.
@
text
@d6 1
a6 13
RCS: @@(#) $Id: README,v 1.17 2002/03/04 23:31:45 hobbs Exp $

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

Note that Tk on Mac OS Classic is no longer supported and likely no longer
compiles, the last release known to work is 8.4.2. The 'mac' source
directory and all other Mac Classic code have been removed from Tk 8.5.

The Mac OS X port of Tk can be found in the 'macosx' source directory.

The information and URLs below are known to be outdated and incorrect.

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
@


1.16
log
@updated READMEs with purls
@
text
@d6 1
a6 1
RCS: @@(#) $Id: README,v 1.15 2001/04/02 02:08:36 hobbs Exp $
d23 1
a23 1
	http://www.purl.org/tcl/home/software/mac/features.html
@


1.16.2.1
log
@Merging with TOT as of 06/09/2002.
@
text
@d6 1
a6 1
RCS: @@(#) $Id$
d23 1
a23 1
	http://www.tcl.tk/software/mac/features.html
@


1.15
log
@	* README:
	* mac/README: updated patchlevel to 8.4a3 and corrected links and
	notes.
@
text
@d3 2
a4 7
by Ray Johnson
Scriptics Corporation
rjohnson@@scriptics.com
with major help from
Jim Ingham
Cygnus Solutions
jingham@@cygnus.com
d6 1
a6 1
RCS: @@(#) $Id: README,v 1.14 2000/05/03 00:18:36 hobbs Exp $
d23 1
a23 1
	http://dev.scriptics.com/software/mac/features.html
@


1.14
log
@	* README:
	* generic/tk.h:
	* library/tk.tcl:
	* mac/README:
	* unix/README:
	* unix/configure.in:
	* unix/tk.spec:
	* win/README:
	* win/aclocal.m4:
	* win/configure.in:
	* win/makefile.vc: updated patchlevel to 8.4a1
@
text
@d11 1
a11 1
RCS: @@(#) $Id: README,v 1.13 2000/04/26 17:37:35 hobbs Exp $
d86 1
a86 2
	http://dev.scriptics.com/ticket/

@


1.14.2.1
log
@sync with head
@
text
@d3 7
a9 2
Originally by Ray Johnson while at Sun Microsystems Labs
with major help from Jim Ingham while at Cygnus Solutions
d11 1
a11 1
RCS: @@(#) $Id: README,v 1.17 2002/03/04 23:31:45 hobbs Exp $
d28 1
a28 1
	http://www.tcl.tk/software/mac/features.html
d86 2
a87 1
	http://tcl.sourceforge.net/
@


1.14.4.1
log
@        * Merged in updates from HEAD branch.
@
text
@d11 1
a11 1
RCS: @@(#) $Id: README,v 1.15 2001/04/02 02:08:36 hobbs Exp $
d86 2
a87 1
	http://tcl.sourceforge.net/
@


1.14.4.2
log
@	* Merged updates from HEAD
@
text
@d3 7
a9 2
Originally by Ray Johnson while at Sun Microsystems Labs
with major help from Jim Ingham while at Cygnus Solutions
d11 1
a11 1
RCS: @@(#) $Id: README,v 1.14.4.1 2001/07/03 20:01:09 dgp Exp $
d28 1
a28 1
	http://www.purl.org/tcl/home/software/mac/features.html
@


1.13
log
@	* README:
	* mac/README:
	* unix/README:
	* unix/tk.spec:
	* win/README: Updating URLs to reference dev.scriptics.com
@
text
@d1 1
a1 1
Tk 8.3 for Macintosh
d11 1
a11 1
RCS: @@(#) $Id: README,v 1.12 2000/02/10 08:47:20 jingham Exp $
@


1.13.2.1
log
@see ChangeLog for specific file details
@
text
@d11 1
a11 1
RCS: @@(#) $Id: README,v 1.13 2000/04/26 17:37:35 hobbs Exp $
d86 2
a87 1
	http://tcl.sourceforge.net/
@


1.13.2.2
log
@updated patchlevel to 8.3.4.
updated READMEs to point to www.tcl-tk.net where applicable.
added proper Win64 support to makefiles.
@
text
@d3 7
a9 2
Originally by Ray Johnson while at Sun Microsystems Labs
with major help from Jim Ingham while at Cygnus Solutions
d11 1
a11 1
RCS: @@(#) $Id: README,v 1.13.2.1 2001/04/04 07:57:17 hobbs Exp $
d28 1
a28 1
	http://www.tcl-tk.net/software/mac/features.html
@


1.13.2.3
log
@	* README:           updated to 8.3.5 patchlevel
	* generic/tk.h:     pointed README urls at www.tcl.tk
	* mac/README:
	* unix/README:
	* unix/configure:
	* unix/configure.in:
	* unix/tcl.m4:
	* unix/tk.spec:
	* win/README:
	* win/configure:
	* win/configure.in:
	* win/tcl.m4:
@
text
@d6 1
a6 1
RCS: @@(#) $Id: README,v 1.13.2.2 2001/10/03 22:04:52 hobbs Exp $
d23 1
a23 1
	http://www.tcl.tk/software/mac/features.html
@


1.12
log
@Minor Doco fixes.
@
text
@d11 1
a11 1
RCS: @@(#) $Id: README,v 1.11 1999/10/01 22:45:22 hobbs Exp $
d28 1
a28 1
	http://www.scriptics.com/mac/features.html
d85 2
a86 7
If you have comments or Bug reports send them to:
Jim Ingham
jingham@@cygnus.com

or use our on-line bug form at

http://www.scriptics.com/support/bugForm.html
@


1.11
log
@1999-09-24  Jeff Hobbs  <hobbs@@scriptics.com>

	* */README:
	* win/makefile.vc:
	* */configure.in:
	* generic/tk.h:
	* library/tk.tcl: up'd to 8.3a1

	* unix/Makefile.in: changed 'mkdir' to 'mkdir -p'

	* library/dialog.tcl: changed {Times 18} to {Times 12} for
	dialog font.
@
text
@d11 1
a11 1
RCS: @@(#) $Id: README,v 1.10 1999/06/25 23:30:26 welch Exp $
d64 1
a64 1
	CodeWarrior Pro 3 or higher
d66 1
a66 1
	  (which requires More Files 1.4.2 or 1.4.3)
a83 5
* If you get the Unix tar file, it will untar into a directory tcl8.0.4.
  However, the Macintosh project files expect the folder to be called
  tcl8.0.  You will need to rename the folder to tcl8.0, or change all the
  paths in the project files.

@


1.10
log
@Changed to Tk 8.2b1
@
text
@d1 1
a1 1
Tk 8.2 for Macintosh
d11 1
a11 1
RCS: @@(#) $Id: README,v 1.9 1999/04/24 01:50:50 stanton Exp $
d33 3
a35 3
Macintosh Tk is distributed in three different forms.  This 
should make it easier to only download what you need.  The 
packages are as follows:
d37 1
a37 1
mactk8.2.sea.hqx
d45 1
a45 1
mactcltk-full-8.2.sea.hqx
d51 1
a51 1
mactk-source-8.2.sea.hqx
d65 1
a65 1
	Mac Tcl 8.2 (source)
d67 1
a67 1
	Mac Tk 8.2 (source)
d80 1
a80 1
  that supports the Appearance Manager well.  Tk 8.0.4 extends this support
d84 4
a87 3
* If you get the Unix tar file, it will untar into a directory tcl8.0.4.  However,
  the Macintosh project files expect the folder to be called tcl8.0.  You will need
  to rename the folder to tcl8.0, or change all the paths in the project files.
@


1.9
log
@merged 8.1.0 changes into mainline
@
text
@d1 1
a1 1
Tk 8.1 for Macintosh
d11 1
a11 1
RCS: @@(#) $Id: README,v 1.8 1999/04/16 01:51:29 stanton Exp $
d37 1
a37 1
mactk8.1.sea.hqx
d45 1
a45 1
mactcltk-full-8.1.sea.hqx
d51 1
a51 1
mactk-source-8.1.sea.hqx
d65 1
a65 1
	Mac Tcl 8.1 (source)
d67 1
a67 1
	Mac Tk 8.1 (source)
@


1.8
log
@* Merged 8.1 branch into the main trunk
@
text
@d11 1
a11 1
RCS: @@(#) $Id$
a21 10
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.

d26 3
a28 34
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.)
d58 1
a58 40
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
a86 91


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.
@


1.8.4.1
log
@Trimmed out release-specific information from the READMEs and added
several pointers into the Scriptics web site.
@
text
@d11 1
a11 1
RCS: @@(#) $Id: README,v 1.8 1999/04/16 01:51:29 stanton Exp $
d22 10
d36 34
a69 3
the Macintosh version of Tk.  The list of these features is
maintained at
	http://www.scriptics.com/mac/features.html
d99 40
a138 1
5. Compiling Tk
d167 91
@


1.7
log
@* Merged changes from 8.0.5:
    - Updated for Mac release
@
text
@d1 1
a1 1
Tk 8.0.5 for Macintosh
d11 1
a11 1
RCS: @@(#) $Id: README,v 1.6 1999/01/04 19:25:27 rjohnson Exp $
d25 1
a25 42
Native Look & Feel!!!  We now try really hard to support the 
Macintosh Look & Feel with Tcl/Tk 8.0.  We aren't finished but
it look pretty good.  Let me know what are the most "un-mac like"
problems and I'll fix them as quickly as I can.

The button, checkbutton, radiobutton, and scrollbar widgets actually
use the Mac toolbox controls.  This means that they will track the
look&feel if you use extension that change the appearance of
applications (like Aaron.)  We also use "system" colors so the default
backgrounds etc. will also change colors.  We plan to support this
feature - so let me know if something doesn't work quite right.
Unfortunantly, we are not able to change the colors of buttons under
MacOS 8.  Doing this is discouraged under Appearance, and we will probably 
not implement it anytime soon.

We also now support native menus!  By using the new -menu option
on toplevels you can have a menubar that is cross platform.  You
can also place Tk menus in the Apple and Help menus!  Check out
the documentation for more details.  Syd Polk <icepick@@eng.sun.com> is
the author of the new menu code.  Feel free to contact him if you
have questions or comments about the menu mechanism.

As of Tk 8.0.4, MacTk menus will adopt the backgrounds, shape, separator, etc
of the current theme. 

The "tk_messageBox" command on the Macintosh is now much more
mac-like.  I'll probably still need to adjust this more - but it
looks a hell of alot better than it did before.

I've also added a command that allows you to get more native window
styles.  However, we have yet to decide on a cross platform solution
to the problem of varying window styles.  None the less, I thought
it would be use full to add the capability in an unsupported means
to tide you over until a better solution is available.  The command
is called "unsupported1".  It can be used in the following way:

	toplevel .foo; unsupported1 style .foo zoomDocProc

The above command will create a document window with a zoom box.
Type "unsupported1 style . ???" to get a list of the supported
styles.  The command works like "wm overrideredirect" - you must
make the call before the window is mapped.
d27 4
a30 2
As always - report the bugs you find - including asthetic ones
in the look & feel of widgets.
d63 2
a64 2
* The send command does not yet work on the Macintosh.  We hope to
  have it available in Tk 8.1.
d78 1
a78 1
mactk8.0.5.sea.hqx
d86 1
a86 1
mactcltk-full-8.0.5.sea.hqx
d92 1
a92 1
mactk-source-8.0.5.sea.hqx
d127 1
a127 1
	http://www.scriptics.com/man/tcl8.0/contents.html
d144 4
a147 6
	CodeWarrior Pro 1 or higher (CodeWarrior release 9 or higher can work
		and we have project files, but we are depricating support)
		8.0.5 was build with CW Pro 4.
	Mac Tcl 8.0 (source)
	  (which requires More Files 1.4.2 or greater - except not 1.4.4)
	Mac Tk 8.0 (source)
d151 2
a152 3
As with Tcl, there is something in the initial release of the CW Pro 2
linker that rendersthe CFM68K version of Wish very unstable.  I am
working with Metrowerks to resolve the issue.
d164 4
a167 4
* If you get the Unix tar file, it will untar into a directory
  tcl8.0.5.  However, the Macintosh project files expect the folder to
  be called tcl8.0.  You will need to rename the folder to tcl8.0, or
  change all the paths in the project files.
d172 4
a175 6
There is now a way to replace the default dialog box for the Wish
application.  If you create the tcl procedure "tkAboutDialog" it will
be called instead of creating the default dialog box.  Your procedure
is then responsible for displaying a window, removing it, etc.  This
interface is experimental and may change in the future - tell me what
you think of it.
d263 5
@


1.6
log
@
Updated the version to 8.0.5.
@
text
@d11 1
a11 1
RCS: @@(#) $Id: README,v 1.5 1998/11/12 05:59:13 jingham Exp $
d47 1
a47 1
As of Tk 8.0.5, MacTk menus will adopt the backgrounds, shape, separator, etc
d185 1
a185 1
		8.0.5 was build with CW Pro 3.
d187 1
a187 1
	  (which requires More Files 1.4.2 or 1.4.3)
@


1.6.2.1
log
@Fixed a few references to Tcl8.0.4 that were inappropriately changed to 8.0.5.
@
text
@d11 1
a11 1
RCS: @@(#) $Id: README,v 1.6 1999/01/04 19:25:27 rjohnson Exp $
d47 1
a47 1
As of Tk 8.0.4, MacTk menus will adopt the backgrounds, shape, separator, etc
d185 1
a185 1
		8.0.5 was build with CW Pro 4.
d187 1
a187 1
	  (which requires More Files 1.4.2 or greater - except not 1.4.4)
@


1.5
log
@Added comment about folder names for tcl  & tk, and one addition to the bugs.doc file.
@
text
@d1 1
a1 1
Tk 8.0.4 for Macintosh
d11 1
a11 1
RCS: @@(#) $Id: README,v 1.4 1998/11/11 17:29:34 jingham Exp $
d47 1
a47 1
As of Tk 8.0.4, MacTk menus will adopt the backgrounds, shape, separator, etc
d117 1
a117 1
mactk8.0.4.sea.hqx
d125 1
a125 1
mactcltk-full-8.0.4.sea.hqx
d131 1
a131 1
mactk-source-8.0.4.sea.hqx
d185 1
a185 1
		8.0.4 was build with CW Pro 3.
d206 4
a209 4
* If you get the Unix tar file, it will untar into a directory tcl8.0.4.  However,
  the Macintosh project files expect the folder to be called tcl8.0.  You will need
  to rename the folder to tcl8.0, or change all the paths in the project files.

@


1.4
log
@Make the Macintosh Menu's adopt the current Theme Appearance if the Appearance extension (version 1.0.1 or later) is installed
@
text
@d11 1
a11 1
RCS: @@(#) $Id: README,v 1.3 1998/09/14 18:23:33 stanton Exp $
d203 7
a209 1
  to the menu system.
@


1.3
log
@Replaced SCCS strings, fixed binary files
@
text
@d1 1
a1 1
Tk 8.0.3 for Macintosh
d11 1
a11 1
RCS: @@(#) $Id$
d37 2
a38 4
MacOS 8.  We are working on a solution to this.  
In the meantime, if you really must have colored buttons, turn off the 
"System-wide platinum appearance" option in the Appearance Control Panel,
and you will get the System 7, colorable, buttons back.
d47 3
d117 1
a117 1
mactk8.0.3.sea.hqx
d125 1
a125 1
mactcltk-full-8.0.3.sea.hqx
d131 1
a131 1
mactk-source-8.0.3.sea.hqx
a137 6
UNIX Tar file distribution.
    The standard Tcl/Tk source distribution has Mac project files
    in it.  Be warned that the Tk project file is lacking one minor
    change compared to the ones in the installers listed above
    having to do with locking down the MDEF resource.

d185 1
a185 1
		8.0.3 was build with CW Pro 3.
d202 2
a203 1
  that supports the Appearance Manager well.
@


1.2
log
@*** empty log message ***
@
text
@d11 1
a11 1
SCCS: %Z% $Id$ 
@


1.1
log
@Initial revision
@
text
@d1 1
a1 1
Tk 8.0 for Macintosh
d4 6
a9 2
Sun Microsystems Laboratories
rjohnson@@eng.sun.com
d11 1
a11 1
SCCS: @@(#) README 1.30 97/11/20 22:06:57
d116 1
a116 1
mactk8.0.sea.hqx
d124 1
a124 1
mactcltk-full-8.0.sea.hqx
d130 1
a130 1
mactk-source-8.0.sea.hqx
d137 6
d146 1
a146 1
Two books are currently available for Tcl.  Both provide a good
d160 3
d171 1
a171 1
	http://sunscript.sun.com/man/tcl8.0/contents.html
d190 1
d206 2
a207 11
  with MacOS 8.  At this point, the only feature that we are using is 
  the API to Iconify windows (so that wm iconify will work).   However,
  as of the release of Tk8.0p1, the SDK from Apple is still in Beta, so 
  we cannot ship it.  So support for the Appearance Manager is turned off
  in the source version of Tk8.0p1.
  If you want to build Tk, and want to get the Appearance Manager features, 
  then need to do the following:
      1) get the SDK from Apple
      2) Uncomment the #define HAVE_APPEARANCE line in tk8.0:mac:MW_TkHeader.pch
      3) Add the Appearance.lib to tk8.0:mac:TkShells.¼, and put the include 
         directory of the SDK on your path in this project, and TkLibraries.¼.
d304 1
a304 1
jingham@@eng.sun.com
@


1.1.4.1
log
@initial tk8.1a2 version
@
text
@d1 1
a1 1
Tk 8.1 for Macintosh
d3 1
a3 1
by Ray Johnson and Jim Ingham
a5 1
jim.ingham@@sun.com
d7 1
a7 1
SCCS: @@(#) README 1.33 98/02/18 11:23:12
d21 41
a61 1
All the widgets will now display internationalized text!
d63 2
a64 4
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.
d97 2
a98 2
* The send command works among interpreters in the same application.  We hope to
  have the complete implementation available in Tk 8.1.
d112 1
a112 1
mactk8.1.sea.hqx
d120 1
a120 1
mactcltk-full-8.1.sea.hqx
d126 1
a126 1
mactk-source-8.1.sea.hqx
d175 3
a177 2
	CodeWarrior Pro 2 or higher
	Mac Tcl 8.1 (source)
d179 1
a179 1
	Mac Tk 8.1 (source)
d183 3
a185 2
As with Tcl, you need to upgrade to the 2.0.1 version of the C
compilers or later to build the CFM68K version of Tcl/Tk.
d192 11
a202 7
  with MacOS 8.  wm iconify uses it, and the coloring of the
  backgrounds of radiobuttons & checkbuttons now works under
  Appearance.  Tk correctly checks the Gestalt for Appearance, so you
  do not have to install it on your target machines.  However, you do
  have to have the header and stub files to build it.  These come with
  CWPro 2, and are also available now from Apple.

d207 6
a212 4
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!
@


1.1.4.2
log
@Merged 8.0.3 changes into 8.1
@
text
@d3 4
a6 7
by Ray Johnson
Scriptics Corporation
rjohnson@@scriptics.com
with major help from
Jim Ingham
Cygnus Solutions
jingham@@cygnus.com
d8 1
a8 1
RCS: @@(#) $Id: README,v 1.3 1998/09/14 18:23:33 stanton Exp $
a95 6
UNIX Tar file distribution.
    The standard Tcl/Tk source distribution has Mac project files
    in it.  Be warned that the Tk project file is lacking one minor
    change compared to the ones in the installers listed above
    having to do with locking down the MDEF resource.

d99 1
a99 1
There are now many books available for Tcl.  These two provide a good
a112 3
More books are listed at
    http://www.scriptics.com/resource/doc/books/

d121 1
a121 1
	http://www.scriptics.com/man/tcl8.0/contents.html
d138 1
a138 1
	CodeWarrior Pro 3 or higher
d153 7
a159 2
  with MacOS 8.0.  The Tk 8.0.3 release is the first Tk release
  that supports the Appearance Manager well.
d254 1
a254 1
jingham@@cygnus.com
@


1.1.4.3
log
@* integrated tk8.0.4 changes.

* generic/tkBind.c: fixed deletion order bug where a crash would
result if a binding deleted "."
@
text
@d11 1
a11 1
RCS: @@(#) $Id: README,v 1.1.4.2 1998/09/30 02:17:59 stanton Exp $
d99 6
d166 1
a166 8
  that supports the Appearance Manager well.  Tk 8.0.4 extends this support
  to the menu system, though you have to have Appearance 1.0.1 or later
  installed for this to work.
  
* If you get the Unix tar file, it will untar into a directory tcl8.0.4.  However,
  the Macintosh project files expect the folder to be called tcl8.0.  You will need
  to rename the folder to tcl8.0, or change all the paths in the project files.

@


1.1.4.4
log
@Changed patch level to 8.1b1
@
text
@d11 1
a11 1
RCS: @@(#) $Id: README,v 1.1.4.3 1998/11/25 21:16:35 stanton Exp $
d127 1
a127 1
	http://www.scriptics.com/man/tcl8.1/contents.html
a262 5

or use our on-line bug form at

http://www.scriptics.com/support/bugForm.html

@


