commit 4fb77c430869e4a6c95fd00cd6a9b9c383d95e71
parent bced00ab9efcdc68982b5e3787f277b86ea3cde8
Author: Roberto Ierusalimschy <roberto@inf.puc-rio.br>
Date: Mon, 29 Apr 1996 15:49:48 -0300
no more "lua_Reference"; new return value for "append";
documentation of "exit" (it was not in the manual).
Diffstat:
M | manual.tex | | | 39 | +++++++++++++++++---------------------- |
1 file changed, 17 insertions(+), 22 deletions(-)
diff --git a/manual.tex b/manual.tex
@@ -1,4 +1,4 @@
-% $Id: manual.tex,v 1.15 1996/04/01 14:36:35 roberto Exp roberto $
+% $Id: manual.tex,v 1.16 1996/04/22 18:00:37 roberto Exp roberto $
\documentstyle[fullpage,11pt,bnf]{article}
@@ -34,7 +34,7 @@ Waldemar Celes Filho
\tecgraf\ --- Departamento de Inform\'atica --- PUC-Rio
}
-\date{\small \verb$Date: 1996/04/01 14:36:35 $}
+\date{\small \verb$Date: 1996/04/22 18:00:37 $}
\maketitle
@@ -1079,12 +1079,10 @@ The routines to manipulate references are the following:
\Deffunc{lua_ref}\Deffunc{lua_getref}
\Deffunc{lua_pushref}\Deffunc{lua_unref}
\begin{verbatim}
-typedef int lua_Reference;
-
-lua_Reference lua_ref (int lock);
-lua_Object lua_getref (lua_Reference ref);
-void lua_pushref (lua_Reference ref);
-void lua_unref (lua_Reference ref);
+int lua_ref (int lock);
+lua_Object lua_getref (int ref);
+void lua_pushref (int ref);
+void lua_unref (int ref);
\end{verbatim}
The function \verb'lua_ref' creates a reference
to the object which is on the top of the stack,
@@ -1122,7 +1120,7 @@ Currently there are three standard libraries:
\begin{itemize}
\item string manipulation;
\item mathematical functions (sin, cos, etc);
-\item input and output.
+\item input and output (plus some system facilities).
\end{itemize}
In order to have access to these libraries,
the host program must call the functions
@@ -1382,8 +1380,6 @@ This function opens a file named \verb'filename' and sets it as the
{\em current} output file.
Unlike the \verb'writeto' operation,
this function does not erase any previous content of the file.
-This function returns 2 if the file already exists,
-1 if it creates a new file, and \nil\ on failure.
\subsubsection*{{\tt remove (filename)}}\Deffunc{remove}
@@ -1484,15 +1480,11 @@ it returns a reasonable date and time representation.
This function replaces functions \verb'date' and \verb'time' from
previous Lua versions.
+\subsubsection*{{\tt exit ([code])}}\Deffunc{exit}
-% \subsubsection*{{\tt debug ()}}
-% This function, when called, repeatedly presents a prompt \verb'lua_debug> '
-% in the error output stream (\verb'stderr'),
-% reads a line from the standard input,
-% and executes (``dostring'') the line.
-% The loop ends when the user types \verb'cont' to the prompt.
-% This function then returns and the execution of the program continues.
-
+This function calls the C function \verb-exit-,
+with an optional \verb-code-,
+to terminate the program.
\section{The Debuger Interface} \label{debugI}
@@ -1850,8 +1842,8 @@ as illustrated in Figure~\ref{Cinher}.
\begin{verbatim}
#include "lua.h"
-lua_Reference lockedParentName; /* lock index for the string "parent" */
-lua_Reference lockedOldIndex; /* previous fallback function */
+int lockedParentName; /* lock index for the string "parent" */
+int lockedOldIndex; /* previous fallback function */
void callOldFallback (lua_Object table, lua_Object index)
{
@@ -2090,10 +2082,13 @@ Here is a list of all these differences.
Functions \verb'date' and \verb'time' (from \verb'iolib')
have been superseded by the new version of function \verb'date'.
\item
+Function \verb'append' (from \verb'iolib') now returns 1 whenever it succeeds,
+whether the file is new or not.
+\item
Function \verb'int2str' (from \verb'strlib') has been superseded by new
function \verb'format', with parameter \verb'"%c"'.
\item
-The lock mechanism has been superseded by the reference mechanism.
+The API lock mechanism has been superseded by the reference mechanism.
However, \verb-lua.h- provides compatibility macros,
so there is no need to change programs.
\item