mirror of
https://github.com/1dot13/source.git
synced 2026-08-05 14:00:23 +02:00
76eda883a5
The tree carried two prebuilt Lua static libraries and a copy of the Lua public headers. lua51.lib is 5.1.2 and matched the headers; lua51.vc9.lib is 5.1.4 and was dead weight — it came second in Ja2_Libraries, so the linker resolved every Lua symbol out of lua51.lib and never pulled an object from it. Just as well, since it asks for /DEFAULTLIB:MSVCRT while we build /MT. ext/lua-5.1.5 is the upstream tarball unmodified, built as lua51 the way the other vendored libraries are, and its src directory replaces lua/ as the home of lua.h, luaconf.h, lauxlib.h and lualib.h. Those four headers were stock 5.1.2 retabbed, so 5.1.5 is bugfix-only against what the game compiled against; the bytecode format is unchanged across 5.1.x and every script under gamedir is plain source anyway. lua/lua.hpp had no includers and returns to etc/ where upstream keeps it. /SAFESEH:NO goes with it. Its two stated reasons were lua51.lib and the smackw32 import library, and both are now gone: every remaining prebuilt static library is SAFESEH-clean (libexpatMT.lib 5 of 5 members with @feat.00 = 0x1, RakNetLibStatic.lib 79 of 79), and lld-link emits a 3155-entry SEHandlerTable without it. The /MT comment blamed the wrong library. lua51.lib carried no linker directives at all; RakNetLibStatic.lib is what pins us to the static runtime, with /DEFAULTLIB:LIBCMT and /DEFAULTLIB:libcpmt. Verified by building all four applications in Debug and Release, and by linking the tarball's own lua.c against our lua51.lib with the build's clang-cl flags and running it under Wine: 5.1 stdlib, GC, coroutines and the x86 __asm fld/fistp lua_number2int fast path all behave. The game itself could not be launched here — this checkout's gamedir has loose Data directories but no SLF archives, so VFS aborts on Data\Ambient.slf long before any script runs. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
146 lines
3.8 KiB
HTML
146 lines
3.8 KiB
HTML
<!-- $Id: luac.man,v 1.28 2006/01/06 16:03:34 lhf Exp $ -->
|
|
<HTML>
|
|
<HEAD>
|
|
<TITLE>LUAC man page</TITLE>
|
|
<LINK REL="stylesheet" TYPE="text/css" HREF="lua.css">
|
|
</HEAD>
|
|
|
|
<BODY BGCOLOR="#FFFFFF">
|
|
|
|
<H2>NAME</H2>
|
|
luac - Lua compiler
|
|
<H2>SYNOPSIS</H2>
|
|
<B>luac</B>
|
|
[
|
|
<I>options</I>
|
|
] [
|
|
<I>filenames</I>
|
|
]
|
|
<H2>DESCRIPTION</H2>
|
|
<B>luac</B>
|
|
is the Lua compiler.
|
|
It translates programs written in the Lua programming language
|
|
into binary files that can be later loaded and executed.
|
|
<P>
|
|
The main advantages of precompiling chunks are:
|
|
faster loading,
|
|
protecting source code from accidental user changes,
|
|
and
|
|
off-line syntax checking.
|
|
<P>
|
|
Precompiling does not imply faster execution
|
|
because in Lua chunks are always compiled into bytecodes before being executed.
|
|
<B>luac</B>
|
|
simply allows those bytecodes to be saved in a file for later execution.
|
|
<P>
|
|
Precompiled chunks are not necessarily smaller than the corresponding source.
|
|
The main goal in precompiling is faster loading.
|
|
<P>
|
|
The binary files created by
|
|
<B>luac</B>
|
|
are portable only among architectures with the same word size and byte order.
|
|
<P>
|
|
<B>luac</B>
|
|
produces a single output file containing the bytecodes
|
|
for all source files given.
|
|
By default,
|
|
the output file is named
|
|
<B>luac.out</B>,
|
|
but you can change this with the
|
|
<B>-o</B>
|
|
option.
|
|
<P>
|
|
In the command line,
|
|
you can mix
|
|
text files containing Lua source and
|
|
binary files containing precompiled chunks.
|
|
This is useful because several precompiled chunks,
|
|
even from different (but compatible) platforms,
|
|
can be combined into a single precompiled chunk.
|
|
<P>
|
|
You can use
|
|
<B>'-'</B>
|
|
to indicate the standard input as a source file
|
|
and
|
|
<B>'--'</B>
|
|
to signal the end of options
|
|
(that is,
|
|
all remaining arguments will be treated as files even if they start with
|
|
<B>'-'</B>).
|
|
<P>
|
|
The internal format of the binary files produced by
|
|
<B>luac</B>
|
|
is likely to change when a new version of Lua is released.
|
|
So,
|
|
save the source files of all Lua programs that you precompile.
|
|
<P>
|
|
<H2>OPTIONS</H2>
|
|
Options must be separate.
|
|
<P>
|
|
<B>-l</B>
|
|
produce a listing of the compiled bytecode for Lua's virtual machine.
|
|
Listing bytecodes is useful to learn about Lua's virtual machine.
|
|
If no files are given, then
|
|
<B>luac</B>
|
|
loads
|
|
<B>luac.out</B>
|
|
and lists its contents.
|
|
<P>
|
|
<B>-o </B><I>file</I>
|
|
output to
|
|
<I>file</I>,
|
|
instead of the default
|
|
<B>luac.out</B>.
|
|
(You can use
|
|
<B>'-'</B>
|
|
for standard output,
|
|
but not on platforms that open standard output in text mode.)
|
|
The output file may be a source file because
|
|
all files are loaded before the output file is written.
|
|
Be careful not to overwrite precious files.
|
|
<P>
|
|
<B>-p</B>
|
|
load files but do not generate any output file.
|
|
Used mainly for syntax checking and for testing precompiled chunks:
|
|
corrupted files will probably generate errors when loaded.
|
|
Lua always performs a thorough integrity test on precompiled chunks.
|
|
Bytecode that passes this test is completely safe,
|
|
in the sense that it will not break the interpreter.
|
|
However,
|
|
there is no guarantee that such code does anything sensible.
|
|
(None can be given, because the halting problem is unsolvable.)
|
|
If no files are given, then
|
|
<B>luac</B>
|
|
loads
|
|
<B>luac.out</B>
|
|
and tests its contents.
|
|
No messages are displayed if the file passes the integrity test.
|
|
<P>
|
|
<B>-s</B>
|
|
strip debug information before writing the output file.
|
|
This saves some space in very large chunks,
|
|
but if errors occur when running a stripped chunk,
|
|
then the error messages may not contain the full information they usually do.
|
|
For instance,
|
|
line numbers and names of local variables are lost.
|
|
<P>
|
|
<B>-v</B>
|
|
show version information.
|
|
<H2>FILES</H2>
|
|
<P>
|
|
<B>luac.out</B>
|
|
default output file
|
|
<H2>SEE ALSO</H2>
|
|
<B>lua</B>(1)
|
|
<BR>
|
|
<A HREF="http://www.lua.org/">http://www.lua.org/</A>
|
|
<H2>DIAGNOSTICS</H2>
|
|
Error messages should be self explanatory.
|
|
<H2>AUTHORS</H2>
|
|
L. H. de Figueiredo,
|
|
R. Ierusalimschy and
|
|
W. Celes
|
|
<!-- EOF -->
|
|
</BODY>
|
|
</HTML>
|