http://www.tcl.tk/man/tcl/tutorial/tcltutorial.html is the "official" 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.
Of course, just because there are plans to ship a tutorial with the Tcl core should not discourage anyone from writing their own tutorials. There are many ways to learn, and having many tutorials provides people with choices. As long as the information is correct, having choices is a good thing.
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 Question: has anyone examined the tutorial to determine how much of the tcl scripting level language has been covered and how much remains to be covered?
NEM No. It's something I plan to do when I have more time, which should be after Christmas 2008.
LV another item of note - the above official tutorial is currently just for Tcl. If someone is looking for a useful contribution, writing similar tutorials for Tk, as well as other popular extensions, would be a wonderful thing to give back to the community.
Hopefully, you will be able to work with the others so that all the tutorials could end up in the same location, providing an evolving community electronic tcl book of sorts.
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).
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.
NEM 2011-01-13: There hasn't been much activity recently. I'm planning to resume work on the book soon, but it will be at a different web address (as I no longer work at the university). I'll update here when it resumes. There is some coverage of 8.6 features, but I need to review what new additions have been made since I last updated.