d16465e
diff -Nur ydotool-1.0.1-orig/manpage/ydotool.1.scd ydotool-1.0.1/manpage/ydotool.1.scd
d16465e
--- ydotool-1.0.1-orig/manpage/ydotool.1.scd	2022-02-16 19:38:49.000000000 +1000
d16465e
+++ ydotool-1.0.1/manpage/ydotool.1.scd	2022-03-21 14:46:37.916103638 +1000
d16465e
@@ -1,12 +1,11 @@
d16465e
 YDOTOOL(1)
d16465e
-
d16465e
 # NAME
d16465e
 
d16465e
 ydotool - command-line _/dev/uinput_ automation tool
d16465e
 
d16465e
 # SYNOPSIS
d16465e
 
d16465e
-*ydotool* *cmd* _args_ [ , *cmd* _args_ ... ]
d16465e
+*ydotool* *cmd* _args_
d16465e
 
d16465e
 *ydotool* *cmd* --help
d16465e
 
d16465e
@@ -14,8 +13,6 @@
d16465e
 
d16465e
 *ydotool* lets you programmatically (or manually) simulate keyboard input and mouse activity, etc. It does this by writing directly to _/dev/uinput_ so it generally needs to run as root.
d16465e
 
d16465e
-It's possible to chain multiple commands together, separated by a comma between two spaces.
d16465e
-
d16465e
 Currently implemented command(s):
d16465e
 
d16465e
 *type*
d16465e
@@ -26,67 +23,37 @@
d16465e
 	Move mouse pointer to absolute position
d16465e
 *click*
d16465e
 	Click on mouse buttons
d16465e
-*recorder*
d16465e
-	Record/replay input events
d16465e
-*sleep*
d16465e
-	sleep for a while
d16465e
 
d16465e
 # KEYBOARD COMMANDS
d16465e
-*key* [*--up*] [*--down*] [*--next-delay* _<ms>_] [*--key-delay* _<ms>_] [*--repeat* _<times>_] [*--repeat-delay <ms>*] _<key sequence>_
d16465e
+*key* [*-d*,*--key-delay* _<ms>_] [_<KEYCODE:PRESSED>_ ...]
d16465e
 
d16465e
-	Type a given keystroke. Examples being "alt+r", "ctrl+J",
d16465e
-	"ctrl+alt+n", "backspace".
d16465e
+	Type a given keycode.
d16465e
+	
d16465e
+	e.g. 28:1 28:0 means pressing on the Enter button on a standard US keyboard.
d16465e
 
d16465e
-	Options:
d16465e
+	42:1 38:1 38:0 24:1 24:0 38:1 38:0 42:0 - "LOL"
d16465e
 
d16465e
-	*--up*
d16465e
-		Only keyup
d16465e
-		
d16465e
-	*--down*
d16465e
-		Only keydown
d16465e
+	Non-interpretable values, such as 0, aaa, l0l, will only cause a delay.
d16465e
 
d16465e
-	*--delay* _<ms>_
d16465e
-		Delay before starting to output keystrokes. Default 100ms.
d16465e
+	See `/usr/include/linux/input-event-codes.h' for available key codes (KEY_\*).
d16465e
 
d16465e
-	*--key-delay* _<ms>_
d16465e
+	Options:
d16465e
+	*-d*,*--key-delay* _<ms>_
d16465e
 		Delay time between keystrokes. Default 12ms.
d16465e
 
d16465e
-	*--repeat* _<times>_
d16465e
-		Times to repeat the key sequence.
d16465e
-
d16465e
-	*--repeat-delay* _<ms>_
d16465e
-		Delay time between repetitions. Default 0ms.
d16465e
-
d16465e
-	Generally, any valid name from _/usr/include/linux/input-event-codes.h_ will work. Multiple keys are separated by '+'.
d16465e
-
d16465e
-	Each key sequence can be any number of modifiers and keys, separated by plus (+)
d16465e
-
d16465e
-	For example: alt+r Alt+F4 CTRL+alt+f3 aLT+1+2+3 ctrl+Backspace 
d16465e
-
d16465e
-	Since we are emulating keyboard input, combinations like Shift+# is invalid because typing a `#' involves pressing Shift and 3.
d16465e
-
d16465e
-	Example: Switch to tty1:
d16465e
-		ydotool key ctrl+alt+f1
d16465e
-
d16465e
-	Example: Close a window in graphical environment:
d16465e
-		ydotool key Alt+F4
d16465e
-
d16465e
-*type* [*--next-delay* _<ms>_] [*--key-delay* _<ms>_] [*--texts* _arg_] [*--file* _<filepath>_] "_texts_"
d16465e
+*type* [*-D*,*--next-delay* _<ms>_] [*-d*,*--key-delay* _<ms>_] [*-f*,*--file* _<filepath>_] "_text_"
d16465e
 
d16465e
 	Types text as if you had typed it on the keyboard.
d16465e
 
