aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorMike Pall <mike>2010-01-17 22:02:13 +0100
committerMike Pall <mike>2010-01-17 22:02:13 +0100
commit379b8c5fe4cc2a2872c0d7f88cbc2a44d8097246 (patch)
tree5a3a10dc9bba41df9b05ca3db005d214cb09c07f /doc
parent4b0725d5fc87da33477b13e74a32f24fafda3541 (diff)
downloadluajit-379b8c5fe4cc2a2872c0d7f88cbc2a44d8097246.tar.gz
luajit-379b8c5fe4cc2a2872c0d7f88cbc2a44d8097246.tar.bz2
luajit-379b8c5fe4cc2a2872c0d7f88cbc2a44d8097246.zip
Update docs with x64 build instructions.
Diffstat (limited to 'doc')
-rw-r--r--doc/changes.html4
-rw-r--r--doc/install.html62
-rw-r--r--doc/luajit.html6
3 files changed, 62 insertions, 10 deletions
diff --git a/doc/changes.html b/doc/changes.html
index 2841a371..84f7f9e0 100644
--- a/doc/changes.html
+++ b/doc/changes.html
@@ -55,9 +55,7 @@ to see whether newer versions are available.
55<div class="major" style="background: #d0d0d0;"> 55<div class="major" style="background: #d0d0d0;">
56<h2 id="snap">Development Snapshot</h2> 56<h2 id="snap">Development Snapshot</h2>
57<ul> 57<ul>
58<li>Build of preliminary x64 interpreter can be enabled with 58<li>Build of preliminary x64 interpreter works on Linux/x64 or WIN64.</li>
59<tt>make "CC=gcc -m64"</tt>.
60Only works on Linux/x64. Does not work on WIN64 or OSX/x64 (yet).</li>
61<li>Implement yield from C hooks.</li> 59<li>Implement yield from C hooks.</li>
62<li>Add abstract C call handling to IR.</li> 60<li>Add abstract C call handling to IR.</li>
63<li>Improve KNUM fuse vs. load heuristics.</li> 61<li>Improve KNUM fuse vs. load heuristics.</li>
diff --git a/doc/install.html b/doc/install.html
index faa60770..605f954d 100644
--- a/doc/install.html
+++ b/doc/install.html
@@ -54,6 +54,17 @@ LuaJIT currently builds out-of-the box on all popular x86 systems
54(Linux, Windows, OSX etc.). It builds and runs fine as a 32&nbsp;bit 54(Linux, Windows, OSX etc.). It builds and runs fine as a 32&nbsp;bit
55application under x64-based systems, too. 55application under x64-based systems, too.
56</p> 56</p>
57<p class="indent" style="color: #00a000;">
58The x64 port of LuaJIT is still experimental and not enabled by default.
59It only contains the interpreter and only builds on Linux/x64 and WIN64
60right now. If you want to give it a try, follow the special build instructions
61below.
62</p>
63<p class="indent" style="color: #00a000;">
64Note that the pure interpreter is quite a bit faster than Lua, but of
65course not as fast as the x86 JIT compiler. Work on the x64 JIT compiler
66is still ongoing.
67</p>
57 68
58<h2>Configuring LuaJIT</h2> 69<h2>Configuring LuaJIT</h2>
59<p> 70<p>
@@ -84,8 +95,8 @@ complete SDK.
84</p> 95</p>
85<p> 96<p>
86E.g. on a current Debian/Ubuntu, install <tt>libc6-dev</tt> 97E.g. on a current Debian/Ubuntu, install <tt>libc6-dev</tt>
87with the package manager. Currently LuaJIT only builds as a 32&nbsp;bit 98with the package manager. Currently LuaJIT builds as a 32&nbsp;bit
88application, so you actually need to install <tt>libc6-dev-i386</tt> 99application by default, so you actually need to install <tt>libc6-dev-i386</tt>
89when building on an x64 OS. 100when building on an x64 OS.
90</p> 101</p>
91<p> 102<p>
@@ -106,6 +117,15 @@ which is probably the default on your system, anyway. Simply run:
106<pre class="code"> 117<pre class="code">
107make 118make
108</pre> 119</pre>
120<div style="color: #00a000;">
121<p>
122You can force a build of the x64 interpreter on Linux/x64 with the
123following command:
124</p>
125<pre class="code">
126make CC="gcc -m64"
127</pre>
128</div>
109<p> 129<p>
110By default modules are only searched under the prefix <tt>/usr/local</tt>. 130By default modules are only searched under the prefix <tt>/usr/local</tt>.
111You can add an extra prefix to the search paths by appending the 131You can add an extra prefix to the search paths by appending the
@@ -122,7 +142,7 @@ in <tt>src/Makefile</tt>. Change it, if you want to build on an older version.
122<p> 142<p>
123The top-level Makefile installs LuaJIT by default under 143The top-level Makefile installs LuaJIT by default under
124<tt>/usr/local</tt>, i.e. the executable ends up in 144<tt>/usr/local</tt>, i.e. the executable ends up in
125<tt>/usr/local/bin</tt> and so on. You need to have root privileges 145<tt>/usr/local/bin</tt> and so on. You need root privileges
126to write to this path. So, assuming sudo is installed on your system, 146to write to this path. So, assuming sudo is installed on your system,
127run the following command and enter your sudo password: 147run the following command and enter your sudo password:
128</p> 148</p>
@@ -157,9 +177,15 @@ Either install one of the open source SDKs
157GCC plus the required development headers. 177GCC plus the required development headers.
158</p> 178</p>
159<p> 179<p>
160Or install Microsoft's Visual C++ (MSVC) &mdash; the freely downloadable 180Or install Microsoft's Visual C++ (MSVC). The freely downloadable
161<a href="http://www.microsoft.com/Express/VC/"><span class="ext">&raquo;</span>&nbsp;Express Edition</a> 181<a href="http://www.microsoft.com/Express/VC/"><span class="ext">&raquo;</span>&nbsp;Express Edition</a>
162works just fine. 182works just fine, but only contains an x86 compiler.
183</p>
184<p>
185The freely downloadable
186<a href="http://msdn.microsoft.com/en-us/windowsserver/bb980924.aspx"><span class="ext">&raquo;</span>&nbsp;Windows SDK</a>
187only comes with command line tools, but this is all you need to build LuaJIT.
188It contains x86 and x64 compilers.
163</p> 189</p>
164<p> 190<p>
165Next, download the source package and unpack it using an archive manager 191Next, download the source package and unpack it using an archive manager
@@ -177,6 +203,32 @@ msvcbuild
177<p> 203<p>
178Then follow the installation instructions below. 204Then follow the installation instructions below.
179</p> 205</p>
206<h3>Building with the Windows SDK</h3>
207<p>
208Open a "Windows SDK Command Shell" and select the x86 compiler:
209</p>
210<pre class="code">
211setenv /release /x86
212</pre>
213<div style="color: #00a000;">
214<p>
215Or select the x64 compiler (this only builds the interpreter right now):
216</p>
217<pre class="code">
218setenv /release /x64
219</pre>
220</div>
221<p>
222Then <tt>cd</tt> to the directory where you've unpacked the sources
223and run these commands:
224</p>
225<pre class="code">
226cd src
227msvcbuild
228</pre>
229<p>
230Then follow the installation instructions below.
231</p>
180<h3>Building with MinGW or Cygwin</h3> 232<h3>Building with MinGW or Cygwin</h3>
181<p> 233<p>
182Open a command prompt window and make sure the MinGW or Cygwin programs 234Open a command prompt window and make sure the MinGW or Cygwin programs
diff --git a/doc/luajit.html b/doc/luajit.html
index 029a5919..7c3779d4 100644
--- a/doc/luajit.html
+++ b/doc/luajit.html
@@ -63,8 +63,10 @@ standard Lua interpreter and can be deployed as a drop-in replacement.
63<p> 63<p>
64LuaJIT offers more performance, at the expense of portability. It 64LuaJIT offers more performance, at the expense of portability. It
65currently runs on all popular operating systems based on <b>x86 CPUs</b> 65currently runs on all popular operating systems based on <b>x86 CPUs</b>
66(Linux, Windows, OSX etc.). It will be ported to x64 CPUs and other 66(Linux, Windows, OSX etc.). A port to x64 CPUs is currently ongoing &mdash;
67platforms in the future, based on user demand and sponsoring. 67you can follow its progress in the <a href="http://luajit.org/download.html"><span class="ext">&raquo;</span>&nbsp;git repository</a>.
68Other platforms will be supported in the future, based on user demand
69and sponsoring.
68</p> 70</p>
69 71
70<h2>Overview</h2> 72<h2>Overview</h2>