summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authordas <das>2007-04-29 02:25:54 (GMT)
committerdas <das>2007-04-29 02:25:54 (GMT)
commit4aa49bb9f98656f10cd297d9b64513b15cdce513 (patch)
tree43376ab4083bd27e4465cd367c4158fa92aaae69 /doc
parentc01c10244df7a1ead8fdca3837c5e3e37da504d3 (diff)
downloadtk-4aa49bb9f98656f10cd297d9b64513b15cdce513.zip
tk-4aa49bb9f98656f10cd297d9b64513b15cdce513.tar.gz
tk-4aa49bb9f98656f10cd297d9b64513b15cdce513.tar.bz2
* doc/colors.n: document new Mac OS X system colors.
* doc/cursors.n: document new Mac OS X native cursors. * doc/font.n: document new Mac OS X 'menu' system font. * doc/wm.n: document new Mac OS X [wm attributes].
Diffstat (limited to 'doc')
-rw-r--r--doc/colors.n152
-rw-r--r--doc/cursors.n29
-rw-r--r--doc/font.n7
-rw-r--r--doc/wm.n14
4 files changed, 192 insertions, 10 deletions
diff --git a/doc/colors.n b/doc/colors.n
index 1b086d8..6a66976 100644
--- a/doc/colors.n
+++ b/doc/colors.n
@@ -1,8 +1,9 @@
'\"
'\" Copyright (c) 1998-2000 by Scriptics Corporation.
'\" Copyright (c) 2003 ActiveState Corporation.
+'\" Copyright (c) 2006-2007 Daniel A. Steffen <das@users.sourceforge.net>
'\"
-'\" RCS: @(#) $Id: colors.n,v 1.4 2003/02/18 20:57:44 hobbs Exp $
+'\" RCS: @(#) $Id: colors.n,v 1.4.2.1 2007/04/29 02:25:54 das Exp $
'\"
'\"
.so man.macros
@@ -14,10 +15,11 @@ colors \- symbolic color names recognized by Tk
.BE
.SH DESCRIPTION
.PP
-Tk recognizes many symbolic color names (eg, \fBred\fR) when
+Tk recognizes many symbolic color names (e.g., \fBred\fR) when
specifying colors. The symbolic names recognized by Tk and their
8-bit RGB values are:
.CS
+\fIName\fR \fIRed\fR \fIGreen\fR \fIBlue\fR
alice blue 240 248 255
AliceBlue 240 248 255
antique white 250 235 215
@@ -778,5 +780,151 @@ yellow4 139 139 0
YellowGreen 154 205 50
.CE
+.SH "PORTABILITY ISSUES"
+
+.TP
+\fBMac OS X\fR
+On Mac OS X, the following additional system colors are available
+(note that the actual color values depend on the currently active OS theme,
+and typically many of these will in fact be patterns rather than pure colors):
+.RS
+.CS
+systemTransparent
+systemBlack
+systemWhite
+systemHighlight
+systemPrimaryHighlightColor
+systemHighlightSecondary
+systemSecondaryHighlightColor
+systemHighlightAlternate
+systemAlternatePrimaryHighlightColor
+systemHighlightText
+systemDialogBackgroundActive
+systemDialogBackgroundInactive
+systemAlertBackgroundActive
+systemAlertBackgroundInactive
+systemModelessDialogBackgroundActive
+systemModelessDialogBackgroundInactive
+systemUtilityWindowBackgroundActive
+systemUtilityWindowBackgroundInactive
+systemListViewSortColumnBackground
+systemListViewBackground
+systemIconLabelBackground
+systemListViewSeparator
+systemChasingArrows
+systemDragHilite
+systemWindowBody
+systemDocumentWindowBackground
+systemFinderWindowBackground
+systemScrollBarDelimiterActive
+systemScrollBarDelimiterInactive
+systemFocusHighlight
+systemPopupArrowActive
+systemPopupArrowPressed
+systemPopupArrowInactive
+systemAppleGuideCoachmark
+systemIconLabelBackgroundSelected
+systemStaticAreaFill
+systemActiveAreaFill
+systemButtonFrame
+systemButtonFrameActive
+systemButtonFrameInactive
+systemButtonFace
+systemButtonFaceActive
+systemButtonFaceInactive
+systemButtonFacePressed
+systemButtonActiveDarkShadow
+systemButtonActiveDarkHighlight
+systemButtonActiveLightShadow
+systemButtonActiveLightHighlight
+systemButtonInactiveDarkShadow
+systemButtonInactiveDarkHighlight
+systemButtonInactiveLightShadow
+systemButtonInactiveLightHighlight
+systemButtonPressedDarkShadow
+systemButtonPressedDarkHighlight
+systemButtonPressedLightShadow
+systemButtonPressedLightHighlight
+systemBevelActiveLight
+systemBevelActiveDark
+systemBevelInactiveLight
+systemBevelInactiveDark
+systemNotificationWindowBackground
+systemMovableModalBackground
+systemSheetBackground
+systemSheetBackgroundOpaque
+systemDrawerBackground
+systemToolbarBackground
+systemSheetBackgroundTransparent
+systemMenu
+systemMenuBackground
+systemMenuActive
+systemMenuBackgroundSelected
+systemListViewOddRowBackground
+systemListViewEvenRowBackground
+systemListViewColumnDivider
+systemTabPaneBackground
+systemPlacardBackground
+systemWindowHeaderBackground
+systemListViewWindowHeaderBackground
+systemSecondaryGroupBoxBackground
+systemMetalBackground
+systemBlackText
+systemWhiteText
+systemDialogActiveText
+systemDialogInactiveText
+systemAlertActiveText
+systemAlertInactiveText
+systemModelessDialogActiveText
+systemModelessDialogInactiveText
+systemWindowHeaderActiveText
+systemWindowHeaderInactiveText
+systemPlacardActiveText
+systemPlacardInactiveText
+systemPlacardPressedText
+systemButtonText
+systemPushButtonActiveText
+systemPushButtonInactiveText
+systemPushButtonPressedText
+systemBevelButtonActiveText
+systemBevelButtonInactiveText
+systemBevelButtonPressedText
+systemPopupButtonActiveText
+systemPopupButtonInactiveText
+systemPopupButtonPressedText
+systemIconLabelText
+systemListViewText
+systemDocumentWindowTitleActiveText
+systemDocumentWindowTitleInactiveText
+systemMovableModalWindowTitleActiveText
+systemMovableModalWindowTitleInactiveText
+systemUtilityWindowTitleActiveText
+systemUtilityWindowTitleInactiveText
+systemPopupWindowTitleActiveText
+systemPopupWindowTitleInactiveText
+systemRootMenuActiveText
+systemRootMenuSelectedText
+systemRootMenuDisabledText
+systemMenuText
+systemMenuItemActiveText
+systemMenuActiveText
+systemMenuItemSelectedText
+systemMenuDisabled
+systemMenuItemDisabledText
+systemPopupLabelActiveText
+systemPopupLabelInactiveText
+systemTabFrontActiveText
+systemTabNonFrontActiveText
+systemTabNonFrontPressedText
+systemTabFrontInactiveText
+systemTabNonFrontInactiveText
+systemIconLabelSelectedText
+systemBevelButtonStickyActiveText
+systemBevelButtonStickyInactiveText
+systemNotificationText
+systemSystemDetailText
+.CE
+.RE
+
.SH KEYWORDS
color, option
diff --git a/doc/cursors.n b/doc/cursors.n
index 0855f5f..a1d82b1 100644
--- a/doc/cursors.n
+++ b/doc/cursors.n
@@ -2,7 +2,9 @@
'\" Copyright (c) 1998-2000 by Scriptics Corporation.
'\" All rights reserved.
'\"
-'\" RCS: @(#) $Id: cursors.n,v 1.3 2002/11/15 15:35:55 dkf Exp $
+'\" Copyright (c) 2006-2007 Daniel A. Steffen <das@users.sourceforge.net>
+'\"
+'\" RCS: @(#) $Id: cursors.n,v 1.3.2.1 2007/04/29 02:25:54 das Exp $
'\"
'\"
.so man.macros
@@ -132,8 +134,8 @@ The \fBno\fR cursor can be specified to eliminate the cursor.
.RE
.TP
-\fBMacintosh\fR
-On Macintosh systems, the following cursors are mapped to native cursors:
+\fBMac OS X\fR
+On Mac OS X systems, the following cursors are mapped to native cursors:
.RS
.CS
arrow
@@ -144,10 +146,29 @@ plus
watch
xterm
.CE
-And the following additional cursors are available:
+And the following additional native cursors are available:
.CS
+copyarrow
+aliasarrow
+contextualmenuarrow
text
cross-hair
+closedhand
+openhand
+pointinghand
+resizeleft
+resizeright
+resizeleftright
+resizeup
+resizedown
+resizeupdown
+none
+notallowed
+poof
+countinguphand
+countingdownhand
+countingupanddownhand
+spinning
.CE
.RE
diff --git a/doc/font.n b/doc/font.n
index c25512a..6c75b66 100644
--- a/doc/font.n
+++ b/doc/font.n
@@ -1,10 +1,11 @@
'\"
'\" Copyright (c) 1996 Sun Microsystems, Inc.
+'\" Copyright (c) 2006-2007 Daniel A. Steffen <das@users.sourceforge.net>
'\"
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\"
-'\" RCS: @(#) $Id: font.n,v 1.3.8.1 2004/10/28 10:19:29 dkf Exp $
+'\" RCS: @(#) $Id: font.n,v 1.3.8.2 2007/04/29 02:25:54 das Exp $
'\"
.so man.macros
.TH font n 8.0 Tk "Tk Built-In Commands"
@@ -273,10 +274,10 @@ MS Windows:
systemfixed ansifixed oemfixed\fR
.DE
.TP
-Macintosh:
+Mac OS X:
.DS
.ta 3c 6c
-\fBsystem application\fR
+\fBsystem application menu\fR
.DE
.RE
.SH EXAMPLE
diff --git a/doc/wm.n b/doc/wm.n
index c61fb21..361fc26 100644
--- a/doc/wm.n
+++ b/doc/wm.n
@@ -5,7 +5,7 @@
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\"
-'\" RCS: @(#) $Id: wm.n,v 1.11.2.5 2006/12/01 19:47:41 hobbs Exp $
+'\" RCS: @(#) $Id: wm.n,v 1.11.2.6 2007/04/29 02:25:54 das Exp $
'\"
.so man.macros
.TH wm n 8.4 Tk "Tk Built-In Commands"
@@ -100,6 +100,18 @@ can be dragged and dropped in lieu of the file's finder icon).
Specifies the alpha transparency level of the window.
It accepts a value from \fB0.0\fR (fully transparent) to \fB1.0\fR (opaque),
values outside that range will be constrained.
+.TP
+\fB\-topmost\fR
+Specifies whether this is a topmost window (displays above all other windows).
+.TP
+\fB\-transparent\fR
+Makes the window content area transparent and turns off the window shadow. For
+the transparency to be effecive, the toplevel background needs to be set to a
+color with some alpha, e.g. "systemTransparent".
+.TP
+\fB\-fullscreen\fR
+Places the window in a mode that takes up the entire main screen and hides
+the dock and menu bar.
.RE
.PP
On X11, there are currently no special attribute values.