home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-2.iso / Developer / resources / libraries / libtclobjc.1.0.README < prev    next >
Encoding:
Text File  |  1994-06-09  |  3.7 KB  |  105 lines
  1. Tcl/Objective-C Interface Library
  2. *********************************
  3.  
  4. The Tcl/Objective-C Interface Library, version 1.0, is now available.
  5.  
  6. Where can you get it?  How can you compile it?
  7. ==============================================
  8.  
  9.    The library is available by anonymous ftp at
  10.          ftp.cs.rochester.edu:pub/objc/libtclobjc-1.0.tar.gz
  11.  
  12.    The library requires GCC (2.5.8 or higher) or NeXT's cc, and tcl-7.3.
  13. If you have tk-3.6, the library can be configured to use it.  If you
  14. have libreadline, the library can be configured to use it.  GCC and
  15. libreadline are available at any of the GNU archive sites; tcl and tk
  16. are available at ftp.cs.berkeley.edu.  GNU archive sites include:
  17.         ASIA: ftp.cs.titech.ac.jp, utsun.s.u-tokyo.ac.jp:/ftpsync/prep
  18.         AUSTRALIA: archie.au:/gnu (archie.oz or archie.oz.au for ACSnet)
  19.         EUROPE: irisa.irisa.fr:/pub/gnu, ftp.mcc.ac.uk, ftp.denet.dk
  20.         USA: gatekeeper.dec.com:/pub/GNU, ftp.uu.net:/systems/gnu
  21.  
  22.    The `.tar' file is compressed with GNU gzip.  It can be obtained by
  23. anonymous ftp at any of the GNU archive sites.
  24.  
  25.    For info about FTP via email, send email to `ftpmail@decwrl.dec.com'
  26. with no subject line, and two-line body with line one `help' and line
  27. two `quit'.
  28.  
  29. What is the Tcl/Objective-C Interface Library?
  30. ==============================================
  31.  
  32.    It's a library of Objective-C objects and support functions for
  33. communicating between Objective-C and Tcl/Tk.  From Tcl you can send
  34. messages to Objective-C objects and get textual representations of
  35. what's returned.  Thus it provides a way to interactively type messages
  36. and see the results, all inside the rich structure of the Tcl scripting
  37. language--almost an Objective-C interpreter.  The library also provides
  38. an Objective-C object that will forward all of its messages to the Tcl
  39. interpreter in textual format.
  40.  
  41.    The library does NOT provide:
  42.      * Handling arguments of non-atomic C types (structures, unions, etc).
  43.      * Tk widgets based on NEXTSTEP AppKit objects.
  44.      * The ability to create new Objective-C classes or methods from Tcl.
  45.  
  46. Examples
  47. ========
  48.  
  49.    Here's an example of a possible main.m:
  50.  
  51.      #include "Tk.h"
  52.      
  53.      int main (int argc, char *argv[])
  54.      {
  55.        id tk = [[Tk alloc] initWithArgc:argc argv:argv];
  56.        [tk promptAndEval];
  57.        exit(0);
  58.      }
  59.  
  60.    Compile it like this:
  61.          gcc main.m -ltclobjc -lreadline -ltermcap \
  62.              -ltk -ltcl -lX11 -lm -lobjc
  63.  
  64.    Once the program is running, I can interactively do things like this:
  65.  
  66.      Tcl% set mylist [[List alloc] init]
  67.      List@0xaf638
  68.      Tcl% $mylist name
  69.      List
  70.      Tcl% set myobject [[Object alloc] init]
  71.      Object@0xaf6b8
  72.      Tcl% $mylist addObject: $myobject
  73.      List@0xaf638
  74.      Tcl% $mylist addObject: [[Object alloc] init]
  75.      List@0xaf638
  76.      Tcl% $mylist count
  77.      2
  78.      Tcl% $mylist addObjectIfAbsent: $myobject
  79.      List@0xaf638
  80.      Tcl% $mylist count
  81.      2
  82.  
  83. Installation
  84. ============
  85.  
  86.    The package uses a configure script created by `autoconf'.  If you
  87. are using gcc (as opposed to NeXT's cc), you may have to install a patch
  88. to gcc first.  See the INSTALL file for details.  If you are on a NeXT
  89. it can be as easy as typing `./configure' and `make install'.
  90.  
  91. Noteworthy changes in 1.0
  92. =========================
  93.  
  94.    * The library has been ported to work under NEXTSTEP.  Thanks to
  95.      Robert Stabl <stabl@informatik.uni-muenchen.de> for doing the port.
  96.  
  97.    * Tk is now optional.  Many minor bug fixes and cleanups.
  98.  
  99.      ------------------------------------------------------------------
  100.      R. Andrew McCallum            ARPA: mccallum@cs.rochester.edu
  101.      Computer Science Department   UUCP: uunet!cs.rochester.edu!mccallum
  102.      University of Rochester       VOX: (716) 275-2527
  103.      Rochester, NY  14627-0226     FEET: CSB  Rm. 625
  104.  
  105.