home *** CD-ROM | disk | FTP | other *** search
/ Serving the Web / ServingTheWeb1995.disc1of1.iso / linux / slacksrce / tcl / tcl+tk+t / tclx7.3bl / tclx7 / tclX7.3b / README < prev   
Encoding:
Text File  |  1994-08-21  |  7.4 KB  |  216 lines
  1. IMPORTANT NOTE:  This package has been customized for Linux to support
  2. the desired directory structure and the automatic generation of shared
  3. libraries.  See the README.linux file for details.  If you do not plan
  4. on compiling this package under Linux, you should get an unmodified
  5. version from your favorite Tcl/Tk archive site.
  6.  
  7.                            Extended Tcl (TclX) 7.3b
  8.                            ========================
  9.  
  10. INTRODUCTION
  11. ============
  12.  
  13.     Extended Tcl (TclX), is a set of extensions to Tcl 7.3, the Tool Command
  14. Language invented by Dr. John Ousterhout of the University of California at
  15. Berkeley.  Tcl is a powerful, yet simple embeddable programming language.
  16. Extended Tcl is oriented towards Unix system programming tasks and large
  17. application development.  Many additional interfaces to the Unix operating
  18. system are provided.  It is upwardly compatible with Tcl 7.3.  You take the
  19. Extended Tcl package, add it to Tcl 7.3, and from that you get Extended Tcl.
  20. (Berkeley Tcl is not included in this distribution, obtain it from
  21. ftp.cs.berkeley.edu).
  22.  
  23.    Support is also included for building a Tk 3.6 wish shell (wishx)
  24. with the Extended Tcl command set.
  25.  
  26.    While this TclX distribution is tested with Tcl 7.3 and Tk 3.6, it will
  27. probably work with new versions of Tcl & Tk with little or no changes.
  28.  
  29.    Extended Tcl was designed and implemented by Karl Lehenbauer
  30. (karl@NeoSoft.com) and Mark Diekhans (markd@Grizzly.com), with help
  31. in the early stages from Peter da Silva (peter@NeoSoft.com).
  32.  
  33.    As with Berkeley Tcl, all of Extended Tcl is freely
  34. redistributable, including for commercial use and resale.
  35.  
  36.    Please read the file INSTALL carefully before building and
  37. installing Extended Tcl.
  38.  
  39.  
  40. FEATURES ADDED BY EXTENDED TCL
  41. ==============================
  42.  
  43.    Here is a summary of the features added by Extended Tcl.  For
  44. more details on the commands and functionality provided by Extended
  45. Tcl, see the manual page man/TclX.man.
  46.  
  47.     o A shell, which provides an environment for developing and
  48.       executing Tcl programs.
  49.  
  50.     o Advanced Tcl code library facility that is oriented towards building
  51.       large applications.  It is compatible with standard Tcl auto-loading.
  52.  
  53.     o General purpose commands which define new programming
  54.       constructs,  debugging and profiling facilities.
  55.  
  56.     o Unix access commands provide access to many Unix system calls,
  57.       including process management.
  58.  
  59.     o File I/O commands provide added facilities for accessing and
  60.       manipulating open files.
  61.  
  62.     o File scanning facility that provides awk-like functionality.
  63.  
  64.     o Extended list manipulation commands.
  65.  
  66.     o Keyed lists, a type of list that provides functionality
  67.       similar to C structures.
  68.  
  69.     o Extended string and character manipulation commands.
  70.  
  71.     o Time and date manipulation and conversion commands.
  72.  
  73.     o Online help on Tcl, TclX and Tk commands.
  74.  
  75.     o A simple interface for accessing TCP/IP based servers.
  76.  
  77.     o X/PG based internationalization commands.
  78.  
  79. ON-LINE HELP
  80. ============
  81.  
  82.     There is a help system included with Extended Tcl.  It contains
  83. some documentation on every command in Berkeley Tcl, Extended Tcl
  84. and Tk.  You can invoke it interactively from within Extended Tcl by
  85. typing "help".
  86.  
  87.     Once you bring Tcl up and have gotten it to pass all the tests,
  88. try typing "help help" to learn how to use help.
  89.  
  90.     There is also a Tk based help program "tclhelp".
  91.  
  92. MANUAL PAGES
  93. ============
  94.  
  95.     Man pages in nroff/troff format are provided for all of Tcl and
  96. the extensions in the directory tclX7.3b/man.  Start with the
  97. TclX.man manual.
  98.  
  99. EXTENDED TCL VERSION NAMING
  100. ===========================
  101.  
  102.     Extended Tcl takes its version number from the corresponding
  103. version of Berkeley (Ousterhout) Tcl upon which it is based, with
  104. the addition of a trailing letter in case there are multiple
  105. releases of Extended Tcl within a single release of Berkeley Tcl.
  106. This release is TclX 7.3b.
  107.  
  108. INTERFACING TCL AND C++
  109. =======================
  110.  
  111. C++ programmers can include the file "tcl++.h" to define C++ classes
  112. that can be used to access a Tcl interpreter.  This is based on Tcl
  113. C++ classes originally developed by Parag Patel.  The files
  114.  
  115.         src/tclXmain.c
  116. and
  117.         tksrc/tkXmain.c
  118.  
  119. will compile under both C and C++.  If your have a C++ compiler that
  120. requires the main to be compiled with C++ (g++ does not have this
  121. restriction), use these files renamed to have the correct suffix for
  122. C++ (usually .C).
  123.  
  124. PACKAGE LIBRARIES
  125. =================
  126.  
  127.     Package Libraries are a Tcl source code management tool included
  128. in this release.  Package libraries allow you to group Tcl
  129. procedures into logical bundles and create single files, libraries,
  130. that contain multiple packages.  The package code provides a
  131. low-overhead means of automatically demand-loading a package on the
  132. first attempt to execute one of the procedures defined within it.
  133. As such, package libraries provide a mechanism to accommodate the
  134. creation of Tcl applications and libraries of a substantial size.
  135. The TclX library mechanism is a super-set of the mechanism provided
  136. with standard Tcl.
  137.  
  138. LINKING TCL APPLICATIONS
  139. ========================
  140.  
  141.    To build a TclX based application containing C code, start with
  142. either:
  143.  
  144.         tclmaster/src/tclXAppInit.c for just TclX
  145. or
  146.         tkmaster/src/tkXAppInit.c for TclX & Tk
  147.  
  148. and add your application initialization.  There are comments in the
  149. code to guide you. The "main" object file is already in the
  150. libraries, all you have to do is link a customized tclXAppInit.o or
  151. tkXAppInit.o file with your application and the Tcl libraries.  For
  152. example:
  153.  
  154.   cc tclXAppInit.o mystuff.a libtclx.a libtcl.a ${SYSLIBS} -o myapp
  155.  
  156.   cc tkXAppInit.o mystuff.a libtkx.a libtk.a libtclx.a libtcl.a ${SYSLIBS} \
  157.      -o myapp
  158.  
  159. Each of those directories has a file SYSLIBS that contains the
  160. system libraries that the TclX configure script thinks you should
  161. use for linking programs. These file are in a format that can be included
  162. from a make file.
  163.  
  164. IMPORTANT NOTE:  libtclx.a must be specified on the link command line
  165. before libtcl.a.  If the order is reversed, incorrect command line
  166. parsing code will be used.
  167.  
  168. SUPPORT FOR EXTENDED TCL
  169. ========================
  170.  
  171.     We are committed to providing continuing support for Extended
  172. Tcl.  Please send questions, bug reports, and bug fixes to:
  173.  
  174.          tcl-project@NeoSoft.com
  175.  
  176. WHERE TO GET IT
  177. ===============
  178.  
  179. Tcl & Tk is available via anonymous ftp from:
  180.  
  181.    ftp.cs.berkeley.edu:/ucb/tcl/[tcl7.3.tar.Z tk3.6.tar.Z]
  182. or
  183.    ftp.neosoft.com:/pub/tcl/distrib/[tcl7.3.tar.gz tk3.6.tar.gz]
  184. or
  185.    ftp.uu.net:languages/tcl/[tcl7.3.tar.Z tk3.6.tar.Z]
  186.  
  187. Extended Tcl 7.3b can be downloaded by anonymous FTP from:
  188.  
  189.    ftp.neosoft.com:/pub/tcl/distrib/tclX7.3b.tar.gz
  190. or
  191.    harbor.ecn.purdue.edu:tcl/extensions/tclX7.3b.tar.gz
  192.  
  193. A contributed sources archive resides on harbor.ecn.purdue.edu and
  194. is mirrored on ftp.ibp.fr for our friends in Europe.  An Frequently
  195. Asked Questions (FAQ) document exists in this archive.
  196.  
  197. Remember to mail Extended Tcl problems and questions to
  198. tcl-project@NeoSoft.com not Dr. John Ousterhout.
  199.  
  200. THANKS
  201. ======
  202.  
  203.   A big thanks to all of the Extended Tcl users from all over the world
  204. who have helped us debug problems and given us valuable suggestions.
  205. A special thanks to John Ousterhout for Tcl, Tk and all the support he
  206. has given us.
  207.  
  208.  
  209. NEOSOFT TCL CONSULTING
  210. ======================
  211.  
  212.   NeoSoft, co-developers of Extended Tcl, provides commercial Tcl
  213. releases, support, training and consulting.  NeoSoft can be reached 
  214. by sending electronic mail to info@NeoSoft.com or by phoning 
  215. +1 713 684 5969.
  216.