1MEV(1)                      General Commands Manual                     MEV(1)
2
3
4

NAME

6       mev - a program to report mouse events
7

SYNOPSIS

9       mev [ options ]
10

DESCRIPTION

12       The `mev' program is part of the gpm package.  The information below is
13       extracted from the texinfo file,  which  is  the  preferred  source  of
14       information.
15
16
17       The  mev  program  is  modeled after xev. It prints to stdout the mouse
18       console events it gets.
19
20
21       mev's default behaviour is to get anything, but command  line  switches
22       can  be used to set the various fields in the Gpm_Connect structure, in
23       order to customize the program's behaviour. I'm  using  mev  to  handle
24       mouse events to Emacs.
25
26
27       Command line switches for mev are the following:
28
29       -C number
30              Select  a  virtual console to get events from.  This is intended
31              to be used for debugging.
32
33       -d number
34              Choose a default mask. By default the server gets any events not
35              belonging  to the event mask. The mask can be provided either as
36              a decimal number, or as a symbolic string.
37
38       -e number
39              Choose the event mask. By default any  event  is  received.  The
40              mask  can  be  provided either as a decimal number, or as a sym‐
41              bolic string.
42
43       -E     Enter emacs mode. In emacs mode  events  are  reported  as  lisp
44              forms  rather  than  numbers.  This is the format used by the t-
45              mouse package within emacs.
46
47       -f     Fit events inside the screen before reporting them. This options
48              re-fits  drag  events, which are allowed to exit the screen bor‐
49              der,
50
51
52       -i     Interactive. Accepts  input  from  stdin  to  change  connection
53              parameters.
54
55       -m number
56              Choose the minimum modifier mask. Any event with fewer modifiers
57              will not be reported to mev. It defaults to 0.  The mask must be
58              provided either as a decimal number, or as a symbolic string.
59
60       -M number
61              Choose  the  maximum modifier mask. Any event with more modifier
62              than specified will not be reported to mev.  It defaults to  ~0,
63              i.e.  all events are received.  The mask must be provided either
64              as a decimal number, or as a symbolic string.
65
66       -p     Requests to draw the pointer during drags. This option  is  used
67              by emacs to avoid invoking ioctl() from lisp code.
68
69
70       When  the arguments are not decimal integers, they are considered lists
71       of alphanumeric characters,  separated  by  a  single  non-alphanumeric
72       character. I use the comma (,), but any will do.
73
74
75       Allowed  names for events are move, drag, down or press, up or release,
76       motion (which is both move and drag), and hard.
77
78
79       Allowed names for modifiers are shift, leftAlt, rightAlt,  anyAlt  (one
80       or the other), control.
81
82
83       When  the  -i  switch  is specified, mev looks at its standard input as
84       command lines rather than events. The input lines are parsed,  and  the
85       commands push and pop are recognized.
86
87
88       The push command, then, accepts the options -d, -e, -m and -M, with the
89       same meaning described above. Unspecified options retain  the  previous
90       value  and  the  resulting masks are used to reopen the connection with
91       the server. pop is used to pop the connection stack. If an empty  stack
92       is popped the program exits.
93
94
95       Other  commands  recognized  are  info, used to return the stack depth;
96       quit to prematurely terminate the program; and  snapshot  to  get  some
97       configuration information from the server.
98
99

BUGS

101       Beginning  with  release 1.16, mev no longer works under xterm.  Please
102       use the rmev program (provided in the sample directory)  to  watch  gpm
103       events under xterm or rxvt.  rmev also displays keyboard events besides
104       mouse events.
105
106

AUTHOR

108       Alessandro Rubini <rubini@linux.it>
109       Ian Zimmerman <itz@speakeasy.org>
110
111

FILES

113       /dev/gpmctl The socket used to connect to gpm.
114
115

SEE ALSO

117        gpm(8)       The mouse server
118        gpm-root(1)  An handler for Control-Mouse events.
119
120       The info file about `gpm', which gives more  complete  information  and
121       explains how to write a gpm client.
122
123
124
1254th Berkeley Distribution        February 1995                          MEV(1)
Impressum