-
Notifications
You must be signed in to change notification settings - Fork 28
/
README
314 lines (219 loc) · 10.3 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
/*
* README -- gpm 1.xx
*
* Copyright 1995-2000 [email protected] (Alessandro Rubini)
* Copyright 2001-2012 nico-gpm at schottelius.org (Nico Schottelius)
*
*******/
The gpm (general purpose mouse) daemon tries to be a useful mouse
server for applications running on the Linux console. Its roots are
in the "selection" package, by Andrew Haylett, and the original code
comes from selection itself. This package is intended as a replacement
for "selection", to provide additional facilities. From 0.18 onward
gpm supports xterm as well, so you can run mouse-sensitive
applications under X, and you can easily write curses applications
which support the mouse on both the Linux console and xterm. The xterm
code is portable to any U*x flavour (look at sample/README).
The first clients have been "The Midnight Commander", by Miguel de
Icaza and an emacs library included in this release. Recent dialog
distributions and the Jed editor use gpm as well, and the same do
several custom applications.
If you want to make a patch to gpm, please read doc/HACK_GPM.
For additionally documentation and other READMEs have a look into doc/.
=========== MAINTENANCE
As of 1.19.4, gpm is officially maintained again.
Most of the README is written by Alessandro Rubine,
only minor changes are made by Nico Schottelius.
=========== MAILING LIST
The mailing list devoted to gpm is "[email protected]"
The list is managed by Mailman and is currently open,
so non-subscribers are allowed to post.
In order to subscribe to the mailing list, visit
http://lists.linux.it/listinfo/gpm
or send a message with "subscribe" in its body to
For example:
echo subscribe | mail [email protected]
=========== DOWNLOAD / HOMEPAGE
The latest releases can always be found in one of the following place:
http://www.nico.schottelius.org/software/gpm/archives/
Mirror:
ftp://arcana.linux.it/pub/gpm/
http://www.ar.linux.it/pub/gpm/
The homepage of gpm can be found at
http://www.nico.schottelius.org/software/gpm/
You can get the latest development tree of gpm via git:
git-clone git://git.schottelius.org/gpm
There are three branches available:
master: Contains the latest gpm1 code, may be broken.
gpm-1-stable: Contains the latest stable source code.
gpm-2-dev: Contains work that heads to gpm2.
=========== COMPILING AND INSTALLING
The package uses autoconf as of 2.12.
Use "./autogen.sh && ./configure && make" to
compile the gpm suite. To install "make install". This installs
everything under the "prefix" directory, which by default is
/usr/local.
Use "./configure --prefix=/usr" if you want to install under /usr
instead of /usr/local.
Exectuable files are installed in $(prefix)/bin (except the gpm daemon
in $(prefix)/sbin), libraries in $(prefix)/lib, man pages in
$(prefix)/man, the lisp library in the proper location for emacs-list
files (detected during the "configure" step); info files are installed
under $(prefix)/info.
If you would like to 'clean'up very tidy, use distclean. Don't forget to use
make distclean config! Otherwise there will be no configure script!
=========== CONFIGURING
Configuration is optional...
* You would like to tell emacs to use t-mouse.el when appropriate. Add
the following lines to your own .emacs (in your home
directory), or in the /usr/lib/emacs/site-lisp/default
(if (and (string-match ".*-linux" system-configuration)
(not window-system)
(or (string-match "linux" (getenv "TERM"))
(string-match "con.*" (getenv "TERM"))))
(load-library "t-mouse"))
* If you want to use gpm-root, copy gpm-root.conf to your /usr/etc
directory, test it out and then edit it to suit your feels.
* You'd like to name the gpm info file inside /usr/info/dir. Just insert
the line
* gpm: (gpm.info). A mouse server for the Linux console
at the proper place. Note that this is usually automatically
performed if you install a package prepared for your own
distribution.
* To invoke gpm (and gpm-root) at system boot, add something like this
to your /etc/rc.d/rc.local
/usr/sbin/gpm -t msc -m /dev/tts/0 &
/usr/bin/gpm-root &
If you are running the new setup of SysVinit, you should better
add a "gpm" script in /etc/rc.d/rc.init and install it in your
runlevels in the usual way (this is usually included in your
distribution as well)
You may want to put the mouse server at a higher priority: in
this case invoke instead "/usr/bin/nice -n -20 /usr/sbin/gpm -t
msc"
The program goes to the background by itself, unless
it is run with debuging enabled (see the -D option in the
documentation).
========== DOCS
The directory "./doc" holds the documentation. The release embeds a
postscript file, slightly reduced to save paper (doc/gpm2.ps), an info
one (doc/gpm.info) and a text-only version (doc/gpmdoc.txt -- but
without table of contents, for now). Man pages are automatically
extracted from the info file, and are installed with "make install"
=========== BUG REPORTS
Before sending bug reports, please look at the file "FAQ",
which outlines some known problems, and how to deal with them.
If your bug isn't fixed by reading there, please report it to me,
without getting angry with me if things don't work at first trial
(but they usually work).
Bug reports are best sent to the gpm mailing list (see above) or to me
via email, if you use personal mail please include the string "gpm"
somewhere in the subject line. This will help my filters in sorting
things out.
* When compilation fails I need your kernel version ("uname -a"), the
compiler version ("gcc -v") and the library version ("ls -l /lib" or,
better "ldd /usr/sbin/gpm"). And the compiler messages, obviously.
* When a program hangs or segfaults, please reinvoke the program under strace:
strace -tf -o /tmp/trace.gpm gpm -t msc
^^^^^^^^^^ put your true cmdline here.
Then send me /tmp/trace.gpm* (they may be one or two files, according
to the strace version), and a description of how you reproduce the problem.
The last resort is a core dump, but I'll ask it personally if I have real
difficulties in tracing out your problem.
=========== CREDITS
The following people contributed to gpm, in chronological order. This
list used to reside in a different file, but it's better for it to stand
out in the README
Andrew Haylett ([email protected])
donated "selection" to the linux community, so I could get
the idea and the code. A few others contributed to selection,
but I lost track of their contributions and names.
Steven S. Dick ([email protected])
fixed a pair of bugs in early gpm versions.
Miguel de Icaza ([email protected])
helped fixing some bugs and provided a good client to test
my server. He helped a lot in testing the various pre-releases.
Olav Woelfelschneider ([email protected])
fixed 0.10 with MouseSystems compatible mice.
Janne Kukonlehto ([email protected])
provided xterm mouse decoding to be stolen by me.
Rick Lyons ([email protected])
fixed a bug in gpm-0.9.
Reuben Sumner ([email protected])
helped fixing behaviour with "-t bm".
Larry Bartholdi ([email protected])
pinpointed an error in t-mouse-suspend
and provided good suggestions for 0.97.
Mark Lord ([email protected])
ported to Dexxa/Logitech mice and gave feedback several times.
Stefan Giessler ([email protected])
fixed some problems with gpm-root and
suggested to put gpm in the background (0.97).
Roman Shapiro
helped with the Logitech MouseMan.
Andries Brouwer ([email protected])
Provided a Latin-1 LUT for chars, and enhanced
lut-loading code (0.98).
Adrian Johnson ([email protected])
Gave good feedback and ideas for the 0.98's
Stephen Lee ([email protected])
Helped a lot with the damned MouseMan protocol (0.98 and 1.0)
John van Leeuwen ([email protected])
Outlined and fixed a pair of bugs in gpm-root 0.98
Alvar Bray ([email protected])
Pointed out an error with awk (0.99)
David A. van Leeuwen ([email protected])
Helped with chord-middle protocols (1.0)
Pavel Kankovsky ([email protected])
Open /dev/ttyxx instead of /dev/console in the lib (1.01)
Mark Shadley ([email protected])
Helped in turning to ELF (1.01 and 1.02) and in fixing
horrible bugs of mine. Without his help 1.03 wouldn't be there.
Lou Sortman ([email protected])
Added support for glidepoint mice within "-t mman". (1.05)
Marc Meis ([email protected])
Provided support for absolute pointing devices, and in
particular for the ncr3125 pen. (1.05)
Michael Plass ([email protected])
Fixed a damned bug in middle button decoding (M_ms) (1.07)
Markus Gutschke ([email protected])
Provided a better re-encoding for "-R" (1.10)
Karsten Ballueder ([email protected])
Suggested the reboot compile-time option (1.10)
John Davis ([email protected])
Found and fixed a buglet in liblow.c for some jed users (1.10)
Julian Thompson ([email protected])
Fixed a buglet in gpm-root (1.10)
Dave Flater ([email protected])
Removed a typo in the disabled decoder for ms-3b (1.11)
Thomas E. Dickey ([email protected])
Ported to autoconf (1.11)
Pavel Machek ([email protected])
New mode "logim" (1.11) and NetMouse (1.14)
Matthias Grimrath ([email protected])
Be c++ compliant in gpm.h (1.11)
Stephen Tell ([email protected])
Patch for the ps2 decoder to support misbehaving devices (1.11)
Francois Chastrette (no-email)
Great help to support plugnpray mice (1.13)
Steve Bennett ([email protected])
Support for the intellimouse serial devices. (1.13)
Jan Daciuk ([email protected])
t-mouse: yet another regexp possibility
Ian Zimmerman is now actively cooperating in maintaining gpm, so
he'll no longer appear in the acknowledgements ;-)
David Given ([email protected])
Offered support for joystick mouse emulation (1.14)
Tim Goodwin ([email protected])
Colin Plumb ([email protected])
Ben Pfaff ([email protected])
Ian and Iris ([email protected])
All of them sent in support for ps2 intellimouse (1.14)
Edmund Grimley Evans ([email protected])
Added "-t ms+lr"
Stefan Runker ([email protected])
Contributed a new Wacom decoder
Alessandro Rubini ([email protected])
He's done a lot of work on gpm and maintained it.
He's still helping me a lot to understand all parts of gpm.