Author: Sean Colombo
Date: 3/26/05

This file lists the basic controls for Mouse and Keyboard input during gameplay
of Final Salvation. For controls that involve both the mouse and the keyboard,
they will generally be listed only in the mouse controls section because they
will be processed as mouse events that may or may not have modifier keys pressed
(eg: shift, ctrl, alt, etc.).

For the sake of development, features will be indented twice until they are
implemented, then they will be moved back to only one indentation.  A tilde("~")
by the event indicates that it has not been definately decided to implement this
feature.

In this document, "sprite" is meant to mean an object that is either a unit or a
structure.  Avatar would be a more accurate term, but this is confusing to
people because of the association with just images (from bulletin board usage).

X - Rougly implemented. Still somewhat beta, but appears to work.

LAST MODIFIED: 200504010039
Mouse
X		Left-Click
X			-Select sprite at cursor.  Deselect formerly selected sprites.
X			-If CTRL key is down upon release:
X				-Select all units on visible screen of the type clicked.
X				 SHIFT rules below still apply.
X			-If SHIFT key is down upon release:
X				-Add the sprite at the cursor to the selection without
X				 deselecting formerly selected sprites.
				-If the sprite at the cursor is selected already,
				 deselect the sprite at the cursor.
X		Left-Click & Drag
X			-Display lasoe while dragging.
X			-On release select units in lasoe and deselect all formerly
X			 selected sprites.
X			-If SHIFT key is down upon release:
X				-Add the lasoed units to the selection without
X				 deselecting formerly selected sprites.
X		Right-Click
X			-If units are selected, send them to this location.
?			-If there is a non-allied non-neutral sprite at the
?			 destination location, selected sprites will attack it.
?			-If there is an allied sprite at the destination location,
?			 selected units will move close to it.
			-If SHIFT key is down upon release:
				- A way-point will be created.
?			-If CTRL key is down upon release:
?				-If there is a sprite of any type at the destination
?				 location, selected sprites will attack it.
?				-Attack-move(*) to the destination location.
?			-If CTRL + SHIFT keys are down upon release:
?				-Attack-move(*) to the destination location.
X		Right-Click & Drag
X			-No effect.
?		Middle-Click
?			-If units are selected, send them to this location in
?			 attack-move mode(*).

NOTE: Need to clarify the differences between a right-click + CTRL, a right-click + CTRL + SHIFT, and a middle-click.

Keyboard
		Esc
			-Deselect all selected units.
		Space-bar
			-Go to location of last broadcasted event.
		P, PAUSE, F10
			-Pause the game and bring up the in-game menu.

		[TODO: ADD MAJORITY OF COMMANDS INCLUDING ORGANIZATIONAL GROUPING
		& TACTICS COMMANDS.]




(*) When moving in attack-move mode, they will move to their destination
(place on map) or target (unit/structure) but they will attack anything
non-allied, non-neutral that they come into contact with.  If there is a
target at the destination location when this type of move is engaged, it
will be attacked regardless of alliances or neutrality.