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, 91 insertions, 50 deletions

diff --git a/doc/pddp/print-help.pd b/doc/pddp/print-help.pd
index a6fc43a9..9208cb6d 100644
--- a/doc/pddp/print-help.pd
+++ b/doc/pddp/print-help.pd
@@ -1,50 +1,91 @@
-#N canvas 11 11 777 611 10;

-#X msg 93 173 walk the dog;

-#X msg 19 173 bang;

-#X msg 60 173 234;

-#X obj 21 10 print;

-#X obj 19 208 print;

-#X text 20 44 The print object is used in Pd to send messages to the

-'terminal window'. When the print object receives a message \, its

-output will appear in the terminal window following the name of the

-print object and a colon (:). If the print object does not have a name

-(which you can supply as an argument within the print object itself)

-then the word "print" appears followed by a colon (:) and your message.

-;

-#X msg 92 240 walk the dog;

-#X msg 19 240 bang;

-#X msg 59 240 234;

-#X obj 19 267 print myPrintObject;

-#X text 181 268 A print object with a name.;

-#X text 17 309 When the print object receives a list \, it will output

-the entire list as a single message. Like below:;

-#X obj 17 369 print print_this_list;

-#X msg 17 346 10 20 30 foo;

-#X msg 17 461 10 20 30 foo;

-#X obj 17 514 unpack f f f s;

-#X obj 17 547 print unpack_this_list;

-#X text 66 201 A print object without a name. Be sure you can see the

-terminal window as you click on these messages.;

-#X text 74 9 -- print messages to the terminal window;

-#X obj 411 43 print~;

-#X text 410 22 RELATED OBJECTS;

-#X text 17 408 To output the list as separate elements \, the list

-needs to be unpacked first. Note that [unpack]'s outlets are triggered

-from right to left. Like below:;

-#X text 28 481 The arguments here are used to tell Pd what type of

-atom to expect: (f = float \, s = symbol).;

-#X text 402 524 This document was updated for Pd version 0.35 test

-24 by Dave Sabine as part of a project called pddp proposed by Krzysztof

-Czaja to build comprehensive documentation for Pd.;

-#X connect 0 0 4 0;

-#X connect 1 0 4 0;

-#X connect 2 0 4 0;

-#X connect 6 0 9 0;

-#X connect 7 0 9 0;

-#X connect 8 0 9 0;

-#X connect 13 0 12 0;

-#X connect 14 0 15 0;

-#X connect 15 0 16 0;

-#X connect 15 1 16 0;

-#X connect 15 2 16 0;

-#X connect 15 3 16 0;

+#N canvas 190 76 886 627 10;
+#X msg 93 173 walk the dog;
+#X msg 19 173 bang;
+#X msg 60 173 234;
+#X obj 21 10 print;
+#X obj 19 208 print;
+#X text 20 44 The print object is used in Pd to send messages to the
+'terminal window'. When the print object receives a message \, its
+output will appear in the terminal window following the name of the
+print object and a colon (:). If the print object does not have a name
+(which you can supply as an argument within the print object itself)
+then the word "print" appears followed by a colon (:) and your message.
+;
+#X msg 92 240 walk the dog;
+#X msg 19 240 bang;
+#X msg 59 240 234;
+#X obj 19 267 print myPrintObject;
+#X text 181 268 A print object with a name.;
+#X text 17 309 When the print object receives a list \, it will output
+the entire list as a single message. Like below:;
+#X obj 17 369 print print_this_list;
+#X msg 17 346 10 20 30 foo;
+#X msg 17 461 10 20 30 foo;
+#X obj 17 514 unpack f f f s;
+#X obj 17 547 print unpack_this_list;
+#X text 66 201 A print object without a name. Be sure you can see the
+terminal window as you click on these messages.;
+#X text 74 9 -- print messages to the terminal window;
+#X obj 153 588 print~;
+#X text 40 588 RELATED OBJECTS;
+#X text 17 408 To output the list as separate elements \, the list
+needs to be unpacked first. Note that [unpack]'s outlets are triggered
+from right to left. Like below:;
+#X text 28 481 The arguments here are used to tell Pd what type of
+atom to expect: (f = float \, s = symbol).;
+#X obj 477 252 print;
+#X msg 497 87 1;
+#X msg 506 108 float 1;
+#X text 464 52 "floats" are interpreted (i.e. it doesn't show the word
+"float" before the number):;
+#X obj 531 210 symbol test;
+#X msg 526 169 symbol this;
+#X obj 531 191 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X msg 568 383 one 2 three;
+#X obj 500 467 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 568 468 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 586 443 print STRAIGHT;
+#X msg 552 363 list 1 two 3;
+#X msg 535 343 1 two 3;
+#X msg 577 404 list one 2 three;
+#X obj 503 444 route list;
+#X text 467 295 [print] only interprets the "list" selector when the
+following body of the message is an implied list \, i.e. a set of atoms
+that starts with a float.;
+#X text 452 551 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 454 28 [print]'S ODDITIES;
+#X text 509 139 "symbols" are not interpreted (i.e. "symbol" is also
+printed:;
+#X connect 0 0 4 0;
+#X connect 1 0 4 0;
+#X connect 2 0 4 0;
+#X connect 6 0 9 0;
+#X connect 7 0 9 0;
+#X connect 8 0 9 0;
+#X connect 13 0 12 0;
+#X connect 14 0 15 0;
+#X connect 15 0 16 0;
+#X connect 15 1 16 0;
+#X connect 15 2 16 0;
+#X connect 15 3 16 0;
+#X connect 24 0 23 0;
+#X connect 25 0 23 0;
+#X connect 27 0 23 0;
+#X connect 28 0 23 0;
+#X connect 29 0 27 0;
+#X connect 30 0 33 0;
+#X connect 30 0 37 0;
+#X connect 34 0 33 0;
+#X connect 34 0 37 0;
+#X connect 35 0 33 0;
+#X connect 35 0 37 0;
+#X connect 36 0 33 0;
+#X connect 36 0 37 0;
+#X connect 37 0 31 0;
+#X connect 37 1 32 0;