Overhaul of bendin/bendout help patches.

Correct some errors and add a note about vanilla compatibility options.

pd/doc/5.reference/bendin-help.pd

-#N canvas 427 32 555 619 10;
+#N canvas 508 58 560 619 10;
 #X obj 0 595 cnv 15 552 21 empty \$0-pddp.cnv.footer empty 20 12 0
-14 -228856 -66577 0;
+14 #dcdcdc #404040 0;
 #X obj 0 0 cnv 15 552 40 empty \$0-pddp.cnv.header bendin 3 12 0 18
--204280 -1 0;
-#X obj 0 395 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13
--228856 -1 0;
+#c4dcdc #000000 0;
+#X obj 0 365 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13
+#dcdcdc #000000 0;
 #N canvas 477 282 494 344 META 0;
 #X text 12 105 LIBRARY internal;
 #X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/;
@@ -21,16 +21,16 @@ to conform to the PDDP template for Pd version 0.42.;
 #X text 12 85 OUTLET_1 float;
 #X text 12 165 RELEASE_DATE 1997;
 #X restore 500 597 pd META;
-#X obj 0 430 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0
-13 -228856 -1 0;
-#X obj 0 495 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12
-0 13 -228856 -1 0;
+#X obj 0 400 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0
+13 #dcdcdc #000000 0;
+#X obj 0 465 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12
+0 13 #dcdcdc #000000 0;
 #X obj 0 560 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12
-0 13 -228856 -1 0;
-#X text 98 439 float;
+0 13 #dcdcdc #000000 0;
+#X text 98 409 float;
 #N canvas 213 167 428 456 Related_objects 0;
 #X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0
-14 -204280 -1 0;
+14 #c4dcdc #000000 0;
 #X text 7 1 [bendin] Related Objects;
 #X obj 75 89 ctlin;
 #X obj 25 116 pgmin;
@@ -67,34 +67,58 @@ by Olaf Matthes);
 #X obj 186 365 chord;
 #X restore 101 597 pd Related_objects;
 #X obj 497 10 bendin;
-#X text 98 405 (none);
-#X obj 78 439 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856
--162280 0;
-#X obj 78 467 cnv 17 3 17 empty \$0-pddp.cnv.let.0 1 5 9 0 16 -228856
--162280 0;
-#X text 98 467 float;
-#X floatatom 148 171 5 0 0 0 - - -, f 5;
-#X floatatom 191 171 5 0 0 0 - - -, f 5;
-#X obj 148 144 bendin;
-#X text 85 221 The [bendin] object reads incoming pitch bend values
-and reports them. If started with no arguments it reports the channel
-number through the right outlet.;
-#X obj 260 144 bendin 2;
-#X floatatom 260 171 5 0 0 0 - - -, f 5;
-#X text 311 171 <-- pitch bend values on channel 2;
+#X text 98 375 (none);
+#X obj 78 409 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 #dcdcdc
+#9c9c9c 0;
+#X obj 78 437 cnv 17 3 17 empty \$0-pddp.cnv.let.0 1 5 9 0 16 #dcdcdc
+#9c9c9c 0;
+#X text 98 437 float;
+#X floatatom 138 81 5 0 0 0 - - -, f 5;
+#X floatatom 195 81 5 0 0 0 - - -, f 5;
+#X obj 138 54 bendin;
+#X obj 260 54 bendin 2;
+#X floatatom 260 81 5 0 0 0 - - -, f 5;
+#X text 311 81 <-- pitch bend values on channel 2;
 #X obj 99 564 pddp/pddplink all_about_midi_flags.pd -text all_about_midi_flags
 ;
 #X text 11 23 read incoming pitch bend values;
-#X text 167 514 - (optional) a single MIDI channel number from which
+#X text 167 484 - (optional) a single MIDI channel number from which
 to read. If the argument is present \, the [bendin] object does not
 show the second (right) outlet.;
-#X text 168 405 - [bendin] reads directly from the MIDI port.;
-#X text 168 439 - pitchbend value (a 14-bit integer).;
-#X text 168 467 - MIDI channel number (available unless argument is
+#X text 168 375 - [bendin] reads directly from the MIDI port.;
+#X text 168 437 - MIDI channel number (available unless argument is
 given).;
-#X text 80 514 1) float;
+#X text 80 484 1) float;
 #X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide
 ;
