GRI(1) GRI(1)
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
- 1 - Formatted: November 5, 2025
GRI(1) GRI(1)
-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
- 2 - Formatted: November 5, 2025
GRI(1) GRI(1)
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
- 3 - Formatted: November 5, 2025
GRI(1) GRI(1)
/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
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/20.2/site-lisp/gri-mode.elc
INSTALLING MULTIPLE VERSIONS
Since the way Gri works sometimes changes with new versions, you may
want to keep old versions installed if an important script depends on
it. The Debian packaging of Gri allows this. Installing the next gri
package (named like gri_LATERVSN-1.deb) will replace your current
version, but Debian i386 (and perhaps alpha) packages will be made for
older versions which can be installed alongside the main gri package.
Look for a package named like so:
- 4 - Formatted: November 5, 2025
GRI(1) GRI(1)
gri-VSN_VSN-1_i386.deb
at the SourceForge download page for the gri project:
http://sourceforge.net/project/showfiles.php?group_id=5511
SEE ALSO
gri_merge(1), gri_unpage(1)
AUTHOR
Gri (c) 1991-2002 Dan Kelley <Dan.Kelley@Dal.CA>
This manual page by Peter S Galbraith <psg@debian.org>.
- 5 - Formatted: November 5, 2025
