DOCATT-8610: Updated PlayerInputManager.cs and PlayerJoinBehavior.cs

- Added doc for JoinPlayersWhenJoinActionIsTriggered value
- Clarified that disabling the action can result when DisableJoining() is called on an action that was joined with the JoinPlayersWhenJoinActionIsTriggered behaviour

Author: unitALG

Packages/com.unity.inputsystem/InputSystem/Plugins/PlayerInput/PlayerInputManager.cs

@@ -334,6 +334,12 @@ public void EnableJoining()
         /// <summary>
         /// Inhibit players from joining the game.
         /// </summary>
+        /// <remarks>
+        /// Note that this method might disable the action, depending on how the action 
+        /// was joined initially. Specifically, if the initial joining was triggered using
+        /// the <see cref="joinBehavior.JoinPlayersWhenJoinActionIsTriggered"/> behavior,
+        /// this method also disables the join action.
+        /// </remarks>
         /// <seealso cref="EnableJoining"/>
         /// <seealso cref="joiningEnabled"/>
         public void DisableJoining()

Packages/com.unity.inputsystem/InputSystem/Plugins/PlayerInput/PlayerJoinBehavior.cs

@@ -15,11 +15,17 @@ public enum PlayerJoinBehavior
         /// </summary>
         JoinPlayersWhenButtonIsPressed,
 
+        /// <summary>
+        /// Listen for button presses on devices that are not paired to any player. If the control 
+        /// they triggered matches a specific action and joining is allowed, join a new player using 
+        /// the device the button was pressed on.
+        /// </summary>
         JoinPlayersWhenJoinActionIsTriggered,
 
         /// <summary>
-        /// Do not join players automatically. Call <see cref="PlayerInputManager.JoinPlayerFromUI"/> or <see cref="PlayerInputManager.JoinPlayerFromAction"/>
-        /// explicitly in order to join new players. Alternatively, just create GameObjects with <see cref="PlayerInput"/>
+        /// Don't join players automatically. Call <see cref="PlayerInputManager.JoinPlayerFromUI"/> 
+        /// or <see cref="PlayerInputManager.JoinPlayerFromAction"/> explicitly in order to join new 
+        /// players. Alternatively, just create GameObjects with <see cref="PlayerInput"/>
         /// components directly and they will be joined automatically.
         /// </summary>
         /// <remarks>