# the "-fix" option to hevea makes it run as many times as necessary

 # to resolve all cross-references and generate an index.

 	$(HEVEA) -fix cmu-user.hva $<

 	$(HACHA) -tocbis $@

 	-$(TIDY) -m *.html

 	rm -f *.log *.bbl *.blg *.ps *.pdf *.aux *.lof *.toc *.out *.ilg

 	rm -f *.vdx *.cdx *.tdx *.fdx *.idx *.cnd *.fnd *.tnd *.vnd *.haux

 	rm -f *.html *.hcnd *.htnd *.hvnd *.hfnd *.htoc

 index:

 	makeindex cmu-user.tdx -o cmu-user.tnd

 \subsection{Alien Access Operations}

   This function returns the value pointed to by an Alien pointer or

   the value of an Alien array element.  If a pointer, an optional

 macro:

 \begin{defmac}{alien:}{def-callback}{\var{name} (\var{return-type}

   This macro defines a Lisp function that can be called from C and a

   Lisp variable.  The arguments to the function must be alien types,

   and the return type must also be an alien type.  This Lisp function

   \code{def-callback} macro.

 \end{defmac}

     \var{args}}

   This macro does the necessary stuff to call the callback named

   \var{callback-name} with the given arguments.

 % to HTML using Hevea. By Luc Maranget and Eric Marsden.

 \newif\ifhmode\hmodefalse

 \let\hbox\mbox

 \def\hfil{}

 \def\hfill{}

 \newcommand{\parbox}[3][]{\mbox{#3}}

 \newcommand{\lengthtest}[1]{true}

 \newenvironment{minipage}[2][]{}{}

    [#4] \\

    \fcnname{#1}\fcnname{#2} #3 \@print{   }

    \@close{DIV}}

 % \newcommand{\layout}[4][]

 %   {\begin{tabular}

 %    \end{tabular}}

 %% Define a new type

 %%

 %%    some description

 %% \end{deftp}

 \newenvironment{deftp}[3]

    \begin{quote}}

   {\end{quote}}

 %% Define a function

 %%

 %%   \defunx[pkg]{name}{params}

 %%   description of function

 %% \end{defun}

   \begin{quote}}

   {\end{quote}}

 \newcommand{\defunx}[3][\mbox{}]{%

 %% Define a macro

 %%

 %%   \defmacx[pkg]{name}{params}

 %%   description of macro

 %% \end{defmac}

   \begin{quote}}

   {\end{quote}}

 \newcommand{\defmacx}[3][\mbox{}]{%

 %% Define a variable

 %%

 %%   description of defvar

 %% \end{defvar}

 \newenvironment{defvar}[2]{%

   \begin{quote}}

   {\end{quote}}

 \newcommand{\defvarx}[2][\mbox{}]{%

 %% Define a constant

 %%

 %%   description of defconst

 %% \end{defconst}

 \newenvironment{defconst}[2]{%

   \begin{quote}}

   {\end{quote}}

 \newcommand{\defconstx}[2][\mbox{}]{%

   {\@open{BLOCKQUOTE}{class=example}\begin{alltt}}

   {\end{alltt}\@close{BLOCKQUOTE}}

 \newenvironment{lisp}

   {\end{alltt}\@close{BLOCKQUOTE}}

 % there are no page numbers in HTML, so we need to override certain

 % cross-referencing macros

 % disable ``this document generated by'' footer

 % \htmlhead{\@print{

 % <a href="../../">CMUCL</a> -&gt

 \setcounter{cuttingdepth}{10}

 \input{report.hva}

 \definecolor{chapter}{rgb}{1, 1, 0.74}

 \definecolor{part}{rgb}{1, 1, 0.81}

 \definecolor{section}{rgb}{1, 1, 0.83}

 \definecolor{subsection}{rgb}{1, 1, 0.89}

 \definecolor{subsubsection}{rgb}{1, 1, 0.93}

 \renewcommand{\@bodyargs}{}

 % EOF

 .code {

    background: #faf0e6;

    border:solid #faf0e6 1px;

 }

 .technical {

 \end{defun}

   Return the truename (in the sense of the variable

    \vindexed{compile-file-truename}) of the source file from which the

    referencing forms were compiled. This slot will be \nil{} if the

    listener.

 \end{defun}

   Return a list of positive integers identifying the form that

   contains the cross-reference. The first integer in the source-path

   is the number of the top-level form containing the cross-reference

 function entry or exit.

 \begin{defmac}{}{trace}{%

   \code{trace} is a debugging tool that prints information when

   specified functions are called.  In its simplest form:

   \findexed{truncate} function.

 \end{Lentry}

 \code{set-floating-point-modes}, use of any value other than the

 default (\kwd{nearest}) can cause unusual behavior, since it will

 affect rounding done by \llisp{} system code as well as rounding in

 To make handling control of floating-point exceptions, the following

 macro is useful.

   \code{body} is executed with the selected floating-point exceptions

   given by \code{traps} masked out (disabled).  \code{traps} should be

   a list of possible floating-point exceptions that should be ignored.

 \section{Describe}

   The \code{describe} function prints useful information about

   \var{object} on \var{stream}, which defaults to

 \section{Generalized Function Names}

   Define lists starting with the symbol \code{name} as a new extended

   function name syntax.

   user-defined package.

 \end{defmac}

   Returns two values:

   \begin{itemize}

   standardized method combinations like \code{progn}, \code{and}, etc.

 \end{itemize}

   In \cmucl, this generic function is called in the above erroneous

   cases.  The parameter \code{gf} is the generic function being

   called, and \code{args} is a list of actual arguments in the generic

 \end{defgeneric}

 \begin{defmethod}[-standard]{pcl:}{no-primary-method}{%

   This method signals a continuable error of type

   \code{pcl:no-primary-method-error}.

 \end{defmethod}

 else.  Because of this, the function \code{pcl:flush-emf-cache} is

 provided for forcing such an update of effective methods.

   Flush cached effective method functions.  If \code{gf} is supplied,

   it should be a generic function metaobject or the name of a generic

   function, and this function flushes all cached effective methods for

 Support for sealing classes and generic functions have been

 implemented.  Please note that this interface is subject to change.

   Seal \code{name} with respect to the given specifiers; \code{name}

   can be the name of a class or generic-function.

   Sealing violations signal an error of type \code{pcl:sealed-error}.

 \end{defmac}

   Remove seals from \code{name-or-object}.

 \end{defun}

 \subsection{Extensions}

   As an extension, \cmucl{} allows \code{constantly} to accept more

   than one value which are returned as multiple values.

 \end{defun}

 \code{(setf fdefinition)} will set the primary function in the

 innermost fwrapper.

   This macro is like \code{defun}, but defines a function named

   \var{name} that can be used as an fwrapper definition.

   arguments.

 \end{defmac}

   This function wraps function \code{function-name} in an fwrapper

   \var{fwrapper} which was defined with \code{define-fwrapper}.

   Value is the fwrapper object created.

 \end{defun}

   Remove fwrappers from the function named \var{function-name}.  If

   \var{type} is supplied, remove fwrappers whose type is \code{equal}

   to \var{type}.  If \var{test} is supplied, remove fwrappers

   satisfying \var{test}.

 \end{defun}

   Find an fwrapper of \var{function-name}.  If \var{type} is supplied,

   find an fwrapper whose type is \code{equal} to \var{type}.  If

   \var{test} is supplied, find an fwrapper satisfying \var{test}.

 \end{defun}

   Update the funcallable instance function of the fwrapper object

   \var{fwrapper} from the definition of its function that was 

   defined with \code{define-fwrapper}.  This can be used to update

   fwrappers after changing a \code{define-fwrapper}.

 \end{defun}

   Update fwrappers of \var{function-name}; see \code{update-fwrapper}.

   If \var{type} is supplied, update fwrappers whose type is

   \code{equal} to \var{type}.  If \var{test} is supplied, update fwrappers

   satisfying \var{test}.

 \end{defun}

   Set \var{function-names}'s fwrappers to elements of the list

   \var{fwrappers}, which is assumed to be ordered from outermost to

   innermost.  \var{fwrappers} null means remove all fwrappers.

 \end{defun}

   Return a list of all fwrappers of \var{function-name}, ordered

   from outermost to innermost.

 \end{defun}

   Prepend fwrapper \var{fwrapper} to the definition of

   \var{function-name}.  Signal an error if \var{function-name} is an

   undefined function.

 \end{defun}

   Remove fwrapper \var{fwrapper} from the definition of

   \var{function-name}.  Signal an error if \var{function-name} is an

   undefined function.

 \end{defun}

   Evaluate \var{body} with \var{var} bound to consecutive fwrappers of

   \var{fdefn}.  Return \var{result} at the end.  Note that \var{fdefn}

   must be an \code{fdefn} object.  You can use

   beginning of this list.

 \end{defvar}

   Defines a module by registering the files that need to be loaded

   when the module is required.  If \var{name} is a symbol, its print

   name is used after downcasing it.

 \end{defmac}

   This function is the module-provider for modules registered by a

   \code{ext:defmodule} form.  

 \end{defun}

   This function is the module-provider for \cmucl's libraries,

   including Gray streams, simple streams, CLX, CLM, Hemlock,

   \emph{etc}.

   Disablle recording of translatable strings.

 \end{defun}

   Sets the locale to the locale specified by \var{locale}.  If

   \var{locale} is not give or is \nil, the locale is determined by

   look at the environment variables \code{LANGUAGE}, \code{LC\_ALL},

   The default locale is ``C''.

 \end{defun}

   Set the default domain to the domain specified by \var{domain}.

   Typically,  this only needs to be done at the top of each source

   file.  This is used to \code{gettext} and \code{ngettext} to set the

   domain for the message string.

 \end{defun}

   Look up the specified string, \var{string}, in the current message

   domain and return its translation.

 \end{defmac}

   Look up the specified string, \var{string}, in the message domain,

   \var{domain}.  The translation is returned.

   \code{intl::dump-pot-files}.) 

 \end{defun}

   Look up the singular or plural form of a message in the default

   domain.  The singular form is \var{singular}; the plural is

   \var{plural}.  The number of items is specified by \var{n} in case

   the correct translation depends on the actual number of items.

 \end{defmac}

   Look up the singular or plural form of a message in the specified

   domain, \var{domain}.  The singular form is \var{singular}; the

   plural is \var{plural}.  The number of items is specified by \var{n}

   created.  (See \code{intl::dump-pot-files}.)

 \end{defun}

   Dumps the translatable strings recorded by \code{dgettext} and

   \code{dngettext}.  The message template file (pot file) is written

   to a file in the directory specified by \var{output-directory}, and

   This is a list of directory pathnames where the translations can be found.

 \end{defvar}  

   Installs reader macros and comment reader into the specified

   readtable as explained below.  The readtable defaults to

   \var{*readtable*}.

 switches:

 \begin{Lentry}

 \item[\code{-help}] Print ou the command line options and exit.

 \end{defmac}

 \begin{defmac}{wire:}{remote-value-bind}{%

       \mstar{local-forms}}}

   \code{remote-value-bind} is similar to \code{multiple-value-bind}

 \begin{defun}{}{string=}{\args \var{s1} \var{s2} \keys{\kwd{start1}

       \kwd{end1} \kwd{start2} \kwd{end2}}}

   \defunx{string/=}{\args \var{s1} \var{s2} \keys{\kwd{start1} \kwd{end1} \kwd{start2} \kwd{end2}}}

   The string comparison is done in codepoint order.  (This is

   different from just comparing the order of the individual characters

   due to surrogate pairs.)  Unicode collation is not done.

 \file{ext-formats:unidata.bin}.  If this file is not found, Unicode

 support is severely reduced; you can only use ASCII characters.

     \keys{\kwd{direction} \kwd{element-type} \kwd{if-exists}

       \kwd{if-does-not-exist} \morekeys \kwd{class} \kwd{mapped}

       \kwd{input-handle} \kwd{output-handle}

   formats and composing external formats.

 \end{defun}

   Print a description of the given \var{external-format}.  This may

   cause the external format to be loaded (silently) if it is not

   already loaded.

 external format is defined using the macro

 \code{stream::define-external-format}.

     (\amprest{} \var{slots})

   If \kwd{base} is not given, this defines a new external format of

 \subsection{Composing External Formats}

 \begin{defmac}{stream:}{define-composing-external-format}{\args \var{name}

     \var{output}}

   This is the same as \code{define-external-format}, except that a

   composing external format is created.