home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / x / xprism.zip / xprism / README
Text File  |  1992-09-30  |  3KB  |  78 lines
  1.  
  2.         --------- XPRISM TOOLBOX --------------
  3.  
  4. This toolbox contains a new xprism3 program. This version of xprism3 has
  5. a file update mechanism added. 
  6.  
  7. Suppose that while you are displaying an datafile (plot) with
  8. xprism3, the datafile being plotted is over-written.  Xprism3 will 
  9. automatically register the fact that the input file has been changed,
  10. and update the currently displayed plot accordingly.  Using this argument, you can determine how often the input file is checked for any potential 
  11. modifications.  It must be specified "-update floatvalue", where float-
  12. value is a floating point value which must be greater than zero.
  13.  
  14. The cantata form will now contain 2 xprism3 glyphs, the regular xprism3 and
  15. the new xprism3 with the file update mechanism added.
  16.  
  17. This directory contains a tar file in which is a toolbox named 
  18. "xprism", containing a new xprism3 application.
  19. In addition to the tar file containing
  20. the toolbox is this README.  This README provides instructions for
  21. setting up and compiling the toolbox.
  22.  
  23. First, acquire the "xprism.tar.Z" file with "binary" mode set to 
  24. TRUE on ftp.  ( ftp> bin ). 
  25.  
  26. Next, create a location for toolboxes if you have not already done
  27. so.  It doesn't matter where, but don't put it in $KHOROS_HOME/src.  
  28. You may want to create a $KHOROS_HOME/toolboxes, or some such location.
  29. Move the tar file to that directory.  
  30.  
  31. Next, untar the toolbox with the command:
  32. % zcat xprism.tar.Z | tar -xfoB -
  33.     -OR-
  34. % uncompress -c xprism.tar.Z | tar -xfoB -
  35.  
  36.  
  37.  
  38.  
  39.         TO COMPILE AND INSTALL:
  40.  
  41.  
  42. INSTALLING TOOLBOX:
  43. This is a same procedure one would for installing any toolbox
  44.  
  45. 1) Use kraftsman to add the "xprism" toolbox to your Khoros Toolbox file
  46. 2) modify the {XPRISM}/repos/config/src_conf/xprism_mf file.
  47.            - substitute your user name as the KHOROS_USER on line 32.
  48.            - substitute the absolute location to the LOCAL_SRC_TOP on 
  49.              line 39.  Use "\pwd" in the toolbox/src directory to 
  50.              get the absolute path, and replace the existing path 
  51.              with this new path.
  52. 3) cd {top dir}/src
  53. 4) make Makefile Makefiles
  54. 5) make install
  55.  
  56. You may want to copy the new xprism3 binary into your KHOROS_HOME/bin
  57. directory and access this through the regular cantata form, rather than
  58. keeping the binary in the XPRISM toolbox bin directory. If you want
  59. to put the xprism3 binary into your KHOROS_HOME/bin follow the
  60. instructions below. Otherwise add {XPRISM}/bin to your path so that you
  61. will be able to execute the new xprism3. Also, remember to run cantata
  62. with the XPRISM/repos/cantata.form file.
  63.  
  64. INSTALLING in KHOROS_HOME
  65. 1. Compile and install xprism3 in the XPRISM toolbox. Do Not copy
  66.    this version into KHOROS_HOME/src.
  67.  
  68. 2. cp XPRISM/bin/xprism3 $KHOROS_HOME/bin/xprism3
  69.  
  70. 3. cp XPRISM/repos/cantata/subforms/plot.sub.khoros 
  71.         $KHOROS_HOME/repos/cantata/subforms/output_plot/plot.sub
  72.  
  73. 4. cp XPRISM/repos/cantata/subforms/*.pane 
  74.         $KHOROS_HOME/repos/cantata/subforms/output_plot/
  75.  
  76.  
  77. Execute cantata and try it out!!!!
  78.