Update controller-autoconfiguration.md

In-depth and structured explanation of the mapping and labeling process, with a particular emphasis on analog inputs and PlayStation controllers.

Most notably, changed

```
input_l2_axis_label = "L2"
input_r2_axis_label = "R2"
```

to

```
input_l2_axis_label = "L2 Analog"
input_r2_axis_label = "R2 Analog"
```

Author: davidhedlund

docs/guides/controller-autoconfiguration.md

@@ -227,6 +227,7 @@ input_product_id = "3570"
 
 The second part is the mapping itself, where each button is assigned to a button of the RetroPad (the joypad abstraction of RetroArch).
 
+Example
 ```
 input_b_btn = "0"
 input_y_btn = "2"
@@ -255,26 +256,70 @@ input_r_y_minus_axis = "-4"
 input_menu_toggle_btn = "8"
 ```
 
-#### Axes (analog inputs)
+Note: These values are examples and should not be directly copied to your configuration file without verification.
 
-* Variable names ending with `_axis` define these (e.g., `input_l_x_axis`, `input_r2_axis`).
-* They represent analog inputs from the controller, like joystick position (e.g., left joystick X-axis, right joystick Y-axis) or trigger pressure (e.g., left trigger, right trigger).
+#### Overview
+
+##### Axes (analog inputs)
+* They represent analog inputs from the controller, like joystick position (e.g., left joystick X-axis, right joystick Y-axis) or trigger pressure (e.g., L2 trigger, R2 trigger).
+* Variable names (for both mappings and labels) includes `_axis` define these (e.g., `input_l_x_plus_axis_label`, `input_r2_axis`).
+
+| Console          | Controller                       | Release Date   | Analog Thumb Sticks | L2/R2 Analog |
+|------------------|----------------------------------|----------------|---------------------|--------------|
+| PlayStation 1    | Sony Dual Analog Controller      | April 1997     | Yes                 | No           |
+| PlayStation 1    | Sony DualShock                   | November 1997  | Yes                 | No           |
+| PlayStation 2    | DualShock 2                      | 2000           | Yes                 | Yes          |
+| PlayStation 3    | Sixaxis                          | 2006           | Yes                 | Yes          |
+| PlayStation 3    | DualShock 3                      | 2008           | Yes                 | Yes          |
+| PlayStation 4    | DualShock 4                      | 2013           | Yes                 | Yes          |
+| PlayStation 5    | DualSense                        | 2020           | Yes                 | Yes          |
+
+###### Mapping variables
 * Axis definitions use `+` and `-` to indicate positive or negative direction (e.g., full press vs. no press).
 * The current RetroArch configurations have axis values that ranges from `0` to `10`. However, if RetroArch does not limit the values to `10`, underlying controller hardware could offer an even wider range.
 
-#### Buttons (digital inputs)
+Mapping variables with analog L2/R2 triggers:
+```
+input_l2_axis = "+2"
+input_r2_axis = "+5"
+```
+
+Note: These values are examples and should not be directly copied to your configuration file without verification.
+
+###### Label variables
+The term "Analog" is included in the variable values for the analog inputs to clearly indicate that these inputs are analog in nature.
+
+Labels for analog thumb sticks:
+```
+input_l_x_plus_axis_label = "Left Analog X+ (right)"
+input_l_x_minus_axis_label = "Left Analog X- (left)"
+input_l_y_plus_axis_label = "Left Analog Y+ (down)"
+input_l_y_minus_axis_label = "Left Analog Y- (up)"
+input_r_x_plus_axis_label = "Right Analog X+ (right)"
+input_r_x_minus_axis_label = "Right Analog X- (left)"
+input_r_y_plus_axis_label = "Right Analog Y+ (down)"
+input_r_y_minus_axis_label = "Right Analog Y- (up)"
+```
+
+Labels for analog L2/R2 triggers:
+```
+input_l2_axis_label = "L2 Analog"
+input_r2_axis_label = "R2 Analog"
+```
+
+##### Buttons (digital inputs)
 
 * These are defined by variable names ending with `_btn` (e.g., `input_a_btn`, `input_start_btn`).
 * The current RetroArch configurations have button values that ranges from `0` to `203`. However, if RetroArch does not limit the values to `203`, underlying controller hardware could offer an even wider range.
 * RetroArch interprets these IDs (usually 1 for pressed, 0 for not pressed) to determine the button state.
 
-##### D-Pad directions (special digital inputs)
+###### D-Pad directions (special digital inputs)
 
 * D-pad directions use variable values beginning with `h0` (e.g., `input_up_btn = "h0up"`).
 * Four `h0` variables exist (`h0up`, `h0down`, `h0left`, `h0right`) for each direction on the D-pad.
 * Note: The value `h1` is used by a single controller (Nintendo_Wii_Remote_Classic_Controller.cfg).
 
-### Input descriptors
+#### Input descriptors
 
 The third part are *input descriptors* used by RetroArch to display the labels of the buttons as they are written on your joypad.
 
@@ -307,9 +352,9 @@ input_r_y_minus_axis_label = "Right Analog Y- (up)"
 input_menu_toggle_btn_label = "Guide"
 ```
 
-#### Sony PlayStation controllers
+#### Example: Controllers for Sony PlayStation 2 and later
 
-So if you are using a Sony PlayStation controllers, RetroArch will refer to the buttons as Cross, Circle, Square and Triangle:
+Labels for PlayStation controllers starting from PS2. Note that analog L2/R2 triggers (`input_l2_axis_label = "L2 Analog"`, and `input_r2_axis_label = "R2 Analog"`) are featured:
 ```
 input_b_btn_label = "Cross"
 input_y_btn_label = "Square"
@@ -323,8 +368,8 @@ input_a_btn_label = "Circle"
 input_x_btn_label = "Triangle"
 input_l_btn_label = "L1"
 input_r_btn_label = "R1"
-input_l2_axis_label = "L2"
-input_r2_axis_label = "R2"
+input_l2_axis_label = "L2 Analog"
+input_r2_axis_label = "R2 Analog"
 input_l3_btn_label = "L3"
 input_r3_btn_label = "R3"
 input_l_x_plus_axis_label = "Left Analog X+ (right)"