more docu

relates to #43

scripts/diary/functions/fn_postInit.sqf

@@ -6,6 +6,7 @@ player createDiarySubject ["shootnscoot_diarySubject","Shoot and Scoot"];
 // create empty diary records
 private _WorkaroundsRecord = player createDiaryRecord ["shootnscoot_diarySubject", ["",""]];
 private _RespawnRecord = player createDiaryRecord ["shootnscoot_diarySubject", ["",""]];
+private _CommanderRecord = player createDiaryRecord ["shootnscoot_diarySubject", ["",""]];
 private _HunterRecord = player createDiaryRecord ["shootnscoot_diarySubject", ["",""]];
 private _ReconRecord = player createDiaryRecord ["shootnscoot_diarySubject", ["",""]];
 private _MortarRecord = player createDiaryRecord ["shootnscoot_diarySubject", ["",""]];
@@ -14,8 +15,10 @@ private _IntroRecord = player createDiaryRecord ["shootnscoot_diarySubject", [""
 
 // create links to chapters
 private _ArtiLink = createDiaryLink ["shootnscoot_diarySubject", _ArtiRecord, "Artillery"];
+private _MortarLink = createDiaryLink ["shootnscoot_diarySubject", _MortarRecord, "Mortar"];
 private _ReconLink = createDiaryLink ["shootnscoot_diarySubject", _ReconRecord, "Reconnaissance"];
 private _HunterLink = createDiaryLink ["shootnscoot_diarySubject", _HunterRecord, "Hunter killer teams"];
+private _CommanderLink = createDiaryLink ["shootnscoot_diarySubject", _CommanderRecord, "Commanders"];
 private _back2IntroLink = "<br/><br/>" + createDiaryLink ["shootnscoot_diarySubject", _IntroRecord, "back to Introduction"];
 
 
@@ -56,25 +59,30 @@ Each team has the following <font color='#00ffff'>type of roles</font>: <br/>
 Both parties <font color='#00ffff'>try to destroy the enemies supply containers</font> with their %1. <br/>
 <img src='\A3\EditorPreviews_F\Data\CfgVehicles\B_Slingload_01_Ammo_F.jpg' width='256' height='144' title='Blufor container' /> <br/>
 <img src='\A3\EditorPreviews_F\Data\CfgVehicles\Land_Pod_Heli_Transport_04_ammo_F.jpg' width='256' height='144' title='Opfor container' /> <br/>
-The containers are hidden under a large camo net.
+The containers can be used to rearm any %1 and %4  <br/>
+(both yours end the enemies; you can steal ammo from the other faction). <br/>
+<br/>
+To make spotting them more challenging they are <font color='#00ffff'>hidden under a large camo net</font>. <br/>
 <img src='\A3\EditorPreviews_F\Data\CfgVehicles\CamoNet_BLUFOR_big_F.jpg' width='370' height='208' title='Blufor camo net' /> 
 <img src='\A3\EditorPreviews_F_Exp\Data\CfgVehicles\CamoNet_ghex_big_F.jpg' width='370' height='208' title='Opfor camo net' /> <br/>
 <br/>
 %2 players use Darter UAVs and signal directionfinders to <font color='#00ffff'>develop a situation picture</font>. <br/>
 <br/>
-%3 perform <font color='#00ffff'>search and destroy</font> on the artillery teams. <br/>
-", _ArtiLink, _ReconLink, _HunterLink
+%3 perform <font color='#00ffff'>search and destroy</font> on the %1 teams. <br/>
+", _ArtiLink, _ReconLink, _HunterLink, _MortarLink
 ]]];
 
 
 // Arti docu
 player setDiaryRecordText [["shootnscoot_diarySubject", _ArtiRecord], ["Artillery", format [
 "<font color='#D18D1F' size='16'>Artillery</font> <br/>
 Artillery requires intel from the %1 elements for targeting information.<br/>
-<img src='rhsafrf\addons\rhs_editorPreviews\data\rhs_D30_vdv.paa' width='370' height='208' title='artillery type is the same for both sides' />  <br/>
+<img src='rhsafrf\addons\rhs_editorPreviews\data\rhs_D30_vdv.paa' width='370' height='208' title='artillery type is the same for both sides' /> <br/>
 The artillery piece is towed by a truck that also brings ammunition.
 <img src='UK3CB_Factions\addons\UK3CB_Factions_Vehicles\wheeled\UK3CB_Factions_Vehicles_ural\data\ui\UK3CB_CHD_B_Ural_Ammo.jpg' width='370' height='208' title='Blufor towing ammo truck' /> 
 <img src='UK3CB_Factions\addons\UK3CB_Factions_Vehicles\wheeled\UK3CB_Factions_Vehicles_ural\data\ui\UK3CB_CHD_O_Ural_Ammo.jpg' width='370' height='208' title='Opfor towing ammo truck' /> <br/>
+See the <font color='#00ffff'>Field Manual</font> section named <font color='#00ffff'>RHS: Towing</font> for how towing artillery pieces works. <br/>
+(available from the Escape menu) <br/>
 ", _ReconLink
 ] + _back2IntroLink]];
 
