http://www.tcl.tk/man/tcl8.5/tutorial/tcltutorial.html is a tutorial for Tcl, built upon TclTutor and designed to be included in the distribution. Clif Flynt, Neil Madden, Arjen Markus, David Welton and others have contributed the information contained in the tutorial.
Since this tutorial is free software under the same generous license as Tcl itself, you are welcome to help improve it, translate it, publish it, or do whatever else you would like.
Comments and suggestions on the contents from both new and experience users are very welcome.
SYStems How can we comment? I suggest a comment sections beneath each lesson. It will act like slashdot story comments, sometimes you can learn more from the comments than from the story. Actually this way the lesson itself can be very basic, and all the gotchas can appear in the users comments.
davidw You can comment just as you would with any other aspect of Tcl - via the tcl-core mailing list, or via the SF bug/request trackers. An on-line version with comments might be kind of neat, but I'm unlikely to spend time building that myself. I want something that can be shipped as-is with the core. So if there are things that need fixing/improving, let's do it.
LV 2007-12-13 Turns out that this is not the case after all. Apparently there was differing expectations concerning the purpose of the tutorial. In any case, the above tutorial was not included in the Tcl 8.5.0 distribution.
LV 2009-Aug-27 In a recent posting to comp.lang.tcl, NEM writes:
...project to update the Tcl tutorial into a book, somewhat along the lines you mention. It's available at http://www.cs.nott.ac.uk/~nem/tcl/tcltutorial/book/html/tutorial.html and is being written as a free Creative Commons licensed resource for the community. Unfortunately, I'm just one rather busy person, so progress comes in dribs and drabs when I find time. Arjen Markus has also contributed the beginning Tk chapters, and some material has been adapted from the original Tcl tutorial (itself based on TclTutor).
A high-quality PDF version is also available for printing: http://www.cs.nott.ac.uk/~nem/tcl/tcltutorial/book/pdf/tutorial.pdf
RLH -- Is this still ongoing?
LV If you are talking about NEM's project, notice that his comment was made last week, so it seems likely it is still ongoing. If you are talking about the work on the tcltutorial files at sf.net, work on those is open to anyone who wants to submit feature request or bug report updates to the files.
NEM Yes, work on the new tutorial book is ongoing, if slow at times. The original tutorial is basically in maintenance mode: we update it in response to bug reports and requests, but not much active development.
LV 17 months after the above information, I am curious whether NEM and the others are continuing to work on the tutorial/book? I know that above there is a mention that people are busy. It is difficult to determine when the last updates occurred, and how much of Tcl/Tk 8.6 is present in the book.
jamc - 2009-11-22 15:49:58
Hi everyone! Sorry if not using the proper writing rules in wiki. I'm insterested in translating the tutorial into Spanish. Is there a translating project? I found nothing about it in the site. Please let me know if I could start working on it. Thanks.
LVwikignome - 2009-11-23 09:06:07
Is the translation interest in the tcl tutorial software, or the tcl tutorial static web pages? I've not heard of anyone working on either. However, each of these items has its own contact. That is who you should email, to confirm and perhaps coordinate.
LVwikignome - 2009-11-23 09:08:57
Has anyone recently gone through the tcl tutorial static web pages, and compared the packages, commands, and options in Tcl 8.6 with the text, to determine how much of Tcl 8.6 is covered, and what parts still need to be covered? Just curious.