diff options
Diffstat (limited to 'upstream/fedora-40/man1/mev.1')
-rw-r--r-- | upstream/fedora-40/man1/mev.1 | 133 |
1 files changed, 133 insertions, 0 deletions
diff --git a/upstream/fedora-40/man1/mev.1 b/upstream/fedora-40/man1/mev.1 new file mode 100644 index 00000000..4074cf29 --- /dev/null +++ b/upstream/fedora-40/man1/mev.1 @@ -0,0 +1,133 @@ +.TH MEV 1 "February 1995" +.UC 4 +.SH NAME +mev \- a program to report mouse events +.SH SYNOPSIS +.B mev +[ +.I options +] +.br +.SH DESCRIPTION +The `mev' program is part of the gpm package. +The information below is extracted from the texinfo file, which is the +preferred source of information. + +.LP +The mev program is modeled after xev. It prints to stdout the +mouse console events it gets. + +.LP +mev's default behaviour is to get anything, but command line switches +can be used to set the various fields in the Gpm_Connect structure, in +order to customize the program's behaviour. I'm using mev to +handle mouse events to Emacs. + +.LP +Command line switches for mev are the following: +.TP +\-C \fBnumber\fP +Select a virtual console to get events from. +This is intended to be used for debugging. +.TP +\-d \fBnumber\fP +Choose a default mask. By default the server gets +any events not belonging to the event mask. The mask can be +provided either as a +decimal number, or as a symbolic string. +.TP +\-e \fBnumber\fP +Choose the event mask. By default any event +is received. The mask can be provided either as a +decimal number, or as a symbolic string. +.TP +\-E +Enter emacs mode. In emacs mode events are reported as +lisp forms rather than numbers. This is the format used by the +t-mouse package within emacs. +.TP +\-f +Fit events inside the screen before reporting them. This options +re-fits drag events, which are allowed to exit the screen border, + +.TP +\-i +Interactive. Accepts input from stdin to change connection +parameters. +.TP +\-m \fBnumber\fP +Choose the minimum modifier mask. Any event with +fewer modifiers will not be reported to mev. It defaults to 0. +The mask must be provided either as a +decimal number, or as a symbolic string. +.TP +\-M \fBnumber\fP +Choose the maximum modifier mask. Any event with +more modifier than specified will not be reported to mev. +It defaults to \~~0, i.e. all events are received. +The mask must be provided either as a +decimal number, or as a symbolic string. +.TP +\-p +Requests to draw the pointer during drags. This option is used +by emacs to avoid invoking ioctl() from lisp code. + +.LP +When the arguments are not decimal integers, they are considered lists +of alphanumeric characters, separated by a single non-alphanumeric +character. I use the comma (,), but any will do. + +.LP +Allowed names for events are move, drag, down or +press, up or release, motion (which is both +move and drag), and hard. + +.LP +Allowed names for modifiers are shift, leftAlt, +rightAlt, anyAlt (one or the other), control. + +.LP +When the \-i switch is specified, mev looks at its standard input as +command lines rather than events. The input lines are parsed, and the +commands push and pop are recognized. + +.LP +The push command, then, accepts the options \-d, \-e, \-m +and \-M, with the same meaning described above. Unspecified options +retain the previous value and the resulting masks are used to reopen +the connection with the server. pop is used to pop the connection +stack. If an empty stack is popped the program exits. + +.LP +Other commands recognized are info, used to return the stack +depth; quit to prematurely terminate the program; and +snapshot to get some configuration information from the server. + +.LP +.SH BUGS +Beginning with release 1.16, \fBmev\fP no longer works under xterm. +Please use the \fBrmev\fP program (provided in the \fBsample\fP +directory) to watch gpm events under xterm or rxvt. \fBrmev\fP also +displays keyboard events besides mouse events. + +.LP +.SH AUTHOR +Alessandro Rubini <rubini@linux.it> +.br +Ian Zimmerman <itz@speakeasy.org> + +.LP +.SH FILES +.nf +/dev/gpmctl The socket used to connect to gpm. +.fi + +.LP +.SH SEE ALSO +.nf +\fB gpm(8) \fP The mouse server +\fB gpm-root(1) \fP An handler for Control-Mouse events. + +.fi +The info file about `gpm', which gives more complete information and +explains how to write a gpm client. |