Add comments and summary tags

Author: keveleigh

Assets/HoloToolkit/Input/Scripts/Cursor/Cursor.cs

@@ -25,13 +25,18 @@ public IPointingSource Pointer
             get { return pointer; }
             set
             {
+                // This value is used to determine the cursor's default distance.
+                // It is cached here to prevent repeated casting in the update loop.
                 pointerIsInputSourcePointer = value is InputSourcePointer;
                 pointer = value;
             }
         }
-
         private IPointingSource pointer;
 
+        /// <summary>
+        /// Cached value if the pointer is of type InputSourcePointer,
+        /// to prevent repeated casting in the update loop.
+        /// </summary>
         private bool pointerIsInputSourcePointer = false;
 
         /// <summary>
@@ -122,6 +127,10 @@ public Vector3 LocalScale
         private Vector3 targetScale;
         private Quaternion targetRotation;
 
+        /// <summary>
+        /// Keeps track of the starting setting for DefaultCursorDistance,
+        /// to revert after a pointer overrides the value.
+        /// </summary>
         private float originalDefaultCursorDistance;
 
         /// <summary>

Assets/HoloToolkit/Input/Scripts/Focus/SimpleSinglePointerSelector.cs

@@ -305,16 +305,19 @@ private void AttachInputSourcePointer(IInputSource inputSource, uint sourceId)
 
             InteractionInputSource interactionInputSource = inputSource as InteractionInputSource;
 
+            // If the InputSource is not an InteractionInputSource, we don't display any ray visualizations.
             if (interactionInputSource == null)
             {
                 return;
             }
 
+            // If no pointing ray prefab has been provided, we return early as there's nothing to display.
             if (linePointerPrefab == null)
             {
                 return;
             }
 
+            // If the pointer line hasn't already been instantiated, create it and store it here.
             if (instantiatedPointerLine == null)
             {
                 instantiatedPointerLine = Instantiate(linePointerPrefab).GetComponent<PointerLine>();
@@ -326,6 +329,7 @@ private void AttachInputSourcePointer(IInputSource inputSource, uint sourceId)
             if (interactionInputSource.TryGetHandedness(sourceId, out handedness))
             {
 #if UNITY_WSA && UNITY_2017_2_OR_NEWER
+                // This updates the handedness of the pointer line, allowing for re-use if it was already in the scene.
                 instantiatedPointerLine.ChangeHandedness((InteractionSourceHandedness)handedness);
 #endif
             }

Assets/HoloToolkit/Input/Scripts/Utilities/ControllerFinder.cs

@@ -90,6 +90,10 @@ protected virtual void OnDestroy()
 #endif
         }
 
+        /// <summary>
+        /// Allows the object to change which controller it tracks, based on handedness.
+        /// </summary>
+        /// <param name="newHandedness">The new handedness to track. Does nothing if the handedness doesn't change.</param>
 #if UNITY_WSA && UNITY_2017_2_OR_NEWER
         public void ChangeHandedness(InteractionSourceHandedness newHandedness)
         {