From 9025e3c799817de9b380db2644dd47a61924c5eb Mon Sep 17 00:00:00 2001 From: das Date: Sun, 29 Apr 2007 02:25:54 +0000 Subject: * 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]. --- doc/colors.n | 152 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++- doc/cursors.n | 29 +++++++++-- doc/font.n | 7 +-- doc/wm.n | 14 +++++- 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 '\" -'\" 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 +'\" +'\" 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 '\" '\" 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. -- cgit v0.12