revised help docs that conform to the PDDP template

svn path=/trunk/; revision=13942

1 files changed, 532 insertions, 25 deletions

diff --git a/doc/pddp/dynamic_sends.pd b/doc/pddp/dynamic_sends.pd
index 847ec412..b215d6a9 100644
--- a/doc/pddp/dynamic_sends.pd
+++ b/doc/pddp/dynamic_sends.pd
@@ -1,27 +1,534 @@
-#N canvas 499 325 522 457 10;
-#X obj 310 194 f \$0;
-#X symbolatom 318 235 0 0 0 0 - - -;
-#X obj 310 213 makesymbol pd-%s-controlled;
-#N canvas 0 22 482 332 1024-controlled 0;
-#X restore 319 61 pd \$0-controlled;
-#N canvas 0 22 478 328 controlled 0;
-#X restore 68 61 pd controlled;
-#X msg 46 167 \; pd-controlled vis \$1;
-#X obj 46 123 tgl 40 0 empty empty open_close 0 -6 1 12 -217060 -1
--1 1 1;
-#X msg 310 285 \; \$1 vis \$2;
-#X obj 310 256 pack symbol float;
-#X obj 310 170 t b f;
-#X obj 310 125 tgl 40 0 empty empty open_close 0 -6 1 12 -217060 -1
+#N canvas 0 26 599 578 10;
+#N canvas 249 339 391 135 \$0-controlled 0;
+#X text 150 50 3I6OO9 3I6OO;
+#X restore 319 11 pd \$0-controlled;
+#N canvas 0 214 261 115 controlled 0;
+#X text 96 41 You rang?;
+#X restore 68 11 pd controlled;
+#X msg 46 99 \; pd-controlled vis \$1;
+#X obj 46 55 tgl 40 0 empty empty open_close 0 -12 1 12 -217060 -1
 -1 0 1;
