aboutsummaryrefslogtreecommitdiff
path: root/manual
diff options
context:
space:
mode:
authorRoberto Ierusalimschy <roberto@inf.puc-rio.br>2023-06-22 11:41:48 -0300
committerRoberto Ierusalimschy <roberto@inf.puc-rio.br>2023-06-22 11:41:48 -0300
commitab6a94952215b1f66436d8eeebded1dad9fa5409 (patch)
treeba66254537defc76602ce351d962b899ddfe1b29 /manual
parent86e8039a72646cd9192fd08a6f1771c90b872ff6 (diff)
parentea39042e13645f63713425c05cc9ee4cfdcf0a40 (diff)
downloadlua-ab6a94952215b1f66436d8eeebded1dad9fa5409.tar.gz
lua-ab6a94952215b1f66436d8eeebded1dad9fa5409.tar.bz2
lua-ab6a94952215b1f66436d8eeebded1dad9fa5409.zip
Merge branch 'master' into nextversion
Diffstat (limited to 'manual')
-rwxr-xr-xmanual/2html2
-rw-r--r--manual/manual.of52
2 files changed, 32 insertions, 22 deletions
diff --git a/manual/2html b/manual/2html
index a4d860dd..43fd8913 100755
--- a/manual/2html
+++ b/manual/2html
@@ -30,7 +30,7 @@ by Roberto Ierusalimschy, Luiz Henrique de Figueiredo, Waldemar Celes
30<p> 30<p>
31<small> 31<small>
32<a href="http://www.lua.org/copyright.html">Copyright</a> 32<a href="http://www.lua.org/copyright.html">Copyright</a>
33&copy; 2022 Lua.org, PUC-Rio. All rights reserved. 33&copy; 2023 Lua.org, PUC-Rio. All rights reserved.
34</small> 34</small>
35<hr> 35<hr>
36 36
diff --git a/manual/manual.of b/manual/manual.of
index 446517ec..1e219f9a 100644
--- a/manual/manual.of
+++ b/manual/manual.of
@@ -20,7 +20,7 @@ making it ideal for configuration, scripting,
20and rapid prototyping. 20and rapid prototyping.
21 21
22Lua is implemented as a library, written in @emphx{clean C}, 22Lua is implemented as a library, written in @emphx{clean C},
23the common subset of C and C++. 23the common subset of @N{standard C} and C++.
24The Lua distribution includes a host program called @id{lua}, 24The Lua distribution includes a host program called @id{lua},
25which uses the Lua library to offer a complete, 25which uses the Lua library to offer a complete,
26standalone Lua interpreter, 26standalone Lua interpreter,
@@ -3161,6 +3161,27 @@ when called through this function.
3161 3161
3162} 3162}
3163 3163
3164@APIEntry{int lua_closethread (lua_State *L, lua_State *from);|
3165@apii{0,?,-}
3166
3167Resets a thread, cleaning its call stack and closing all pending
3168to-be-closed variables.
3169Returns a status code:
3170@Lid{LUA_OK} for no errors in the thread
3171(either the original error that stopped the thread or
3172errors in closing methods),
3173or an error status otherwise.
3174In case of error,
3175leaves the error object on the top of the stack.
3176
3177The parameter @id{from} represents the coroutine that is resetting @id{L}.
3178If there is no such coroutine,
3179this parameter can be @id{NULL}.
3180
3181(This function was introduced in @N{release 5.4.6}.)
3182
3183}
3184
3164@APIEntry{int lua_compare (lua_State *L, int index1, int index2, int op);| 3185@APIEntry{int lua_compare (lua_State *L, int index1, int index2, int op);|
3165@apii{0,0,e} 3186@apii{0,0,e}
3166 3187
@@ -4157,23 +4178,12 @@ and then pops the top element.
4157 4178
4158} 4179}
4159 4180
4160@APIEntry{int lua_resetthread (lua_State *L, lua_State *from);| 4181@APIEntry{int lua_resetthread (lua_State *L);|
4161@apii{0,?,-} 4182@apii{0,?,-}
4162 4183
4163Resets a thread, cleaning its call stack and closing all pending 4184This function is deprecated;
4164to-be-closed variables. 4185it is equivalent to @Lid{lua_closethread} with
4165Returns a status code: 4186@id{from} being @id{NULL}.
4166@Lid{LUA_OK} for no errors in the thread
4167(either the original error that stopped the thread or
4168errors in closing methods),
4169or an error status otherwise.
4170In case of error,
4171leaves the error object on the top of the stack.
4172
4173The parameter @id{from} represents the coroutine that is resetting @id{L}.
4174If there is no such coroutine,
4175this parameter can be @id{NULL}.
4176(This parameter was introduced in @N{release 5.4.5}.)
4177 4187
4178} 4188}
4179 4189
@@ -5787,7 +5797,7 @@ with @id{tname} in the registry.
5787 5797
5788Creates a new Lua state. 5798Creates a new Lua state.
5789It calls @Lid{lua_newstate} with an 5799It calls @Lid{lua_newstate} with an
5790allocator based on the @N{standard C} allocation functions 5800allocator based on the @N{ISO C} allocation functions
5791and then sets a warning function and a panic function @see{C-error} 5801and then sets a warning function and a panic function @see{C-error}
5792that print messages to the standard error output. 5802that print messages to the standard error output.
5793 5803
@@ -6905,10 +6915,10 @@ including if necessary a path and an extension.
6905@id{funcname} must be the exact name exported by the @N{C library} 6915@id{funcname} must be the exact name exported by the @N{C library}
6906(which may depend on the @N{C compiler} and linker used). 6916(which may depend on the @N{C compiler} and linker used).
6907 6917
6908This function is not supported by @N{ISO C}. 6918This functionality is not supported by @N{ISO C}.
6909As such, it is only available on some platforms 6919As such, @id{loadlib} is only available on some platforms:
6910(Windows, Linux, Mac OS X, Solaris, BSD, 6920Linux, Windows, Mac OS X, Solaris, BSD,
6911plus other Unix systems that support the @id{dlfcn} standard). 6921plus other Unix systems that support the @id{dlfcn} standard.
6912 6922
6913This function is inherently insecure, 6923This function is inherently insecure,
6914as it allows Lua to call any function in any readable dynamic 6924as it allows Lua to call any function in any readable dynamic