Revised and added to all_about help patches

svn path=/trunk/; revision=13941

1 files changed, 153 insertions, 57 deletions

diff --git a/doc/pddp/all_about_lists_vs_anythings.pd b/doc/pddp/all_about_lists_vs_anythings.pd
index 0579c050..d81f8e48 100644
--- a/doc/pddp/all_about_lists_vs_anythings.pd
+++ b/doc/pddp/all_about_lists_vs_anythings.pd
@@ -1,74 +1,75 @@
-#N canvas 63 22 763 581 10;
-#X msg 95 298 1 2 3;
-#X obj 125 329 route list;
-#X msg 62 278 list 1 2 3;
-#X msg 10 63 list;
-#X symbolatom 32 129 10 0 0 0 - - -;
+#N canvas 0 0 448 568 10;
+#N canvas 0 0 878 658 old 0;
+#X msg 95 368 1 2 3;
+#X obj 125 399 route list;
+#X msg 62 348 list 1 2 3;
+#X msg 10 93 list;
+#X symbolatom 32 159 10 0 0 0 - - -;
 #X obj 4 2 cnv 15 750 20 empty empty all_about_lists_vs_anythings 20
 10 1 18 -233017 -66577 0;
-#X text 7 39 SPECIAL CASES OF "LISTS".;
-#X obj 125 348 bng 15 250 50 0 empty empty list -20 7 1 10 -262144
+#X text 7 69 SPECIAL CASES OF "LISTS".;
+#X obj 125 418 bng 15 250 50 0 empty empty list -20 7 1 10 -262144
 -1 -1;
-#X obj 189 349 bng 15 250 50 0 empty empty non-list 19 7 1 10 -262144
+#X obj 189 419 bng 15 250 50 0 empty empty non-list 19 7 1 10 -262144
 -1 -1;
-#X msg 184 277 list this is a set with a cast;
-#X msg 191 296 this is a set withOUT a cast;
-#X obj 441 135 bng 15 250 50 0 empty empty bang 0 20 1 9 -262144 -1
+#X msg 184 347 list this is a set with a cast;
+#X msg 191 366 this is a set withOUT a cast;
+#X obj 441 195 bng 15 250 50 0 empty empty bang 0 20 1 9 -262144 -1
 -1;
-#X obj 490 135 bng 15 250 50 0 empty empty float 0 21 1 9 -262144 -1
+#X obj 490 195 bng 15 250 50 0 empty empty float 0 21 1 9 -262144 -1
 -1;
-#X obj 539 135 bng 15 250 50 0 empty empty symbol 0 21 1 9 -262144
+#X obj 539 195 bng 15 250 50 0 empty empty symbol 0 21 1 9 -262144
 -1 -1;
-#X msg 443 73 list this is a set with a cast;
-#X msg 450 92 this is a set withOUT a cast;
-#X obj 638 135 bng 15 250 50 0 empty empty list 0 21 1 9 -262144 -1
+#X msg 443 133 list this is a set with a cast;
+#X msg 450 152 this is a set withOUT a cast;
+#X obj 638 195 bng 15 250 50 0 empty empty list 0 21 1 9 -262144 -1
 -1;
-#X obj 120 527 route list;
-#X obj 120 546 bng 15 250 50 0 empty empty list -20 7 1 10 -262144
+#X obj 120 617 route list;
+#X obj 120 636 bng 15 250 50 0 empty empty list -20 7 1 10 -262144
 -1 -1;
-#X obj 184 547 bng 15 250 50 0 empty empty non-list 19 7 1 10 -262144
+#X obj 184 637 bng 15 250 50 0 empty empty non-list 19 7 1 10 -262144
 -1 -1;
-#X msg 189 491 one 2 three 4 five;
-#X msg 40 491 1 two 3 four 5;
-#X text 8 198 IMPLICIT LISTS;
-#X msg 40 471 list 1 two 3 four 5;
-#X msg 189 471 list one 2 three 4 five;
-#X msg 17 83 list 25;
-#X msg 24 103 list foo;
-#X text 87 104 A "list" of one "symbol" is converted to a "symbol"
+#X msg 189 581 one 2 three 4 five;
+#X msg 40 581 1 two 3 four 5;
+#X text 8 268 IMPLICIT LISTS;
+#X msg 40 561 list 1 two 3 four 5;
+#X msg 189 561 list one 2 three 4 five;
+#X msg 17 113 list 25;
+#X msg 24 133 list foo;
+#X text 87 134 A "list" of one "symbol" is converted to a "symbol"
 ;
-#X text 72 83 A "list" of one "float" is converted to a "float";
-#X text 50 63 An empty "list" is converted to a "bang";
-#X obj 477 514 pddp/pddplink all_about_atom_conversion.pd -text all_about_atom_conversion
+#X text 72 113 A "list" of one "float" is converted to a "float";
+#X text 50 93 An empty "list" is converted to a "bang";
+#X obj 477 594 pddp/pddplink all_about_atom_conversion.pd -text all_about_atom_conversion
 ;
 #X obj 721 3 pddp/pddplink http://puredata.info/dev/pddp -text pddp
 ;
