.\" Copyright (C) 1995, 1996, 1997, and 1998 WIDE Project.
.\" All rights reserved.
.\" 
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. Neither the name of the project nor the names of its contributors
.\"    may be used to endorse or promote products derived from this software
.\"    without specific prior written permission.
.\" 
.\" THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\"     $Id: xmindpath.1,v 1.6 1998/09/30 23:55:22 itojun Exp $
.\"
.Dd August 22, 1998
.Dt XMINDPATH 1
.Os MAGICPOINT
.\"
.Sh NAME
.Nm xmindpath
.Nd MindPath PocketPoint user-level driver for X11
.\"
.Sh SYNOPSIS
.Nm
.Op Fl dv
.Op Fl f Ar dev
.\"
.Sh DESCRIPTION
.Nm
reads signal sent from MindPath PocketPoint device via serial port,
and translate that into X11 event.
.Pp
PocketPoint is a laser pointer, with three remote control keys.
Three keys are right arrow, left arrow and "f/x" key.
Keypress will be transmitted as 1200bps IrDA signal,
which can be parsed by your computer.
.Nm
parses the IrDA input signal, and maps the keypress as follows:
.Bl -tag -width indent
.It right arrow
Mouse button 1 (leftmost mouse button).
This key will be interpreted by
.Xr mgp 1
as "proceed page" request.
.It left arrow
Mouse button 3 (rightmost mouse button).
This key will be interpreted by
.Xr mgp 1
as "go back one page" request.
.It "f/x" key
Currently mouse button 2 (middle mouse button) is mapped to this key.
However, this will be changed in the near future.
.El
.Pp
To perform remote-controlled presentation,
invoke
.Nm
simultaneously with
.Xr mgp 1
.Po
maybe from other terminal window
.Pc .
.Pp
If you specify
.Ar dev
after
.Fl f ,
the specified device will be used as serial port.
With
.Fl v ,
.Nm
will generate more messages.
.Fl d
option is provided just for debugging sessions.
.\"
.Sh RETURN VALUES
The program exits with 0 on success, non-zero on failures.
.\"
.Sh SEE ALSO
.Xr mgp 1 .
.Pp
MindPath PocketPoint:
.Li http://www.mindpath.com/ppoint.htm
.\"
.Sh HISTORY
The
.Nm
command was implemented by Jun-ichiro Itoh
.Li <itojun@itojun.org> .
.Pp
This program derives most of its X11 related code from twiddler driver.
.Sh BUGS
Keycode for "f/x" key should be configurable.
BSDI
.Xr gettyd 8
support would be desirable.