From 0b924dbaf60e4246ae272de264fbd497bcd90f69 Mon Sep 17 00:00:00 2001
From: Gregory Labute <gregoryl@unity3d.com>
Date: Wed, 22 Nov 2023 16:07:01 -0500
Subject: [PATCH] add missing API doc

---
 .../Runtime/Deprecated/LegacyLensSettings.cs  | 23 +++++++++++++++++--
 1 file changed, 21 insertions(+), 2 deletions(-)

diff --git a/com.unity.cinemachine/Runtime/Deprecated/LegacyLensSettings.cs b/com.unity.cinemachine/Runtime/Deprecated/LegacyLensSettings.cs
index 818003ea8..8615e77c1 100644
--- a/com.unity.cinemachine/Runtime/Deprecated/LegacyLensSettings.cs
+++ b/com.unity.cinemachine/Runtime/Deprecated/LegacyLensSettings.cs
@@ -9,25 +9,43 @@ namespace Unity.Cinemachine
     [Serializable]
     public struct LegacyLensSettings
     {
+        /// <summary>Obsolete.</summary>
         public float FieldOfView;
+        /// <summary>Obsolete.</summary>
         public float OrthographicSize;
+        /// <summary>Obsolete.</summary>
         public float NearClipPlane;
+        /// <summary>Obsolete.</summary>
         public float FarClipPlane;
+        /// <summary>Obsolete.</summary>
         public float Dutch;
+        /// <summary>Obsolete.</summary>
         public LensSettings.OverrideModes ModeOverride;
 
+        /// <summary>Obsolete.</summary>
         public Camera.GateFitMode GateFit;
+        /// <summary>Obsolete.</summary>
         [HideInInspector] public Vector2 m_SensorSize;
+        /// <summary>Obsolete.</summary>
         public Vector2 LensShift;
+        /// <summary>Obsolete.</summary>
         public float FocusDistance;
+        /// <summary>Obsolete.</summary>
         public int Iso;
+        /// <summary>Obsolete.</summary>
         public float ShutterSpeed;
+        /// <summary>Obsolete.</summary>
         public float Aperture;
+        /// <summary>Obsolete.</summary>
         public int BladeCount;
+        /// <summary>Obsolete.</summary>
         public Vector2 Curvature;
+        /// <summary>Obsolete.</summary>
         public float BarrelClipping;
+        /// <summary>Obsolete.</summary>
         public float Anamorphism;
 
+        /// <summary>Obsolete.</summary>
         public LensSettings ToLensSettings()
         {
             var lens = new LensSettings
@@ -54,6 +72,7 @@ public LensSettings ToLensSettings()
             return lens;
         }
 
+        /// <summary>Obsolete</summary>
         public void SetFromLensSettings(LensSettings src)
         {
             FieldOfView = src.FieldOfView;
@@ -76,7 +95,7 @@ public void SetFromLensSettings(LensSettings src)
             Anamorphism = src.PhysicalProperties.Anamorphism;
         }
         
-        /// <summary>Make sure lens settings are sane.  Call this from OnValidate().</summary>
+        /// <summary>Make sure legacy lens settings are sane.  Call this from OnValidate().</summary>
         public void Validate()
         {
             FarClipPlane = Mathf.Max(FarClipPlane, NearClipPlane + 0.001f);
@@ -91,7 +110,7 @@ public void Validate()
             Anamorphism = Mathf.Clamp(Anamorphism, -1, 1);
         }
 
-        /// <summary>Default Lens Settings</summary>
+        /// <summary>Obsolete.  Default Legacy Lens Settings</summary>
         public static LegacyLensSettings Default => new ()
         {
             FieldOfView = 40f,