/usr/share/doc/gri/html/GetEnv.html is in gri-html-doc 2.12.23-9build2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>Gri: `get env' command</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"></head>
<body bgcolor="#FFFFFF" text="#000000" link="#0000EE" vlink="#551A8B" alink="FF0000">
<!-- newfile GetEnv.html "Gri: `get env' command" "Gri Commands" -->
<!-- @node Get Env, Group, Flip, List Of Gri Commands -->
<a name="GetEnv" ></a>
<img src="./resources/top_banner.gif" alt="navigation map" usemap="#navigate_top" border="0">
<table summary="top banner" border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="150" valign="top">
<font size=-1>
<br>
Chapters:
<br>
<a href="Introduction.html">1: Introduction</a><br>
<a href="SimpleExample.html">2: Simple example</a><br>
<a href="InvokingGri.html">3: Invocation</a><br>
<a href="GettingMoreControl.html">4: Finer Control</a><br>
<a href="X-Y.html">5: X-Y Plots</a><br>
<a href="ContourPlots.html">6: Contour Plots</a><br>
<a href="Images.html">7: Image Plots</a><br>
<a href="Examples.html">8: Examples</a><br>
<a href="Commands.html">9: Gri Commands</a><br>
<a href="Programming.html">10: Programming</a><br>
<a href="Environment.html">11: Environment</a><br>
<a href="Emacs.html">12: Emacs Mode</a><br>
<a href="History.html">13: History</a><br>
<a href="Installation.html">14: Installation</a><br>
<a href="Bugs.html">15: Gri Bugs</a><br>
<a href="TestSuite.html">16: Test Suite</a><br>
<a href="GriInThePress.html">17: Gri in Press</a><br>
<a href="Acknowledgments.html">18: Acknowledgments</a><br>
<a href="License.html">19: License</a><br>
<br>
Indices:<br>
<a href="ConceptIndex.html"><i>Concepts</i></a><br>
<a href="CommandIndex.html"><i>Commands</i></a><br>
<a href="BuiltinIndex.html"><i>Variables</i></a><br>
</font>
<td width="500" valign="top">
<map name="navigate_top">
<area alt="index.html#Top" shape="rect" coords="5,2,218,24" href="index.html#Top">
<area alt="ListOfGriCommands.html#ListOfGriCommands" shape="rect" coords="516,2,532,24" href="ListOfGriCommands.html#ListOfGriCommands">
<area alt="Gri: `flip' command" shape="rect" coords="557,2,573,24" href="Flip.html">
<area alt="Gri: `group' command" shape="rect" coords="581,2,599,24" href="Group.html">
</map>
<map name="navigate_bottom">
<area alt="index.html#Top" shape="rect" coords="5,2,218,24" href="index.html#Top">
<area alt="Gri: `group' command" shape="rect" coords="581,2,599,24" href="Group.html">
</map>
<h3>9.3.13: `<font color="#82140F"><code>get env</code></font>'</h3>
<!-- latex: \index{get env} -->
<TABLE SUMMARY="Example" BORDER="0" BGCOLOR="#efefef" WIDTH="100%">
<TR>
<TD>
<PRE>
<font color="#82140F">
`get env \result \environment_variable'
</font></PRE>
</TD>
</TR>
</TABLE>
<p>
Get the value of an "environment variable" from the unix operating system,
and store the result in the indicated synonym. This makes most sense on
unix systems (hence the name, patterned after the unix command
`<font color="#82140F"><code>getenv</code></font>'). This command can be useful in making gri programs
resistant to changes in data-file locations. Suppose, for example,
there is a file called `<font color="#82140F"><samp>data</samp></font>', normally in a local directory called
`<font color="#82140F"><code>Bravo</code></font>'. The line `<font color="#82140F"><code>open Bravo/data</code></font>' will fail if the Bravo
directory is moved. But if the name of the datafile is stored in an
unix environment variable, `<font color="#82140F"><code>DIR_BRAVO</code></font>' say, then the gri program will
work no matter where the Bravo data are moved, so long as an appropriate
environment variable is modified when the data are moved. Example:
<p>
<TABLE SUMMARY="Example" BORDER="0" BGCOLOR="#efefef" WIDTH="100%">
<TR>
<TD>
<PRE>
<font color="#82140F">
get env \dir DIR_BRAVO
if {rpn "\dir" "" ==}
show "Cannot determine location of the Bravo data,"
show "which should be stored in the environment"
show "variable DIR_BRAVO. You should"
show "do something like"
show "export DIR_BRAVO='/data/Bravo/'"
show "in your ~/.environment file"
quit
end if
open \dir/data
...
</font></PRE>
</TD>
</TR>
</TABLE>
<p>
</table>
<img src="./resources/bottom_banner.gif" alt="navigation map" usemap="#navigate_bottom" border="0">
</body>
</html>
|