home *** CD-ROM | disk | FTP | other *** search
/ ftp.cse.unsw.edu.au / 2014.06.ftp.cse.unsw.edu.au.tar / ftp.cse.unsw.edu.au / pub / doc / applications / tkperl / tkperl-0.010-README < prev    next >
Encoding:
Text File  |  1994-02-20  |  6.6 KB  |  153 lines
  1. --------------------------------------------------------------------------------
  2. This is TkPerl, a programm which combines Perl with the graphic extension Tk.
  3.  
  4. If you are already a user of the *great* Perl and you are seeking for a
  5.  graphical user interface like Tk, you'll be right with this program.
  6.  
  7. TkPerl is a normal Perl interpreter which additionally includes 33 new Tk
  8.  commands for window creation, handling and so on. Within this distribution
  9.  other widget sets are included as well as the SNMP support.
  10.  
  11. --------------------------------------------------------------------------------
  12. Quick start:
  13.  
  14.     setenv DISPLAY        <your_X_display>
  15.     setenv TKPERLLIBDIR    `pwd`/lib:`pwd`/lib/demos
  16.     ./bin*/tkperl ./demos/widget
  17.  
  18. Take a look into the ./lib/demos directory for some examples ...
  19. --------------------------------------------------------------------------------
  20. What if...
  21.  
  22. Q: If it dumps a core ?
  23. A: Check the environment variables for including the startup scripts, or
  24.    send an Email to smile@ira.uka.de
  25.  
  26. Q: What is `SMILE' mentioned in the Makefile ?
  27. A: SMILE is the abbrevation for Secure network management in Large Environments,
  28.     a project group which is the originator of this package. For some reasons
  29.     it is NOT possible to give free access to the complete software packages
  30.     - therefore the executable of the snmptkperl, which opens SNMP support is
  31.     included in this distribution.
  32. --------------------------------------------------------------------------------
  33. Tell me...
  34.  
  35. Q: What are the differences between the TkPerl executables within the
  36.     ./bin* directories ?
  37. A: There are currently three executables named `tkperl', `tkperl+' ,`tkperl++'
  38.    `tkperl+++' and `debugtkperl'. The first one is the basic TkPerl
  39.    interpreter without any extensions, the second program includes
  40.    additionally the Square widget add-on (which should be used to run the
  41.    `square' application script).  The third is a TkPerl interpreter which
  42.    is combined with the Square widget and the Blt library (this last one is
  43.    a pre-alpha version, sorry). The next one includes furthermore the "vuw"
  44.    widgets bargraph, dial, pie and stripchart. The last one, `debugtkperl',
  45.    is the same as the last executable but with some debugging code, which
  46.    prints each statement activated from the Tk modules.
  47.    Additionally the executable called `snmptkperl' supports the above
  48.    mentioned SNMP extension (the main goal of our project group).
  49.  
  50. Q: What are the new TkPerl commands ?
  51. A: First of all TkPerl recognizes two new commands named `Info' and `tkInit'.
  52.    Unless calling this no differences to a normal Perl interpreter should
  53.    occur. The `Info' command is used to show the already defined commands.
  54.    The `tkInit' is used to initialize the Tk part and therefore creates
  55.    33 Tk commands:
  56.     tk'after, tk'bind, tk'button, tk'canvas, tk'checkbutton, tk'destroy,
  57.     tk'entry, tk'exit, tk'focus, tk'frame, tk'grab, tk'label, tk'listbox,
  58.     tk'lower, tk'menu, tk'menubutton, tk'message, tk'option, tk'pack,
  59.     tk'place, tk'radiobutton, tk'raise, tk'scale, tk'scrollbar,
  60.     tk'selection, tk'send, tk'text, tk'tk, tk'tkwait, tk'toplevel,
  61.     tk'update, tk'winfo and finally tk'wm
  62.    For the details take a look into the manual pages coming from the Tk
  63.    distribution.
  64.  
  65. --------------------------------------------------------------------------------
  66. You need:
  67. - a C-compiler
  68. - the TCL library (version 7.3 or higher)
  69. - the Tk library (version 3.6 or higher)
  70. - the Perl program (version 4.0 or higher)
  71.  
  72. Optionally you need:
  73. - the SMILE library (version 5.2 or higher) for SNMP-TkPerl
  74. - the BLT library (version 1.0beta or higher) for some widgets
  75.  
  76. --------------------------------------------------------------------------------
  77. Installation:
  78.  
  79. - Install all the needed software packages mentioned above (with configuring
  80.    each of them) as base for this software.
  81. - Change to the `src' directory and edit the first section of the `Makefile'
  82.    to correspond to your local enviroment
  83. - Call `make World` and see what happens.
  84.  
  85. TkPerl is known to run on:
  86.   SunOS 4.1.*
  87.   Solaris 2.*
  88.  
  89. --------------------------------------------------------------------------------
  90. Mail addresses
  91.  
  92.   Our working group is happy about any comments, improvements and so on.
  93.   The mailing address is
  94.  
  95.     smile@ira.uka.de
  96.  
  97. --------------------------------------------------------------------------------
  98. FTP addresses
  99.  
  100.   Try for example ftp.ira.uka.de(129.13.10.90):/pub/misc/tkperl-*.tar.z
  101.  
  102. --------------------------------------------------------------------------------
  103. History and other interessing things:
  104.  
  105. TkPerl got started in the midst of December, 1993. It was initially developed
  106.  due to the *unusual* syntax of Tcl and the need to combine the *mighty* Perl
  107.  with a graphical programming interface. The main goal was to prevent major
  108.  modifications in the existing software packages so that there will be no more
  109.  work with upcoming new releases of Tk (or widget extensions). Therefore TkPerl
  110.  if bases on the following software architecture model:
  111.  
  112.     +-----------------------+---------------+
  113.     | Tk library        | Widget Extens.|    widgetAddons/
  114.     |       +---------------+---------------+    libnewtk.a
  115.     |     | small parts of Tcl library    |    tcl*.o
  116.     +-------+------------------+------------+
  117.     | Tk-Tcl-adaption layer       |            Perl_Ext.o, tclstubs.o
  118.     +------------------+-------+
  119.     | Perl interpreter | Addon |            uperl.o, userinit.o
  120.     +------------------+-------+
  121.  
  122. --------------------------------------------------------------------------------
  123. TODO:
  124.  
  125. - Make tkperl compile `out of the box' via GNU autoconf.
  126.  
  127. - for installation:
  128.    When satisfied, call `make install` to install binary and manual.
  129.  
  130. There will be a real README file later.
  131.  
  132. The compiled executable is running under Solaris 2.3.
  133.  
  134. --------------------------------------------------------------------------------
  135. TkPerl is Copyright (C) 1993, 1994 Guenther Schreiner.
  136.  
  137. This program is free software; you can redistribute it and/or modify
  138. it under the terms of the GNU General Public License as published by
  139. the Free Software Foundation (version 2 of the License).
  140.  
  141. This program is distributed in the hope that it will be useful,
  142. but WITHOUT ANY WARRANTY; without even the implied warranty of
  143. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  144. GNU General Public License for more details.
  145.  
  146. You should have received a copy of the GNU General Public License
  147. along with this program; if not, write to the Free Software
  148. Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  149.  
  150. --------------------------------------------------------------------------------
  151. $Header: /home/irafs1/smile/application/tkperl/tkperl-0.010/RCS/README,v 1.1 1994/02/08 15:38:25 guenther Exp guenther $
  152. --------------------------------------------------------------------------------
  153.