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,14 +59,17 @@ 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
 ]]];
 
 
@@ -107,18 +113,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
@@ -138,6 +159,13 @@ Hunter killer teams also bring Electronic Warfare (EW in short) capabilities if
 " + _back2IntroLink]];
 
 
+// Hunter killer docu
+player setDiaryRecordText [["shootnscoot_diarySubject", _CommanderRecord], ["Commanders",
+"<font color='#D18D1F' size='16'>Commanders</font> <br/>
+Blabla
+" + _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,