MEV(1)

NAME
       mev - a program to report mouse events

SYNOPSIS
       mev [ options ]

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.

       The  mev program is modeled after xev. It prints to stdout
       the console  events  it  gets,  both  keyboard  and  mouse
       events.

       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
       Emacs Support.

       Command line switches for mev are the following:

       -C number
              Select  a virtual console to get events from.  This
              is intended to be used for debugging.

       -d number
              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.

       -e number
              Choose  the  event  mask.  By  default any event is
              received. The mask can be provided either as a dec-
              imal number, or as a symbolic string.

       -E     Enter emacs mode. In emacs mode events are reported
              as lisp forms rather than numbers. This is the for-
              mat used by the t-mouse package within emacs.

       -f     Fit events inside the screen before reporting them.
              This options re-fits drag events, which are allowed
              to exit the screen border, Margins.

       -i     Interactive.  Accepts  input  from  stdin to change
              connection parameters.

       -m number
              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.

       -M number
              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.

       -p     Requests  to  draw  the  pointer during drags. This
              option is used by emacs to avoid  invoking  ioctl()
              from lisp code.

       When the arguments are not decimal integers, they are con-
       sidered lists of alphanumeric characters, separated  by  a
       single  non-alphanumeric character. I use the comma ``,'',
       but any will do.

       Allowed names for events are move, drag, down or press, up
       or  release,  motion  (which  is  both move adn drag), and
       hard.

       Allowed names for modifiers are shift, leftAlt,  rightAlt,
       anyAlt (one or the other), control.

       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.

       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.

       The  only  other  commands  recognized  are  info, used to
       return the stack depth, and quit to premautrely  terminate
       the program.

AUTHOR
       Alessandro Rubini lt;rubini@ipvvis.unipv.it

FILES
       /var/run/gpmctl The socket used to connect to gpm.

SEE ALSO
       gpm(1) The mouse server 
       gpm-root(1) An handler for Control-Mouse events. 

       The  info  file  about  `gpm',  which  gives more complete
       information and explains how to write a gpm client.