Update documentation.

docs/examples/multiple_files/axes.yml

@@ -5,8 +5,6 @@ rules:
     input:
       device: right-stick
       axis: Y
-      deadzone_start: 29000
-      deadzone_end: 31000
     output:
       device: primary
       axis: Y
@@ -16,8 +14,6 @@ rules:
     input:
       device: right-stick
       axis: X
-      deadzone_start: 30000
-      deadzone_end: 32000
     output:
       device: primary
       axis: X
@@ -27,8 +23,6 @@ rules:
     input:
       device: pedals
       axis: Z
-      deadzone_start: 124
-      deadzone_end: 132
     output:
       device: primary
       axis: Z
@@ -39,8 +33,6 @@ rules:
     input:
       device: left-stick
       axis: Y
-      deadzone_start: 29500
-      deadzone_end: 31000
     output:
       device: primary
       axis: RY
@@ -50,8 +42,6 @@ rules:
     input:
       device: left-stick
       axis: X
-      deadzone_start: 29000
-      deadzone_end: 30500
     output:
       device: primary
       axis: RX
@@ -62,8 +52,6 @@ rules:
     input:
       device: right-stick
       axis: RX
-      deadzone_start: 29500
-      deadzone_end: 30250
     output:
       device: secondary
       axis: X
@@ -72,8 +60,6 @@ rules:
     input:
       device: right-stick
       axis: RY
-      deadzone_start: 29500
-      deadzone_end: 30250
     output:
       device: secondary
       axis: Y
@@ -87,8 +73,6 @@ rules:
     input:
       device: right-stick
       axis: ABS_THROTTLE
-      deadzone_start: 0
-      deadzone_end: 500
     output:
       device: primary
       axis: ABS_THROTTLE
@@ -100,8 +84,6 @@ rules:
     input:
       device: left-stick
       axis: ABS_THROTTLE
-      deadzone_start: 0
-      deadzone_end: 500
     output:
       device: primary
       axis: ABS_RUDDER
@@ -111,8 +93,8 @@ rules:
     name: tractor in
     modes:
       - main
-    repeat_rate_max: 10
+    repeat_rate_max: 50
-    repeat_rate_min: 100
+    repeat_rate_min: 500
     increment: -1
     input:
       device: left-stick
@@ -127,8 +109,8 @@ rules:
     name: tractor out
     modes:
       - main
-    repeat_rate_max: 10
+    repeat_rate_max: 50
-    repeat_rate_min: 100
+    repeat_rate_min: 500
     increment: 1
     input:
       device: left-stick
@@ -175,44 +157,6 @@ rules:
     input:
       device: right-stick
       axis: ABS_THROTTLE
-      deadzone_start: 0
-      deadzone_end: 500
     output:
       device: primary
       axis: RZ
-      
-  # In tractor mode, most flight controls are disabled to prevent us
-  # from accidentally trying to fly off without throttle control
-  # - type: axis-to-relaxis
-  #   name: tractor in
-  #   modes:
-  #     - tractor
-  #   repeat_rate_max: 10
-  #   repeat_rate_min: 100
-  #   increment: -1
-  #   input:
-  #     device: left-stick
-  #     axis: Y
-  #     deadzone_start: 0
-  #     deadzone_end: 30250
-  #   output:
-  #     device: mouse
-  #     axis: REL_WHEEL
-
-  # - type: axis-to-relaxis
-  #   name: tractor out
-  #   modes:
-  #     - tractor
-  #   repeat_rate_max: 10
-  #   repeat_rate_min: 100
-  #   increment: 1
-  #   input:
-  #     device: left-stick
-  #     axis: Y
-  #     deadzone_start: 29500
-  #     deadzone_end: 64000
-  #     inverted: true
-  #   output:
-  #     device: mouse
-  #     axis: REL_WHEEL
-

docs/readme.md

@@ -57,7 +57,9 @@ evtest | grep BTN_
 
 ### Axis Deadzones
 
-For most axis inputs, you will want to define deadzones. There are three possible approaches:
+**NOTE: For most axis mappings, you probably don't want to specify a deadzone!** Use deadzone configurations in your target game instead. Joyful-configured deadzones are intended to be used in conjunction with the `axis-to-button` and `axis-to-relaxis` input types, or when splitting an axis into multiple outputs. Using them with standard `axis` mappings may result in a loss of fidelity and "stuck" inputs.
+
+There are three ways to specify deadzones:
 
 * Define `deadzone_start` and `deadzone_end` to explicitly set the deadzone bounds.
 * Define `deadzone_center` and `deadzone_size`; this will create a deadzone of the indicated size centered at the given axis position.