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