doc: more documentation on mouse gestures

docs/capabilities.md

@@ -164,6 +164,10 @@ Pressing the button, if the button is diverted, causes the mouse pointer to stop
 When the button is released a MOUSE_GESTURE notification with the total mouse movement
 while the button was pressed is sent to the Solaar rule system.
 
+MOUSE_GESTURE notifications trigger mouse gesture conditions in Solaar rules.
+For more information on mouse gesture rules conditions see
+[the rules page](https://pwr-solaar.github.io/Solaar/rules).
+
 Mouse gestures is an experimental feature.
 Significant changes might be made to it in the future.
 

docs/rules.md

@@ -125,11 +125,14 @@ All of these rules are only active if the key or feature is diverted, of course.
 Solaar reads rules from a YAML configuration file (normally `~/.config/solaar/rules.yaml`).
 This file contains zero or more documents, each a rule.
 
-Here is a file with three rules:
+Here is a file with four rules:
 
 ```
 %YAML 1.3
 ---
+- MouseGesture: [Mouse Up, Mouse Down]
+- Execute: xflock4
+...
 - Feature: CROWN
 - Process: quodlibet
 - Rule: [ Test: crown_start_press, KeyPress: XF86_AudioMute ]