Add LuaDeprecatedMethodAttribute and apply to client.transformPointX/Y

BizHawk.Client.Common/lua/LuaAttributes.cs

@@ -2,6 +2,9 @@
 
 namespace BizHawk.Client.Common
 {
+	[AttributeUsage(AttributeTargets.Method | AttributeTargets.Class)]
+	public sealed class LuaDeprecatedMethodAttribute : Attribute {}
+
 	[AttributeUsage(AttributeTargets.Method)]
 	public sealed class LuaMethodAttribute : Attribute
 	{

BizHawk.Client.Common/lua/LuaDocumentation.cs

@@ -40,7 +40,7 @@ __Types and notation__
 ** A standard Lua table
 ");
 
-			foreach (var library in this.Select(lf => new { Name = lf.Library, Description = lf.LibraryDescription }).Distinct())
+			foreach (var library in this.Where(lf => !lf.IsDeprecated).Select(lf => new { Name = lf.Library, Description = lf.LibraryDescription }).Distinct())
 			{
 				sb
 					.AppendFormat("%%TAB {0}%%", library.Name)
@@ -166,6 +166,7 @@ __Types and notation__
 			_luaExampleAttribute = method.GetCustomAttribute<LuaMethodExampleAttribute>(false);
 			_method = method;
 
+			IsDeprecated = method.GetCustomAttribute<LuaDeprecatedMethodAttribute>(false) != null;
 			Library = library;
 			LibraryDescription = libraryDescription;
 		}
@@ -173,6 +174,8 @@ __Types and notation__
 		public string Library { get; }
 		public string LibraryDescription { get; }
 
+		public readonly bool IsDeprecated;
+
 		public MethodInfo Method => _method;
 
 		public string Name => _luaAttributes.Name;

BizHawk.Client.EmuHawk/tools/Lua/Libraries/EmuLuaLibrary.Client.cs

@@ -373,10 +373,12 @@ namespace BizHawk.Client.EmuHawk
 		}
 
 #pragma warning disable CS0612
+		[LuaDeprecatedMethod]
 		[LuaMethodExample("local inclitra = client.transformPointX( 16 );")]
 		[LuaMethod("transformPointX", "Transforms an x-coordinate in emulator space to an x-coordinate in client space")]
 		public static int TransformPointX(int x) => ClientApi.TransformPointX(x);
 
+		[LuaDeprecatedMethod]
 		[LuaMethodExample("local inclitra = client.transformPointY( 32 );")]
 		[LuaMethod("transformPointY", "Transforms an y-coordinate in emulator space to an y-coordinate in client space")]
 		public static int TransformPointY(int y) => ClientApi.TransformPointY(y);