docs: add info about deprecated first affordability preview system

Author: LordMidas

msu/hooks/skills/skill.nut

@@ -62,7 +62,7 @@
 	q.m.IsBaseValuesSaved <- false;
 	q.m.ScheduledChanges <- [];
 
-	q.m.PreviewField <- {};
+	q.m.PreviewField <- {}; // Deprecated - part of the first Affordability Preview system
 
 	q.isType = @() function( _t, _any = true, _only = false )
 	{
@@ -334,15 +334,18 @@
 	{
 	}
 
+	// Deprecated - part of the first Affordability Preview system
 	q.onAffordablePreview <- function( _skill, _movementTile )
 	{
 	}
 
+	// Deprecated - part of the first Affordability Preview system
 	q.modifyPreviewField <- function( _skill, _field, _newChange, _multiplicative )
 	{
 		::MSU.Skills.modifyPreview(this, _skill, _field, _newChange, _multiplicative);
 	}
 
+	// Deprecated - part of the first Affordability Preview system
 	q.modifyPreviewProperty <- function( _skill, _field, _newChange, _multiplicative )
 	{
 		::MSU.Skills.modifyPreview(this, null, _field, _newChange, _multiplicative);
@@ -587,6 +590,7 @@
 });
 
 ::MSU.QueueBucket.VeryLate.push(function() {
+	// Legacy support for the first Affordablity Preview system which has been deprecated
 	::MSU.MH.rawHookTree("scripts/skills/skill", function(p) {
 		local obj = p;
 		while (!("onAffordablePreview" in obj))

msu/hooks/skills/skill_container.nut

@@ -220,6 +220,7 @@
 		]);
 	}
 
+	// Deprecated - part of the first Affordability Preview system
 	q.onAffordablePreview <- function( _skill, _movementTile )
 	{
 		this.m.PreviewProperty.clear();

msu/hooks/ui/screens/tactical/modules/turn_sequence_bar/turn_sequence_bar.nut

@@ -60,7 +60,7 @@
 		local previewAP = activeEntity.getPreviewActionPoints();
 
 		activeEntity.m.MSU_IsPreviewing = true;
-		activeEntity.getSkills().onAffordablePreview(skill, movement == null ? null : movement.End);
+		activeEntity.getSkills().onAffordablePreview(skill, movement == null ? null : movement.End); // Deprecated - part of the first Affordability Preview system
 		activeEntity.m.MSU_PreviewSkill = skill;
 		activeEntity.m.MSU_PreviewMovement = movement;
 		activeEntity.getSkills().update(); // During this update actor.isPreviewing() is true