Update documentation.

docs/examples/multiple_files/axes.yml

@@ -0,0 +1,56 @@
+rules:
+  - type: simple
+    input:
+      device: right-stick
+      axis: ABS_X
+    output:
+      device: main
+      axis: ABS_X
+
+  - type: simple
+    input:
+      device: right-stick
+      axis: ABS_Y
+    output:
+      device: main
+      axis: ABS_Y
+
+  - type: simple
+    input:
+      device: right-stick
+      axis: ABS_THROTTLE
+    output:
+      device: main
+      axis: ABS_THROTTLE
+
+  - type: simple
+    input:
+      device: left-stick
+      axis: ABS_X
+    output:
+      device: main
+      axis: ABS_RX
+
+  - type: simple
+    input:
+      device: left-stick
+      axis: ABS_Y
+    output:
+      device: main
+      axis: ABS_RY
+
+  - type: simple
+    input:
+      device: left-stick
+      axis: ABS_THROTTLE
+    output:
+      device: main
+      axis: ABS_RUDDER
+
+  - type: simple
+    input:
+      device: pedals
+      axis: ABS_Z
+    output:
+      device: main
+      axis: ABS_Z

docs/examples/multiple_files/buttons.yml

@@ -0,0 +1,21 @@
+rules:
+  - name: Trigger
+    type: combo
+    inputs:
+      - device: right-stick
+        button: BTN_THUMB
+      - device: right-stick
+        button: BTN_THUMB2
+    output:
+      device: main
+      button: BTN_TRIGGER
+  - name: Trigger2
+    type: combo
+    inputs:
+      - device: left-stick
+        button: BTN_THUMB
+      - device: left-stick
+        button: BTN_THUMB2
+    output:
+      device: main
+      button: BTN_THUMB

docs/examples/multiple_files/devices.yml

@@ -0,0 +1,17 @@
+devices:
+  - name: main
+    type: virtual
+    buttons: 56
+    axes: 8
+  - name: right-stick
+    type: physical
+    device_name: VIRPIL Controls 20220407 R-VPC Stick MT-50CM2
+  - name: left-stick
+    type: physical
+    device_name: VIRPIL Controls 20220407 L-VPC Stick MT-50CM2
+  - name: pedals
+    type: physical
+    device_name: "CH PRODUCTS CH PRO PEDALS USB "
+  - name: button-box
+    type: physical
+    device_name: Arduino Arduino Joystick

docs/examples/multiple_files/readme.md

@@ -0,0 +1,7 @@
+## multi-file configuration example
+
+This directory demonstrates how to split your configuration across multiple files.
+Note that we re-define the top-level `rules` element; this is by design.
+
+It also serves as a real-world example demonstrating many of the available features of the system.
+It is based on the author's actual mappings for Star Citizen.