Man Linux: Main Page and Category List

NAME

       gri - scientific graphics language

SYNOPSIS

       gri [ OPTIONS ] [ CommandFile [ PostScriptFile ]]

DESCRIPTION

       Gri is a programming language for scientific graphics.  It can make x-y
       graphs, contour-graphs, and image graphs.  In addition, Gri has a  full
       suite  of  low-level  graphical  elements  and  sufficient  programming
       capabilities (loops, subroutines, etc) to permit complex customization.

       Gri  is  not  point-click.   In  some  ways  it  is  analogous  to TeX.
       Extensive power rewards tolerance of a modest learning curve.

OPTIONS

       If a command file (CommandFile) is named, commands are read  from  that
       file;  otherwise they are read from the keyboard.  If a command file is
       named, then a file in which to store the PostScript output may also  be
       named;  otherwise  it is stored in a file named by substituting the .ps
       extension instead of .gri in CommandFile.  If no command file is named,
       the  output is named gri-00.ps (or gri-01.ps if gri-00.ps exists, etc).

       There are 3 special forms that do no graphing:

       ‘gri -creator postscript_file’

              Extracts the Gri commands that created the Gri PostScript  file.

       ‘gri -help’ or ‘gri -h’

              Prints this help message.

       ‘gri -version’ or ‘gri -v’

              Prints the version number of Gri.

       In normal usage, where drawing is expected, Gri takes these options:

       -batch or -b

              Stops printing of prompts and hints.

       -chatty[N] or -c[N]

              Let gri print info messages

       -debug or -d

              Turns debugging on (sets variable ..debug.. to value 1).

       -warn_offpage

              Warn  if any item is drawn far off a 8.5x11 inch page.  (This is
              the default.)

       -nowarn_offpage

              Don’t warn if any item is drawn far off a 8.5x11 inch page

       -directory pathname

              Specifies the directory  where  Gri  looks  for  startup  files;
              otherwise  it  looks in /opt/gri/lib or at whatever directory is
              defined in configure shellscript, at compile time.

       -directory_default

              Reports directory where gri.cmd should be found, if not supplied
              by -directory.

       -no_bounding_box

              Make bounding-box be full page.

       -no_expecting

              Prevent  warning  message if ‘expecting version .n.’  command is
              missing.

       -no_startup_message

              Stops printing of startup message.

       -publication or -p

              Sets the builtin variable ..publication.. to 1; normally  it  is
              0.   One  might use if statements (‘if !..publication..’ ...) on
              drafts.

       -superuser or -s

              Used only by Gri programmers (who can check the value with the C
              function  ‘superuser()’.)   An  optional  value  can be supplied
              without spaces (e.g. ‘-s2’) to set the debugging  level.   Flags
              are listed below; add flags to get several actions at once

              1: print cmdline before/after substituting synonyms

              2: print cmdline before/after substituting rpn expressions

              4: print new commands being defined

              8: print system commands and ‘open "... | "’ commands before

              they are passed to the system

              128: for author’s use only

              256: for author’s use only

              Note  that  all flags are equal to 2 raised to an integer power.
              Since the flag values are detected by  a  bitwise  OR,  you  can
              combine  flags  by  adding;  thus  specifying a flag of 5 yields
              flags 1 and 4 together; specifying 15 yields flags 1, 2,  4  and
              8.

       -trace or -t

              Makes Gri print out command lines as they are executed.

       -true or -y

              Makes Gri think the answer to all ‘query’s is RETURN.

SEE ALSO

       For more information, please consult online info and html manuals.

       The  info  manual  included  in the main gri Debian package is normally
       accessed by typing

       info gri

       (or from within Emacs’ own info).

       There  are  also   reference   cards   in   postscript   format.    See
       /usr/share/doc/gri/*refcard.ps

       The  Debian  package  gri-html-doc provides the html manual, which when
       installed is then located at

              /usr/share/doc/gri/html/index.html

       or, if you have a web server installed, at

              http://localhost/doc/gri/html/index.html

       The  HTML  manual  is  accessible  via  dwww  and  dhelp  Debian   help
       interfaces.  The html FAQ is located at

              /usr/share/doc/gri/html/FAQ.html

       The     gri-html-doc     package     also    includes    examples    in
       /usr/share/doc/gri/examples/ which are described in the manual, and are
       included as a quick start primer.

       The  gri-ps-doc  package is a PostScript version of the manual suitable
       for printing.

GRI_MERGE AND GRI_UNPAGE COMMANDS

       Two Perl scripts are provided with Gri  to  manipulate  the  PostScript
       output.

       gri_merge  is  used  to  merge  multiple Gri output files into a single
       PostScript  file.   See  gri_merge  -h  and  its  man  page  for  usage
       information.

       gri_unpage  is used is split a multi-page Gri output file (in which the
       new page command was used) into separate PostScript files, one for each
       page.

       See their respective man pages.

EMACS SUPPORT

       An  emacs  mode is provided with Gri.  It is documented in the gri Info
       or HTML manual.

       The mode is installed automatically in Debian by the elisp file:

       /etc/emacs/site-start.d/50gri-el.el

       The emacs mode itself is gri-mode.el and  is  installed  on  Debian  as
       /usr/share/emacs/site-lisp/gri-mode.el

       Byte-compiled  versions  of this file are produced for every flavour of
       Emacs  that  is   installed,   and   are   located   in   places   like
       /usr/share/emacs/23.1/site-lisp/gri-el/gri-mode.elc

SEE ALSO

       gri_merge(1), gri_unpage(1)

AUTHOR

       Gri (c) 1991-2010 Dan Kelley <Dan.Kelley@Dal.CA>

       This manual page by Peter S Galbraith <psg@debian.org>.

                                                                        GRI(1)