-#X text 11 400 Sets of mixed atoms are defined based on what the "selector"
+#X text 11 490 Sets of mixed atoms are defined based on what the "selector"
 (the first element of a set). If the "selector" is a "float" \, then
 the set is a "list". If the "selector" is the word "list" \, then the
 set is a "list". If the "selector" is a "symbol" \, then the set is
 NOT a "list":;
-#X text 600 551 updated for Pd 0.38-2;
-#X obj 688 135 bng 15 250 50 0 empty empty UNDEFINED 0 21 1 9 -262144
+#X text 570 631 updated for Pd 0.38-2;
+#X obj 688 195 bng 15 250 50 0 empty empty UNDEFINED 0 21 1 9 -262144
 -1 -1;
-#X msg 459 286 1 1;
-#X obj 452 312 +;
-#X floatatom 452 334 5 0 0 0 - - -;
-#X msg 424 286 1 3;
-#X text 416 46 A set that is not a "list" has an undefined type:;
-#X msg 451 267 list 1 2;
-#X text 402 208 If you send a "list" of arguments to the first inlet
+#X msg 459 356 1 1;
+#X obj 452 382 +;
+#X floatatom 452 404 5 0 0 0 - - -;
+#X msg 424 356 1 3;
+#X text 416 106 A set that is not a "list" has an undefined type:;
+#X msg 451 337 list 1 2;
+#X text 402 278 If you send a "list" of arguments to the first inlet
 of an object \, the elements of that "list" will be applied to the
 respective inlet. This does not apply to sets that are NOT "lists".
 ;
-#X text 400 192 "LISTS" MAP TO INLETS;
-#X text 407 367 WORKING WITH MIXED SETS;
-#X text 11 381 SETS OF MIXED "ATOMS";
-#X text 9 218 A message having more than one atom starting with a "float"
+#X text 400 262 "LISTS" MAP TO INLETS;
+#X text 407 457 WORKING WITH MIXED SETS;
+#X text 11 471 SETS OF MIXED "ATOMS";
+#X text 9 288 A message having more than one atom starting with a "float"
 is implicitly considered a list. A message having more than one atom
 starting with a "symbol" is not \, unless that "symbol" is the selector
 "list".;
-#N canvas 183 32 857 475 has 0;
+#N canvas 30 68 857 475 has 0;
 #X obj 96 162 print;
 #X msg 57 93 list one two three;
 #X msg 42 54 1 2 3;
@@ -195,26 +196,32 @@ symbol] outputs a symbol from its left outlet.;
 #X connect 53 0 54 0;
 #X connect 54 0 48 0;
 #X connect 54 1 49 0;
-#X restore 443 453 pd has some odd cases of list handling;
-#X text 407 389 When working with sets that might be either "lists"
+#X restore 443 543 pd has some odd cases of list handling;
+#X text 407 479 When working with sets that might be either "lists"
 or undefined \, use [prepend]. Many of the "list" handling objects
 in Pd have odd quirks which can make things difficult.;
-#X obj 441 115 route bang float symbol pointer list;
-#X obj 589 135 bng 15 250 50 0 empty empty pointer 0 21 1 9 -262144
+#X obj 441 175 route bang float symbol pointer list;
+#X obj 589 195 bng 15 250 50 0 empty empty pointer 0 21 1 9 -262144
 -1 -1;
-#X obj 11 169 bng 15 250 50 0 empty empty bang 0 20 1 9 -262144 -1
+#X obj 11 199 bng 15 250 50 0 empty empty bang 0 20 1 9 -262144 -1
 -1;
-#X obj 60 169 bng 15 250 50 0 empty empty float 0 21 1 9 -262144 -1
+#X obj 60 199 bng 15 250 50 0 empty empty float 0 21 1 9 -262144 -1
 -1;
-#X obj 109 169 bng 15 250 50 0 empty empty symbol 0 21 1 9 -262144
+#X obj 109 199 bng 15 250 50 0 empty empty symbol 0 21 1 9 -262144
 -1 -1;
-#X obj 208 169 bng 15 250 50 0 empty empty list 0 21 1 9 -262144 -1
+#X obj 208 199 bng 15 250 50 0 empty empty list 0 21 1 9 -262144 -1
 -1;
-#X obj 258 169 bng 15 250 50 0 empty empty UNDEFINED 0 21 1 9 -262144
+#X obj 258 199 bng 15 250 50 0 empty empty UNDEFINED 0 21 1 9 -262144
 -1 -1;
-#X obj 11 149 route bang float symbol pointer list;
-#X obj 159 169 bng 15 250 50 0 empty empty pointer 0 21 1 9 -262144
+#X obj 11 179 route bang float symbol pointer list;
+#X obj 159 199 bng 15 250 50 0 empty empty pointer 0 21 1 9 -262144
 -1 -1;
+#X text 39 53 (this has nothing to do with lists vs. anythings);
+#X text 419 243 (this has nothing to do with lists vs. anythings);
+#X text 413 79 (this is misleading-- the anything below would match
+selector "this");
+#X text 424 440 (mention list trim here);
+#X text 16 455 (this is an anything \, which is never defined);
 #X connect 0 0 1 0;
 #X connect 1 0 7 0;
 #X connect 1 1 8 0;
