|
| 1 | +README: Tcl |
| 2 | + This is the Tcl 8.6.6 source distribution. |
| 3 | + http://sourceforge.net/projects/tcl/files/Tcl/ |
| 4 | + You can get any source release of Tcl from the URL above. |
| 5 | + |
| 6 | +Contents |
| 7 | +-------- |
| 8 | + 1. Introduction |
| 9 | + 2. Documentation |
| 10 | + 3. Compiling and installing Tcl |
| 11 | + 4. Development tools |
| 12 | + 5. Tcl newsgroup |
| 13 | + 6. The Tcler's Wiki |
| 14 | + 7. Mailing lists |
| 15 | + 8. Support and Training |
| 16 | + 9. Tracking Development |
| 17 | + 10. Thank You |
| 18 | + |
| 19 | +1. Introduction |
| 20 | +--------------- |
| 21 | +Tcl provides a powerful platform for creating integration applications that |
| 22 | +tie together diverse applications, protocols, devices, and frameworks. |
| 23 | +When paired with the Tk toolkit, Tcl provides the fastest and most powerful |
| 24 | +way to create GUI applications that run on PCs, Unix, and Mac OS X. |
| 25 | +Tcl can also be used for a variety of web-related tasks and for creating |
| 26 | +powerful command languages for applications. |
| 27 | + |
| 28 | +Tcl is maintained, enhanced, and distributed freely by the Tcl community. |
| 29 | +Source code development and tracking of bug reports and feature requests |
| 30 | +takes place at: |
| 31 | + |
| 32 | + http://core.tcl.tk/ |
| 33 | + |
| 34 | +Tcl/Tk release and mailing list services are hosted by SourceForge: |
| 35 | + |
| 36 | + http://sourceforge.net/projects/tcl/ |
| 37 | + |
| 38 | +with the Tcl Developer Xchange hosted at: |
| 39 | + |
| 40 | + http://www.tcl.tk/ |
| 41 | + |
| 42 | +Tcl is a freely available open source package. You can do virtually |
| 43 | +anything you like with it, such as modifying it, redistributing it, |
| 44 | +and selling it either in whole or in part. See the file |
| 45 | +"license.terms" for complete information. |
| 46 | + |
| 47 | +2. Documentation |
| 48 | +---------------- |
| 49 | + |
| 50 | +Extensive documentation is available at our website. |
| 51 | +The home page for this release, including new features, is |
| 52 | + http://www.tcl.tk/software/tcltk/8.6.html |
| 53 | + |
| 54 | +Detailed release notes can be found at the file distributions page |
| 55 | +by clicking on the relevant version. |
| 56 | + http://sourceforge.net/projects/tcl/files/Tcl/ |
| 57 | + |
| 58 | +Information about Tcl itself can be found at |
| 59 | + http://www.tcl.tk/about/ |
| 60 | + |
| 61 | +There have been many Tcl books on the market. Many are mentioned in the Wiki: |
| 62 | + http://wiki.tcl.tk/_/ref?N=25206 |
| 63 | + |
| 64 | +To view the complete set of reference manual entries for Tcl 8.6 online, |
| 65 | +visit the URL: |
| 66 | + http://www.tcl.tk/man/tcl8.6/ |
| 67 | + |
| 68 | +2a. Unix Documentation |
| 69 | +---------------------- |
| 70 | + |
| 71 | +The "doc" subdirectory in this release contains a complete set of |
| 72 | +reference manual entries for Tcl. Files with extension ".1" are for |
| 73 | +programs (for example, tclsh.1); files with extension ".3" are for C |
| 74 | +library procedures; and files with extension ".n" describe Tcl |
| 75 | +commands. The file "doc/Tcl.n" gives a quick summary of the Tcl |
| 76 | +language syntax. To print any of the man pages on Unix, cd to the |
| 77 | +"doc" directory and invoke your favorite variant of troff using the |
| 78 | +normal -man macros, for example |
| 79 | + |
| 80 | + ditroff -man Tcl.n |
| 81 | + |
| 82 | +to print Tcl.n. If Tcl has been installed correctly and your "man" program |
| 83 | +supports it, you should be able to access the Tcl manual entries using the |
| 84 | +normal "man" mechanisms, such as |
| 85 | + |
| 86 | + man Tcl |
| 87 | + |
| 88 | +2b. Windows Documentation |
| 89 | +------------------------- |
| 90 | + |
| 91 | +The "doc" subdirectory in this release contains a complete set of Windows |
| 92 | +help files for Tcl. Once you install this Tcl release, a shortcut to the |
| 93 | +Windows help Tcl documentation will appear in the "Start" menu: |
| 94 | + |
| 95 | + Start | Programs | Tcl | Tcl Help |
| 96 | + |
| 97 | +3. Compiling and installing Tcl |
| 98 | +------------------------------- |
| 99 | + |
| 100 | +There are brief notes in the unix/README, win/README, and macosx/README about |
| 101 | +compiling on these different platforms. There is additional information |
| 102 | +about building Tcl from sources at |
| 103 | + |
| 104 | + http://www.tcl.tk/doc/howto/compile.html |
| 105 | + |
| 106 | +4. Development tools |
| 107 | +--------------------------- |
| 108 | + |
| 109 | +ActiveState produces a high quality set of commercial quality development |
| 110 | +tools that is available to accelerate your Tcl application development. |
| 111 | +Tcl Dev Kit builds on the earlier TclPro toolset and provides a debugger, |
| 112 | +static code checker, single-file wrapping utility, bytecode compiler and |
| 113 | +more. More information can be found at |
| 114 | + |
| 115 | + http://www.ActiveState.com/Tcl |
| 116 | + |
| 117 | +5. Tcl newsgroup |
| 118 | +---------------- |
| 119 | + |
| 120 | +There is a USENET news group, "comp.lang.tcl", intended for the exchange of |
| 121 | +information about Tcl, Tk, and related applications. The newsgroup is a |
| 122 | +great place to ask general information questions. For bug reports, please |
| 123 | +see the "Support and bug fixes" section below. |
| 124 | + |
| 125 | +6. Tcl'ers Wiki |
| 126 | +--------------- |
| 127 | + |
| 128 | +A Wiki-based open community site covering all aspects of Tcl/Tk is at: |
| 129 | + |
| 130 | + http://wiki.tcl.tk/ |
| 131 | + |
| 132 | +It is dedicated to the Tcl programming language and its extensions. A |
| 133 | +wealth of useful information can be found there. It contains code |
| 134 | +snippets, references to papers, books, and FAQs, as well as pointers to |
| 135 | +development tools, extensions, and applications. You can also recommend |
| 136 | +additional URLs by editing the wiki yourself. |
| 137 | + |
| 138 | +7. Mailing lists |
| 139 | +---------------- |
| 140 | + |
| 141 | +Several mailing lists are hosted at SourceForge to discuss development or |
| 142 | +use issues (like Macintosh and Windows topics). For more information and |
| 143 | +to subscribe, visit: |
| 144 | + |
| 145 | + http://sourceforge.net/projects/tcl/ |
| 146 | + |
| 147 | +and go to the Mailing Lists page. |
| 148 | + |
| 149 | +8. Support and Training |
| 150 | +------------------------ |
| 151 | + |
| 152 | +We are very interested in receiving bug reports, patches, and suggestions |
| 153 | +for improvements. We prefer that you send this information to us as |
| 154 | +tickets entered into our tracker at: |
| 155 | + |
| 156 | + http://core.tcl.tk/tcl/reportlist |
| 157 | + |
| 158 | +We will log and follow-up on each bug, although we cannot promise a |
| 159 | +specific turn-around time. Enhancements may take longer and may not happen |
| 160 | +at all unless there is widespread support for them (we're trying to |
| 161 | +slow the rate at which Tcl/Tk turns into a kitchen sink). It's very |
| 162 | +difficult to make incompatible changes to Tcl/Tk at this point, due to |
| 163 | +the size of the installed base. |
| 164 | + |
| 165 | +The Tcl community is too large for us to provide much individual support |
| 166 | +for users. If you need help we suggest that you post questions to |
| 167 | +comp.lang.tcl. We read the newsgroup and will attempt to answer esoteric |
| 168 | +questions for which no one else is likely to know the answer. In addition, |
| 169 | +see the following Web site for links to other organizations that offer |
| 170 | +Tcl/Tk training: |
| 171 | + |
| 172 | + http://wiki.tcl.tk/training |
| 173 | + |
| 174 | +9. Tracking Development |
| 175 | +----------------------- |
| 176 | + |
| 177 | +Tcl is developed in public. To keep an eye on how Tcl is changing, see |
| 178 | + http://core.tcl.tk/ |
| 179 | + |
| 180 | +10. Thank You |
| 181 | +------------- |
| 182 | + |
| 183 | +We'd like to express our thanks to the Tcl community for all the |
| 184 | +helpful suggestions, bug reports, and patches we have received. |
| 185 | +Tcl/Tk has improved vastly and will continue to do so with your help. |
0 commit comments