Outliner Lighto Scripting
=========================

  This document contains the LIL scripting commands that Outliner Lighto
exposes to LIL scripts loaded either by the .ol.lil in the home
directory (or current directory for systems like DOS that do not have a
dedicated home directory) or by manually entering code with the E key
when in normal mode.

  Only the commands exposed by Outliner Lighto are documented here.  For
the full LIL documentation (including the syntax and other LIL commands
available to scripts) check http://runtimeterror.com/tech/lil

The Outliner Lighto script commands are:

	root
	  returns the root node
	current
	  returns the currently selected node
	parent <node>
	  returns the parent node of the given node
	children <node>
	  returns a list with all the children of the given node
	target <node>
	  returns the node that is the target of the given pointer node
	type <node>
	  returns the given node's type (normal, tickable or pointer)
	done <node>
	  returns the percentage of the given tickable node
	add [parent] <text>
	  add a new node under the current node or the given parent with
	  the given text
	ask [prompt]
	  ask the user for a line of text at the bottom left side of the
	  console, with an optional prompt text
	system [command]
	  execute the given command and return the command's output.  Note
	  that this may not be fully supported in all operating systems
	select [title] <choices> [index]
	  show a list of choices (choices is a LIL space separated list),
	  with an optional title.  It returns the index of the selected item
	  (starting from 0) or an empty string if the user cancelled.  If
	  index is given, the default choice is the given index
	display <text>
	 or
	display <title> <text>
	 or
	display <quit character> <title> <text>
	  shows the given text as flowing text in full screen.  The special
	  ASCII character codes 1, 2, 3, 4, 5, 6 and 7 can be used to apply
	  the colors blue, green, cyan, red, magenta, yellow or white (the
	  default color) and the character code 10 can be used to insert a
	  new line.  If title is used, it will be displayed at the top of
	  the console.  If quit character is used, it will be used as the
	  character to quit from the display, otherwise the Q character will
	  be used
	brief <flag>
	  if flag is 0 or an empty string, disable brief mode, otherwise
	  enable it (e.g. brief 0 disables it and brief 1 enables it)
