diff options
author | kyren <kerriganw@gmail.com> | 2018-02-11 18:12:20 -0500 |
---|---|---|
committer | kyren <kerriganw@gmail.com> | 2018-02-11 18:12:20 -0500 |
commit | 9a45ef45e4ea8d47c2ea51ca0b31f88743f8c22f (patch) | |
tree | 8dc9992322a45d3b2298a95269764000ad108e36 /README.md | |
parent | 9388a72d61167174e5a4b09d21f1f7f2e865b946 (diff) | |
download | mlua-9a45ef45e4ea8d47c2ea51ca0b31f88743f8c22f.zip |
clarify the situation with the debug library a bit better
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 9 |
1 files changed, 6 insertions, 3 deletions
@@ -97,15 +97,18 @@ In summary, here is a list of `rlua` behaviors that should be considered a bug. If you encounter them, a bug report would be very welcome: * If you can cause UB at all with `rlua` without typing the word "unsafe", - this is absolutely 100% a bug. This does not include loading the "debug" - library, which requires typing "unsafe". If you load the debug library, - every guarantee goes out the window. + this is absolutely 100% a bug. * If your code panics / aborts with a message that contains the string "rlua internal error", this is a bug. * The above is true even for the internal panic about running out of stack space! There are a few ways to generate normal script errors by running out of stack, but if you encounter a *panic* based on running out of stack, this is a bug. + * If you load the "debug" library (which requires typing "unsafe"), every + safety / panic / abort guarantee goes out the window. The debug library can + be used to do extremely scary things. If you use the debug library and + encounter a bug, it may still very well be a bug, but try to find a + reproduction that does not involve the debug library first. * When the internal version of Lua is built using the `gcc` crate, and `cfg!(debug_assertions)` is true, Lua is built with the `LUA_USE_APICHECK` define set. Any abort caused by this internal Lua API checking is |