@@ -249,3 +256,92 @@ in Pd have odd quirks which can make things difficult.;
 #X connect 55 3 56 0;
 #X connect 55 4 53 0;
 #X connect 55 5 54 0;
+#X restore 368 202 pd old;
+#X obj 1 1 cnv 15 445 20 empty \$0-pddp.cnv.header lists_vs_anythings
+20 10 1 18 -261106 -33289 0;
+#X obj 407 2 pddp/pddplink http://puredata.info/dev/pddp -text pddp
+;
+#X obj 1 546 cnv 15 445 20 empty \$0-pddp.cnv.footer empty 20 12 0
+14 -233017 -33289 0;
+#N canvas 44 246 494 344 META 0;
+#X text 12 115 HELP_PATCH_AUTHORS Dave Sabine \, May 5 \, 2003 . Jonathan
+Wilkes revised the patch to conform to the PDDP template for Pd version
+0.42.;
+#X text 12 95 LIBRARY PDDP;
+#X text 12 5 GENRE all_about_pd;
+#X text 12 45 KEYWORDS needs_work;
+#X text 12 25 NAME list;
+#X text 12 65 DESCRIPTION definitions for list and anything in the
+context of Pd;
+#X restore 392 548 pd META;
+#X obj 6 548 pddp/pddplink pddp/help.pd -text help;
+#X obj 40 92 pddp/pddplink all_about_atoms.pd;
+#X obj 40 107 pddp/pddplink all_about_messages.pd;
+#X text 40 249 Anythings;
+#X text 40 182 Examples:;
+#X text 60 202 list one two three;
+#X text 60 217 0 1 60;
+#X text 60 232 list foo 121 bar;
+#X text 40 35 If you are familiar with messages in Pd then the difference
+between a list and an "anything" will be easy to understand. If not
+\, have a look at the following help patches:;
+#X text 199 201 move to all_about_route? ->;
+#X text 40 142 A list message consists of either a) the selector "list"
+followed by two or more atoms \, or b) a multi-element message beginning
+with a number ("implicit list").;
+#X text 40 269 1) The term "anything" in Pd generally means "any message"--
+to be specific \, any message in Pd that has a valid selector (or is
+an implicit float or list message). This includes the built-in message
+types float \, symbol \, list \, bang \, and pointer \, as well as
+custom messages like "set 87" \, print \, debug \, "receive972 a b
+d 3" \, etc.;
+#X text 40 349 2) The term "anything" is also used to mean messages
+with selectors other than those of Pd's built-in message types-- i.e
+\, "anything else." This use probably arises because there is not a
+name for the set of messages consisting of one or more atoms that aren't
+float \, symbol \, list \, pointer \, nor bang messages. (The word
+"meta-message" is synonymous with this meaning.);
+#N canvas 14 370 428 105 Fine_print 0;
+#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0
+14 -261106 -33289 0;
+#X text 7 2 Lists vs. Anythings - A few more details;
+#X text 22 43 What about messages with custom atoms? Are these included
+in "anything"?;
+#X restore 243 253 pd Fine_print;
+#X text 39 448 * (archaic) To confuse matters even more \, many externals
+were made before there was a built-in "list" message in Pd. Some external
+objects' help patches may refer to all messages that are not a symbol
+\, float \, pointer \, or bang as a "list.";
+#X text 40 127 Lists *;
+#N canvas 15 248 428 305 Related_objects_and_Quick_Quiz 0;
+#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0
+14 -261106 -33289 0;
+#X text 7 2 Lists vs. Anythings - Related Objects;
+#X obj 22 43 list;
+#X msg 77 43;
+#X obj 1 71 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12
+0 14 -261106 -33289 0;
+#X text 7 72 Quick Quiz!;
+#X msg 35 105 list one two three;
+#X msg 65 156 one two three;
+#X msg 75 183 symbol one_two_three;
+#X msg 55 129 1 2 3;
+#X obj 35 215 route list symbol one;
+#X obj 153 242 bng 15 500 50 0 empty empty one 0 24 1 12 -262144 -1
+-1;
+#X obj 86 242 bng 15 500 50 0 empty empty symbol 0 24 1 12 -262144
+-1 -1;
+#X obj 35 242 bng 15 500 50 0 empty empty list 0 24 1 12 -262144 -1
+-1;
+#X obj 201 242 bng 15 500 50 0 empty empty None_of_the_above 0 24 1
+12 -262144 -1 -1;
+#X connect 6 0 10 0;
+#X connect 7 0 10 0;
+#X connect 8 0 10 0;
+#X connect 9 0 10 0;
+#X connect 10 0 13 0;
+#X connect 10 1 12 0;
+#X connect 10 2 11 0;
+#X connect 10 3 14 0;
+#X restore 103 548 pd Related_objects_and_Quick_Quiz;
+#X obj 40 517 pddp/pddplink all_about_message_conversion.pd;