replaced with vanilla help files

svn path=/trunk/; revision=14607

1 files changed, 265 insertions, 503 deletions

diff --git a/externals/vanilla/list-help.pd b/externals/vanilla/list-help.pd
index 2a872d0e..8ab27888 100644
--- a/externals/vanilla/list-help.pd
+++ b/externals/vanilla/list-help.pd
@@ -1,130 +1,18 @@
-#N canvas 0 0 555 619 10;
-#X obj 0 595 cnv 15 552 21 empty \$0-pddp.cnv.footer empty 20 12 0
-14 -228856 -66577 0;
-#X obj 0 0 cnv 15 552 40 empty \$0-pddp.cnv.header list 3 12 0 18 -204280
--1 0;
-#X obj 0 161 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13
--228856 -1 0;
-#N canvas 50 244 494 344 META 0;
-#X text 12 90 LIBRARY internal;
-#X text 12 130 WEBSITE http://crca.ucsd.edu/~msp/;
-#X text 12 50 LICENSE SIBSD;
-#X text 12 110 AUTHOR Miller Puckette;
-#X text 12 170 HELP_PATCH_AUTHORS Updated for Pd version 0.40. Jonathan
-Wilkes revised the patch to conform to the PDDP template for Pd version
-0.42.;
-#X text 12 70 DESCRIPTION building and using variable-length messages
-;
-#X text 12 5 NAME list append list prepend list trim list split list
-length;
-#X text 12 30 KEYWORDS control storage needs_work list_op symbol_op
-;
-#X text 12 150 RELEASE_DATE 2005;
-#X restore 500 598 pd META;
-#X obj 0 244 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0
-13 -228856 -1 0;
-#X obj 0 295 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12
-0 13 -228856 -1 0;
-#X obj 0 506 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12
-0 13 -228856 -1 0;
-#N canvas 99 484 428 109 Related_objects 0;
-#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0
-14 -204280 -1 0;
-#X text 7 1 [list] Related Objects;
-#X obj 21 42 float;
-#X obj 61 42 symbol;
-#X obj 112 42 pack;
-#X obj 152 42 unpack;
-#X restore 102 599 pd Related_objects;
-#X obj 78 253 cnv 17 3 17 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856
--162280 0;
-#X obj 78 170 cnv 17 3 17 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856
--162280 0;
-#X obj 493 3 list;
-#X obj 465 20 pddp/pddplink http://wiki.puredata.info/en/list -text
-pdpedia: list;
-#N canvas 0 83 555 502 append 0;
-#X obj 0 0 cnv 15 552 40 empty \$0-pddp.cnv.header empty 3 12 0 14
--204280 -1 0;
-#X obj 13 3 list append;
-#X text 18 24 append (concatenate) the second list to the first;
-#X obj 0 294 cnv 3 520 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13
--228856 -1 0;
-#X obj 0 377 cnv 3 520 3 empty \$0-pddp.cnv.outlets outlets 8 12 0
-13 -228856 -1 0;
-#X obj 78 386 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856
--162280 0;
-#X obj 78 303 cnv 17 3 40 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856
--162280 0;
-#X obj 78 353 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856
--162280 0;
-#X text 98 304 anything;
-#X text 98 354 anything;
-#X obj 0 421 cnv 3 520 3 empty \$0-pddp.cnv.argument arguments 8 12
-0 13 -228856 -1 0;
-#X text 80 456 n);
-#X text 98 471 float;
-#X text 80 440 1);
-#X text 170 440 - the symbol "append".;
-#X text 170 456 - an arbitrary number of additional floats or symbols
-may be specified to initialize the list stored at the right inlet.
-;
-#X obj 158 219 list append 1 2;
-#X floatatom 168 165 5 0 0 0 - - -;
-#X msg 158 140 1 2 3;
-#X msg 178 190 bang;
-#X msg 285 189 bang;
-#X obj 158 241 print append;
-#X msg 285 163 4 5 6 and 7;
-#X msg 285 80 4 5 6;
-#X msg 285 139 four 5 6;
-#X msg 285 110 list four 5 6;
-#X text 178 354 - all input is converted to a list and stored.;
-#X text 178 304 - all input is converted to a list. The list stored
-at the right inlet is appended to it \, and the resulting list is sent
-to the outlet.;
-#X text 98 387 list;
-#X text 168 387 - the output is always a message with the selector
-"list" (see subpatch "list_conversion" for more info).;
-#X text 98 440 symbol atom;
-#X text 98 456 symbol atom;
-#X connect 16 0 21 0;
-#X connect 17 0 16 0;
-#X connect 18 0 16 0;
-#X connect 19 0 16 0;
-#X connect 20 0 16 1;
-#X connect 22 0 16 1;
-#X connect 23 0 16 1;
-#X connect 24 0 16 1;
-#X connect 25 0 16 1;
-#X restore 102 365 pd append;
-#N canvas 87 25 428 592 about-lists 0;
-#X obj 22 567 print message;
-#X msg 22 380 list x.wav 44100;
-#X msg 22 538 read \$1 \$2;
-#X msg 22 409 set x.wav 44100;
-#X msg 39 509 set \, add2 read \, adddollar 1 \, adddollar 2;
-#X msg 22 439 x.wav 44100;
-#X obj 39 483 loadbang;
-#X text 127 486 reset message as it was;
-#X text 139 380 good;
-#X text 128 411 bad;
-#X text 94 439 ugly;
-#X msg 223 403 list 44100 x.wav;
-#X msg 236 428 44100 x.wav;
-#X obj 223 454 print number-first;
-#X text 217 375 these two are equivalent:;
-#X text 19 266 In the example below \, the top message sets \$1 to
-"x.wav" and \$2 to 44100 in the "read" message. The lower message box
-outputs the message "read x.wav 44100". The "set" message changes the
-content of the message box itself (click on the longer message box
-below to repair the damage.) The "ugly" message \, since it is neither
-"list" nor "set" \, gets interpreted in an arbitrary (and probably
-inappropriate!) way.;
-#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0
-14 -204280 -1 0;
-#X text 7 1 [list] About lists in Pd;
-#X text 19 37 Messages in Pd are somewhat artificially divided into
+#N canvas 256 20 629 492 12;
+#X obj 29 11 list;
+#X text 76 12 - building and using variable-length messages;
+#N canvas 92 130 654 658 about-lists 0;
+#X obj 50 625 print message;
+#X msg 50 438 list x.wav 44100;
+#X msg 50 596 read \$1 \$2;
+#X msg 50 467 set x.wav 44100;
+#X msg 67 567 set \, add2 read \, adddollar 1 \, adddollar 2;
+#X msg 50 497 x.wav 44100;
+#X obj 67 541 loadbang;
+#X text 155 544 reset message as it was;
+#X text 207 438 good;
+#X text 196 469 bad;
+#X text 46 25 Messages in Pd are simewhat artificially divided into
 two classes. First are data-holding messages (bang \, float \, symbol
 \, list) which are the primary way of communicating between objects.
 Second is "everything else" (you could call them out-of-band messages
@@ -133,81 +21,238 @@ write files \, quit Pd \, etc. These are provided so that complex objects
 don't need to have 100 separate inlets for every possible functionality.
 It's not clear whether this was a good design choice \, but it's entrenched.
 ;
-#X text 19 170 The distinction becomes visible \, and ugly \, when
+#X text 162 497 ugly;
+#X text 48 183 The distinction becomes visible \, and ugly \, when
 the leading item in a data-holding message is a symbol. In this case
 \, to disambiguate it from the other sort \, the printed form of the
 message has a selector \, "list" or "symbol" prepended to it. Underneath
-\, there is always a selector in front of data messages \, but it is
+\, there is always a selector in fromt of data messages \, but it is
 implied if the first data item is a number.;
+#X msg 411 461 list 44100 x.wav;
+#X msg 424 486 44100 x.wav;
+#X obj 411 512 print number-first;
+#X text 405 433 these two are equivalent:;
+#X text 50 294 In the example below \, the top message sets \$1 to
+"x.wav" and \$2 to 44100 in the "read" message. The lower message box
+outputs the message "read x.wav 44100". The "set" message changes the
+content of the message box itself (click on the longer message box
+below to repair the damage.) The "ugly" message \, since it is neither
+"list" nor "set" \, gets interpreted in an arbitrary (and probably
+inappropriate!) way.;
 #X connect 1 0 2 0;
 #X connect 2 0 0 0;
 #X connect 3 0 2 0;
 #X connect 4 0 2 0;
 #X connect 5 0 2 0;
 #X connect 6 0 4 0;
-#X connect 11 0 13 0;
-#X connect 12 0 13 0;
-#X restore 101 546 pd about-lists;
-#X text 11 23 building and using variable-length messages;
-#X text 80 314 1);
-#X text 80 474 n);
-#X text 180 365 append - append the second list to the first;
-#X text 180 409 split - split a list in two;
-#X text 180 387 prepend - prepend the second list to the first;
-#X text 180 453 length - output the number of items in a list;
-#X text 180 431 trim - trim the "list" selector off;
-#X obj 212 113 list;
-#X msg 233 68 rice;
-#X msg 212 46 beans;
-#X obj 212 135 print groceries;
-#X msg 246 90 cornbread;
-#X text 98 510 Here are some examples showing how to use these objects
-to compose and/or use variable length messages:;
-#N canvas 19 21 525 646 simple_sequencer 0;
-#X obj 23 173 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+#X connect 13 0 15 0;
+#X connect 14 0 15 0;
+#X restore 43 324 pd about-lists;
+#X text 33 52 There are four list classes:;
+#X obj 22 82 list append;
+#X obj 22 107 list prepend;
+#X obj 22 157 list trim;
+#X obj 22 132 list split;
+#X text 140 81 - append the second list to the first;
+#X text 141 108 - prepend the second list to the first;
+#X text 141 133 - split a list in two;
+#X text 141 160 - trim the "list" selector off;
+#N canvas 186 284 602 409 trim 0;
+#X msg 159 239 1 2 3;
+#X msg 159 190 list cis boom bah;
+#X msg 160 265 bang;
+#X msg 159 163 walk the dog;
+#X obj 134 341 list trim;
+#X obj 134 363 print trim;
+#X msg 160 287 1 x y;
+#X msg 159 313 x 1 y;
+#X text 29 19 trim - convert list to message \, using first item as
+selector;
+#X msg 159 213 55;
+#X text 27 55 The "list trim" object inputs lists (or makes lists out
+of incoming non-list messages) and outputs a message whose selector
+is the first item of the list \, and whose arguments \, if any \, are
+the remainder of the list. If the list has no items \, or if its first
+item is numeric \, the selector is "list" (which might print out as
+list \, float \, or bang.);
+#X connect 0 0 4 0;
+#X connect 1 0 4 0;
+#X connect 2 0 4 0;
+#X connect 3 0 4 0;
+#X connect 4 0 5 0;
+#X connect 6 0 4 0;
+#X connect 7 0 4 0;
+#X connect 9 0 4 0;
+#X restore 506 160 pd trim;
+#X text 501 53 details:;
+#X text 499 36 click for;
+#N canvas 100 190 608 420 append 0;
+#X obj 17 324 list append 1 2;
+#X floatatom 17 154 5 0 0 0 - - -;
+#X msg 17 129 1 2 3;
+#X msg 17 82 list cis boom bah;
+#X msg 17 179 bang;
+#X msg 176 294 bang;
+#X obj 17 353 print append;
+#X msg 17 39 walk the dog;
+#X msg 176 244 list x y z;
+#X msg 175 218 go dog go;
+#X msg 174 268 4 5 6 and 7;
+#X text 138 37 non-list message converted to list;
+#X text 182 77 list starting with symbol;
+#X text 181 96 (needs explicit "list" selector);
+#X text 69 152 number is one-element list;
+#X text 72 129 numeric list;
+#X text 67 181 bang is zero-element list;
+#X text 270 215 same for right inlet...;
+#X text 286 267 (note: only the first item;
+#X text 289 286 need be a number to make this;
+#X text 289 304 a list.);
+#X text 170 325 <- creation args initialize the list to append;
+#X text 20 6 Append - append (concatenate) the second list to the first
+;
+#X connect 0 0 6 0;
+#X connect 1 0 0 0;
+#X connect 2 0 0 0;
+#X connect 3 0 0 0;
+#X connect 4 0 0 0;
+#X connect 5 0 0 1;
+#X connect 7 0 0 0;
+#X connect 8 0 0 1;
+#X connect 9 0 0 1;
+#X connect 10 0 0 1;
+#X restore 506 84 pd append;
+#N canvas 391 326 667 561 split 0;
+#X msg 103 328 1 2 3;
+#X msg 79 231 list cis boom bah;
+#X msg 99 263 bang;
+#X obj 79 421 list split 2;
+#X floatatom 182 396 3 0 5 0 - - -;
+#X obj 79 469 print split1;
+#X obj 198 470 print split2;
+#X msg 79 204 walk the dog;
+#X msg 102 306 1 2;
+#X msg 100 285 1;
+#X msg 103 349 1 2 3 4;
+#X msg 103 372 1 2 so are you;
+#X obj 320 470 print split3;
+#X text 76 488 first n;
+#X text 195 489 rest of list;
+#X text 317 489 shorter than n;
+#X text 218 394 new split point;
+#X text 49 25 Split - cut a list into smaller ones;
+#X text 210 419 <-- creation arg inits split point;
+#X text 201 202 non-list message converted to list;
+#X text 245 231 list with three symbols;
+#X text 139 288 list with one number;
+#X text 177 310 ... etc;
+#X text 241 370 <- if the first item is a number \, it's a list.;
+#X text 142 262 list with no items;
+#X text 48 61 The "list split" object takes lists and outputs the first
+"n" items (left outlet) and the remaining ones (middle outlet). The
+two outputs appear in the usual right-to-left order. In case there
+are fewer than "n" items in the list \, it is output (in its entirety)
+from the third outlet instead. The creation argument or the inlet sets
+the split point.;
+#X connect 0 0 3 0;
+#X connect 1 0 3 0;
+#X connect 2 0 3 0;
+#X connect 3 0 5 0;
+#X connect 3 1 6 0;
+#X connect 3 2 12 0;
+#X connect 4 0 3 1;
+#X connect 7 0 3 0;
+#X connect 8 0 3 0;
+#X connect 9 0 3 0;
+#X connect 10 0 3 0;
+#X connect 11 0 3 0;
+#X restore 506 134 pd split;
+#N canvas 0 0 640 478 prepend 0;
+#X floatatom 17 154 5 0 0 0 - - -;
+#X msg 17 129 1 2 3;
+#X msg 17 82 list cis boom bah;
+#X msg 17 179 bang;
+#X msg 176 294 bang;
+#X obj 17 353 print append;
+#X msg 17 39 walk the dog;
+#X msg 176 244 list x y z;
+#X msg 175 218 go dog go;
+#X msg 174 268 4 5 6 and 7;
+#X text 138 37 non-list message converted to list;
+#X text 182 77 list starting with symbol;
+#X text 181 96 (needs explicit "list" selector);
+#X text 69 152 number is one-element list;
+#X text 72 129 numeric list;
+#X text 67 181 bang is zero-element list;
+#X text 270 215 same for right inlet...;
+#X text 286 267 (note: only the first item;
+#X text 289 286 need be a number to make this;
+#X text 289 304 a list.);
+#X text 20 6 Prepend - prepend the second list to the first;
+#X text 171 326 <- creation args initialize the list to prepend;
+#X obj 17 324 list prepend 1 2;
+#X connect 0 0 22 0;
+#X connect 1 0 22 0;
+#X connect 2 0 22 0;
+#X connect 3 0 22 0;
+#X connect 4 0 22 1;
+#X connect 6 0 22 0;
+#X connect 7 0 22 1;
+#X connect 8 0 22 1;
+#X connect 9 0 22 1;
+#X connect 22 0 5 0;
+#X restore 506 109 pd prepend;
+#X text 30 241 In general \, inlets that take lists (two each for append/prepend
+\, and one each for split and trim) will convert non-list messages
+(such as "set 5") to lists (such as "list set 5" automatically. Here's
+more about lists in Pd:;
+#X text 31 357 And here are some examples showing how to use these
+objects to compose and/or use variable length messages:;
+#N canvas 381 50 719 646 example1 0;
+#X obj 43 173 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
 -1;
-#X obj 232 176 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+#X obj 252 176 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
 -1;
-#X text 227 154 clear;
-#X text 20 153 send;
-#X msg 71 175 250;
-#X msg 103 175 500;
-#X msg 136 175 750;
-#X msg 169 175 1000;
-#X obj 23 258 list append;
-#X obj 188 220 t l;
-#X obj 71 214 list prepend;
-#X obj 23 426 t l l;
-#X obj 74 426 print start;
-#X obj 129 257 print stored;
-#X obj 23 451 list split 1;
-#X obj 23 575 del;
-#X obj 23 607 print bang;
-#X obj 55 542 list append;
-#X msg 35 403 0 250 250 500;
-#X text 98 150 -- add --;
-#X text 37 20 example 1: simple rhythmic sequencer;
-#X text 29 53 The top part of this patch demonstrates building up a
+#X text 247 154 clear;
+#X text 40 153 send;
+#X msg 91 175 250;
+#X msg 123 175 500;
+#X msg 156 175 750;
+#X msg 189 175 1000;
+#X obj 43 258 list append;
+#X obj 208 220 t l;
+#X obj 91 214 list prepend;
+#X obj 43 426 t l l;
+#X obj 94 426 print start;
+#X obj 149 257 print stored;
+#X obj 43 451 list split 1;
+#X obj 43 575 del;
+#X obj 43 607 print bang;
+#X obj 75 542 list append;
+#X msg 55 403 0 250 250 500;
+#X text 118 150 -- add --;
+#X text 57 20 example 1: simple rhythmic sequencer;
+#X text 49 53 The top part of this patch demonstrates building up a
 message from a variable number of elements provided sequentially. The
 "list prepend" object stores the list and \, each time a number arrives
 \, prepends the previous list to it.;
-#X text 216 237 "list prepend" to its own inlet.;
-#X text 213 220 "trigger list" is needed only to connect outlet of
+#X text 416 237 "list prepend" to its own inlet.;
+#X text 253 220 "trigger list" is needed only to connect outlet of
 ;
-#X text 254 258 printout shows the growing message.;
-#X text 47 279 "list append" stores the growing message which is output
+#X text 274 258 printout shows the growing message.;
+#X text 67 279 "list append" stores the growing message which is output
 by the "send" button above. "list prepend" would have been equivalent.
 ;
-#X text 165 403 <-- test message;
-#X text 39 354 The bottom part of the patch takes numbers off the beginning
+#X text 185 403 <-- test message;
+#X text 59 354 The bottom part of the patch takes numbers off the beginning
 of the list \, one by one \, to use as delays.;
-#X text 190 426 printout shows the sequence as it starts.;
-#X text 169 543 The rest of the list is stored for next time.;
-#X obj 141 505 print done;
-#X text 150 450 Split off the first item. If there is none \, nothing
+#X text 210 426 printout shows the sequence as it starts.;
+#X text 189 543 The rest of the list is stored for next time.;
+#X obj 161 505 print done;
+#X text 170 450 Split off the first item. If there is none \, nothing
 comes out the first or second outlet \, but instead we get a "bang"
 from the third one.;
-#X text 64 575 After delay \, output a bang and recall the rest of
+#X text 84 575 After delay \, output a bang and recall the rest of
 the list.;
 #X connect 0 0 8 0;
 #X connect 1 0 10 1;
@@ -229,8 +274,9 @@ the list.;
 #X connect 15 0 17 0;
 #X connect 17 0 14 0;
 #X connect 18 0 11 0;
-#X restore 401 546 pd simple_sequencer;
-#N canvas 126 39 397 569 another_sequencer 0;
+#X restore 222 410 pd example1;
+#X text 65 409 simple sequencer;
+#N canvas 126 39 568 569 example2 0;
 #X obj 66 263 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
 -1;
 #X obj 292 266 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
@@ -280,8 +326,10 @@ by taking the "pitch" output before the delay object (previously the
 #X connect 16 0 15 0;
 #X connect 16 1 11 1;
 #X connect 16 2 19 0;
-#X restore 401 568 pd another_sequencer;
-#N canvas 47 147 447 426 serializer 0;
+#X restore 222 436 pd example2;
+#X text 56 438 another sequencer;
+#X text 115 465 serializer;
+#N canvas 116 31 673 426 example3 0;
 #X obj 19 287 list split 1;
 #X obj 19 378 print;
 #X obj 19 204 until;
@@ -294,11 +342,11 @@ by taking the "pitch" output before the delay object (previously the
 all the items of a list.;
 #X text 178 147 <- click to test;
 #X text 101 171 First store list \, then start the loop;
-#X text 88 199 "until" bangs its output until told to stop by a "bang"
+#X text 118 199 "until" bangs its output until told to stop by a "bang"
 to its right inlet.;
-#X text 107 241 Store the remaining list.;
-#X text 184 286 third outlet of "split" tells us to stop.;
-#X text 37 318 Second outlet of "split" becomes the new list for "list
+#X text 137 241 Store the remaining list.;
+#X text 194 286 third outlet of "split" tells us to stop.;
+#X text 67 318 Second outlet of "split" becomes the new list for "list
 append" above.;
 #X text 75 377 First outlet is the output.;
 #X connect 0 0 1 0;
@@ -310,317 +358,31 @@ append" above.;
 #X connect 4 1 3 1;
 #X connect 5 0 2 1;
 #X connect 6 0 4 0;
-#X restore 241 568 pd serializer;
-#N canvas 100 215 428 350 lists_vs_non-lists 0;
-#X obj 23 290 list append 1 2;
-#X floatatom 23 120 5 0 0 0 - - -;
-#X msg 23 95 1 2 3;
-#X msg 23 68 list cis boom bah;
-#X msg 23 145 bang;
-#X msg 162 260 bang;
-#X obj 23 319 print append;
-#X msg 23 43 walk the dog;
-#X msg 162 210 list x y z;
-#X msg 161 184 go dog go;
-#X msg 160 234 4 5 6 and 7;
-#X text 119 43 non-list message converted to list;
-#X text 144 68 list starting with symbol;
-#X text 75 118 number is one-element list;
-#X text 75 95 numeric list;
-#X text 75 145 bang is zero-element list;
-#X text 226 184 same for right inlet...;
-#X text 235 233 (note: only the first item;
-#X text 238 252 need be a number to make this;
-#X text 238 270 a list.);
-#X text 121 290 <- creation args initialize the list to append;
-#X obj 2 2 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0
-14 -204280 -1 0;
-#X text 8 2 [list] Lists vs. Non-lists;
-#X connect 0 0 6 0;
-#X connect 1 0 0 0;
-#X connect 2 0 0 0;
-#X connect 3 0 0 0;
-#X connect 4 0 0 0;
-#X connect 5 0 0 1;
-#X connect 7 0 0 0;
-#X connect 8 0 0 1;
-#X connect 9 0 0 1;
-#X connect 10 0 0 1;
-#X restore 101 568 pd lists_vs_non-lists;
-#N canvas 0 82 555 506 prepend 0;
-#X obj 0 0 cnv 15 552 40 empty \$0-pddp.cnv.header empty 3 12 0 14
--204280 -1 0;
-#X obj 0 299 cnv 3 520 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13
--228856 -1 0;
-#X obj 0 377 cnv 3 520 3 empty \$0-pddp.cnv.outlets outlets 8 12 0
-13 -228856 -1 0;
-#X obj 78 386 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856
--162280 0;
-#X obj 78 308 cnv 17 3 40 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856
--162280 0;
-#X obj 78 354 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856
--162280 0;
-#X text 98 309 anything;
-#X text 98 355 anything;
-#X obj 0 421 cnv 3 520 3 empty \$0-pddp.cnv.argument arguments 8 12
-0 13 -228856 -1 0;
-#X text 80 456 n);
-#X text 98 471 float;
-#X text 80 440 1);
-#X text 170 456 - an arbitrary number of additional floats or symbols
-may be specified to initialize the list stored at the right inlet.
-;
-#X floatatom 198 160 5 0 0 0 - - -;
-#X msg 188 135 1 2 3;
-#X msg 208 185 bang;
-#X msg 315 184 bang;
-#X msg 315 158 4 5 6 and 7;
-#X msg 315 75 4 5 6;
-#X msg 315 134 four 5 6;
-#X msg 315 105 list four 5 6;
-#X text 178 355 - all input is converted to a list and stored.;
-#X text 18 24 prepend the second list to the first;
-#X obj 13 3 list prepend;
-#X obj 188 214 list prepend 1 2;
-#X obj 188 236 print prepend;
-#X text 178 309 - all input is converted to a list. The list stored
-at the right inlet is prepended to it \, and the resulting list is
-sent to the outlet.;
-#X text 170 440 - the symbol "prepend".;
-#X text 98 387 list;
-#X text 168 387 - the output is always a message with the selector
-"list" (see subpatch "list_conversion" for more info).;
-#X text 98 440 symbol atom;
-#X text 98 456 symbol atom;
-#X connect 13 0 24 0;
-#X connect 14 0 24 0;
-#X connect 15 0 24 0;
-#X connect 16 0 24 1;
-#X connect 17 0 24 1;
-#X connect 18 0 24 1;
-#X connect 19 0 24 1;
-#X connect 20 0 24 1;
-#X connect 24 0 25 0;
-#X restore 102 387 pd prepend;
-#N canvas 1 82 555 530 split 0;
-#X obj 0 0 cnv 15 552 40 empty \$0-pddp.cnv.header empty 3 12 0 14
--204280 -1 0;
-#X obj 0 277 cnv 3 520 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13
--228856 -1 0;
-#X obj 0 371 cnv 3 520 3 empty \$0-pddp.cnv.outlets outlets 8 12 0
-13 -228856 -1 0;
-#X obj 78 380 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856
--162280 0;
-#X obj 78 286 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856
--162280 0;
-#X obj 78 314 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856
--162280 0;
-#X text 98 287 anything;
-#X obj 0 458 cnv 3 520 3 empty \$0-pddp.cnv.argument arguments 8 12
-0 13 -228856 -1 0;
-#X text 80 477 1);
-#X msg 200 145 bang;
-#X obj 159 173 list split 2;
-#X floatatom 262 148 3 0 5 0 - - -;
-#X msg 159 57 1 2;
-#X msg 124 57 1;
-#X text 156 228 first n;
-#X text 245 228 rest of list;
-#X text 337 228 shorter than n;
-#X text 18 24 cut a list into smaller ones;
-#X obj 13 3 list split;
-#X msg 173 79 one 2 3;
-#X msg 183 101 list one 2 3;
-#X msg 193 123 1 2 three;
-#X obj 159 211 print split0;
-#X obj 248 211 print split1;
-#X obj 340 211 print split2;
-#X text 178 287 - all input is converted to a list.;
-#X text 98 315 float;
-#X text 98 381 list;
-#X obj 78 403 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856
--162280 0;
-#X text 98 404 list;
-#X obj 78 425 cnv 17 3 17 empty \$0-pddp.cnv.let.2 2 5 9 0 16 -228856
--162280 0;
-#X text 98 426 list;
-#X text 178 315 - split point. A value of n will send the first n elements
-to the left outlet \, and the rest of the list to the middle outlet.
-Incoming lists shorter than n are sent to the rightmost outlet.;
-#X text 168 381 - the first n elements of the incoming list.;
-#X text 168 404 - the remaining elements of the incoming list.;
-#X text 168 426 - if the incoming list has fewer than n elements \,
-it is sent in its entirety to the rightmost outlet.;
-#X text 170 477 - the symbol "split".;
-#X text 98 493 float;
-#X text 80 493 2);
-#X text 98 477 symbol atom;
-#X text 170 493 - (optional) an integer to initialize the split point.
-;
-#X connect 9 0 10 0;
-#X connect 10 0 22 0;
-#X connect 10 1 23 0;
-#X connect 10 2 24 0;
-#X connect 11 0 10 1;
-#X connect 12 0 10 0;
-#X connect 13 0 10 0;
-#X connect 19 0 10 0;
-#X connect 20 0 10 0;
-#X connect 21 0 10 0;
-#X restore 102 409 pd split;
-#N canvas 1 82 555 481 trim 0;
-#X obj 0 0 cnv 15 552 40 empty \$0-pddp.cnv.header empty 3 12 0 14
--204280 -1 0;
-#X obj 0 330 cnv 3 520 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13
--228856 -1 0;
-#X obj 0 385 cnv 3 520 3 empty \$0-pddp.cnv.outlets outlets 8 12 0
-13 -228856 -1 0;
-#X obj 78 394 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856
--162280 0;
-#X obj 78 339 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856
--162280 0;
-#X text 98 340 anything;
-#X obj 0 429 cnv 3 520 3 empty \$0-pddp.cnv.argument arguments 8 12
-0 13 -228856 -1 0;
-#X text 80 448 1);
-#X msg 49 139 1 2 3;
-#X msg 49 90 list cis boom bah;
-#X msg 49 195 bang;
-#X msg 49 63 walk the dog;
-#X obj 49 276 list trim;
-#X obj 49 298 print trim;
-#X msg 49 222 1 x y;
-#X msg 49 248 x 1 y;
-#X msg 49 113 55;
-#X text 98 395 anything;
-#X text 170 448 - the symbol "trim".;
-#X obj 13 3 list trim;
-#X text 18 24 remove the list selector;
-#X text 128 230 The [list trim] object inputs lists (or makes lists
-out of incoming non-list messages) and outputs a message whose selector
-is the first item of the list \, and whose arguments \, if any \, are
-the remainder of the list. If the list has no items \, or if its first
-item is numeric \, the selector is "list" (which might print out as
-list \, float \, or bang.);
-#X text 98 448 symbol atom;
-#X text 178 340 - all input is converted to a list. A bang message
-is converted to an empty list. A symbol message like "symbol blah"
-is converted to "list blah".;
-#X text 134 63 non-list messages remain non-list messages;
-#X text 97 139 implicit list remains a list;
-#X msg 49 167 symbol x;
-#X text 86 195 becomes message "list" (interpreted by most objects
-as bang);
-#X text 166 90 "list" selector gets trimmed off;
-#X text 79 113 becomes "list 55" (interpreted by most objects as float)
-;
-#X text 112 167 "symbol" selector gets trimmed off.;
-#X text 168 395 - after the incoming message is converted to a list
-\, the "list" selector is removed and the message is output.;
-#X connect 8 0 12 0;
-#X connect 9 0 12 0;
-#X connect 10 0 12 0;
-#X connect 11 0 12 0;
-#X connect 12 0 13 0;
-#X connect 14 0 12 0;
-#X connect 15 0 12 0;
-#X connect 16 0 12 0;
-#X connect 26 0 12 0;
-#X restore 102 431 pd trim;
-#N canvas 1 99 555 490 length 0;
-#X obj 0 0 cnv 15 552 40 empty \$0-pddp.cnv.header empty 3 12 0 14
--204280 -1 0;
-#X obj 0 374 cnv 3 520 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13
--228856 -1 0;
-#X obj 0 411 cnv 3 520 3 empty \$0-pddp.cnv.outlets outlets 8 12 0
-13 -228856 -1 0;
-#X obj 78 420 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856
--162280 0;
-#X obj 78 383 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856
--162280 0;
-#X text 98 384 anything;
-#X obj 0 448 cnv 3 520 3 empty \$0-pddp.cnv.argument arguments 8 12
-0 13 -228856 -1 0;
-#X text 80 467 1);
-#X obj 13 3 list length;
-#X msg 226 161 1 2 3;
-#X msg 226 112 list cis boom bah;
-#X msg 227 187 bang;
-#X msg 226 85 walk the dog;
-#X msg 227 209 1 x y;
-#X msg 226 235 x 1 y;
-#X msg 226 135 55;
-#X obj 201 263 list length;
-#X floatatom 201 289 5 0 0 0 - - -;
-#X text 18 24 number of elements in a list;
-#X text 98 421 float;
-#X text 170 467 - the symbol "length".;
-#X text 98 467 symbol atom;
-#X text 168 384 - any message type is accepted and converted to a list.
-;
-#X text 168 421 - [list length] outputs the number of elements in the
-list.;
-#X connect 9 0 16 0;
-#X connect 10 0 16 0;
-#X connect 11 0 16 0;
-#X connect 12 0 16 0;
-#X connect 13 0 16 0;
-#X connect 14 0 16 0;
-#X connect 15 0 16 0;
-#X connect 16 0 17 0;
-#X restore 102 453 pd length;
-#X text 98 314 symbol atom;
-#X text 98 329 float;
-#N canvas 49 88 428 419 list_conversion_in_Pd 0;
-#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0
-14 -204280 -1 0;
-#X text 7 1 [list] Conversion;
-#X text 19 168 In brief:;
-#X text 19 188 "list" -> bang;
-#X text 19 208 "list 1" -> "float 1";
-#X text 19 228 "list hello" -> "symbol hello";
-#X text 19 37 Most objects in Pd handle zero- and one-element lists
-in the following way:;
-#X text 19 67 * an incoming zero-element list (i.e. \, a message consisting
-onf the selector "list") is treated as a bang.;
-#X text 19 97 * an incoming one-element list that contains a float
-is treated as a float.;
-#X obj 22 331 route list float;
-#X obj 22 304 list;
-#X obj 22 358 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1
--1;
-#X obj 68 358 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1
--1;
-#X msg 22 277 12;
-#X text 55 277 implicit float-- same as "float 12";
-#X text 55 304 output as "list 12";
-#X floatatom 68 387 5 0 0 0 - - -;
-#X text 130 331 [route] converts "list 12" to "float 12";
-#X text 19 127 * an incoming one-element list that contains a symbol
-atom is treated as a symbol.;
-#X connect 9 0 11 0;
-#X connect 9 1 12 0;
-#X connect 9 1 16 0;
-#X connect 10 0 9 0;
-#X connect 13 0 10 0;
-#X restore 241 546 pd list_conversion_in_Pd;
-#X text 170 314 - (optional) if no creation argument is given \, or
-if the first creation argument is a number \, [list] will behave like
-[list append]. Otherwise \, one of the following symbols may be given
-as arguments (see subpatches for more info):;
-#X text 98 252 [list] family objects always output a list. See the
-"list_conversion_in_Pd" subpatch below for how lists are interpreted
-by other objects.;
-#X text 98 474 depending on what the first creation argument is \,
-other creation arguments may be specified.;
-#X text 98 171 See subpatches under the heading "arguments" for more
-details. With the exception of the right inlet of [list split] \, All
-[list] objects will convert incoming non-list messages to lists (e.g.
-\, "set 5" will become "list set 5"). A bang message is converted to
-an empty list (i.e. \, "list") \, and "symbol foo" is converted to
-"list foo".;
-#X obj 4 598 pddp/pddplink pddp/help.pd -text help;
-#X connect 22 0 25 0;
-#X connect 23 0 22 1;
-#X connect 24 0 22 0;
-#X connect 26 0 22 1;
+#X restore 222 463 pd example3;
+#X obj 23 207 list;
+#X text 71 208 - short for "list append";
+#X text 141 185 - output number of items in list;
+#N canvas 188 111 576 365 length 0;
+#X msg 126 183 1 2 3;
+#X msg 126 134 list cis boom bah;
+#X msg 127 209 bang;
+#X msg 126 107 walk the dog;
+#X msg 127 231 1 x y;
+#X msg 126 257 x 1 y;
+#X msg 126 157 55;
+#X obj 101 285 list length;
+#X floatatom 101 311 5 0 0 0 - - -;
+#X text 29 18 length - number of items in list;
+#X text 27 55 The "list length" object outputs the number of arguments
+in a list or other message.;
+#X connect 0 0 7 0;
+#X connect 1 0 7 0;
+#X connect 2 0 7 0;
+#X connect 3 0 7 0;
+#X connect 4 0 7 0;
+#X connect 5 0 7 0;
+#X connect 6 0 7 0;
+#X connect 7 0 8 0;
+#X restore 506 186 pd length;
+#X text 353 468 updated for Pd version 0.40.;
+#X obj 22 182 list length;