added new rawhid help files

svn path=/trunk/; revision=1193

9 files changed, 478 insertions, 128 deletions

diff --git a/externals/build/doc/help-linuxevent.pd b/externals/build/doc/help-linuxevent.pd
deleted file mode 100644
index 9e6be44e..00000000
--- a/externals/build/doc/help-linuxevent.pd
+++ /dev/null
@@ -1,14 +0,0 @@
-#N canvas 454 205 450 300 10;
-#X floatatom 244 176 5 0 0 3 code - -;
-#X floatatom 303 176 5 0 0 3 value - -;
-#X floatatom 185 176 4 0 0 3 type - -;
-#X floatatom 112 176 9 0 0 3 time - -;
-#X msg 176 53 start;
-#X msg 187 91 stop;
-#X obj 126 123 linuxevent /dev/input/event0;
-#X connect 4 0 6 0;
-#X connect 5 0 6 0;
-#X connect 6 0 3 0;
-#X connect 6 1 2 0;
-#X connect 6 2 0 0;
-#X connect 6 3 1 0;
diff --git a/externals/build/doc/help-linuxjoystick.pd b/externals/build/doc/help-linuxjoystick.pd
deleted file mode 100644
index 0c37469e..00000000
--- a/externals/build/doc/help-linuxjoystick.pd
+++ /dev/null
@@ -1,98 +0,0 @@
-#N canvas 61 386 886 505 10;
-#X msg 192 64 start;
-#X msg 203 95 stop;
-#X floatatom 397 180 2 0 0 3 button# - -;
-#X floatatom 454 179 2 0 0 3 button_value - -;
-#X floatatom 143 180 5 0 0 3 y-axis - -;
-#X floatatom 95 180 5 0 0 3 x-axis - -;
-#X floatatom 242 181 3 0 0 3 hat-X - -;
-#X floatatom 288 181 3 0 0 3 hat-Y - -;
-#X floatatom 192 181 5 0 0 3 twist - -;
-#X floatatom 331 180 5 0 0 3 throttle - -;
-#X obj 192 123 linuxjoystick /dev/input/event1;
-#X obj 299 309 select 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18
-19 20 21;
-#X obj 297 354 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
--1;
-#X obj 313 355 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
--1;
-#X obj 333 354 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
--1;
-#X obj 351 354 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
--1;
-#X obj 370 353 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
--1;
-#X obj 389 354 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
--1;
-#X obj 409 353 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
--1;
-#X obj 734 354 bng 30 250 50 0 empty empty not_recognized 0 -6 0 8
--261689 -1 -1;
-#X obj 689 352 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
--1;
-#X obj 667 350 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
--1;
-#X obj 647 351 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
--1;
-#X obj 631 354 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
--1;
-#X obj 613 352 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
--1;
-#X obj 596 350 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
--1;
-#X obj 579 352 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
--1;
-#X obj 561 351 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
--1;
-#X obj 541 349 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
--1;
-#X obj 523 351 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
--1;
-#X obj 503 350 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
--1;
-#X obj 485 351 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
--1;
-#X obj 466 351 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
--1;
-#X obj 447 353 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
--1;
-#X obj 428 353 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
--1;
-#X obj 439 220 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
--1;
-#X connect 0 0 10 0;
-#X connect 1 0 10 0;
-#X connect 2 0 11 0;
-#X connect 3 0 35 0;
-#X connect 10 0 5 0;
-#X connect 10 1 4 0;
-#X connect 10 2 8 0;
-#X connect 10 3 6 0;
-#X connect 10 4 7 0;
-#X connect 10 5 9 0;
-#X connect 10 6 2 0;
-#X connect 10 7 3 0;
-#X connect 11 0 12 0;
-#X connect 11 1 13 0;
-#X connect 11 2 14 0;
-#X connect 11 3 15 0;
-#X connect 11 4 16 0;
-#X connect 11 5 17 0;
-#X connect 11 6 18 0;
-#X connect 11 7 34 0;
-#X connect 11 8 33 0;
-#X connect 11 9 32 0;
-#X connect 11 10 31 0;
-#X connect 11 11 30 0;
-#X connect 11 12 29 0;
-#X connect 11 13 28 0;
-#X connect 11 14 27 0;
-#X connect 11 15 26 0;
-#X connect 11 16 25 0;
-#X connect 11 17 24 0;
-#X connect 11 18 23 0;
-#X connect 11 19 22 0;
-#X connect 11 20 21 0;
-#X connect 11 21 20 0;
-#X connect 11 22 19 0;
-#X connect 35 0 2 0;
diff --git a/externals/build/doc/help-linuxmouse.pd b/externals/build/doc/help-linuxmouse.pd
deleted file mode 100644
index e7352962..00000000
--- a/externals/build/doc/help-linuxmouse.pd
+++ /dev/null
@@ -1,16 +0,0 @@
-#N canvas 454 205 450 300 10;
-#X floatatom 258 160 5 0 0 3 button# - -;
-#X floatatom 321 162 5 0 0 3 button_value - -;
-#X floatatom 175 160 2 0 0 3 wheel - -;
-#X floatatom 99 161 4 0 0 3 y-axis - -;
-#X floatatom 24 162 4 0 0 3 x-axis - -;
-#X obj 75 110 linuxmouse /dev/input/event0;
-#X msg 125 40 start;
-#X msg 136 78 stop;
-#X connect 5 0 4 0;
-#X connect 5 1 3 0;
-#X connect 5 2 2 0;
-#X connect 5 3 0 0;
-#X connect 5 4 1 0;
-#X connect 6 0 5 0;
-#X connect 7 0 5 0;
diff --git a/externals/build/doc/help-ifeel.pd b/externals/build/doc/ifeel-help.pd
index 7001c79d..7001c79d 100644
--- a/externals/build/doc/help-ifeel.pd
+++ b/externals/build/doc/ifeel-help.pd
diff --git a/externals/build/doc/linuxevent-help.pd b/externals/build/doc/linuxevent-help.pd
new file mode 100644
index 00000000..9b0971ac
--- /dev/null
+++ b/externals/build/doc/linuxevent-help.pd
@@ -0,0 +1,223 @@
+#N canvas 287 167 569 543 10;
+#X floatatom 241 326 5 0 0 3 code - -;
+#X floatatom 305 326 5 0 0 3 value - -;
+#X floatatom 177 326 4 0 0 3 type - -;
+#X floatatom 104 326 9 0 0 3 time - -;
+#X msg 172 202 start;
+#X msg 173 224 stop;
+#X obj 114 303 linuxevent /dev/input/event0;
+#X obj 114 184 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 25 184 metro 20;
+#X text 293 260 time between polls (ms);
+#X obj 25 162 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X msg 45 162 stop;
+#X msg 226 260 delay 20;
+#X obj 114 135 key;
+#N canvas 278 328 611 524 Event_Codes 0;
+#X text 28 48 (For a complete listing of Linux Input Events \, see
+/usr/include/linux/input.h.);
+#X obj 11 9 cnv 15 580 30 empty empty Event_Codes 20 12 1 14 -225271
+-66577 0;
+#X text 32 118 EVENT CODE;
+#X text 162 118 #define;
+#X text 232 118 number;
+#X text 32 133 -----------------------------------;
+#X text 32 148 X Axis;
+#X text 32 163 Y Axis;
+#X text 32 178 Z Axis;
+#X text 32 193 Horizontal Wheel;
+#X text 32 208 Dial;
+#X text 32 223 Wheel;
+#X text 32 238 Misc;
+#X text 162 148 REL_X;
+#X text 162 163 REL_Y;
+#X text 162 178 REL_Z;
+#X text 162 193 REL_HWHEEL;
+#X text 162 208 REL_DIAL;
+#X text 162 223 REL_WHEEL;
+#X text 162 238 REL_MISC;
+#X text 232 148 0;
+#X text 232 163 1;
+#X text 232 178 2;
+#X text 232 193 6;
+#X text 232 208 7;
+#X text 232 223 8;
+#X text 232 238 9;
+#X text 307 118 EVENT CODE;
+#X text 457 118 #define;
+#X text 547 118 number;
+#X text 307 148 Absolute X;
+#X text 307 163 Absolute Y;
+#X text 307 178 Absolute Z;
+#X text 307 193 RX;
+#X text 307 208 RY;
+#X text 307 223 RZ;
+#X text 307 238 Throttle;
+#X text 307 253 Rudder;
+#X text 307 268 Wheel;
+#X text 307 283 Gas Pedal;
+#X text 307 298 Brake Pedal;
+#X text 307 313 Hat Switch 0 X-axis;
+#X text 307 328 Hat Switch 0 Y-axis;
+#X text 307 343 Hat Switch 1 X-axis;
+#X text 307 358 Hat Switch 1 Y-axis;
+#X text 307 373 Hat Switch 2 X-axis;
+#X text 307 388 Hat Switch 2 Y-axis;
+#X text 307 403 Hat Switch 3 X-axis;
+#X text 307 418 Hat Switch 3 Y-axis;
+#X text 307 433 Pressure;
+#X text 307 448 Distance;
+#X text 307 463 Tilt X-Axis;
+#X text 307 478 Tilt Y-Axis;
+#X text 307 493 Misc;
+#X text 457 148 ABS_X;
+#X text 457 163 ABS_Y;
+#X text 457 178 ABS_Z;
+#X text 457 193 ABS_RX;
+#X text 457 208 ABS_RY;
+#X text 457 223 ABS_RZ;
+#X text 457 238 ABS_THROTTLE;
+#X text 457 253 ABS_RUDDER;
+#X text 457 268 ABS_WHEEL;
+#X text 457 283 ABS_GAS;
+#X text 457 298 ABS_BRAKE;
+#X text 457 313 ABS_HAT0X;
+#X text 457 328 ABS_HAT0Y;
+#X text 457 343 ABS_HAT1X;
+#X text 457 358 ABS_HAT1Y;
+#X text 457 373 ABS_HAT2X;
+#X text 457 388 ABS_HAT2Y;
+#X text 457 403 ABS_HAT3X;
+#X text 457 418 ABS_HAT3Y;
+#X text 457 433 ABS_PRESSURE;
+#X text 457 448 ABS_DISTANCE;
+#X text 457 463 ABS_TILT_X;
+#X text 457 478 ABS_TILT_Y;
+#X text 457 493 ABS_MISC;
+#X text 547 148 0;
+#X text 547 163 1;
+#X text 547 178 2;
+#X text 547 193 3;
+#X text 547 208 4;
+#X text 547 223 5;
+#X text 547 238 6;
+#X text 547 253 7;
+#X text 547 268 8;
+#X text 547 283 9;
+#X text 547 298 10;
+#X text 547 313 16;
+#X text 547 328 17;
+#X text 547 343 18;
+#X text 547 358 19;
+#X text 547 373 20;
+#X text 547 388 21;
+#X text 547 403 22;
+#X text 547 418 23;
+#X text 547 433 24;
+#X text 547 448 25;
+#X text 547 463 26;
+#X text 547 478 27;
+#X text 547 493 28;
+#X obj 30 89 cnv 15 250 25 empty empty Relative_Axes 20 12 1 12 -241660
+-66577 0;
+#X obj 308 89 cnv 15 280 25 empty empty Absolute_Axes 20 12 1 12 -241660
+-66577 0;
+#X text 307 133 ----------------------------------------;
+#X restore 439 368 pd Event_Codes;
+#N canvas 546 568 420 271 Event_Types 0;
+#X text 28 48 (For a complete listing of Linux Input Events \, see
+/usr/include/linux/input.h.);
+#X text 84 94 EVENT TYPE;
+#X text 84 109 -----------------------------------;
+#X text 84 124 RST;
+#X text 84 139 Keys and Buttons;
+#X text 84 154 Relative Axes;
+#X text 84 169 Absolute Axes;
+#X text 84 184 Misc Events;
+#X text 84 199 LED Event;
+#X text 84 214 Sounds;
+#X text 84 229 Autorepeat Values;
+#X text 84 244 Force Feedback;
+#X text 214 94 #define;
+#X text 214 124 EV_RST;
+#X text 214 139 EV_KEY;
+#X text 214 154 EV_REL;
+#X text 214 169 EV_ABS;
+#X text 214 184 EV_MSC;
+#X text 214 199 EV_LED;
+#X text 214 214 EV_SND;
+#X text 214 229 EV_REP;
+#X text 214 244 EV_FF;
+#X text 284 94 number;
+#X text 284 124 0;
+#X text 284 139 1;
+#X text 284 154 2;
+#X text 284 169 3;
+#X text 284 184 4;
+#X text 284 199 17;
+#X text 284 214 18;
+#X text 284 229 20;
+#X text 284 244 21;
+#X obj 11 9 cnv 15 400 30 empty empty Event_Types 20 12 1 14 -262131
+-66577 0;
+#X restore 439 348 pd Event_Types;
+#N canvas 0 0 450 300 Event_Values 0;
+#X text 28 48 (For a complete listing of Linux Input Events \, see
+/usr/include/linux/input.h.);
+#X obj 11 9 cnv 15 400 30 empty empty Event_Values 20 12 1 14 -261681
+-66577 0;
+#X restore 439 388 pd Event_Values;
+#X text 8 373 Check the Pd console for supported event types and codes.
+This object will report them when it opens a device.;
+#X obj 9 8 cnv 15 550 30 empty empty linuxevent 20 12 1 16 -228992
+-66577 0;
+#X text 17 50 [linuxevent] outputs raw events from the Linux Event
+system. It is used for access the output of various Human Interface
+Devices \, like mice \, joysticks \, tablets \, etc.;
+#X text 346 18 related HID objects:;
+#X obj 497 17 linuxhid;
+#X text 33 111 bang to get an update when polling is stopped.;
+#X msg 236 201 poll;
+#X msg 236 223 nopoll;
+#X text 153 183 start/stop polling (synonyms for the same thing);
+#X obj 114 155 sel 98;
+#X text 160 155 <- (type 'b' for a bang);
+#X text 15 413 Here's an example for using a joystick:;
+#X msg 72 441 start;
+#X msg 116 441 stop;
+#X obj 82 469 linuxevent-joystick /dev/input/event1;
+#X floatatom 336 498 2 0 0 3 button# - -;
+#X floatatom 393 497 2 0 0 3 button_value - -;
+#X floatatom 82 498 5 0 0 3 y-axis - -;
+#X floatatom 35 498 5 0 0 3 x-axis - -;
+#X floatatom 181 499 3 0 0 3 hat-X - -;
+#X floatatom 227 499 3 0 0 3 hat-Y - -;
+#X floatatom 131 499 5 0 0 3 twist - -;
+#X floatatom 270 498 5 0 0 3 throttle - -;
+#X connect 4 0 6 0;
+#X connect 5 0 6 0;
+#X connect 6 0 3 0;
+#X connect 6 1 2 0;
+#X connect 6 2 0 0;
+#X connect 6 3 1 0;
+#X connect 7 0 6 0;
+#X connect 8 0 6 0;
+#X connect 10 0 8 0;
+#X connect 11 0 8 0;
+#X connect 12 0 6 0;
+#X connect 13 0 26 0;
+#X connect 23 0 6 0;
+#X connect 24 0 6 0;
+#X connect 26 0 7 0;
+#X connect 29 0 31 0;
+#X connect 30 0 31 0;
+#X connect 31 0 35 0;
+#X connect 31 1 34 0;
+#X connect 31 2 38 0;
+#X connect 31 3 36 0;
+#X connect 31 4 37 0;
+#X connect 31 5 39 0;
+#X connect 31 6 32 0;
+#X connect 31 7 33 0;
diff --git a/externals/build/doc/linuxevent-joystick.pd b/externals/build/doc/linuxevent-joystick.pd
new file mode 100644
index 00000000..029b7f33
--- /dev/null
+++ b/externals/build/doc/linuxevent-joystick.pd
@@ -0,0 +1,76 @@
+#N canvas 455 201 722 483 10;
+#X msg 35 43 start;
+#X msg 44 62 stop;
+#X obj 16 9 inlet;
+#X obj 79 116 pack f f f;
+#X obj 137 159 print UNKNOWN_JOYSTICK_EVENT_TYPE;
+#X text 148 139 types (1=buttons 3=abs axes);
+#X obj 167 256 print UNKNOWN_JOYSTICK_EVENT_CODE;
+#X obj 275 409 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 306 409 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 337 409 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 369 408 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 400 408 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 431 409 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 557 410 bng 30 250 50 0 empty empty not_routed 33 6 1 8 -262144
+-1 -1;
+#X obj 275 386 route 288 289 290 291 292 293 294 295 296;
+#X obj 464 409 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 493 408 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 525 408 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 79 139 route 3 1;
+#X obj 38 378 outlet;
+#X obj 59 357 outlet;
+#X obj 80 337 outlet;
+#X obj 102 317 outlet;
+#X obj 123 297 outlet;
+#X obj 144 277 outlet;
+#X text 52 214 codes (0=X 1=Y 6=throttle 7=rudder \, 16=hat0X \, 17=hat0Y)
+;
+#X obj 456 338 outlet;
+#X text 446 354 button_num;
+#X text 537 355 button_value;
+#X obj 556 339 outlet;
+#X obj 456 272 unpack f f;
+#X obj 456 308 - 288;
+#X obj 16 86 linuxevent \$1;
+#X obj 38 234 route 0 1 7 16 17 6;
+#X connect 0 0 32 0;
+#X connect 1 0 32 0;
+#X connect 2 0 32 0;
+#X connect 3 0 18 0;
+#X connect 14 0 7 0;
+#X connect 14 1 8 0;
+#X connect 14 2 9 0;
+#X connect 14 3 10 0;
+#X connect 14 4 11 0;
+#X connect 14 5 12 0;
+#X connect 14 6 15 0;
+#X connect 14 7 16 0;
+#X connect 14 8 17 0;
+#X connect 14 9 13 0;
+#X connect 18 0 33 0;
+#X connect 18 1 14 0;
+#X connect 18 1 30 0;
+#X connect 18 2 4 0;
+#X connect 30 0 31 0;
+#X connect 30 1 29 0;
+#X connect 31 0 26 0;
+#X connect 32 1 3 0;
+#X connect 32 2 3 1;
+#X connect 32 3 3 2;
+#X connect 33 0 19 0;
+#X connect 33 1 20 0;
+#X connect 33 2 21 0;
+#X connect 33 3 22 0;
+#X connect 33 4 23 0;
+#X connect 33 5 24 0;
diff --git a/externals/build/doc/linuxhid.pd b/externals/build/doc/linuxhid.pd
new file mode 100644
index 00000000..96440fa2
--- /dev/null
+++ b/externals/build/doc/linuxhid.pd
@@ -0,0 +1,12 @@
+#N canvas 618 332 428 305 10;
+#X obj 13 10 cnv 15 400 40 empty empty Linux_HID 20 12 1 18 -261689
+-66577 0;
+#X text 28 96 Raw access to the mouse output \, not tied to the sccreen
+borders.;
+#X text 22 169 Raw access to the joystick output with a fixed number
+of outlets.;
+#X text 22 239 Raw access to the output of the Linux Event system.
+;
+#X obj 16 75 linuxmouse;
+#X obj 18 219 linuxevent;
+#X obj 16 146 linuxjoystick;
diff --git a/externals/build/doc/linuxjoystick-help.pd b/externals/build/doc/linuxjoystick-help.pd
new file mode 100644
index 00000000..874aaa5d
--- /dev/null
+++ b/externals/build/doc/linuxjoystick-help.pd
@@ -0,0 +1,125 @@
+#N canvas 107 356 731 483 10;
+#X floatatom 324 292 2 0 0 3 button# - -;
+#X floatatom 381 291 2 0 0 3 button_value - -;
+#X floatatom 70 292 5 0 0 3 y-axis - -;
+#X floatatom 23 292 5 0 0 3 x-axis - -;
+#X floatatom 169 293 3 0 0 3 hat-X - -;
+#X floatatom 215 293 3 0 0 3 hat-Y - -;
+#X floatatom 119 293 5 0 0 3 twist - -;
+#X floatatom 258 292 5 0 0 3 throttle - -;
+#X obj 119 235 linuxjoystick /dev/input/event1;
+#X obj 211 364 select 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18
+19 20 21;
+#X obj 211 403 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 229 403 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 248 403 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 266 403 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 285 403 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 303 403 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 322 403 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 629 403 bng 30 250 50 0 empty empty not_recognized 0 -6 0 8
+-261689 -1 -1;
+#X obj 600 403 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 581 403 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 563 403 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 544 403 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 526 403 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 507 403 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 489 403 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 470 403 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 452 403 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 433 403 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 415 403 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 396 403 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 377 403 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 359 403 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 340 403 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 366 332 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 20 9 cnv 15 700 30 empty empty linuxjoystick 20 12 1 16 -257472
+-66577 0;
+#X text 502 17 related HID objects:;
+#X obj 653 16 linuxhid;
+#X msg 214 136 start;
+#X msg 214 157 stop;
+#X obj 156 118 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 67 118 metro 20;
+#X text 335 194 time between polls (ms);
+#X obj 67 96 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X msg 87 96 stop;
+#X msg 268 194 delay 20;
+#X obj 156 69 key;
+#X msg 278 135 poll;
+#X msg 278 156 nopoll;
+#X text 195 117 start/stop polling (synonyms for the same thing);
+#X obj 156 89 sel 98;
+#X text 202 89 <- (type 'b' for a bang);
+#X connect 0 0 9 0;
+#X connect 1 0 33 0;
+#X connect 8 0 3 0;
+#X connect 8 1 2 0;
+#X connect 8 2 6 0;
+#X connect 8 3 4 0;
+#X connect 8 4 5 0;
+#X connect 8 5 7 0;
+#X connect 8 6 0 0;
+#X connect 8 7 1 0;
+#X connect 9 0 10 0;
+#X connect 9 1 11 0;
+#X connect 9 2 12 0;
+#X connect 9 3 13 0;
+#X connect 9 4 14 0;
+#X connect 9 5 15 0;
+#X connect 9 6 16 0;
+#X connect 9 7 32 0;
+#X connect 9 8 31 0;
+#X connect 9 9 30 0;
+#X connect 9 10 29 0;
+#X connect 9 11 28 0;
+#X connect 9 12 27 0;
+#X connect 9 13 26 0;
+#X connect 9 14 25 0;
+#X connect 9 15 24 0;
+#X connect 9 16 23 0;
+#X connect 9 17 22 0;
+#X connect 9 18 21 0;
+#X connect 9 19 20 0;
+#X connect 9 20 19 0;
+#X connect 9 21 18 0;
+#X connect 9 22 17 0;
+#X connect 33 0 0 0;
+#X connect 37 0 8 0;
+#X connect 38 0 8 0;
+#X connect 39 0 8 0;
+#X connect 40 0 8 0;
+#X connect 42 0 40 0;
+#X connect 43 0 40 0;
+#X connect 44 0 8 0;
+#X connect 45 0 49 0;
+#X connect 46 0 8 0;
+#X connect 47 0 8 0;
+#X connect 49 0 39 0;
diff --git a/externals/build/doc/linuxmouse-help.pd b/externals/build/doc/linuxmouse-help.pd
new file mode 100644
index 00000000..067733a4
--- /dev/null
+++ b/externals/build/doc/linuxmouse-help.pd
@@ -0,0 +1,42 @@
+#N canvas 112 187 450 441 10;
+#X floatatom 238 220 5 0 0 3 button# - -;
+#X floatatom 299 220 5 0 0 3 button_value - -;
+#X floatatom 190 220 2 0 0 3 wheel - -;
+#X floatatom 137 220 4 0 0 3 y-axis - -;
+#X floatatom 79 220 4 0 0 3 x-axis - -;
+#X obj 95 193 linuxmouse /dev/input/event0;
+#X obj 18 6 cnv 15 400 30 empty empty linuxmouse 20 12 1 16 -225280
+-66577 0;
+#X text 206 17 related HID objects:;
+#X obj 357 16 linuxhiderfic;
+#X text 24 263 [linuxmouse] takes events directly from a Linux event
+device \, so that you get mouse data regardless of whether Pd has focus.
+Also \, the data from the event system is relative and limited to the
+screen size.;
+#X msg 51 71 start;
+#X msg 51 93 stop;
+#X msg 115 70 poll;
+#X msg 115 92 nopoll;
+#X text 24 335 Rather than polling like the other linuxhid objects
+\, [linuxmouse] uses a pollfn so it receives events as they happen.
+A pollfn listens to a network socket \, and takes action upon activity.
+Since all mouse events go through the network socket between pd and
+pd-gui \, this works for responding to mouse events.;
+#X msg 158 165 close;
+#X text 179 91 (synonyms for the same actions);
+#X text 182 75 start/stop polling;
+#X msg 147 122 open;
+#X msg 152 142 open /dev/input/event1;
+#X text 183 123 opens the previous device;
+#X connect 5 0 4 0;
+#X connect 5 1 3 0;
+#X connect 5 2 2 0;
+#X connect 5 3 0 0;
+#X connect 5 4 1 0;
+#X connect 10 0 5 0;
+#X connect 11 0 5 0;
+#X connect 12 0 5 0;
+#X connect 13 0 5 0;
+#X connect 15 0 5 0;
+#X connect 18 0 5 0;
+#X connect 19 0 5 0;