Documentation cleanup and reorganization.
[luajit-2.0/celess22.git] / doc / status.html
blob6bb4df892f6a2e3569e7091e82b854dcde429438
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
2 <html>
3 <head>
4 <title>Status &amp; Roadmap</title>
5 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
6 <meta name="Author" content="Mike Pall">
7 <meta name="Copyright" content="Copyright (C) 2005-2012, Mike Pall">
8 <meta name="Language" content="en">
9 <link rel="stylesheet" type="text/css" href="bluequad.css" media="screen">
10 <link rel="stylesheet" type="text/css" href="bluequad-print.css" media="print">
11 <style type="text/css">
12 ul li { padding-bottom: 0.3em; }
13 </style>
14 </head>
15 <body>
16 <div id="site">
17 <a href="http://luajit.org"><span>Lua<span id="logo">JIT</span></span></a>
18 </div>
19 <div id="head">
20 <h1>Status &amp; Roadmap</h1>
21 </div>
22 <div id="nav">
23 <ul><li>
24 <a href="luajit.html">LuaJIT</a>
25 <ul><li>
26 <a href="http://luajit.org/download.html">Download <span class="ext">&raquo;</span></a>
27 </li><li>
28 <a href="install.html">Installation</a>
29 </li><li>
30 <a href="running.html">Running</a>
31 </li></ul>
32 </li><li>
33 <a href="extensions.html">Extensions</a>
34 <ul><li>
35 <a href="ext_ffi.html">FFI Library</a>
36 <ul><li>
37 <a href="ext_ffi_tutorial.html">FFI Tutorial</a>
38 </li><li>
39 <a href="ext_ffi_api.html">ffi.* API</a>
40 </li><li>
41 <a href="ext_ffi_semantics.html">FFI Semantics</a>
42 </li></ul>
43 </li><li>
44 <a href="ext_jit.html">jit.* Library</a>
45 </li><li>
46 <a href="ext_c_api.html">Lua/C API</a>
47 </li></ul>
48 </li><li>
49 <a class="current" href="status.html">Status</a>
50 <ul><li>
51 <a href="changes.html">Changes</a>
52 </li></ul>
53 </li><li>
54 <a href="faq.html">FAQ</a>
55 </li><li>
56 <a href="http://luajit.org/performance.html">Performance <span class="ext">&raquo;</span></a>
57 </li><li>
58 <a href="http://wiki.luajit.org/">Wiki <span class="ext">&raquo;</span></a>
59 </li><li>
60 <a href="http://luajit.org/list.html">Mailing List <span class="ext">&raquo;</span></a>
61 </li></ul>
62 </div>
63 <div id="main">
64 <p>
65 The <span style="color: #0000c0;">LuaJIT&nbsp;1.x</span> series represents
66 the current <span style="color: #0000c0;">stable branch</span>.
67 Only a single bug has been discovered in the last three years. So, if
68 you need a rock-solid VM, you are encouraged to fetch the latest
69 release of LuaJIT 1.x from the <a href="http://luajit.org/download.html"><span class="ext">&raquo;</span>&nbsp;Download</a>
70 page.
71 </p>
72 <p>
73 <span style="color: #c00000;">LuaJIT&nbsp;2.0</span> is the currently active
74 <span style="color: #c00000;">development branch</span> in beta test.
75 It has <a href="http://luajit.org/performance.html"><span class="ext">&raquo;</span>&nbsp;much better performance</a> than
76 LuaJIT&nbsp;1.x and runs on many more platforms and architectures.
77 It's nearing a stable release, so you should definitely
78 start to evaluate it for new projects right now.
79 </p>
81 <h2>Current Status</h2>
82 <p>
83 LuaJIT ought to run all Lua&nbsp;5.1-compatible source code just fine.
84 It's considered a serious bug if the VM crashes or produces unexpected
85 results &mdash; please report this.
86 </p>
87 <p>
88 Known incompatibilities and issues in LuaJIT&nbsp;2.0:
89 </p>
90 <ul>
91 <li>
92 There are some differences in <b>implementation-defined</b> behavior.
93 These either have a good reason, are arbitrary design choices
94 or are due to quirks in the VM. The latter cases may get fixed if a
95 demonstrable need is shown.
96 </li>
97 <li>
98 The Lua <b>debug API</b> is missing a couple of features (return
99 hooks for non-Lua functions) and shows slightly different behavior
100 in LuaJIT (no per-coroutine hooks, no tail call counting).
101 </li>
102 <li>
103 Some checks are missing in the JIT-compiled code for obscure situations
104 with <b>open upvalues aliasing</b> one of the SSA slots later on (or
105 vice versa). Bonus points, if you can find a real world test case for
106 this.
107 </li>
108 <li>
109 Currently some <b>out-of-memory</b> errors from <b>on-trace code</b> are not
110 handled correctly. The error may fall through an on-trace
111 <tt>pcall</tt> or it may be passed on to the function set with
112 <tt>lua_atpanic</tt> on x64. This issue will be fixed in LuaJIT&nbsp;2.1.
113 </li>
114 </ul>
116 <h2>Roadmap</h2>
118 Please refer to the
119 <a href="http://www.freelists.org/post/luajit/LuaJIT-Roadmap-20122013"><span class="ext">&raquo;</span>&nbsp;LuaJIT
120 Roadmap 2012/2013</a> for details.
121 </p>
123 </p>
124 <br class="flush">
125 </div>
126 <div id="foot">
127 <hr class="hide">
128 Copyright &copy; 2005-2012 Mike Pall
129 <span class="noprint">
130 &middot;
131 <a href="contact.html">Contact</a>
132 </span>
133 </div>
134 </body>
135 </html>