


RLAB(1)                   USER COMMANDS                   RLAB(1)


NAME
       rlab  -  matrix oriented, interactive programming environ-
       ment


SYNOPSIS
       rlab [-Vdhlmnpqr] [file(s)] [-]

DESCRIPTION
       rlab is an  interpreter  for  the  RLaB  Programming  Lan-
       guage/Environment.  The RLaB language is useful for matrix
       or array oriented numerical analyses. RLaB  is  especially
       useful  for prototyping and experimenting with algorithms.

       rlab also provides a convenient interface to many  of  the
       LAPACK, FFTPACK, and RANLIB subroutines.


OPTIONS
       -V     Prints the version number to stderr and exits.

       -d     causes  a  readable  form  of  the  internal  stack
              machine's compiled program to be output to  stderr.
              This  option  should  be  used  in conjunction with
              `-qln' options. This option  is  not  intended  for
              general use.

       -h     prints the usage message to the screen and exits.

       -l     prevents loading of the rlab library of rfiles.

       -m     prevents printing of the greeting message.

       -n     prevents line number and file name information from
              being used in the  internal  stack  machine  codes.
              This  option  should only be used with the `-dlnq'.
              This option is not intended for general use.

       -p     prevents rlab from using the  specified  pager  for
              all output.

       -q     prevents loading of the startup file

       -r     prevents usage of the GNU readline library for com-
              mand line editing.

       file(s)
              are loaded and executed by rlab after  the  `.rlab'
              file, and after the library files.

       -      forces  rlab  to go interactive after all the files
              on the command line have been executed.





Version 1.11               1 June 1994                          1





RLAB(1)                   USER COMMANDS                   RLAB(1)


ENVIRONMENT
       rlab checks the values of  several  environment  variables
       upon  startup,  and  uses  them to overide the compiled in
       defaults. If a particular  environment  variable  has  not
       been set, the default value is used.

       RLAB_RC0 Startup rfile.

       RLAB_HELP_DIR The principle directory of help files.

       RLAB_LIB_DIR The directory of rfiles to load on startup.

       RLAB_PAGER  The  pager to use for paging help files to the
       screen. If RLAB_PAGER is not set, then the environment  is
       checked  for  PAGER  .   If neither exists, then the pager
       specified at compile time is used.

       RLAB_SEARCH_PATH A colon separated list of directories  to
       search when attempting to load rfiles. This directory list
       should contain  the  RLAB_LIB_DIR  and  the  RLaB  toolbox
       directory.  If RLAB_LIB_DIR is not in the RLAB_SEARCH_PATH
       , then there may be unresolved function variables.


EXECUTION
       rlab is normally executed from a shell command line.  Upon
       startup rlab

       Processes the command line options.

       Executes the `.rlab' file.

       Executes any `.r' files in the library directory.

       Executes any files specified on the command line.

       Goes into interactive mode if no files are specified on the
       command line, or if the `-' option is used.

       rlab  can  also  be  invoked  by using the `#!' convention
       employed by exec(2).  A rlab script  that  begins  with  a
       line of the form:

            #! pathname [arg]

       where  pathname  is  the  full  pathname  to the rlab exe-
       cutable, and arg is optional argument(s). Note that if the
       `-'  option  is not specified rlab will not go interactive
       after the script has been executed.


DOCUMENTATION
       rlab has an on-line help system, which can be accessed  by
       typing  `help'.  A  tutorial  and  a  reference manual are



Version 1.11               1 June 1994                          2





RLAB(1)                   USER COMMANDS                   RLAB(1)


       currently being worked on.

       This man-page was not intended to provide a description of
       the language, or rlab's features. Please refer to the man-
       uals, or the on-line help.


BUGS
       Paged output gets hosed after an `out of memory'  message.

       rlab  implements  fprintf(),  printf() and sprintf() using
       the C library functions, fprintf, printf and  sprintf,  so
       rlab inherits any bugs or limitations of the library func-
       tions.

       Send bug reports to: ians@eskimo.com.

       Bug reports should include  the  rlab  version  number,  a
       short  rfile  that exercises the bug, and a description of
       the host operating system and hardware.


AUTHORS
       Ian Searle (ians@eskimo.com)

       Phillip Musumeci and Ian Searle are  the  authors  of  the
       RLaB Primer

       Brad Hards is the author of the RLaB Reference Manual

       Mike Brennan has contributed some code from mawk.


SEE ALSO
       sh (1) more (1) exec (2)






















Version 1.11               1 June 1994                          3