-#X text 112 333 Since \$0 is only expanded if it starts the name \,
-it is necessary to use [makesymbol] in order to put the \$0 expansion
-into the middle of the name.;
-#X connect 0 0 2 0;
-#X connect 2 0 1 0;
-#X connect 2 0 8 0;
+#X msg 310 107 vis \$1;
+#X obj 310 134 s pd-\$0-controlled;
+#N canvas 11 26 915 645 (subpatch) 0;
+#X obj 28 5 r pd-\$0-controlled;
+#X obj 28 27 route vis;
+#X obj 28 49 sel 1;
+#X obj 28 172 f;
+#X obj 65 172 + 1;
+#X obj 28 96 timer;
+#X obj 28 74 t b b;
+#X obj 28 150 b;
+#X msg 108 163 clear \, text 20 20 I'm not going any further if you
+refuse to take the time to read what I'm writing.;
+#X obj 28 226 route 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18
+19 20;
+#X obj 209 513 s \$0-m;
+#X obj 28 558 s pd-\$0-controlled;
+#X msg 55 533 clear;
+#X obj 28 484 list trim;
+#X obj 28 508 t a b;
+#X obj 543 298 f;
+#X obj 579 298 + 1;
+#X obj 558 271 0;
+#X obj 543 325 + 1;
+#X obj 510 419 list split;
+#X obj 543 352 t b a;
+#X obj 510 391 list;
+#X obj 512 244 t b a b;
+#X obj 510 444 list prepend text 20 20;
+#X msg 549 524 clear;
+#X obj 510 498 t b a b;
+#X obj 510 471 list trim;
+#X obj 665 479 f;
+#X obj 677 273 500;
+#X obj 665 506 t a a;
+#X obj 692 532 * 0.05;
+#X obj 665 556 -;
+#X obj 649 613 t b a;
+#X obj 614 402 del;
+#X obj 194 451 del 750;
+#X floatatom 710 435 5 0 0 0 - - -;
+#X obj 28 118 moses 2500;
+#X obj 487 588 list;
+#X obj 490 554 del 1000;
+#X obj 487 611 list append LOL;
+#X obj 299 576 list prepend text 20 20;
+#X obj 301 590 list trim;
+#X obj 589 473 b;
+#X obj 488 631 list;
+#X obj 473 665 list append (call me);
+#X obj 570 563 del 1700;
+#X obj 512 154 list append Just quit looking in this window and we
+can both go back to do - ing what we were do - ing before YOU STARTED
+THIS LOOKING IN - SIDE - AH MY WIN - A - DOW P - A - N - E ! ! ! !
+! ! ! ! ! ! l ! ! 1 ! ! I ! !! !! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! / --
+! ! ! ! ! ! ! ! ! @ ! ! ! ! ! ! ! ! ! ! ! ! ! !;
+#X msg 193 478 bng 0;
+#X obj 267 444 del 1800;
+#X obj 76 596 list trim;
+#X obj 274 488 b;
+#X obj 57 656 s pd-controlled;
+#X obj 212 615 b;
+#X obj 238 668 b;
+#X msg 161 688 vis 1 \, bng 0;
+#X obj 306 495 del 1500;
+#X obj 179 557 del 3000;
+#X obj 182 668 del 1000;
+#X obj 244 622 del 1400;
+#X obj 614 663 b;
+#X obj 726 653 b;
+#X obj 754 584 s \$0-frame-magick;
+#X obj 65 199 mod 6;
+#N canvas 0 0 450 300 many_bngs 0;
+#X obj 128 31 inlet;
+#X obj 128 97 f;
+#X obj 167 97 + 1;
+#X msg 131 166 bng 0;
+#X obj 130 215 outlet;
+#X obj 131 190 t b a;
+#X obj 69 128 del 50;
+#X obj 132 62 t a b;
+#X msg 189 62 0;
+#X obj 128 123 moses 100;
+#X connect 0 0 7 0;
+#X connect 1 0 2 0;
+#X connect 1 0 9 0;
+#X connect 2 0 1 1;
+#X connect 3 0 5 0;
+#X connect 5 0 6 0;
+#X connect 5 1 4 0;
+#X connect 6 0 1 0;
+#X connect 7 0 1 0;
+#X connect 7 1 8 0;
+#X connect 8 0 1 1;
+#X connect 9 0 3 0;
+#X restore 372 499 pd many_bngs;
+#X msg 307 520 bng 0;
+#X obj 320 619 del 800;
+#X obj 643 667 del 1400;
+#X obj 28 253 list append text 20 20 You better close this window right
+now and never open it again. I'm warning you... Yeah \, that's right.
+Just walk away \, you nosy person \, you...;
+#X obj 63 422 list append text 20 20 You know I'm a wizard \, right?
+I mean you know you just opened the window to a wizard's house \, and
+your about to get a spell put on you?;
+#X obj 86 395 list append text 20 20 Check yourself. Why \, there's
+a [bng] hanging from your little mouse pointer!;
+#X obj 268 468 list append text 20 60 Now mouse over my window \, nosy...
+;
+#X obj 309 674 del 2000;
+#N canvas 340 34 624 597 nbx 0;
+#X obj 92 26 inlet;
+#X obj 89 65 f \$0;
+#X obj 68 149 outlet;
+#X obj 177 155 del 50;
+#X obj 175 35 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1
+-1;
+#X obj 171 184 metro 1000;
+#X obj 242 147 0;
+#X obj 179 210 f;
+#X obj 211 211 + 1;
+#X obj 113 267 list prepend;
+#X obj 137 405 random 337;
+#X obj 140 432 + 1000;
+#X obj 158 363 random 37;
+#X obj 160 384 + 1300;
+#X obj 183 322 random 7;
+#X obj 184 343 + 1330;
+#X obj 121 296 route 0 1 2 3 4;
+#X msg 231 344 1337;
+#X msg 49 214 0;
+#X msg 294 71 0;
+#X obj 293 187 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144
+-1 -1;
+#X obj 327 198 print;
+#X obj 247 239 moses 4;
+#X msg 285 269 0;
+#X obj 119 465 random 8999;
+#X obj 54 490 + 1000;
+#X obj 114 515 t a;
+#X obj 113 577 s \$0-nbx;
+#X obj 190 535 s \$0-nbx2;
+#X obj 271 535 s \$0-nbx3;
+#X obj 340 535 s \$0-nbx4;
+#X obj 410 535 s \$0-nbx5;
+#X msg 184 510 set \$1;
+#X msg 264 510 set \$1;
+#X msg 334 510 set \$1;
+#X msg 404 510 set \$1;
+#X obj 262 297 r \$0-nbxs;
+#X obj 330 295 r \$0-nbx2s;
+#X obj 401 295 r \$0-nbx3s;
+#X obj 470 295 r \$0-nbx4s;
+#X obj 540 295 r \$0-nbx5s;
+#X obj 277 385 f;
+#X obj 337 385 f;
+#X obj 407 385 f;
+#X obj 477 385 f;
+#X obj 547 385 f;
+#X obj 292 322 b;
+#X obj 306 343 del 4000;
+#X obj 362 322 b;
+#X obj 376 343 del 4000;
+#X obj 422 322 b;
+#X obj 436 343 del 4000;
+#X obj 482 322 b;
+#X obj 496 343 del 4000;
+#X obj 552 322 b;
+#X obj 566 343 del 4000;
+#X obj 254 447 line;
+#X msg 254 421 \$1 \, 1337 3.6e+06;
+#X msg 111 543 set \$1;
+#X obj 354 447 line;
+#X msg 354 421 \$1 \, 1337 3.6e+06;
+#X obj 464 447 line;
+#X msg 464 421 \$1 \, 1337 3.6e+06;
+#X obj 574 447 line;
+#X msg 574 421 \$1 \, 1337 3.6e+06;
+#X obj 584 497 line;
+#X msg 584 471 \$1 \, 1337 3.6e+06;
+#X obj 185 485 pipe 600;
+#X obj 265 485 pipe 900;
+#X obj 335 485 pipe 1500;
+#X obj 405 485 pipe 1900;
+#X msg 61 93 obj 350 160 nbx 10 35 0 1e+37 0 1 \$1-nbxs \$1-nbx empty
+15 -8 0 25 14 12 23 63 256 \, obj 350 200 nbx 10 35 0 1e+37 0 1 \$1-nbx2s
+\$1-nbx2 empty 15 -8 0 25 14 12 23 63 256 \, obj 436 120 nbx 10 35
+0 1e+37 0 1 \$1-nbx3s \$1-nbx3 empty 15 -8 0 15 14 12 23 63 256 \,
+obj 436 80 nbx 10 35 0 1e+37 0 1 \$1-nbx4s \$1-nbx4 empty 15 -8 0 15
+14 12 23 63 256 \, obj 436 40 nbx 10 35 0 1e+37 0 1 \$1-nbx5s \$1-nbx5
+empty 15 -8 0 15 14 12 23 63 256;
+#X obj 103 240 metro 60;
+#X connect 0 0 1 0;
+#X connect 0 0 6 0;
+#X connect 0 0 3 0;
+#X connect 1 0 71 0;
+#X connect 3 0 5 0;
+#X connect 3 0 72 0;
+#X connect 4 0 1 0;
+#X connect 4 0 6 0;
+#X connect 4 0 3 0;
+#X connect 5 0 7 0;
+#X connect 5 0 21 0;
+#X connect 6 0 7 1;
+#X connect 7 0 8 0;
+#X connect 7 0 9 1;
+#X connect 7 0 22 0;
+#X connect 8 0 7 1;
+#X connect 9 0 16 0;
+#X connect 10 0 11 0;
+#X connect 11 0 26 0;
+#X connect 12 0 13 0;
+#X connect 13 0 26 0;
+#X connect 14 0 15 0;
+#X connect 15 0 26 0;
+#X connect 16 0 24 0;
+#X connect 16 1 10 0;
+#X connect 16 2 12 0;
+#X connect 16 3 14 0;
+#X connect 16 4 17 0;
+#X connect 17 0 26 0;
+#X connect 18 0 72 0;
+#X connect 19 0 6 0;
+#X connect 20 0 5 0;
+#X connect 22 1 23 0;
+#X connect 23 0 5 0;
+#X connect 23 0 17 0;
+#X connect 23 0 72 0;
+#X connect 24 0 25 0;
+#X connect 25 0 26 0;
+#X connect 26 0 58 0;
+#X connect 26 0 67 0;
+#X connect 26 0 68 0;
+#X connect 26 0 69 0;
+#X connect 26 0 70 0;
+#X connect 32 0 28 0;
+#X connect 33 0 29 0;
+#X connect 34 0 30 0;
+#X connect 35 0 31 0;
+#X connect 36 0 46 0;
+#X connect 36 0 41 1;
+#X connect 37 0 42 1;
+#X connect 37 0 48 0;
+#X connect 38 0 43 1;
+#X connect 38 0 50 0;
+#X connect 39 0 44 1;
+#X connect 39 0 52 0;
+#X connect 40 0 45 1;
+#X connect 40 0 54 0;
+#X connect 41 0 57 0;
+#X connect 42 0 60 0;
+#X connect 43 0 62 0;
+#X connect 44 0 64 0;
+#X connect 45 0 66 0;
+#X connect 46 0 47 0;
+#X connect 47 0 41 0;
+#X connect 48 0 49 0;
+#X connect 49 0 42 0;
+#X connect 50 0 51 0;
+#X connect 51 0 43 0;
+#X connect 52 0 53 0;
+#X connect 53 0 44 0;
+#X connect 54 0 55 0;
+#X connect 55 0 45 0;
+#X connect 56 0 58 0;
+#X connect 57 0 56 0;
+#X connect 58 0 27 0;
+#X connect 59 0 32 0;
+#X connect 60 0 59 0;
+#X connect 61 0 33 0;
+#X connect 62 0 61 0;
+#X connect 63 0 34 0;
+#X connect 64 0 63 0;
+#X connect 65 0 35 0;
+#X connect 66 0 65 0;
+#X connect 67 0 32 0;
+#X connect 68 0 33 0;
+#X connect 69 0 34 0;
+#X connect 70 0 35 0;
+#X connect 71 0 2 0;
+#X connect 72 0 9 0;
+#X restore 380 677 pd nbx;
+#X obj 242 643 list append text 20 100 I CAN BE EVERYWHERE AT ONCE...
+;
+#X obj 741 489 del 800;
+#X msg 771 528 vis 0;
+#X obj 661 581 max 20;
+#X obj 753 560 del 300;
+#X obj 230 354 list append text 20 20 You don't believe me \, do you?
+Ah \, they never do... How dreadful it must be to while away the hours
+as a hapless mortal...;
+#X obj 163 546 list append text 20 80 A wretch like you could never
+dream of doing this--;
+#X obj 712 626 list append text 150 50 3I6OO9 3I6OO;
+#N canvas 412 219 602 465 magic 0;
+#X obj 41 351 s \$0-m;
+#X obj 41 39 inlet;
+#X msg 41 165 vis 1 \, editmode 1 \, editmode 0 \, mouse 320 60 0 0
+0 \, mouseup 320 60 0 0 0;
+#X obj 296 9 inlet;
+#X msg 295 98 vis 0;
+#X obj 294 134 s pd-\$0-controlled;
+#X obj 297 70 spigot;
+#X obj 183 25 1;
+#X obj 299 41 del 0;
+#X connect 1 0 2 0;
+#X connect 1 0 7 0;
+#X connect 2 0 0 0;
+#X connect 3 0 8 0;
+#X connect 4 0 5 0;
+#X connect 6 0 4 0;
+#X connect 7 0 6 1;
+#X connect 8 0 6 0;
+#X restore 855 561 pd magic;
+#X obj 832 533 del 2000;
+#X obj 45 303 list append text 20 20 I should have guessed that a stranger
+blithely staring into my window would be less than polite. Lacking
+physical form has its upside: I'm in no physical danger from your rudeness.
+So I'll bite-- what the heck is your problem?;
+#X text 233 86 What? Wizards are messy!;
+#X connect 0 0 1 0;
+#X connect 1 0 2 0;
+#X connect 2 0 6 0;
+#X connect 2 0 81 1;
+#X connect 3 0 4 0;
+#X connect 3 0 9 0;
+#X connect 4 0 62 0;
+#X connect 5 0 36 0;
 #X connect 6 0 5 0;
