home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / r / rlab / !RLaB / !Help < prev    next >
Encoding:
Text File  |  1995-11-28  |  9.0 KB  |  240 lines
  1. ARCH:
  2.     This is RLaB for RISC OS, 1.23, RISC OS beta 4.
  3.     As far as I know, it runs up for the title of 'Fattest RISC OS program'
  4.     since it is > 1.4M in size. No, won't run on a 2Mb machine :-).
  5.  
  6.     The port of RLaB to the RISC OS environment was started to provide
  7.     RISC OS with a powerful math tool. 
  8.  
  9.     I suggest that you run RLaB in a !Zap Taskwindow, since I can't tell how well
  10.     do other task windows cope with it. !Edit is fine, though.
  11.  
  12.         There is now a command line editing based on Oliver Betts 'Readline' module.
  13.         RLaB will load it for you.
  14.               
  15.         Starting from version beta3, draw files are supported as output format, 
  16.         so there should be no need for Riscript/GNUPlot anymore 
  17.         
  18.         However, GNUPlot can now be used with ease as output device since I've
  19.         rewritten the 'gnuplot' 'R' file. Find it in the !RLaB.misc.RISCOS dir
  20.         
  21.     The RISC OS version is likely to be included in the mainstream RLaB source code, 
  22.     so I expect to keep it quite up-to-date. (RLaB is now 1.23)       
  23.  
  24. ****    PLEASE READ RLaB's CHANGELOG TO FIND OUT THE DIFFERENCES BETWEEN 1.19 and 1.23
  25.  
  26.  
  27. ****    WHAT'S NEW: ( HEY , I SAID NEW , AND IT'S FREE : READ THIS !!!! )
  28.  
  29.         1.23  beta 4/23: 
  30.         
  31.         -- RLaB updated to v 1.23 - PLEASE READ RLaB's CHANGELOG
  32.         
  33.         -- command line history and editing 
  34.     
  35.     
  36.     
  37.     1.19b beta 3: *much* functionality included!
  38.     
  39.     A lot of popular requests for these 2 additions:
  40.     
  41.     -- Draw files supported! Just hit return when asked for the output device of
  42.     your choice. * NOTE *: most examples do not close the output stream, use pend()
  43.     or pclose() to do so or else the last plotted file will remain open.
  44.     Many thanks to Gareth McCaughan (gjm11@pmms.cam.ac.uk) for his mkdrawf 
  45.     utility that allowed me to debug draw files in a human-intelligible way.
  46.     mkdrawf files are available as output option 2 but are not supported.
  47.     (This also means that the plplot library now supports Draw files and that I'm going
  48.     to release it as well.)
  49.     
  50.     -- Help files can now be split on more than 1 directory (workaround for
  51.     77 file limit)
  52.     
  53.     -- New RISC OS specific 'gnuplot' 'R' file should anyone need it.
  54.     
  55.     -Some bugs fixed:
  56.      1 - Quite nasty - having the 'gnuplot' R file in the lib directory would
  57.          clash with plplot. Now 'gnuplot' has been removed from the library
  58.          'rlib' directory. 
  59.          It can be found in the 'examples' dir. If you still want to use GNUPlot,  
  60.              GNUPlot 3.4 is now supported through the gnupipe utility. Remove 
  61.              'plplot' from 'rlib' and copy 'gnuplot' in it instead.
  62.          Most examples behave as they should, now!
  63.          
  64.      2 - Now differentiates from 'not existing' and 'wrong filetype' when an error
  65.          occurs while loading.
  66.     
  67.     
  68.     
  69.     1.19b beta 2:
  70.         
  71.         -- RLaB updated to current version, 1.19b. See WHATS/NEW for RLaB specific
  72.         info on the differences between 1.18 and 1.19
  73.  
  74.     -- New RLaB / RLaB filetype icons :-) 
  75.  
  76.     -- filetypes:
  77.     RLaB now supports filetype checking, i.e. it will check the filetype 
  78.     of any 'r' file you try to load/rfile/require and generally try to interpret.
  79.     Unless the system variable  RLAB_FILETYPE is set to something appropriate
  80.     (RLaB seems to be a reasonable filetype name), RLaB will default its type
  81.     to text and will refuse to load any other types. Unfortunately, Acorn is
  82.     running short of types, so I cannot have one allocated officially.
  83.     The PD unofficially allocated type is RLaB = 0x110
  84.     Check the !boot and !run files to see how it works.
  85.     
  86.     -- gnuplot support:
  87.     Thanks to some code provided by Alun Jones I have included the 'gnupipe' 
  88.     utility. It simply pipes to GNUPlot anything you give it. 
  89.     For example: gnupipe <list of commands>.
  90.  
  91.         -- fixed docs:
  92.         The supplied primer pages are converted by DVIView and need some TeX fonts
  93.         to be installed. A !Othrfnt directory is now supplied that should contain 
  94.         all the fonts needed
  95.  
  96.           -- new rfiles:
  97.     loaddir:
  98.      old loaddir as supplied won't work under RISC OS. A RISC OS specific
  99.      version supersedes the old one (moved now to loaddir_ux)
  100.      (courtesy Ian McLoughlin)
  101.     gnupl_pipe:
  102.      pipes a command file to gnuplot (that must be already running)
  103.      See under gnuplot support
  104.     system_ext:
  105.      forks a task obey basically working nicely around the 'system' memory
  106.      problem. It is just an example that gives you an idea, in the 
  107.      'examples' directory
  108.         
  109.  
  110.  
  111.     1.18c beta 1: 
  112.     
  113.     first official release
  114.     Thanks to the new excellent Acorn C compiler v5 it can now extend its
  115.     own wimpslot so it doesn't really matter if you allocate it a smaller than
  116.     necessary chunk. Start it in a 2 Mb slot, and it will grab/release what it
  117.     needs.
  118.  
  119.  
  120. ****    OK, BUT LET ME HAVE FUN FIRST...
  121.     start !RLaB and type:
  122.     load ("test") - this should finish in approx 230 sec unless you have a math
  123.             copro (on a RPC, in a window) - It's 150 sec outside the desktop
  124.             It's 170 sec with a RPC 700 (grrr..:-) )
  125.             - how long will it take with a math copro?? 
  126.     load ("examples.plot_test") - this will create draw files and show them in 
  127.     all their glory.
  128.     if you want to test GNUPlot:
  129.     Load GNUPlot
  130.     substitute plplot in 'rlib' with gnuplot (from the misc.RISCOS dir)
  131.     start RLaB and load ("RISC_OS.gnpltst_sm")
  132.     If all goes OK, you can now proceed on your own :-)
  133.  
  134.  
  135.  
  136. ****    KNOWN BUGS/FEATURES :-):
  137.     beta 4:
  138.     - nothing new
  139.     
  140.     beta 3:
  141.     - the plplot library fails its test #19 and does not map correctly to phisycal 
  142.     coordinates (plplot test #10). This should not be a problem for RLaB.
  143.     - I've seen RLaB crash once when I selected a filename > 10 chars for plplot
  144.     output. This may have been fixed by some changes I did.
  145.     - Always use pend() at the end of your plotting to close the last output file.
  146.       This is not a bug - It's an RLaB feature.  
  147.         - RLaB might die with a backtrace or 'assertion failed' when quit, 
  148.           if a plotting session was interrupted. 
  149.           Since however this might happen only when closing RLaB, it's
  150.           only a cosmetic issue.
  151.         - I've not had time to change the gnuplot 'r' file so that it wipes its
  152.           temp files - they are named 'rtmpf*' and you might want to remove them 
  153.           manually or edit the RISC OS gnuplot 'r' file to fix this.
  154.     
  155.     -Most of the examples files are now run without any problems.
  156.       Do not rely on the examples tough - they are providing just an example.
  157.     
  158.     -system() will not work if there is no extra space left in RLaB's wimpslot
  159.      and you try to run a compiled program. You should use this trick:
  160.      1)system("taskwindow \"<your command here>\" -quit");
  161.     
  162.     -some UNIX specific features might not be working.
  163.     
  164.     -Many more, of the worst possible kind. I just haven't discovered them yet.
  165.      Expect it to fall over at any time :-). Can't be worse than Windows anyway.
  166.     
  167. ****    CREDITS
  168.     
  169.     First of all, the 2 most patient persons in the world, my wife and daughter - 
  170.     They seldom complain whan I stay up at night debugging this beast :-) 
  171.     (mmmhh.. she just read this and suggested to change 'seldom' to 'never')
  172.  
  173.     Jan Searle (jans@eskimo.com) - The man behind RLaB. Great Job!!
  174.  
  175.     Dr. Maurice LeBrun (mjl@dino.ph.utexas.edu) - PlPlot, a superb library
  176.     
  177.     Alun 'Da Penguin' Jones for several RISC OS hints and code snippets
  178.     
  179.         Please read the ANNOUNCEMENT for an updated list of credits
  180.         
  181.     
  182. ****    CONTACTS:
  183.     Ian Searle (RLaB maintainer and helmsman): ians@eskimo.com
  184.         for RLaB bugs only - check with me first to see if it's an Acorn problem
  185.     
  186.     Maurizio Ferrari (Acorn port responsible): ferrari@bologna.maraut.it
  187.         RLaB Acorn port problems
  188.         Mail me to be included in the 'updates for RISC OS' mailing list.
  189.         
  190.     RLaB mailing list: Send mail to rlab-request@eskimo.com
  191.                 This is read by a human, so no special syntax is required, just state 
  192.                 your desire.
  193.         To communicate with others on the list mail to rlab-list@eskimo.com
  194.  
  195.  
  196. ****    HISTORY:
  197.  
  198.     1.23 beta 4
  199.     RLaB updated to 1.23
  200.         readline history and editing
  201.  
  202.         1.19b beta 3
  203.         Drawfiles native
  204.         Split help dir
  205.         GNUPlot real support
  206.  
  207.     1.19b beta 2
  208.     RLaB updated to 1.19b
  209.     
  210.     1.18c beta 2 - never publicly released
  211.     Filetype check on loads/rfile/require etc. 
  212.            It defaults to text unless otherwise specified.
  213.     New startup taskobey (Now displays name in task list)
  214.     rfiles: loaddir, gnupl_pipe
  215.     
  216.     1.18c beta 1
  217.     Switched to AnsiLib and C v5
  218.     Improvements:
  219.         1-Dynamic allocations of WimpSlot (thanks to Acorn C v5)
  220.         2-Now loads files with '/' in the name string (couldn't with Unixlib)
  221.         3-Fixed Infinity and Nan representation
  222.     
  223.     1.18c alpha - never publicly released
  224.     Never released, first fully functional version. Compiled with Unixlib and Acorn C v4
  225.  
  226.  
  227. ****    FUTURE IMPROVEMENTS:
  228.     
  229.     Throwback on rfiles syntax errors
  230.     Better integration in the Desktop (nice menus, iconbar, drag, drop, AND A BANNER!)
  231.     
  232.     
  233.     PPLLLLEEEEEEAAAAAASSSSEEEEEEEEEEEE!!!!!!!!!!
  234.     
  235.     I need feedback - It took me quite a long time to port RLaB. Tell me what you think
  236.     and give advice for future enhancements. You can even send me a tin of anchovies
  237.     I like them on a slice of pizza.
  238.     
  239.     IF YOU HAVE READ SO FAR YOU ARE AN ASTOUNDING READER :-)
  240.