Bug Physics.Raycast() layer mask is to SELECT, not IGNORE layers

In the docs https://docs.unity3d.com/ScriptReference/Physics.Raycast.html, the statement "A Layer mask that is used to selectively ignore colliders when casting a ray." is incorrect.

Also, "You may optionally provide a LayerMask, to filter out any Colliders you aren't interested in generating collisions with." is incorrect.

When testing, Physics.Raycast() layer mask is to SELECT, not IGNORE layers. I spent 2 hours pulling my hair off...

Example:

Code (CSharp):

1. public static bool IsMouseButton(this Camera camera, int button, out RaycastHit hit, LayerMask layerMask)
2.         {
3.             hit = new RaycastHit();
4.  
5.             if (Input.GetMouseButton(button))
6.             {
7.                 Debug.Log($"Mouse button {button} is down, layer mask {layerMask.value}");
8.  
9.                 var ray = camera.ScreenPointToRay(Input.mousePosition);
10.  
11.                 // I tested layerMask and ~layerMask
12.                 // layerMask proves to be used for SELECTING and not IGNORING layers
13.                 if (Physics.Raycast(ray, out hit, Mathf.Infinity, layerMask))
14.                 {
15.                     Debug.Log($"Mouse button {button} is down, hit {hit.collider.gameObject.name}");
16.                     return true;
17.                 }
18.             }
19.  
20.             return false;
21.         }

 

@yant suggestion: It would help tremendously if the docs included a proper/comprehensive example of how the mask is intended to be used. As of writing, none of the examples show use of mask. Thanks.