-#X connect 8 0 7 0;
-#X connect 9 0 0 0;
-#X connect 9 1 8 1;
-#X connect 10 0 9 0;
+#X connect 6 1 5 1;
+#X connect 7 0 3 0;
+#X connect 8 0 13 0;
+#X connect 9 0 67 0;
+#X connect 9 1 83 0;
+#X connect 9 2 68 0;
+#X connect 9 3 78 0;
+#X connect 9 4 34 0;
+#X connect 9 4 69 0;
+#X connect 9 5 46 0;
+#X connect 12 0 11 0;
+#X connect 13 0 14 0;
+#X connect 14 0 11 0;
+#X connect 14 1 12 0;
+#X connect 15 0 16 0;
+#X connect 15 0 18 0;
+#X connect 16 0 15 1;
+#X connect 17 0 15 1;
+#X connect 18 0 20 0;
+#X connect 19 0 23 0;
+#X connect 19 2 42 0;
+#X connect 20 0 21 0;
+#X connect 20 1 19 1;
+#X connect 21 0 19 0;
+#X connect 22 0 15 0;
+#X connect 22 1 21 1;
+#X connect 22 1 37 1;
+#X connect 22 2 17 0;
+#X connect 22 2 28 0;
+#X connect 23 0 26 0;
+#X connect 24 0 11 0;
+#X connect 25 0 27 0;
+#X connect 25 1 11 0;
+#X connect 25 2 24 0;
+#X connect 26 0 25 0;
+#X connect 27 0 29 0;
+#X connect 27 0 35 0;
+#X connect 28 0 27 1;
+#X connect 29 0 31 0;
+#X connect 29 1 30 0;
+#X connect 29 1 33 1;
+#X connect 30 0 31 1;
+#X connect 31 0 76 0;
+#X connect 32 0 33 0;
+#X connect 32 1 27 1;
+#X connect 33 0 15 0;
+#X connect 34 0 47 0;
+#X connect 34 0 48 0;
+#X connect 36 0 8 0;
+#X connect 36 1 7 0;
+#X connect 37 0 39 0;
+#X connect 38 0 37 0;
+#X connect 38 0 45 0;
+#X connect 39 0 40 0;
+#X connect 39 0 43 1;
+#X connect 40 0 41 0;
+#X connect 41 0 14 0;
+#X connect 42 0 38 0;
+#X connect 43 0 44 0;
+#X connect 44 0 40 0;
+#X connect 44 0 59 0;
+#X connect 45 0 43 0;
+#X connect 46 0 22 0;
+#X connect 47 0 10 0;
+#X connect 48 0 70 0;
+#X connect 49 0 11 0;
+#X connect 50 0 55 0;
+#X connect 52 0 58 0;
+#X connect 52 0 65 0;
+#X connect 53 0 57 0;
+#X connect 54 0 51 0;
+#X connect 55 0 56 0;
+#X connect 55 0 64 0;
+#X connect 56 0 79 0;
+#X connect 57 0 54 0;
+#X connect 58 0 73 0;
+#X connect 59 0 66 0;
+#X connect 60 0 74 0;
+#X connect 62 0 3 1;
+#X connect 63 0 11 0;
+#X connect 64 0 11 0;
+#X connect 65 0 63 0;
+#X connect 65 0 71 0;
+#X connect 66 0 80 0;
+#X connect 67 0 13 0;
+#X connect 68 0 13 0;
+#X connect 69 0 13 0;
+#X connect 70 0 49 0;
+#X connect 70 0 50 0;
+#X connect 71 0 72 0;
+#X connect 72 0 10 0;
+#X connect 73 0 49 0;
+#X connect 73 0 53 0;
+#X connect 74 0 75 0;
+#X connect 74 0 77 0;
+#X connect 75 0 11 0;
+#X connect 76 0 32 0;
+#X connect 77 0 61 0;
+#X connect 77 0 82 0;
+#X connect 78 0 13 0;
+#X connect 79 0 49 0;
+#X connect 79 0 52 0;
+#X connect 80 0 60 0;
+#X connect 80 0 13 0;
+#X connect 82 0 81 0;
+#X connect 83 0 13 0;
+#X restore 518 534 pd;
+#X obj 403 534 namecanvas \$0-m;
+#X obj 147 301 bng 15 250 50 0 empty \$0-frame-magick empty 17 7 0
+10 -262144 -1 -1;
+#N canvas 0 0 450 373 \$0-hhhhaaaannnnggggeeeerrrr 0;
+#X obj 117 66 inlet;
+#X obj 219 60 inlet;
+#X obj 219 133 del 400;
+#X obj 117 275 pack 0 \$0;
+#X msg 117 297 \; \$2-frame delta 0 \$1;
+#X obj 117 147 tgl 15 0 empty empty empty 17 7 0 10 -262144 -1 -1 0
+1;
+#X obj 117 172 - 0.5;
+#X obj 117 194 * 16;
+#X msg 117 221 0 \, \$1 200;
+#X obj 117 248 line;
+#X msg 240 200 1;
+#X obj 117 93 spigot 1;
+#X obj 117 120 t b b;
+#X msg 181 94 0;
+#X obj 240 175 del 250;
+#X obj 219 108 t b b;
+#X obj 219 84 spigot 1;
+#X msg 284 96 0;
+#X msg 62 134 set 0;
+#X connect 0 0 11 0;
+#X connect 1 0 16 0;
+#X connect 2 0 5 0;
+#X connect 2 0 14 0;
+#X connect 3 0 4 0;
+#X connect 5 0 6 0;
+#X connect 6 0 7 0;
+#X connect 7 0 8 0;
+#X connect 8 0 9 0;
+#X connect 9 0 3 0;
+#X connect 10 0 11 1;
+#X connect 10 0 16 1;
+#X connect 11 0 12 0;
+#X connect 12 0 5 0;
+#X connect 12 1 13 0;
+#X connect 13 0 11 1;
+#X connect 14 0 10 0;
+#X connect 15 0 2 0;
+#X connect 15 1 17 0;
+#X connect 16 0 15 0;
+#X connect 17 0 16 1;
+#X connect 18 0 5 0;
+#X restore 68 342 pd \$0-hhhhaaaannnnggggeeeerrrr;
+#X obj 61 336 cnv 15 200 200 empty \$0-frame empty 20 12 0 14 -66577
+-66577 0;
+#X obj 66 341 cnv 15 190 190 empty \$0-frame empty 20 12 0 14 -198977
+-66577 0;
+#X obj 71 346 cnv 15 180 180 empty \$0-frame empty 20 12 0 14 -66577
+-66577 0;
+#X obj 76 351 cnv 15 170 170 empty \$0-frame empty 20 12 0 14 -232882
+-66577 0;
+#X obj 79 394 f \$0;
+#X symbolatom 87 435 0 0 0 0 - - -;
+#X obj 79 413 makesymbol pd-%s-controlled;
+#X msg 79 485 \; \$1 vis \$2;
+#X obj 79 456 pack symbol float;
+#X obj 79 370 t b f;
+#X text 9 193 In the old days \, \$0 was only expanded if it started
+the name \, so it was necessary to use [makesymbol] in order to put
+the value of \$0 into the middle of the name (as in the patch below).
+Additionally \, the entire patch had to be drawn by hand on a punchcard
+(taking care to avoid punching any holes whatsoever) and then given
+directly to Miller \, who would file it away in a drawer for safekeeping
+through the harsh Winter months.;
+#X text 277 391 Vintage Pd Patch;
+#X text 277 411 Medium: Pixels on Canvas;
+#X text 277 431 Artist: Petey Deepea;
+#X text 277 451 Price: Less than 1k;
+#X text 9 152 Since dollarsign variables will now expand in the middle
+of a symbol \, this help patch is deprecated. Dynamic sends using the
+message box can still be handy \, however.;
+#X obj 310 57 tgl 40 0 empty empty open_close 0 -12 1 12 -217060 -1
+-1 0 1;
+#X connect 3 0 2 0;
+#X connect 4 0 5 0;
+#X connect 8 0 9 0;
+#X connect 8 0 9 1;
+#X connect 14 0 16 0;
+#X connect 16 0 15 0;
+#X connect 16 0 18 0;
+#X connect 18 0 17 0;
+#X connect 19 0 14 0;
+#X connect 19 1 18 1;
+#X connect 26 0 4 0;