1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56
|
NAME
lua-any - Helper script for multi-Lua-version shebang lines
DESCRIPTION
Some Lua scripts work with multiple versions of Lua but not all
of them. The upstream author of the software may hence have chosen
the loose shebang line:
#!/usr/bin/env lua
In Debian /usr/bin/lua is a valid Lua interpreter but it is
under the control of the user, that can set its value to the Lua
version of its choice, even one that is not able to run the script
in question.
lua-any is a helper that understands metadata written in comments
and selects a valid Lua interpreter. Example:
#!/usr/bin/env lua-any
-- Lua-Versions: 5.1 5.3
lua-any tests in turn the existence of lua5.1 and lua5.3 and
executes the script with the first existing interpreter.
SYNTAX
lua-any looks only at the first 10 lines of the script for metadata,
i.e. it processes the file trough the head utility.
The format of a line is essentially key:value, where leading and
trailing spaces are removed from value. The key is matched in a case
insensitive way. The Lua comment, --, must have no leading spaces.
The following keys are supported:
Lua-Versions
Space separated list of Lua versions.
Lua-Root
The common root of all interpreters. By default its value
is /usr/bin/lua. Each Lua version selected in Lua-Versions
is simply appended to it in order to obtain the full name
of the interpreter.
Lua-Args
Extra arguments to be passed to Lua interpreters, like
-l lfs. By default this is empty.
DEBIAN NOTES
A package using lua-any should declare its dependencies on Lua
interpreters using a disjunction. Example:
Depends: lua-any, lua5.1 | lua5.3
AUTHOR
Enrico Tassi <gareuselesinge@debian.org>
|