'''TODO:''' ---- '''1. Installation and Getting Started Guide''' - how to install the Tcl suite on various platforms and some basic advice for newbies. Maybe it would be good to have some HOWTOs: *Sun-Install-HOWTO *HPUX-Install-HOWTO *Debian-Install-HOWTO *RedHat-Install-HOWTO and s.o. '''2.Extensions Use Guide''' - what kinds of extensions exist and what kinds of use can each of them be used. Maybe: - TclX-Extension-HOWTO - itcl-Extension-HOWTO and s.o '''3.Extensions Programmer Guide''' - how to write extensions so there aren't collisions. ([LV]: This is basically the Tcl Extension Architecture '''[TEA]'''.) I think writing some kind of Extension manager is good. This needs to be something like Debian dselect tool or Redhat RPM, some program that will know what extensions are installed, in which directory, where the config files for this extension are located, whether there are collisions with some other extension etc. '''4.Tcl/Tk Core Hackers Guide''' - more about core of the Tcl suite. Some map of the Tcl/Tk core sources. '''5.Guide to using Tcl/Tk as a C library''' rather than a programming language. '''6.Guide to extending Tcl/Tk''' with standalone executables and IPC, instead of loadable/static extensions. ---- There used to be a mailing list for TTDP: URL for registration: http://www.onelist.com/subscribe.cgi/ttdp Subscribe through email: * mailto:ttdp-subscribe@onelist.com - subscribe to a list. * mailto:ttdp-unsubscribe@onelist.com - unsubscribe from a list. * mailto:ttdp-digest@onelist.com - switch your subscription to digest mode. * mailto:ttdp-normal@onelist.com - switch your subscription to normal mode. Archive of all messages is available. http://www.onelist.com/arcindex.cgi?listname=ttdp The address to which you send emails is mailto:ttdp@onelist.com. ---- The site formerly known as onelist.com was sold sometime ago to egroups.com - now that egroups.com also has been sold to yahoo.com, I find the above no longer appears to work - anyone know where the project resides these days? ([LV] as far as I am aware, the project was fairly low volume anyways - few people seemed to be involved in improving the Tcl docs. I don't know that it went anywhere.) I'm really interested in knowing whether there is a PDF collecting all Tcl, Tk, and related extension man pages... ---- [LV] From a discussion on the chat room: I hypothesize that there are at least 4 layers of doc that a language needs: 1. User layer - this layer is generally expected to be written by an application developer. However, having some standard documentation provided by Tcl, Tk, and other extensions makes life easier for the app developer. The type of doc intended here is for someone trying to use an application written in tcl, tk, etc. For instance, documenting environment variables, default widget behavior, how to set options to configure widgets, how to customize aspects of the language itself, etc. This doc is '''not''' intended for a programmer, but a user. 1. Script developer layer - this layer tells someone writing an application purely in Tcl. This is basically what we have in section ''n'' of the man pages, for instance. Not only basic information is here - some layer of depth, regarding optimation issues, etc. would be expected for this type of programming. However, one would expect to be talking to someone who may be uncomfortable at digging into the C source code for instance. 1. C public API/Stubs developer layer - this layer is intended by use for someone writing C extensions, trying to do more in depth optimisations, or even some degree of debugging of more serious problems. 1. Tcl internals layer - at this point, the person needing to get this deep had better be prepared to learn C pretty well. This layer of doc should deal with how Tcl handles things internally, out of sight even to the extension developer. People doing hard core debugging, as well as people trying to do more than ''casual'' extension writing.