summaryrefslogtreecommitdiffstats
path: root/macosx/README
diff options
context:
space:
mode:
Diffstat (limited to 'macosx/README')
-rw-r--r--macosx/README17
1 files changed, 16 insertions, 1 deletions
diff --git a/macosx/README b/macosx/README
index c63b8ae..3da5c75 100644
--- a/macosx/README
+++ b/macosx/README
@@ -185,7 +185,22 @@ Support for the 3 argument form was added with the Cocoa-based Tk 8.5.7, 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).
-If you want to use Remote Debugging with Xcode, you need to set the
+- Another command available in the tk::unsupported::MacWindowStyle namespace is
+tk::unsupported::MacWindowStyle tabbingid window ?newId? which can be used to
+get or set the tabbingIdentifier for the NSWindow associated with a Tk Window.
+(This is only available for OSX 10.12 and later, since the tabbingIdentifier
+does not exist on earlier systems.) The command returns the tabbingIdentifier
+of the window prior to calling this function. If the optional newId argument
+is omitted, the window's tabbingIdentifier is not changed.
+
+The purpose of the tabbingIdentifier is that NSWindows may only be grouped
+together as tabs if they all have the same tabbingIdentifier. In particular,
+by giving a window a unique tabbingIdentifier one can prevent it from becoming
+a tab in any other window. Note, however, that changing the tabbingIdentifier
+of a window which is already a tab does not cause it to become a separate
+window.
+
+- If you want to use Remote Debugging with Xcode, you need to set the
environment variable XCNOSTDIN to 1 in the Executable editor for Wish. That will
cause us to force closing stdin & stdout. Otherwise, given how Xcode launches
Wish remotely, they will be left open and then Wish & gdb will fight for stdin.