Tcl package Thread source code

Check-in [65f81bd56a]
Login
Bounty program for improvements to Tcl and certain Tcl packages.
Tcl 2019 Conference, Houston/TX, US, Nov 4-8
Send your abstracts to [email protected]
or submit via the online form by Sep 9.

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

Overview
Comment:clarifying of thread::create documentation, closes [f5a5c23f47bef3d7]
Downloads: Tarball | ZIP archive | SQL archive
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA3-256: 65f81bd56adc79353c9510bad35e1989fa2bd867e2a5c4f1d49d83f16768fed6
User & Date: sebres 2019-05-09 16:05:18
References
2019-05-09
16:09 Closed ticket [f5a5c23f47]: Clarify execution order for thread creation scripts plus 6 other changes artifact: c2bd66db81 user: sebres
Context
2019-05-09
16:20
small amend check-in: 6eef222a2f user: sebres tags: trunk
16:05
clarifying of thread::create documentation, closes [f5a5c23f47bef3d7] check-in: 65f81bd56a user: sebres tags: trunk
2019-03-28
20:18
merge-mark check-in: ffb96f851c user: jan.nijtmans tags: trunk
Changes
Hide Diffs Unified Diffs Ignore Whitespace Patch

Changes to doc/man/thread.n.

358
359
360
361
362
363
364
365
366


367
368
369
370
371
372
373
This section describes commands for creating and destroying threads
and sending scripts to threads for evaluation\&.
.TP
\fBthread::create\fR ?-joinable? ?-preserved? ?script?
This command creates a thread that contains a Tcl interpreter\&.
The Tcl interpreter either evaluates the optional \fBscript\fR, if
specified, or it waits in the event loop for scripts that arrive via
the \fBthread::send\fR command\&. The result, if any, of the
optional \fBscript\fR is never returned to the caller\&.


The result of \fBthread::create\fR is the ID of the thread\&. This is
the opaque handle which identifies the newly created thread for
all other package commands\&. The handle of the thread goes out of scope
automatically when thread is marked for exit
(see the \fBthread::release\fR command below)\&.
.sp
If the optional \fBscript\fR argument contains the \fBthread::wait\fR






|
|
>
>







358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
This section describes commands for creating and destroying threads
and sending scripts to threads for evaluation\&.
.TP
\fBthread::create\fR ?-joinable? ?-preserved? ?script?
This command creates a thread that contains a Tcl interpreter\&.
The Tcl interpreter either evaluates the optional \fBscript\fR, if
specified, or it waits in the event loop for scripts that arrive via
the \fBthread::send\fR command\&. Both of them would take place simultaneously
with the return of command \fBthread::create\fR to the caller thread\&.
Neither the caller wait for the evaluation of optional \fBscript\fR,
nor the result, if any, of the \fBscript\fR is returned to the caller\&.
The result of \fBthread::create\fR is the ID of the thread\&. This is
the opaque handle which identifies the newly created thread for
all other package commands\&. The handle of the thread goes out of scope
automatically when thread is marked for exit
(see the \fBthread::release\fR command below)\&.
.sp
If the optional \fBscript\fR argument contains the \fBthread::wait\fR