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.2

       lua-any  tests in turn the existence of lua5.1 and lua5.2 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.2

AUTHOR

       Enrico Tassi <gareuselesinge@debian.org>