added in documentation of Pd oddities that I generated in response to the thread on pd-dev about Miller's new [list] object

svn path=/trunk/; revision=3383

1 files changed, 188 insertions, 66 deletions

diff --git a/doc/pddp/route-help.pd b/doc/pddp/route-help.pd
index bb87e568..b4dcca5f 100644
--- a/doc/pddp/route-help.pd
+++ b/doc/pddp/route-help.pd
@@ -1,13 +1,9 @@
-#N canvas 103 43 1019 657 10;
-#X obj 7 331 print x1;
-#X obj 69 331 print x2;
-#X obj 131 331 print x3;
-#X obj 194 331 print x4;
+#N canvas 190 100 1023 661 10;
 #X obj 82 273 route 23 54 1;
 #X msg 170 239 54 43;
 #X msg 212 239 1 foo bar;
 #X obj 141 418 route big apple;
-#X msg 351 386 1 2 3;
+#X msg 351 376 1 2 3;
 #X msg 248 376 big apple pie;
 #X msg 320 238 walk the dog;
 #X text 8 217 numeric arguments:;
@@ -27,10 +23,6 @@ a match if found \, and the message contains multiple elements (a list)
 the corresponding outlet. If no match is found \, then the entire message
 is sent out the right-most outlet - the "rejection" outlet. The number
 of outlets is the number of arguments plus one.;
-#X text 176 265 In this case \, the creation arguments are all numbers
-and [route] will therefore assume that it should attempt to match messages
-that are data type 'number'. All messages that are not numbers will
-be output through the right-most outlet.;
 #X msg 18 239 23 345 456;
 #X msg 96 239 420 34 45;
 #X msg 32 376 apple pie;
@@ -59,13 +51,10 @@ output through the right-most outlet).;
 #X text 630 328 none of the above!;
 #X text 702 268 a list of symbols;
 #X text 599 349 SPECIAL CASES OF LISTS.;
-#X text 18 563 RELATED OBJECTS;
-#X obj 22 584 select;
-#X obj 67 584 trigger;
-#X obj 119 584 moses;
-#X text 588 603 This document was updated for Pd version 0.35 test
-26 by Dave Sabine as part of a project called pddp proposed by Krzysztof
-Czaja to build comprehensive documentation for Pd.;
+#X text 17 583 RELATED OBJECTS;
+#X obj 21 604 select;
+#X obj 68 604 trigger;
+#X obj 122 604 moses;
 #X text 26 36 Route checks the first element of a message against each
 of its creation arguments \, which may be numbers or symbols (but not
 a mixture of the two unless the data types are defined explicitly)
@@ -84,7 +73,7 @@ is:;
 #X text 16 187 iem.kug.ac.at/pdb/;
 #X obj 193 34 demux;
 #X obj 245 34 gate;
-#X restore 22 607 pd related_objects_from_other_libraries;
+#X restore 21 627 pd related_objects_from_other_libraries;
 #X floatatom 625 498 5 0 0 0 - - -;
 #X symbolatom 673 497 10 0 0 0 - - -;
 #X obj 578 518 bng 15 250 50 0 empty empty bang -6 23 1 12 -262144
@@ -114,54 +103,187 @@ is:;
 -1 -1;
 #X obj 237 439 bng 15 250 50 0 empty empty everything_else -2 23 1
 12 -262144 -1 -1;
-#X obj 286 326 bng 15 250 50 0 empty empty bang -6 23 1 12 -262144
--1 -1;
-#X obj 333 326 bng 15 250 50 0 empty empty float -4 23 1 12 -262144
--1 -1;
-#X obj 381 326 bng 15 250 50 0 empty empty symbol -12 23 1 12 -262144
--1 -1;
-#X obj 429 326 bng 15 250 50 0 empty empty everything_else -2 23 1
-12 -262144 -1 -1;
 #X obj 129 469 print x1;
 #X obj 189 469 print x2;
 #X obj 249 469 print x3;
