1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/os/persistentdata/persistentstorage/sqlite3api/TEST/TCL/tcldistribution/README Fri Jun 15 03:10:57 2012 +0200
1.3 @@ -0,0 +1,193 @@
1.4 +README: Tcl
1.5 + This is the Tcl 8.4.15 source distribution.
1.6 + Tcl/Tk is also available through NetCVS:
1.7 + http://tcl.sourceforge.net/
1.8 + You can get any source release of Tcl from the file distributions
1.9 + link at the above URL.
1.10 +
1.11 +RCS: @(#) $Id: README,v 1.49.2.18 2006/10/23 17:53:23 dgp Exp $
1.12 +
1.13 +Contents
1.14 +--------
1.15 + 1. Introduction
1.16 + 2. Documentation
1.17 + 3. Compiling and installing Tcl
1.18 + 4. Development tools
1.19 + 5. Tcl newsgroup
1.20 + 6. Tcl contributed archive
1.21 + 7. Tcl Resource Center
1.22 + 8. Mailing lists
1.23 + 9. Support and Training
1.24 + 10. Thank You
1.25 +
1.26 +1. Introduction
1.27 +---------------
1.28 +Tcl provides a powerful platform for creating integration applications that
1.29 +tie together diverse applications, protocols, devices, and frameworks.
1.30 +When paired with the Tk toolkit, Tcl provides the fastest and most powerful
1.31 +way to create GUI applications that run on PCs, Unix, and the Macintosh.
1.32 +Tcl can also be used for a variety of web-related tasks and for creating
1.33 +powerful command languages for applications.
1.34 +
1.35 +Tcl is maintained, enhanced, and distributed freely by the Tcl community.
1.36 +The home for Tcl/Tk sources and bug/patch database is on SourceForge:
1.37 +
1.38 + http://tcl.sourceforge.net/
1.39 +
1.40 +with the Tcl Developer Xchange hosted at:
1.41 +
1.42 + http://www.tcl.tk/
1.43 +
1.44 +Tcl is a freely available open source package. You can do virtually
1.45 +anything you like with it, such as modifying it, redistributing it,
1.46 +and selling it either in whole or in part. See the file
1.47 +"license.terms" for complete information.
1.48 +
1.49 +2. Documentation
1.50 +----------------
1.51 +
1.52 +Extensive documentation is available at our website.
1.53 +The home page for this release, including new features, is
1.54 + http://www.tcl.tk/software/tcltk/8.4.html
1.55 +
1.56 +Detailed release notes can be found at the file distributions page
1.57 +by clicking on the relevant version.
1.58 + http://sourceforge.net/project/showfiles.php?group_id=10894
1.59 +
1.60 +Information about Tcl itself can be found at
1.61 + http://www.tcl.tk/about/
1.62 +
1.63 +There have been many Tcl books on the market. Many are mentioned in the Wiki:
1.64 + http://wiki.tcl.tk/book
1.65 +
1.66 +2a. Unix Documentation
1.67 +----------------------
1.68 +
1.69 +The "doc" subdirectory in this release contains a complete set of
1.70 +reference manual entries for Tcl. Files with extension ".1" are for
1.71 +programs (for example, tclsh.1); files with extension ".3" are for C
1.72 +library procedures; and files with extension ".n" describe Tcl
1.73 +commands. The file "doc/Tcl.n" gives a quick summary of the Tcl
1.74 +language syntax. To print any of the man pages on Unix, cd to the
1.75 +"doc" directory and invoke your favorite variant of troff using the
1.76 +normal -man macros, for example
1.77 +
1.78 + ditroff -man Tcl.n
1.79 +
1.80 +to print Tcl.n. If Tcl has been installed correctly and your "man" program
1.81 +supports it, you should be able to access the Tcl manual entries using the
1.82 +normal "man" mechanisms, such as
1.83 +
1.84 + man Tcl
1.85 +
1.86 +2b. Windows Documentation
1.87 +-------------------------
1.88 +
1.89 +The "doc" subdirectory in this release contains a complete set of Windows
1.90 +help files for Tcl. Once you install this Tcl release, a shortcut to the
1.91 +Windows help Tcl documentation will appear in the "Start" menu:
1.92 +
1.93 + Start | Programs | Tcl | Tcl Help
1.94 +
1.95 +3. Compiling and installing Tcl
1.96 +-------------------------------
1.97 +
1.98 +There are brief notes in the unix/README, win/README, and macosx/README about
1.99 +compiling on these different platforms. There is additional information
1.100 +about building Tcl from sources at
1.101 +
1.102 + http://www.tcl.tk/doc/howto/compile.html
1.103 +
1.104 +4. TclPro Development tools
1.105 +---------------------------
1.106 +
1.107 +A high quality set of commercial quality development tools is available to
1.108 +accelerate your Tcl application development. The TclPro product provides a
1.109 +debugger, static code checker, packaging utility, and bytecode compiler.
1.110 +TclPro was open-sourced when Scriptics/Ajuba was acquired by Interwoven.
1.111 +Visit its home at SourceForge for more information and source/binaries:
1.112 +
1.113 + http://tclpro.sourceforge.net/
1.114 +
1.115 +ActiveState has picked up support for commercial Tcl development tools.
1.116 +More information can be found at
1.117 +
1.118 + http://www.ActiveState.com/Tcl
1.119 +
1.120 +5. Tcl newsgroup
1.121 +----------------
1.122 +
1.123 +There is a USENET news group, "comp.lang.tcl", intended for the exchange of
1.124 +information about Tcl, Tk, and related applications. The newsgroup is a
1.125 +great place to ask general information questions. There is also
1.126 +a USENET news group, "comp.lang.tcl.announce", intended to announce new
1.127 +releases of software, training, and more. For bug reports, please
1.128 +see the "Support and bug fixes" section below.
1.129 +
1.130 +6. Tcl contributed archive
1.131 +--------------------------
1.132 +
1.133 +Many people have created exciting packages and applications based on Tcl
1.134 +and/or Tk and made them freely available to the Tcl community. An archive
1.135 +of these contributions is kept on the machine ftp://archives.tcl.tk/pub/tcl
1.136 +(aka ftp://ftp.procplace.com/pub/tcl). You can access the archive using
1.137 +anonymous FTP. The archive also contains several FAQ ("frequently asked
1.138 +questions") documents that provide solutions to problems that are commonly
1.139 +encountered by Tcl newcomers.
1.140 +
1.141 +7. The Tcler's Wiki
1.142 +-------------------
1.143 +
1.144 +A Wiki-based open community site covering all aspects of Tcl/Tk is at:
1.145 +
1.146 + http://wiki.tcl.tk/
1.147 +
1.148 +A wealth of useful information can be found there.
1.149 +
1.150 +8. Mailing lists
1.151 +----------------
1.152 +
1.153 +Several mailing lists are hosted at SourceForge to discuss development or
1.154 +use issues (like Macintosh and Windows topics). For more information and
1.155 +to subscribe, visit:
1.156 +
1.157 + http://sourceforge.net/projects/tcl/
1.158 +
1.159 +and go to the Mailing Lists page.
1.160 +
1.161 +9. Support and Training
1.162 +------------------------
1.163 +
1.164 +We are very interested in receiving bug reports, patches, and suggestions
1.165 +for improvements. We prefer that you send this information to us via the
1.166 +bug form at SourceForge, rather than emailing us directly. The bug
1.167 +database is at:
1.168 +
1.169 + http://tcl.sourceforge.net/
1.170 +
1.171 +The bug form was designed to give uniform structure to bug reports as
1.172 +well as to solicit enough information to minimize followup questions.
1.173 +
1.174 +We will log and follow-up on each bug, although we cannot promise a
1.175 +specific turn-around time. Enhancements, reported via the Feature
1.176 +Requests form at the same web site, may take longer and may not happen
1.177 +at all unless there is widespread support for them (we're trying to
1.178 +slow the rate at which Tcl/Tk turns into a kitchen sink). It's very
1.179 +difficult to make incompatible changes to Tcl/Tk at this point, due to
1.180 +the size of the installed base.
1.181 +
1.182 +The Tcl community is too large for us to provide much individual support
1.183 +for users. If you need help we suggest that you post questions to
1.184 +comp.lang.tcl. We read the newsgroup and will attempt to answer esoteric
1.185 +questions for which no one else is likely to know the answer. In addition,
1.186 +see the following page on the Wiki for links to other organizations that offer
1.187 +Tcl/Tk training:
1.188 +
1.189 + http://wiki.tcl.tk/training
1.190 +
1.191 +10. Thank You
1.192 +-------------
1.193 +
1.194 +We'd like to express our thanks to the Tcl community for all the
1.195 +helpful suggestions, bug reports, and patches we have received.
1.196 +Tcl/Tk has improved vastly and will continue to do so with your help.