@@ -107,18 +115,33 @@ Their <font color='#00ffff'>speed limit is set to 90 km/h</font>. <br/>
 
 
 // Reconnaissance docu
-player setDiaryRecordText [["shootnscoot_diarySubject", _ReconRecord], ["Reconnaissance",
+player setDiaryRecordText [["shootnscoot_diarySubject", _ReconRecord], ["Reconnaissance", format [
 "<font color='#D18D1F' size='16'>Sound directionfinding</font> <br/>
-Blabla<br/>
+This sensor is a truck that starts operation <br/>
+- <font color='#00ffff'>as soon as mast is erected</font> <br/>
+- <font color='#00ffff'>as long as an operator sits inside</font> (can be any player) <br/>
+<br/>
+To erect the mast: <br/>
+1. take the <font color='#00ffff'>driver seat</font> <br/>
+2. use Vanilla mouse menu <br/>
+3. use menu entry <font color='#00ffff'>Deploy Mast</font> <br/>
 <img src='UK3CB_Factions\addons\UK3CB_Factions_Vehicles\wheeled\UK3CB_Factions_Vehicles_gaz66\data\ui\UK3CB_CHD_B_Gaz66_Radio.jpg' width='370' height='208' title='Blufor sound directionfinder truck (mast not deployed)' /> 
 <img src='UK3CB_Factions\addons\UK3CB_Factions_Vehicles\wheeled\UK3CB_Factions_Vehicles_gaz66\data\ui\UK3CB_CHD_O_Gaz66_Radio.jpg' width='370' height='208' title='Opfor sound directionfinder truck (mast not deployed)' /> <br/>
 <br/>
+<font color='#00ffff'>Only</font> %1 <font color='#00ffff'>operators and</font> %2 <font color='#00ffff'>of the faction can see directionfinding results</font> on the map. <br/>
+<br/>
+Be aware that: <br/>
+- <font color='#00ffff'>Sound needs time to travel</font> from the shooter to your directionfinders. <br/>
+  You won't see all bearing lines for all events instantaneously. <br/>
+- <font color='#00ffff'>Bearing lines have an error of up to %3°</font> from the real direction of the shooting %4. <br/>
+<br/>
+<br/>
 <br/>
 <font color='#D18D1F' size='16'>Aerial reconnaissance</font> <br/>
 Drone blabla<br/>
 <img src='\A3\EditorPreviews_F\Data\CfgVehicles\B_UAV_01_F.jpg' width='370' height='208' title='Blufor UAV' /> 
 <img src='\A3\EditorPreviews_F\Data\CfgVehicles\O_UAV_01_F.jpg' width='370' height='208' title='Opfor UAV' /> <br/>
-" + _DroneAIWorkaround + _back2IntroLink]];
+", _ReconLink, _CommanderLink, arsr_angleError, _ArtiLink] + _DroneAIWorkaround + _back2IntroLink]];
 
 
 // Hunter killer docu
@@ -133,11 +156,47 @@ These teams get directed to their search and destroy areas by <font color='#00ff
 Once they are in the general vicinity of enemy artillery they can hear artillery firing by themselves, which also guides them. <br/>
 <br/>
 <br/>
-<font color='#D18D1F' size='16'>Electronic Warfare</font> <br/>
+<font color='#D18D1F' size='14'>Electronic Warfare</font> <br/>
 Hunter killer teams also bring Electronic Warfare (EW in short) capabilities if the <font color='#00ffff'>Engineer / EW operator</font> slot is taken.
 " + _back2IntroLink]];
 
 
+private _myVLS = nil;
+switch (playerSide) do
+{
+    case west: { _myVLS = blufor_vls; };
+    case east: { _myVLS = opfor_vls; };
+};
+
+// Commander docu
+player setDiaryRecordText [["shootnscoot_diarySubject", _CommanderRecord], ["Commanders", format [
+"<font color='#D18D1F' size='16'>Commanders</font> <br/>
+The commanders are the <font color='#00ffff'>top-most leaders</font> their faction. <br/>
+<br/>
+They are the only persons that are not a %1 operator but still <font color='#00ffff'>see the directionfinders bearings</font>. <br/>
+<br/>
+<font color='#D18D1F' size='14'>Cruise Missile strike</font> <br/>
+In addition they are the only ones authorized to <font color='#00ffff'>launch Cruise Missile strikes</font> from the destroyer near the own base. <br/>
+(lower ranking players can't connect their UAV terminal to this asset)
+<img src='\A3\EditorPreviews_F_Destroyer\Data\Cfgvehicles\Destroyer_01_assembled.jpg' width='370' height='208' title='Destroyer' /> <br/>
+<img src='\A3\EditorPreviews_F_Destroyer\Data\Cfgvehicles\B_Ship_MRLS_01_F.jpg' width='370' height='208' title='Cruise Missile launcher' /> <br/>
+How to strike? <br/>
+1. <font color='#00ffff'>provide a laser lock on target</font> from a drone <br/>
+2. open UAV terminal and connect to Cuise missile launcher <br/>
+3. go into the Gunner position <br/>
+4. check <font color='#00ffff'>sensor display</font> (right side of screen per default) for laser spots <br/>
+5. <font color='#00ffff'>select the laser spot</font> you wish to shoot at <br/>
+5.1. by pressing your <font color='#00ffff'>%2</font> hotkey <font color='#00ffff'>%3</font> (once or more often) <br/>
+6. wait for laser lockon beeping sound to change from a lower to a higher pitch <br/>
+7. fire weapon <br/>
+<img src='\A3\EditorPreviews_F\Data\CfgVehicles\B_UAV_01_F.jpg' width='256' height='144' title='Blufor UAV' /> 
+<img src='\A3\EditorPreviews_F\Data\CfgVehicles\O_UAV_01_F.jpg' width='256' height='144' title='Opfor UAV' /> <br/>
+<br/>
+Be aware that you only have <font color='#00ffff'>%4 missle(s)</font> available. <br/>
+So use them carefully for high-value targets. <br/>
+", _ReconLink, actionName "vehLockTargets", actionKeysNames "vehLockTargets", _myVLS ammo "weapon_VLS_01"] + _back2IntroLink]];
+
+
 // Respawn docu
 player setDiaryRecordText [["shootnscoot_diarySubject", _RespawnRecord], ["Spawn and respawn",
 "<font color='#D18D1F' size='16'>Spawn</font> <br/>

scripts/spot-randomizer/functions/fn_placeSupplyStation.sqf

@@ -3,7 +3,7 @@ params ["_side", "_stationid"];
 
 _position = getMarkerPos _stationid;
 
-// find me a good, flat spot at a distance of up t0 150m away from the marker position
+// find me a good, flat spot at a distance of up to 150m away from the marker position
 // don't be in the sea and if no such position is found default to the original provided position
 private _fuzzyPosition = [_position, 0,  150, 10, 0, 0.2, 0, [], [_position, _position]] call BIS_fnc_findSafePos;
 

scripts/spot-randomizer/functions/fn_placeTask.sqf

@@ -4,12 +4,30 @@ private _position =  markerPos _stationid;
 private _text = trim(markerText _stationid); // Must trim whitespaces from markerText
 private _taskID = (str _side) + _stationid; // Tasks are side-specific, so we add it to the id
 
+
+// show side dependent container and camo net image in the task descriptions
+private _containerImage = "";
+private _netImage = "";
+switch (_side) do
+{
+    case west: {
+        _containerImage = "<img src='\A3\EditorPreviews_F\Data\CfgVehicles\B_Slingload_01_Ammo_F.jpg' width='256' height='144' title='Blufor container' />";
+        _netImage       = "<img src='\A3\EditorPreviews_F\Data\CfgVehicles\CamoNet_BLUFOR_big_F.jpg' width='370' height='208' title='Blufor camo net' />";
+    };
+    case east: {
+        _containerImage = "<img src='\A3\EditorPreviews_F\Data\CfgVehicles\Land_Pod_Heli_Transport_04_ammo_F.jpg' width='256' height='144' title='Opfor container' />";
+        _netImage       = "<img src='\A3\EditorPreviews_F_Exp\Data\CfgVehicles\CamoNet_ghex_big_F.jpg' width='370' height='208' title='Opfor camo net' />";
+    };
+};
+
+
+// create task
 [
     _side,
     _taskID,
-    ["Here is/was one of your own supply containers.",
+    [["Up to 150m away from this position is/was one of your own supply containers. <br/>%1 <br/><br/>%2", _containerImage, _netImage],
     _text + " Supply Station",
-    ""],
+    ""],    // deprecated parameter
     _position,
     "CREATED",
     -1,