summaryrefslogtreecommitdiffstats
path: root/upstream/fedora-40/man1/mev.1
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/fedora-40/man1/mev.1')
-rw-r--r--upstream/fedora-40/man1/mev.1133
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.