Tk Source Code

Check-in [731a5957]
Login

Many hyperlinks are disabled.
Use anonymous login to enable hyperlinks.

Overview
Comment:Ticket [9ba9729ef1]: text complements for man winfo and man send
Downloads: Tarball | ZIP archive
Timelines: family | ancestors | descendants | both | bug-9ba9729ef1
Files: files | file ages | folders
SHA3-256: 731a5957cc7b4f61c57800db37d22e24bb298067ae1b5e4e6e7db82698dbb9a9
User & Date: erikleunissen 2025-08-16 07:43:40.304
Original Comment: Proposed texts for man winfo and man send
Context
2025-08-16
09:06
send.test: on macOS/aqua skip tests that send to interps in other processes (add constraint notAqua) check-in: 1f3dbb47 user: erikleunissen tags: bug-9ba9729ef1
07:43
Ticket [9ba9729ef1]: text complements for man winfo and man send check-in: 731a5957 user: erikleunissen tags: bug-9ba9729ef1
2025-08-15
22:25
Merge 9.0 Leaf check-in: 031211db user: jan.nijtmans tags: trunk, main
Changes
Unified Diff Ignore Whitespace Patch
Changes to doc/send.n.
86
87
88
89
90
91
92






93
94
95
96
97
98
99
is enabled (i.e. only certain hosts can establish connections) and (b) the
list of enabled hosts is empty.
This means that applications cannot connect to your server unless
they use some other form of authorization
such as that provide by \fBxauth\fR.
Under Windows, \fBsend\fR is currently disabled.  Most of the
functionality is provided by the \fBdde\fR command instead.






.SH EXAMPLE
.PP
This script fragment can be used to make an application that only runs
once on a particular display.
.CS
if {[tk appname FoobarApp] ne "FoobarApp"} {
    \fBsend\fR -async FoobarApp RemoteStart $argv







>
>
>
>
>
>







86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
is enabled (i.e. only certain hosts can establish connections) and (b) the
list of enabled hosts is empty.
This means that applications cannot connect to your server unless
they use some other form of authorization
such as that provide by \fBxauth\fR.
Under Windows, \fBsend\fR is currently disabled.  Most of the
functionality is provided by the \fBdde\fR command instead.
.SH LIMITATIONS
.PP
Under macOS/aqua, the send command works only with interpreters that exist in
the same process (these are returned by "winfo interps"). Invocations that
target an interpreter that exists in another process return an empty string
without accomplishing anything; no error is returned.
.SH EXAMPLE
.PP
This script fragment can be used to make an application that only runs
once on a particular display.
.CS
if {[tk appname FoobarApp] ne "FoobarApp"} {
    \fBsend\fR -async FoobarApp RemoteStart $argv
Changes to doc/winfo.n.
150
151
152
153
154
155
156


157
158
159
160
161
162
163
\fBwinfo interps \fR?\fB\-displayof \fIwindow\fR?
.
Returns a list whose members are the names of all Tcl interpreters
(e.g. all Tk-based applications) currently registered for a particular display.
If the \fB\-displayof\fR option is given then the return value refers
to the display of \fIwindow\fR;  otherwise it refers to
the display of the application's main window.


.\" METHOD: ismapped
.TP
\fBwinfo ismapped \fIwindow\fR
.
Returns \fB1\fR if \fIwindow\fR is currently mapped, \fB0\fR otherwise.
.\" METHOD: manager
.TP







>
>







150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
\fBwinfo interps \fR?\fB\-displayof \fIwindow\fR?
.
Returns a list whose members are the names of all Tcl interpreters
(e.g. all Tk-based applications) currently registered for a particular display.
If the \fB\-displayof\fR option is given then the return value refers
to the display of \fIwindow\fR;  otherwise it refers to
the display of the application's main window.
Under macOS/aqua, the command returns only the interpreters that exist in the
same process as the current interpreter.
.\" METHOD: ismapped
.TP
\fBwinfo ismapped \fIwindow\fR
.
Returns \fB1\fR if \fIwindow\fR is currently mapped, \fB0\fR otherwise.
.\" METHOD: manager
.TP