Added '@info' comments for functions.

Author: Caball009

Core/GameEngine/Source/Common/RandomValue.cpp

@@ -229,7 +229,10 @@ DEBUG_LOG(( "%d: GetGameLogicRandomValue = %d (%d - %d), %s line %d",
 }
 
 //
-// Integer random value; does not change the seed values
+// TheSuperHackers @info This function does not change the seed values with retail compability disabled.
+// Consecutive calls always return the same value for the same combination of min / max values, assuming the seed values haven't changed in between.
+// The intended use case for this function are randomized values that are desirable to be synchronized across clients,
+// but should not result in a mismatch if they aren't; e.g. for scripted audio events.
 //
 Int GetGameLogicCurrentRandomValue( int lo, int hi, const char *file, int line )
 {
@@ -327,7 +330,10 @@ DEBUG_LOG(( "%d: GetGameLogicRandomValueReal = %f, %s line %d",
 }
 
 //
-// Real random value; does not change the seed values
+// TheSuperHackers @info This function does not change the seed values with retail compability disabled.
+// Consecutive calls always return the same value for the same combination of min / max values, assuming the seed values haven't changed in between.
+// The intended use case for this function are randomized values that are desirable to be synchronized across clients,
+// but should not result in a mismatch if they aren't; e.g. for scripted audio events.
 //
 Real GetGameLogicCurrentRandomValueReal( Real lo, Real hi, const char *file, int line )
 {