Implemented text-to-speech synthesis as a fallback aural annunciation…

… mechanism.

Documented incompatibility with JARDesign Ground Handling Deluxe.
Implemented "all" debug option in raas.dbg.log().
Fixed broken formatting of >80 char lines.
Implemented detection of WAV loading failures.
Documented raas.ND_alert(), raas.set_sound_on(), raas.ND_alert_HUD(), raas.load_config(), raas.load_configs() and raas.show_init_msg().

X-RAAS.cfg

@@ -1,5 +1,7 @@
 -- This is the X-RAAS configuration file.
 --
+--	!!! READ THIS CAREFULLY !!!
+--
 -- Everything on a line following a double dash (--) is a comment and is
 -- ignored by X-RAAS. You can uncomment the following clauses below to
 -- override how X-RAAS interacts with your simulator. To uncomment a line,
@@ -8,14 +10,15 @@
 --
 --   <name> = <value>
 --
--- Uncommenting a parameter activates that change in X-RAAS (you need to
--- reload your FlyWithLua scripts or reload the airplane). Otherwise the
--- parameter will remain at its default value.
+-- Uncommenting a parameter activates that change in X-RAAS. Otherwise the
+-- parameter will remain at its default value. After changing a parameter
+-- in the configuration file, reload the FlyWithLua scripts or reload the
+-- airplane for the change to take effect.
+--
+-- X-RAAS reads configuration files from two places:
 --
--- You must put this file into one of two places in your X-Plane 10
--- installation to make sure X-RAAS sees it:
---	*) <X-Plane 10>/Resources/plugins/FlyWithLua/Scripts/X-RAAS.cfg
---	*) <X-Plane 10>/Aircraft/<Your Aircraft>/X-RAAS.cfg
+--	*) <X-PLANE 10>/Resources/plugins/FlyWithLua/Scripts/X-RAAS.cfg
+--	*) <X-PLANE 10>/Aircraft/<CURRENT AIRCRAFT'S FOLDER>/X-RAAS.cfg
 --
 -- X-RAAS loads the files in this order, so any changes you make in an
 -- aircraft's X-RAAS.cfg overrides what is in the global X-RAAS.cfg in
@@ -25,12 +28,15 @@
 -- aircraft's X-RAAS.cfg.
 --
 -- The X-RAAS configuration parameters are listed below with explanations
--- what they do.
+-- on what they do.
 
 
 
 --	Uncommenting the following line disables X-RAAS. It is a master knob
---	and takes effect prior to examining of the values further below.
+--	and takes effect prior to any other initialization steps.
+--	You can use this in an X-RAAS.cfg for only one aircraft to either
+--	selectively disable or enable X-RAAS for it (e.g. globally enabling
+--	X-RAAS, but disabling it on fighters).
 --	Default value: true
 
 -- RAAS_enabled = false
@@ -41,7 +47,7 @@
 --	detects the currently loaded aircraft is a helicopter. Setting this
 --	to true will permit X-RAAS to start up regardless of the aircraft
 --	type loaded. Please note that the parameters RAAS_min_engines and
---	RAAS_min_MTOW must also be satisfied.
+--	RAAS_min_MTOW must also be satisfied (see below).
 --	Default value: false
 
 -- RAAS_allow_helos = true
@@ -110,6 +116,19 @@
 
 
 
+--	Due to known compatibility issues with certain 3rd party add-ons,
+--	on some installations, X-RAAS may not be able to play aural
+--	annunciations. If that is the case and you don't want to disable
+--	the incompatible 3rd party add-on, setting the parameter below to
+--	`true' will make X-RAAS use X-Plane's built-in text-to-speech
+--	engine to generate annunciations. The annunciations will be of
+--	a lower quality, so use this option only as a fallback.
+--	Default value: false
+
+-- RAAS_use_TTS = true
+
+
+
 --	In the United States, runways are allowed to have single-digit
 --	numbers, so runway “01” is simply referred to as runway “1”. By
 --	default, X-RAAS uses the ICAO standard and always pronounces