d16465e
 	Options:
d16465e
 
d16465e
-	*--next-delay* _<ms>_
d16465e
-		Delay before starting typing. Default 100ms.
d16465e
+	*-d*,*--key-delay* _<ms>_
d16465e
+		Delay time between key events (up/down each). Default 12ms.
d16465e
 
d16465e
-	*--key-delay* _<ms>_
d16465e
-		Delay time between keystrokes. Default 12ms.
d16465e
-
d16465e
-	*--texts* _arg_
d16465e
-		Texts to type
d16465e
+	*-D*,*--next-delay* _<ms>_
d16465e
+		Delay between strings. Default 0ms.
d16465e
 
d16465e
-	*--file* _<filepath>_
d16465e
+	*-f*,*--file* _<filepath>_
d16465e
 		Specify a file, the contents of which will be typed as if passed as an argument. The filepath may also be '-' to read from stdin.
d16465e
 
d16465e
 	Example: to type 'Hello world!' you would do:
d16465e
@@ -94,8 +61,8 @@
d16465e
 
d16465e
 # MOUSE COMMANDS
d16465e
 
d16465e
-*mousemove* _<x> <y>_
d16465e
-	Move the mouse to the specific relative X and Y coordinates on the screen.
d16465e
+*mousemove* [*-a*,*--absolute*] _<x> <y>_
d16465e
+	Move the mouse to the relative X and Y coordinates on the screen.
d16465e
 
d16465e
 	Options:
d16465e
 	*--absolute*
d16465e
@@ -104,47 +71,38 @@
d16465e
 	Example: to move the cursor to absolute coordinates (100,100):
d16465e
 		ydotool mousemove --absolute 100 100
d16465e
 
d16465e
-*click*  [*--next-delay* _<ms>_] _button_
d16465e
-	Send a click. Buttons are: _left_, _right_ or _middle_
d16465e
-
d16465e
-	Options:
d16465e
-
d16465e
-	*--next-delay* _<ms>_
d16465e
-		Delay before click. Default 100ms.
d16465e
-
d16465e
-	*--up*
d16465e
-		Only mouseup
d16465e
-
d16465e
-	*--down*
d16465e
-		Only mousedown
d16465e
-
d16465e
-	*--buttons* _<arg>_
d16465e
-		Buttons to press (left, right, middle)
d16465e
-
d16465e
-	Example: Mouse middle click:
d16465e
-		ydotool click middle
d16465e
-
d16465e
-*recorder* [*--record* _<devices>_] [*--replay* _<input files>_] [*--display*] [*--duration* _<ms>_] [*--devices* _<path>_] [*--file* _<path>_]
d16465e
+*click* [*-d*,*--next-delay* _<ms>_] [*-r*,*--repeat* _N_ ] [_button_ ...]
d16465e
+	Send a click.
d16465e
 
d16465e
 	Options:
d16465e
+	*-d*,*--next-delay* _<ms>_
d16465e
+		Delay between input events (up/down, a compete click means doubled time). Default 25ms.
d16465e
 
d16465e
-	*--record* _<devices>_
d16465e
-		Devices to record from. Default is all, including non-keyboard devices.
d16465e
-
d16465e
-	*--replay* _<input files>_
d16465e
-		The record file can't be replayed on an architecture with different endianness.
d16465e
-
d16465e
-	*--display*
d16465e
-		Display
d16465e
+	*-r*,*--repeat* _N_
d16465e
+		Repeat entire sequence N times
d16465e
 
d16465e
-	*--duration* _<ms>_
d16465e
-		Record duration. Otherwise use SIGINT to stop recording.
d16465e
+	all mouse buttons are represented using hexadecimal numeric values, with an optional
d16465e
+	bit mask to specify if mouse up/down needs to be omitted.
d16465e
 
d16465e
-	*--devices* _<path>_
d16465e
-		Devices, separated by comma, to record from. Default is all devices (default: "")
d16465e
+	- 0x00 - LEFT
d16465e
+	- 0x01 - RIGHT
d16465e
+	- 0x02 - MIDDLE
d16465e
+	- 0x03 - SIDE
d16465e
+	- 0x04 - EXTR
d16465e
+	- 0x05 - FORWARD
d16465e
+	- 0x06 - BACK
d16465e
+	- 0x07 - TASK
d16465e
+	- 0x40 - Mouse down
d16465e
+	- 0x80 - Mouse up
d16465e
+    
d16465e
+	Examples:
d16465e
+
d16465e
+	- 0x00: chooses left button, but does nothing (you can use this to implement extra sleeps)
d16465e
+	- 0xC0: left button click (down then up)
d16465e
+	- 0x41: right button down
d16465e
+	- 0x82: middle button up
d16465e
 
d16465e
-	*--file* _<path>_
d16465e
-		File to record to / replay from
d16465e
+	The '0x' prefix can be omitted if you want.
d16465e
 
d16465e
 # AUTHOR
d16465e