-#X text 526 557 [trigger]-style shortcuts don't work:;
-#X obj 538 577 route a b f l p s;
-#X text 667 576 !=;
-#X obj 689 577 route anything bang float list pointer symbol;
-#X connect 4 0 0 0;
-#X connect 4 1 1 0;
-#X connect 4 2 2 0;
-#X connect 4 3 3 0;
-#X connect 5 0 4 0;
-#X connect 6 0 4 0;
-#X connect 7 0 60 0;
-#X connect 7 0 67 0;
-#X connect 7 1 61 0;
-#X connect 7 1 68 0;
-#X connect 7 2 62 0;
-#X connect 7 2 69 0;
-#X connect 8 0 7 0;
-#X connect 9 0 7 0;
-#X connect 10 0 4 0;
-#X connect 13 0 50 0;
-#X connect 14 0 50 0;
-#X connect 15 0 50 0;
-#X connect 16 0 50 0;
-#X connect 17 0 50 0;
-#X connect 18 0 50 0;
-#X connect 23 0 4 0;
-#X connect 24 0 4 0;
-#X connect 25 0 7 0;
-#X connect 26 0 7 0;
-#X connect 44 0 51 0;
-#X connect 45 0 52 0;
-#X connect 47 0 50 0;
-#X connect 48 0 50 0;
-#X connect 49 0 50 0;
-#X connect 50 0 46 0;
-#X connect 50 1 44 0;
-#X connect 50 2 45 0;
-#X connect 50 3 53 0;
-#X connect 50 4 54 0;
-#X connect 55 0 50 0;
+#X text 565 555 [trigger]-style shortcuts don't work:;
+#X text 678 574 !=;
+#X obj 579 575 route b f s l;
+#X obj 700 575 route bang float symbol list;
+#X obj 7 331 print x23;
+#X obj 75 331 print x54;
+#X obj 143 331 print x1;
+#X obj 204 331 print other;
+#X obj 82 293 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 109 293 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 137 293 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 161 293 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X text 176 265 In this case \, the creation arguments are all numbers
+and [route] will therefore assume that it should attempt to match messages
+that are data type "float". All messages that are not numbers will
+be output through the right-most outlet.;
+#N canvas 0 22 466 633 routing_data_types 0;
+#X obj 334 314 route symbol;
+#X obj 336 334 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 413 335 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 331 361 route symbol;
+#X obj 333 381 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 410 382 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X msg 318 269 test;
+#X msg 357 269 symbol test;
+#X obj 58 331 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 135 331 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 55 378 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 132 378 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X msg 89 266 bang;
+#X obj 56 311 route bang;
+#X obj 53 358 route bang;
+#X text 14 5 routing based on reserved words:;
+#X obj 188 331 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 265 331 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 185 378 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 262 378 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 186 311 route float;
+#X obj 183 358 route float;
+#X msg 170 266 1;
+#X msg 209 266 float 12;
+#X obj 181 542 route list;
+#X obj 181 561 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 249 562 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 168 580 route list;
+#X obj 168 599 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 236 600 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X msg 184 493 list 1 two 3;
+#X msg 167 473 1 two 3;
+#X msg 200 513 list one 2 three;
+#X msg 365 289 symbol;
+#X msg 113 484 list;
+#X msg 224 287 float test;
+#X text 26 245 These all output the as same atom type that is routed:
+;
+#X msg 15 266 bang test;
+#X obj 71 131 route 1;
+#X msg 71 183 2 3 4;
+#X obj 71 164 prepend set;
+#X msg 71 100 1 2 3 4;
+#X msg 218 183 is not a list;
+#X obj 218 164 prepend set;
+#X obj 218 131 route this;
+#X msg 218 100 this is not a list;
+#X text 21 50 [route] has three modes \, first is float \, second is
+symbol \, and third is data type. In the first two modes \, the first
+element of the set is stripped off by [route].;
+#X text 26 206 In the third mode \, [route] outputs the same atom type
+(bang->bang \, float->float \, symbol->symbol).;
+#X text 26 419 Lists do not behave the same with [route list] even
+though it is interpreting incoming lists \, not just routing by keyword
+\, as in the second symbol mode.;
+#X msg 174 164 set;
+#X text 157 164 re;
+#X text 164 24 "bang" \, "float" \, "symbol" \, and "list";
+#X connect 0 0 1 0;
+#X connect 0 0 3 0;
+#X connect 0 1 2 0;
+#X connect 3 0 4 0;
+#X connect 3 1 5 0;
+#X connect 6 0 0 0;
+#X connect 7 0 0 0;
+#X connect 12 0 13 0;
+#X connect 13 0 8 0;
+#X connect 13 0 14 0;
+#X connect 13 1 9 0;
+#X connect 14 0 10 0;
+#X connect 14 1 11 0;
+#X connect 20 0 16 0;
+#X connect 20 0 21 0;
+#X connect 20 1 17 0;
+#X connect 21 0 18 0;
+#X connect 21 1 19 0;
+#X connect 22 0 20 0;
+#X connect 23 0 20 0;
+#X connect 24 0 25 0;
+#X connect 24 0 27 0;
+#X connect 24 1 26 0;
+#X connect 27 0 28 0;
+#X connect 27 1 29 0;
+#X connect 30 0 24 0;
+#X connect 31 0 24 0;
+#X connect 32 0 24 0;
+#X connect 33 0 0 0;
+#X connect 34 0 24 0;
+#X connect 35 0 20 0;
+#X connect 37 0 13 0;
+#X connect 38 0 40 0;
+#X connect 40 0 39 0;
+#X connect 41 0 38 0;
+#X connect 43 0 42 0;
+#X connect 44 0 43 0;
+#X connect 45 0 44 0;
+#X connect 49 0 42 0;
+#X connect 49 0 39 0;
+#X restore 838 496 pd routing_data_types;
+#X text 580 601 This document was updated for Pd version 0.38.4 by
+Dave Sabine and Hans-Christoph Steiner as part of a project called
+pddp proposed by Krzysztof Czaja to build comprehensive documentation
+for Pd.;
+#X text 832 475 More info:;
+#X connect 0 0 64 0;
+#X connect 0 0 68 0;
+#X connect 0 1 65 0;
+#X connect 0 1 69 0;
+#X connect 0 2 66 0;
+#X connect 0 2 70 0;
+#X connect 0 3 67 0;
+#X connect 0 3 71 0;
+#X connect 1 0 0 0;
+#X connect 2 0 0 0;
+#X connect 3 0 54 0;
+#X connect 3 0 57 0;
+#X connect 3 1 55 0;
+#X connect 3 1 58 0;
+#X connect 3 2 56 0;
+#X connect 3 2 59 0;
+#X connect 4 0 3 0;
+#X connect 5 0 3 0;
+#X connect 6 0 0 0;
+#X connect 9 0 44 0;
+#X connect 10 0 44 0;
+#X connect 11 0 44 0;
+#X connect 12 0 44 0;
+#X connect 13 0 44 0;
+#X connect 14 0 44 0;
+#X connect 18 0 0 0;
+#X connect 19 0 0 0;
+#X connect 20 0 3 0;
+#X connect 21 0 3 0;
+#X connect 38 0 45 0;
+#X connect 39 0 46 0;
+#X connect 41 0 44 0;
+#X connect 42 0 44 0;
+#X connect 43 0 44 0;
+#X connect 44 0 40 0;
+#X connect 44 1 38 0;
+#X connect 44 2 39 0;
+#X connect 44 3 47 0;
+#X connect 44 4 48 0;
+#X connect 49 0 44 0;