diff options
| author | Roberto Ierusalimschy <roberto@inf.puc-rio.br> | 2023-06-22 11:41:48 -0300 |
|---|---|---|
| committer | Roberto Ierusalimschy <roberto@inf.puc-rio.br> | 2023-06-22 11:41:48 -0300 |
| commit | ab6a94952215b1f66436d8eeebded1dad9fa5409 (patch) | |
| tree | ba66254537defc76602ce351d962b899ddfe1b29 /manual | |
| parent | 86e8039a72646cd9192fd08a6f1771c90b872ff6 (diff) | |
| parent | ea39042e13645f63713425c05cc9ee4cfdcf0a40 (diff) | |
| download | lua-ab6a94952215b1f66436d8eeebded1dad9fa5409.tar.gz lua-ab6a94952215b1f66436d8eeebded1dad9fa5409.tar.bz2 lua-ab6a94952215b1f66436d8eeebded1dad9fa5409.zip | |
Merge branch 'master' into nextversion
Diffstat (limited to 'manual')
| -rwxr-xr-x | manual/2html | 2 | ||||
| -rw-r--r-- | manual/manual.of | 52 |
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 | © 2022 Lua.org, PUC-Rio. All rights reserved. | 33 | © 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, | |||
| 20 | and rapid prototyping. | 20 | and rapid prototyping. |
| 21 | 21 | ||
| 22 | Lua is implemented as a library, written in @emphx{clean C}, | 22 | Lua is implemented as a library, written in @emphx{clean C}, |
| 23 | the common subset of C and C++. | 23 | the common subset of @N{standard C} and C++. |
| 24 | The Lua distribution includes a host program called @id{lua}, | 24 | The Lua distribution includes a host program called @id{lua}, |
| 25 | which uses the Lua library to offer a complete, | 25 | which uses the Lua library to offer a complete, |
| 26 | standalone Lua interpreter, | 26 | standalone 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 | |||
| 3167 | Resets a thread, cleaning its call stack and closing all pending | ||
| 3168 | to-be-closed variables. | ||
| 3169 | Returns a status code: | ||
| 3170 | @Lid{LUA_OK} for no errors in the thread | ||
| 3171 | (either the original error that stopped the thread or | ||
| 3172 | errors in closing methods), | ||
| 3173 | or an error status otherwise. | ||
| 3174 | In case of error, | ||
| 3175 | leaves the error object on the top of the stack. | ||
| 3176 | |||
| 3177 | The parameter @id{from} represents the coroutine that is resetting @id{L}. | ||
| 3178 | If there is no such coroutine, | ||
| 3179 | this 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 | ||
| 4163 | Resets a thread, cleaning its call stack and closing all pending | 4184 | This function is deprecated; |
| 4164 | to-be-closed variables. | 4185 | it is equivalent to @Lid{lua_closethread} with |
| 4165 | Returns 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 | ||
| 4168 | errors in closing methods), | ||
| 4169 | or an error status otherwise. | ||
| 4170 | In case of error, | ||
| 4171 | leaves the error object on the top of the stack. | ||
| 4172 | |||
| 4173 | The parameter @id{from} represents the coroutine that is resetting @id{L}. | ||
| 4174 | If there is no such coroutine, | ||
| 4175 | this 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 | ||
| 5788 | Creates a new Lua state. | 5798 | Creates a new Lua state. |
| 5789 | It calls @Lid{lua_newstate} with an | 5799 | It calls @Lid{lua_newstate} with an |
| 5790 | allocator based on the @N{standard C} allocation functions | 5800 | allocator based on the @N{ISO C} allocation functions |
| 5791 | and then sets a warning function and a panic function @see{C-error} | 5801 | and then sets a warning function and a panic function @see{C-error} |
| 5792 | that print messages to the standard error output. | 5802 | that 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 | ||
| 6908 | This function is not supported by @N{ISO C}. | 6918 | This functionality is not supported by @N{ISO C}. |
| 6909 | As such, it is only available on some platforms | 6919 | As such, @id{loadlib} is only available on some platforms: |
| 6910 | (Windows, Linux, Mac OS X, Solaris, BSD, | 6920 | Linux, Windows, Mac OS X, Solaris, BSD, |
| 6911 | plus other Unix systems that support the @id{dlfcn} standard). | 6921 | plus other Unix systems that support the @id{dlfcn} standard. |
| 6912 | 6922 | ||
| 6913 | This function is inherently insecure, | 6923 | This function is inherently insecure, |
| 6914 | as it allows Lua to call any function in any readable dynamic | 6924 | as it allows Lua to call any function in any readable dynamic |
