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>

