From ecab831ebfca1b08e93bf8dd3c1a7e3b43cf5c97 Mon Sep 17 00:00:00 2001
From: Mike Pall <mike>
Date: Tue, 14 Jun 2011 01:58:19 +0200
Subject: Add more docs for bytecode load/save feature.

---
 doc/extensions.html | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

(limited to 'doc/extensions.html')

diff --git a/doc/extensions.html b/doc/extensions.html
index 7d12299c..b0e11644 100644
--- a/doc/extensions.html
+++ b/doc/extensions.html
@@ -166,6 +166,23 @@ positive infinity results in <tt>"inf"</tt> and negative infinity results
 in <tt>"-inf"</tt>.
 </p>
 
+<h3 id="string_dump"><tt>string.dump(f [,strip])</tt> generates portable bytecode</h3>
+<p>
+An extra argument has been added to <tt>string.dump()</tt>. If set to
+<tt>true</tt>, 'stripped' bytecode without debug information is
+generated. This speeds up later bytecode loading and reduces memory
+usage. See also the
+<a href="running.html#opt_b"><tt>-b</tt> command line option</a>.
+</p>
+<p>
+The generated bytecode is portable and can be loaded on any architecture
+that LuaJIT supports, independent of word size or endianess. However the
+bytecode compatibility versions must match. Bytecode stays compatible
+for dot releases (x.y.0 &rarr; x.y.1), but may change with major or
+minor releases (2.0 &rarr; 2.1) or between any beta release. Foreign
+bytecode (e.g. from Lua 5.1) is incompatible and cannot be loaded.
+</p>
+
 <h3 id="math_random">Enhanced PRNG for <tt>math.random()</tt></h3>
 <p>
 LuaJIT uses a Tausworthe PRNG with period 2^223 to implement
-- 
cgit v1.2.3-55-g6feb