+#X floatatom 138 141 5 0 0 0 - - -, f 5;
+#X floatatom 195 141 5 0 0 0 - - -, f 5;
+#X floatatom 260 141 5 0 0 0 - - -, f 5;
+#X obj 138 114 bendin 0 1;
+#X obj 260 114 bendin 2 1;
+#X text 80 531 2) float;
+#X text 167 531 - (optional) flag. If nonzero \, [bendin] yields signed
+output values (-8192 - 8191).;
+#X text 168 409 - pitchbend value (signed range -8192 - 8191 by default).
+;
+#X text 37 120 unsigned values;
+#X text 48 66 signed values;
+#X text 7 135 (vanilla-compatible);
+#X text 85 171 The [bendin] object reads incoming pitch bend values
+and reports them. If invoked with no arguments (or a zero argument
+meaning "omni") it reports the channel number through the right outlet.
+;
+#X text 85 233 CAVEAT: In pd-l2ork \, for consistency with bendout
+\, bendin yields *signed* 14 bit values (-8192 - 8191) by default.
+However \, for compatibility with vanilla pd \, you can also make bendin
+use the *unsigned* 14 bit range (0 - 16384) by adding 1 (or any non-zero
+value) as the second argument. This also becomes the default if the
+-legacy-bendin option is specified on the command line. You can add
+that option to the startup flags in the preferences if you need out-of-the-box
+interoperability with vanilla Pd.;
 #X connect 16 0 14 0;
 #X connect 16 1 15 0;
-#X connect 18 0 19 0;
+#X connect 17 0 18 0;
+#X connect 30 0 27 0;
+#X connect 30 1 28 0;
+#X connect 31 0 29 0;

pd/doc/5.reference/bendout-help.pd

-#N canvas 432 35 555 619 10;
+#N canvas 432 38 556 623 10;
 #X obj 0 595 cnv 15 552 21 empty \$0-pddp.cnv.footer empty 20 12 0
-14 -228856 -66577 0;
+14 #dcdcdc #404040 0;
 #X obj 0 0 cnv 15 552 40 empty \$0-pddp.cnv.header bendout 3 12 0 18
--204280 -1 0;
+#c4dcdc #000000 0;
 #X obj 0 377 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13
--228856 -1 0;
+#dcdcdc #000000 0;
 #N canvas 489 282 494 344 META 0;
 #X text 12 105 LIBRARY internal;
 #X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/;
@@ -22,15 +22,15 @@ to conform to the PDDP template for Pd version 0.42.;
 #X text 12 165 RELEASE_DATE 2009;
 #X restore 500 597 pd META;
 #X obj 0 458 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0
-13 -228856 -1 0;
+13 #dcdcdc #000000 0;
 #X obj 0 486 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12
-0 13 -228856 -1 0;
+0 13 #dcdcdc #000000 0;
 #X obj 0 561 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12
-0 13 -228856 -1 0;
+0 13 #dcdcdc #000000 0;
 #X text 98 387 float;
 #N canvas 204 206 441 421 Related_objects 0;
 #X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0
-14 -204280 -1 0;
+14 #c4dcdc #000000 0;
 #X text 8 2 [bendout] Related Objects;
 #X obj 73 80 ctlin;
 #X obj 216 80 pgmin;
@@ -65,10 +65,10 @@ by Olaf Matthes);
 #X obj 22 390 pddp/helplink cyclone/midiflush;
 #X restore 101 598 pd Related_objects;
 #X text 98 462 (none);
-#X obj 78 387 cnv 17 3 35 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856
--162280 0;
-#X obj 78 430 cnv 17 3 17 empty \$0-pddp.cnv.let.0 1 5 9 0 16 -228856
--162280 0;
+#X obj 78 387 cnv 17 3 35 empty \$0-pddp.cnv.let.0 0 5 9 0 16 #dcdcdc
+#9c9c9c 0;
+#X obj 78 430 cnv 17 3 17 empty \$0-pddp.cnv.let.0 1 5 9 0 16 #dcdcdc
+#9c9c9c 0;
 #X text 98 430 float;
 #X obj 99 565 pddp/pddplink all_about_midi_flags.pd -text all_about_midi_flags
 ;
@@ -83,14 +83,14 @@ by Olaf Matthes);
 #X text 168 505 - (optional) the MIDI channel number to be written
 to. If no argument is given \, [bendout] defaults to channel 1 . The
 channel can be changed by sending an integer to the right inlet.;
-#X text 168 387 - pitchbend value (0-127).;
 #X text 168 430 - MIDI channel number (defaults to channel 1).;
-#X text 168 462 - [bendin] writes directly to the MIDI port.;
 #X text 80 505 1) float;
 #X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide
 ;
 #X text 98 407 list;
 #X text 168 407 - a list is distributed to the inlets.;
+#X text 168 387 - pitchbend value (-8192 - 8191).;
+#X text 168 462 - [bendout] writes directly to the MIDI port.;
 #X connect 15 0 17 0;
 #X connect 16 0 17 1;
 #X connect 18 0 20 0;