Fix typos and alphebetically sort docs for CLI flags
This commit is contained in:
parent
51ecaea4e2
commit
7660ad6440
2 changed files with 44 additions and 32 deletions
34
README.md
34
README.md
|
@ -1,10 +1,10 @@
|
||||||
# lisgd
|
# lisgd
|
||||||
|
|
||||||
Lisgd (libinput synthetic gesture daemon) lets you bind gestures based on
|
Lisgd (libinput **synthetic** gesture daemon) lets you bind gestures based on
|
||||||
libinput touch events to run specific commands to execute. For example,
|
libinput touch events to run specific commands to execute. For example,
|
||||||
dragging left to right with one finger could execute a particular command
|
dragging left to right with one finger could execute a particular command
|
||||||
like launching a terminal. Directional L-R, R-L, U-D, and D-U gestures and
|
like launching a terminal. Directional L-R, R-L, U-D, and D-U gestures and
|
||||||
diagnoal LD-RU, RD-LU, UR-DL, UL-DR gestures are supported with 1 through
|
diagnol LD-RU, RD-LU, UR-DL, UL-DR gestures are supported with 1 through
|
||||||
n fingers.
|
n fingers.
|
||||||
|
|
||||||
Unlike other libinput gesture daemons, lisgd uses touch events to
|
Unlike other libinput gesture daemons, lisgd uses touch events to
|
||||||
|
@ -32,22 +32,26 @@ Flags:
|
||||||
|
|
||||||
- **-d [devicenodepath]**: Defines the dev filesystem device to monitor
|
- **-d [devicenodepath]**: Defines the dev filesystem device to monitor
|
||||||
- Example: `lisgd -d /dev/input/input1`
|
- Example: `lisgd -d /dev/input/input1`
|
||||||
- **-t [threshold_units]**: Threshold in libinput units (pixels) after which a
|
|
||||||
gesture registers. Defaults to 300.
|
|
||||||
- Example: `lisgd -t 400`
|
|
||||||
- **-r [milli]**: Number of degrees offset each 45-degree interval may still
|
|
||||||
be recognized within. Maximum value is 45. Default value is 15. E.g. U-D
|
|
||||||
is a 180 degree gesture but with 15 degrees of leniency will be recognized
|
|
||||||
between 165-195 degrees.
|
|
||||||
- Example: `lisgd -r 20`
|
|
||||||
- **-m [timeoutms]**: Number of milliseconds gestures must be performed within
|
|
||||||
to be registered. After the timeoutms value; the gesture won't be registered.
|
|
||||||
- Example: `lisgd -m 1200`
|
|
||||||
- **-v**: Verbose mode, useful for debugging
|
|
||||||
- Example: `lisgd -v`
|
|
||||||
- **-g [nfingers,gesture,command]**: Allows you to bind a gesture wherein
|
- **-g [nfingers,gesture,command]**: Allows you to bind a gesture wherein
|
||||||
nfingers is an integer, gesture is one of {LR,RL,DU,UD,DLUR,URDL,ULDR,DLUR},
|
nfingers is an integer, gesture is one of {LR,RL,DU,UD,DLUR,URDL,ULDR,DLUR},
|
||||||
and command is the shell command to be executed. The -g option can be used
|
and command is the shell command to be executed. The -g option can be used
|
||||||
multiple times to bind multiple gestures.
|
multiple times to bind multiple gestures.
|
||||||
- Single Gesture Example: `lisgd -g "1,LR,notify-send swiped lr"`
|
- Single Gesture Example: `lisgd -g "1,LR,notify-send swiped lr"`
|
||||||
- Multiple Gestures Example: `lisgd -g "1,LR,notify-send swiped lr" -g "1,RL,noitfy-send swiped rl"`
|
- Multiple Gestures Example: `lisgd -g "1,LR,notify-send swiped lr" -g "1,RL,noitfy-send swiped rl"`
|
||||||
|
- **-m [timeoutms]**: Number of milliseconds gestures must be performed within
|
||||||
|
to be registered. After the timeoutms value; the gesture won't be registered.
|
||||||
|
- Example: `lisgd -m 1200`
|
||||||
|
- **-o [orientation]**: Number of 90-degree rotations to translate gestures by.
|
||||||
|
Can be set to 0-3. For example using 1; a L-R gesture would become a U-D
|
||||||
|
gesture. Meant to be used for screen-rotation.
|
||||||
|
- Example `lisgd -o 1`
|
||||||
|
- **-r [degrees]**: Number of degrees offset each 45-degree interval may still
|
||||||
|
be recognized within. Maximum value is 45. Default value is 15. E.g. U-D
|
||||||
|
is a 180 degree gesture but with 15 degrees of leniency will be recognized
|
||||||
|
between 165-195 degrees.
|
||||||
|
- Example: `lisgd -r 20`
|
||||||
|
- **-t [threshold_units]**: Threshold in libinput units (pixels) after which a
|
||||||
|
gesture registers. Defaults to 300.
|
||||||
|
- Example: `lisgd -t 400`
|
||||||
|
- **-v**: Verbose mode, useful for debugging
|
||||||
|
- Example: `lisgd -v`
|
||||||
|
|
42
lisgd.1
42
lisgd.1
|
@ -5,21 +5,22 @@ lisgd \- libinput synthetic gesture daemon
|
||||||
|
|
||||||
.SH SYNOPSIS
|
.SH SYNOPSIS
|
||||||
.B lisgd
|
.B lisgd
|
||||||
|
[\fB\-d\fR \fIdevicepath\fR]
|
||||||
|
[\fB\-g\fR \fIgesturespec\fR]...
|
||||||
[\fB\-t\fR \fIthreshold\fR]
|
[\fB\-t\fR \fIthreshold\fR]
|
||||||
[\fB\-d\fR \fIdegreesofleniency\fR]
|
|
||||||
[\fB\-m\fR \fItimeoutms\fR]
|
[\fB\-m\fR \fItimeoutms\fR]
|
||||||
[\fB\-o\fR \fIorientation\fR]
|
[\fB\-o\fR \fIorientation\fR]
|
||||||
[\fB\-v\fR \fIverbose\fR]
|
[\fB\-r\fR \fIdegreesofleniency\fR]
|
||||||
[\fB\-g\fR \fIgesturespec\fR]...
|
[\fB\-v]
|
||||||
|
|
||||||
|
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
.B lisgd
|
.B lisgd
|
||||||
(or libinput **synthetic** gesture daemon) lets you bind gestures based on
|
(or libinput synthetic gesture daemon) lets you bind gestures based on
|
||||||
libinput touch events to run specific commands to execute. For example,
|
libinput touch events to run specific commands to execute. For example,
|
||||||
dragging left to right with one finger could execute a particular command
|
dragging left to right with one finger could execute a particular command
|
||||||
like launching a terminal. Directional L-R, R-L, U-D, and D-U gestures and
|
like launching a terminal. Directional L-R, R-L, U-D, and D-U gestures and
|
||||||
diagnoal LD-RU, RD-LU, UR-DL, UL-DR gestures are supported with 1 through
|
diagnol LD-RU, RD-LU, UR-DL, UL-DR gestures are supported with 1 through
|
||||||
n fingers.
|
n fingers.
|
||||||
|
|
||||||
Unlike other libinput gesture daemons, lisgd uses touch events to
|
Unlike other libinput gesture daemons, lisgd uses touch events to
|
||||||
|
@ -40,9 +41,22 @@ you're using.
|
||||||
Path of the dev filesystem device to monitor (like /dev/input/event1).
|
Path of the dev filesystem device to monitor (like /dev/input/event1).
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
.BR \-t ", " \-t\ distancethreshold\fR
|
.BR \-g ", " \-g\ nfingers,gesture,command\fR
|
||||||
Threshold in libinput units (pixels) after which a gesture registers. Defaults
|
Allow you to bind a gesture wherein nfingers is an integer, gesture is
|
||||||
to 300.
|
one of {LR,RL,DU,UD,DLUR,URDL,ULDR,DLUR}, and the shell command to be executed.
|
||||||
|
|
||||||
|
The -g option can be used multiple times to bind multiple gestures.
|
||||||
|
|
||||||
|
.TP
|
||||||
|
.BR \-m ", " \-m\ timeoutms\fR
|
||||||
|
Number of milliseconds gestures must be performed within to be registered. After
|
||||||
|
the timeoutms value; the gesture won't be registered.
|
||||||
|
|
||||||
|
.TP
|
||||||
|
.BR \-o ", " \-o\ orientation\fR
|
||||||
|
Number of 90-degree rotations to translate gestures by. Can be set to 0-3. For
|
||||||
|
example using 1; a L-R gesture would become a U-D gesture. Meant to be used
|
||||||
|
for screen-rotation.
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
.BR \-r ", " \-r\ degreesofleniency\fR
|
.BR \-r ", " \-r\ degreesofleniency\fR
|
||||||
|
@ -51,20 +65,14 @@ Maximum value is 45. Default value is 15. E.g. U-D is a 180 degree gesture
|
||||||
but with 15 degrees of leniency will be recognized between 165-195 degrees.
|
but with 15 degrees of leniency will be recognized between 165-195 degrees.
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
.BR \-m ", " \-m\ timeoutms\fR
|
.BR \-t ", " \-t\ distancethreshold\fR
|
||||||
Number of milliseconds gestures must be performed within to be registered. After
|
Threshold in libinput units (pixels) after which a gesture registers. Defaults
|
||||||
the timeoutms value; the gesture won't be registered.
|
to 300.
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
.BR \-v \fR
|
.BR \-v \fR
|
||||||
Enables verbose mode which prints debugging messages.
|
Enables verbose mode which prints debugging messages.
|
||||||
|
|
||||||
.TP
|
|
||||||
.BR \-g ", " \-g\ nfingers,gesture,command\fR
|
|
||||||
Allow you to bind a gesture wherein nfingers is an integer, gesture is
|
|
||||||
one of {LR,RL,DU,UD,DLUR,URDL,ULDR,DLUR}, and the shell command to be executed.
|
|
||||||
|
|
||||||
The -g option can be used multiple times to bind multiple gestures.
|
|
||||||
|
|
||||||
.SH SEE ALSO
|
.SH SEE ALSO
|
||||||
lisgd was built as part of Sxmo; an project to create a Pinephone UI out of
|
lisgd was built as part of Sxmo; an project to create a Pinephone UI out of
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue