<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>Environment variables used by Hugs</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="The Hugs 98 User's Guide"
HREF="index.html"><LINK
REL="UP"
TITLE="Changing the behaviour of Hugs"
HREF="options.html"><LINK
REL="PREVIOUS"
TITLE="Changing the behaviour of Hugs"
HREF="options.html"><LINK
REL="NEXT"
TITLE="Locale-based character encoding"
HREF="locale.html"><LINK
REL="STYLESHEET"
TYPE="text/css"
HREF="hugs-ug.css"></HEAD
><BODY
CLASS="SECT1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>The Hugs 98 User's Guide</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="options.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Chapter 3. Changing the behaviour of Hugs</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="locale.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="ENVIRONMENT-VARIABLES"
>3.2. Environment variables used by Hugs</A
></H1
><P
>Hugs also consults a number of environment variables
on systems that support them.
The method for setting these varies with the system.</P
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><A
NAME="EMACS"
></A
><CODE
CLASS="ENVAR"
>EMACS</CODE
></DT
><DD
><P
>(Windows only)
If this variable is set, Hugs is assumed to be running in an Emacs subshell
(with different line termination conventions on input).</P
></DD
><DT
><A
NAME="HOME"
></A
><CODE
CLASS="ENVAR"
>HOME</CODE
></DT
><DD
><P
>The user's home directory.
This is substituted for <TT
CLASS="LITERAL"
>{Home}</TT
> in the argument of the
<A
HREF="options.html#OPTION-SEARCH-PATH"
><CODE
CLASS="OPTION"
>-P</CODE
></A
> option
(see <A
HREF="options.html#OPTIONS-LOADING"
>Section 3.1.2</A
>),
and for <SPAN
CLASS="QUOTE"
>"<TT
CLASS="LITERAL"
>~</TT
>"</SPAN
> in the argument of the
<B
CLASS="COMMAND"
>:cd</B
> command
(see <A
HREF="misc-commands.html"
>Section 2.4</A
>).</P
></DD
><DT
><A
NAME="HUGSFLAGS"
></A
><CODE
CLASS="ENVAR"
>HUGSFLAGS</CODE
></DT
><DD
><P
>Additional options for Hugs, processed before any given on the command line
(see <A
HREF="options.html#OPTIONS-LIST"
>Section 3.1</A
>).
The following example assumes a shell compatible with the Unix Bourne shell:
<PRE
CLASS="PROGRAMLISTING"
>HUGSFLAGS='+k -E"vi +%d"'
export HUGSFLAGS</PRE
></P
></DD
><DT
><A
NAME="HUGSDIR"
></A
><CODE
CLASS="ENVAR"
>HUGSDIR</CODE
></DT
><DD
><P
>The Hugs library directory.
This is substituted for <TT
CLASS="LITERAL"
>{Hugs}</TT
> in the argument of the
<A
HREF="options.html#OPTION-SEARCH-PATH"
><CODE
CLASS="OPTION"
>-P</CODE
></A
> option
(see <A
HREF="options.html#OPTIONS-LOADING"
>Section 3.1.2</A
>).
This directory should also contain an <TT
CLASS="FILENAME"
>include</TT
>
subdirectory, which <B
CLASS="COMMAND"
>ffihugs</B
> will search for include
files, particularly <TT
CLASS="FILENAME"
>HsFFI.h</TT
>
(see <A
HREF="ffihugs.html"
>Section 4.2</A
>).</P
></DD
><DT
><A
NAME="IGNORE-USER-REGISTRY"
></A
><CODE
CLASS="ENVAR"
>IGNORE_USER_REGISTRY</CODE
></DT
><DD
><P
>(Windows only)
If this variable is set, options are not read from the user portion of the
Registry (see <A
HREF="options.html#OPTIONS-LIST"
>Section 3.1</A
>).
You might use this to recover if your registry settings get messed up
somehow.</P
></DD
><DT
><A
NAME="LCCTYPE"
></A
><CODE
CLASS="ENVAR"
>LC_CTYPE</CODE
></DT
><DD
><P
>The locale used for external representation of Haskell <TT
CLASS="LITERAL"
>Char</TT
>
values
(see <A
HREF="locale.html"
>Section 3.3</A
>).</P
></DD
><DT
><A
NAME="SHELL"
></A
><CODE
CLASS="ENVAR"
>SHELL</CODE
></DT
><DD
><P
>The shell that is invoked by the <B
CLASS="COMMAND"
>:!</B
> command
(see <A
HREF="misc-commands.html"
>Section 2.4</A
>).</P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="options.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="locale.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Changing the behaviour of Hugs</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="options.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Locale-based character encoding</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
