home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / maths / plplot / plplot_2 / drivers / tk / help_tcltk < prev    next >
Encoding:
Text File  |  1994-05-26  |  11.6 KB  |  281 lines
  1. # $Id: help_tcltk.tcl,v 1.2 1994/05/26 19:23:23 mjl Exp $
  2. # $Log: help_tcltk.tcl,v $
  3. # Revision 1.2  1994/05/26  19:23:23  mjl
  4. # Inserted missing CVS Id and Log fields.
  5. #
  6. #----------------------------------------------------------------------------
  7. # help_tcltk w
  8. #
  9. # Create a top-level window that displays info for On Tcl/TK.. help item.
  10. # Maurice LeBrun, IFS
  11. # Adapted from mkStyles.tcl from widget demo.
  12. #
  13. # Arguments:
  14. #    w -    Name to use for new top-level window.
  15. #----------------------------------------------------------------------------
  16.  
  17. proc help_tcltk {{w .help_tcltk}} {
  18.     catch {destroy $w}
  19.     toplevel $w
  20.     dpos $w
  21.     wm title $w "Help on Tcl/TK"
  22.     wm iconname $w "help_tcltk"
  23.     normal_text_setup $w 64
  24.  
  25.     insertWithTags $w.t {\
  26. Tcl/TK (written by John Ousterhout, UC Berkeley) is rapidly gaining in
  27. popularity, and already has a world-wide following.  Software developers
  28. usually prefer it to Motif for building user interfaces due to the higher
  29. level of abstraction employed by Tcl/TK.  Widgets can be easily created,
  30. destroyed, and manipulated via simple Tcl expressions.  Further, Tcl/TK is
  31. non-proprietary, so you can in principle run it on any X-based platform,
  32. as well as have unrestricted access to the source code.  The package is
  33. well documented, with a book on Tcl/TK due out in late 1993 (draft copies
  34. are available via anonymous ftp), numerous man pages, and a Usenet
  35. newsgroup comp.lang.tcl for discussion of all aspects of using Tcl/TK.
  36.  
  37. Some selected excerpts from the Tcl/TK "Frequently Asked Questions" list
  38. follow:
  39.  
  40. ---------------------------------------------------------
  41.  
  42. From: FAQ General information
  43. Subject: -II- What is Tcl?  Tk?  Extended Tcl? 
  44.  
  45.     Tcl (Version 6.7) stands for ``tool command language'' and is
  46. pronounced ``tickle.'' It is actually two things: a language and a
  47. library.  First, Tcl is a simple textual language, intended primarily for
  48. issuing commands to interactive programs such as text editors, debuggers,
  49. illustrators, and shells.  It has a simple syntax and is also
  50. programmable, so Tcl users can write command procedures to provide more
  51. powerful commands than those in the built-in set.
  52.  
  53.     Second, Tcl is a library package that can be embedded in application
  54. programs.  The Tcl library consists of a parser for the Tcl language,
  55. routines to implement the Tcl built-in commands, and procedures that allow
  56. each application to extend Tcl with additional commands specific to that
  57. application.  The application program generates Tcl commands and passes
  58. them to the Tcl parser for execution.  Commands may be generated by
  59. reading characters from an input source, or by associating command strings
  60. with elements of the application's user interface, such as menu entries,
  61. buttons, or keystrokes.  When the Tcl library receives commands it parses
  62. them into component fields and executes built-in commands directly.  For
  63. commands implemented by the application, Tcl calls back to the application
  64. to execute the commands.  In many cases commands will invoke recursive
  65. invocations of the Tcl interpreter by passing in additional strings to
  66. execute (procedures, looping commands, and conditional commands all work
  67. in this way).
  68.  
  69.     An application program gains three advantages by using Tcl for its
  70. command language.  First, Tcl provides a standard syntax: once users know
  71. Tcl, they will be able to issue commands easily to any Tcl-based
  72. application.  Second, Tcl provides programmability.  All a Tcl application
  73. needs to do is to implement a few application-specific low-level commands.
  74. Tcl provides many utility commands plus a general programming interface
  75. for building up complex command procedures.  By using Tcl, applications
  76. need not re-implement these features.  Third, extensions to Tcl, such as
  77. the Tk toolkit, provide mechanisms for communicating between applications
  78. by sending Tcl commands back and forth.  The common Tcl language framework
  79. makes it easier for applications to communicate with one another.
  80.  
  81.     Tk (Version 3.2) - an extension to Tcl which provides the programmer
  82. with an interface to the X11 windowing system.  Note that many users will
  83. encounter Tk via the ``wish'' command.  Wish is a simple windowing shell
  84. which permits the user to write Tcl applications in a prototyping
  85. environment.
  86.  
  87.     Extended Tcl (tclX) (Version 6.7c) - This extended set of commands are
  88. provided by NeoSoft, and provide additional Unix system interfaces to the
  89. Tcl programmer.  Many users will encounter Tcl via the ``tcl'' command -
  90. an interactive Tcl command interpreter.
  91.  
  92. ------------------------------
  93.  
  94. From: FAQ Tcl/Tk Package Catalog
  95. Subject: -XI- Where can I get these packages?
  96.  
  97. The "home site" for Tcl on the Internet is sprite.berkeley.edu.
  98. Sprite is an experimental research machine whose IP servers
  99. occasionally flake out.  If you find that sprite is refusing
  100. connections, send mail to "root@sprite.berkeley.edu", wait a few
  101. hours, and try again.
  102.  
  103. Tcl and Extended Tcl were posted to comp.sources.misc, appearing
  104. In volume 25 and then Tcl appeared again in volume 26 and can be found at 
  105. most comp.sources.misc archive sites in the tcl and tclx directories.
  106. These are quite old versions actually, but are still usable.
  107.  
  108. a. Tcl    - available on sprite.berkeley.edu and harbor.ecn.purdue.edu
  109. b. Tk    - available on sprite.berkeley.edu and harbor.ecn.purdue.edu
  110. c. Extended Tcl - available on sprite.berkeley.edu and harbor.ecn.purdue.edu
  111.  
  112. The IP address for harbor.ecn.purdue.edu is 128.46.128.76 .
  113. sprite.berkeley.edu is a CNAME for allspice.Berkeley.EDU, whose
  114. IP address is 128.32.150.27.
  115.  
  116. Other sites which either mirror the Tcl/Tk submissions or have special
  117. versions are:
  118.  
  119. ftp.uu.net:/languages/tcl        <- sprite only
  120. gatekeeper.dec.com:/.0/BSD/UCB/sprite     <- sprite only
  121. sunsite.unc.edu:/pub/languages/tcl
  122. ftp.ibp.fr:/pub/tcl            <- distrib, contrib, expect
  123. syd.dit.csiro.au:/pub/tk        <- contrib and sprite
  124.  
  125. iskut.ucs.ubc.ca:/pub/X11/tcl
  126. ftp.funet.fi:/pub/languages/tcl
  127. coma.cs.tu-berlin.ed:/pub/tcl
  128. nic.funet.fi:/pub/languages/tcl
  129. oskgate0.mei.co.jp:/free/X/toolkits/tcl <- sprite only
  130.  
  131. sunsite.unc.edu:/pub/Linux    <- contains port of extended Tcl and 
  132.                     extended Tk to this OS.
  133.  
  134. --------------------------------------
  135.  
  136. From: -XI- Where can I get these packages?
  137. Subject: -A- Retrieving Tcl and Tk
  138.  
  139.  
  140. >From: ouster@sprite.Berkeley.EDU (John Ousterhout)
  141. >Newsgroups: comp.lang.tcl
  142. >Subject: Obtaining Tcl/Tk sources
  143.  
  144. For people new to the Tcl/Tk community, here is information on how
  145. to obtain Tcl and Tk sources.  The information below describes what
  146. I distribute; other information is available from other machines
  147. also, such as harbor.ecn.purdue.edu.
  148.  
  149. The sources and documentation for the Tcl command
  150. language library, for the Tk toolkit, and for a few Tcl-based
  151. applications, are in the public FTP area on sprite.berkeley.edu.
  152. All of these files are in the "tcl" subdirectory of the FTP area.
  153. Here is a catalog of what's available.  Most of the files are
  154. compressed tar files ("xxx.tar.Z").  There is some overlap
  155. between the contents of the various packages.
  156.  
  157. tk3.2.tar.Z -        This is the latest release of the Tk toolkit, released
  158.             in February 1993.  It includes a complete copy of the
  159.             Tcl V6.7 release (the version of Tcl with which it is
  160.             compatible) plus a simple windowing shell called
  161.             "wish".  If you retrieve this file you don't need to
  162.             retrieve Tcl separately.
  163.  
  164. tcl6.7.tar.Z -        This is the newest release of the Tcl library.
  165.             It became available in February 1993.  This package
  166.             includes only the Tcl library and its documentation,
  167.             plus a simple main program for testing.
  168.  
  169. tclX6.5c.tar.Z -        Extended Tcl (or NeoSoft Tcl), created by Mark
  170.             Diekhans and Karl Lehenbauer, which adds a number
  171.             of useful facilities to the base Tcl release.
  172.             Among the things in Extended Tcl are a Tcl shell,
  173.             many new commands for things like UNIX kernel
  174.             call access and math library routines, and an
  175.             on-line help facility.  This file is based on
  176.             Tcl 6.5 and also works with Tcl 6.6, 6.7 and Tk 3.1,
  177.             Tk 3.2
  178.  
  179.             Note that tclX6.5c-6.7c.update.shar.Z exists on 
  180.             the purdue archive site.
  181.  
  182. book.p1.ps.Z        Compressed Postscript for a draft of the first part
  183.             of an upcoming book on Tcl and Tk to be published in
  184.             1993 by Addison-Wesley.  This part of the book
  185.             describes the Tcl language and how to write scripts
  186.             in it.  About 130 pages in length.
  187.  
  188. book.p2.ps.Z        Compressed Postscript for a draft of the second part
  189.             of an upcoming book on Tcl and Tk to be published in
  190.             1993 by Addison-Wesley.  This part of the book
  191.             describes the Tk extension and how to write scripts
  192.             in it.  About 130 pages in length.
  193.  
  194. tclUsenix90.ps -        Postscript for a paper on Tcl that appeared in the
  195.             Winter 1990 USENIX Conference.  This paper is also
  196.             included in the Tcl and Tk distributions.
  197.  
  198. tkUsenix91.ps -        Postscript for a paper on Tk that appeared in the
  199.             Winter 1991 USENIX Conference.  This paper is also
  200.             included in the Tk distribution.
  201.  
  202. tkF10.ps -        Postscript for Figure 10 of the Tk paper.
  203.  
  204. tut.tar.Z -        A collection of materials from a full-day tutorial
  205.             on Tcl and Tk.  Includes viewgraphs from five one-hour
  206.             talks plus a sample widget.
  207.  
  208. In addition, there may be older releases of some or all of the above
  209. files;  look for files with earlier release numbers.
  210.  
  211.  
  212. To retrieve any or all of these packages, use anonymous FTP to
  213. sprite.berkeley.edu (Internet address 128.32.150.27).  Use user
  214. "anonymous"; when asked for a password, type your login name.  Then
  215. retrieve the relevant file(s) with the commands like the following:
  216.         type image (try "type binary" if this command is rejected)
  217.         cd tcl
  218.         get tk3.2.tar.Z
  219.  
  220. Be sure to retrieve files in image mode (type "type image" to FTP)
  221. in order to make sure that you don't lose bits.
  222.  
  223. Any file with a .Z extension is a compressed file, which means you must
  224. use the "uncompress" program to get back a normal file.  For example, for
  225. the file tk3.2.tar.Z, you should type
  226.  
  227.     uncompress tk3.2.tar.Z
  228.  
  229. once you've retrieved the file.  This will produce a file named "tk3.2.tar".
  230. Then you will need to use tar to extract the members.  Typically one
  231. would use a command such as:
  232.  
  233.     tar xv tk3.2.tar
  234.  
  235. to extract the pieces.
  236.  
  237. Each of the releases has a README file in the top-level directory that
  238. describes how to compile the release, where to find documentation, etc.
  239.  
  240. Questions or problems about any of these distributions should be directed
  241. to "John Ousterhout" <ouster@cs.berkeley.edu>.
  242.  
  243. If you don't have access to Sprite, you can also retrieve some or
  244. all of the above files from other FTP repositories.  Here is a
  245. sampler of machines that store some or all of the Tcl/Tk information,
  246. plus the directories in which to check:
  247.  
  248. ftp.uu.net:        /languages/tcl/*
  249. export.lcs.mit.edu:        /contrib/tk*
  250. harbor.ecn.purdue.edu:    /pub/tcl/*
  251.  
  252. --------------------------------------
  253.  
  254. From: -XI- Where can I get these packages?
  255. Subject: -B- Accessing the Tcl/Tk User Contributions Archive
  256.  
  257. Contributions to the Tcl/Tk Contrib Archive are most welcome --
  258. please upload them to:
  259.  
  260.     harbor.ecn.purdue.edu:/incoming    [128.46.128.76]
  261.  
  262. send the archive maintainer <tcl-archive@harbor.ecn.purdue.edu> a note stating
  263. the names of the files you uploaded and a brief description for the
  264. index.
  265.  
  266. Harbor is the central file server for the software staff of the
  267. Engineering Computer Network, so please try to refrain from FTPing
  268. stuff between 9am and 5pm EST (GMT -0500).  No mail-archive service is
  269. planned as yet -- users without FTP capability should use one of the
  270. following mail-based FTP services (send mail to the appropriate address
  271. with "help" in the body):
  272.  
  273. BITNET users:   BITFTP <bitftp@pucc.princeton.edu>
  274. Others:         "DEC ftpmail" <ftpmail@decwrl.dec.com>
  275. Europe:         ftpmail@grasp1.univ-lyon1.fr
  276.         mail-server@ftp.tu-clausthal.de
  277. } normal
  278.     $w.t configure -state disabled
  279.     $w.t mark set insert 0.0
  280. }
  281.