fixed typos and mentioned fswap alias in swap-help.pd

svn path=/trunk/; revision=15060

4 files changed, 104 insertions, 101 deletions

diff --git a/doc/pddp/all_about_atom_conversion.pd b/doc/pddp/all_about_atom_conversion.pd
index 9e0cb1bd..210e5ca2 100644
--- a/doc/pddp/all_about_atom_conversion.pd
+++ b/doc/pddp/all_about_atom_conversion.pd
@@ -35,7 +35,7 @@ Wilkes revised the patch to conform to the PDDP template for Pd version
 #X obj 43 65 pddp/pddplink all_about_atoms.pd;
 #X text 42 36 Converting between atom types in Pd can be tricky. Make
 sure you have read the following help patches first:;
-#N canvas 9 155 428 140 symbol-atom_to_float 0;
+#N canvas 11 164 428 140 symbol-atom_to_float 0;
 #X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 20 10
 1 18 -261106 -33289 0;
 #X text 7 1 From a symbol-atom to a float;
@@ -43,19 +43,13 @@ sure you have read the following help patches first:;
 #X obj 20 90 pddp/helplink zexy/symbol2list;
 #X text 20 37 There are no internal objects to turn a symbol-atom into
 a float. There are two important externals for this \, however:;
-#X restore 43 149 pd symbol-atom_to_float;
-#N canvas 14 48 428 554 float_to_symbol-atom 0;
+#X restore 43 128 pd symbol-atom_to_float;
+#N canvas 15 77 428 554 float_to_symbol-atom 0;
 #X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 20 10
 1 18 -261106 -33289 0;
 #X text 7 1 Changing a float to a symbol-atom;
-#X obj 45 163 hsl 128 15 0 127 0 0 empty 123 empty -2 -8 0 10 -262144
--1 -1 7000 1;
-#X text 19 79 For example \, you can enter a number for the "receive-symbol"
-of the so-called IEMGUIS like the slider below. Since receive-names
-need to be symbol-atoms \, the GUI automatically converts "123" to
-a symbol-atom after you click "Ok" or "Apply" in the "Properties" dialogue.
-;
-#X text 181 158 <- hslider with receive-symbol "123";
+#X obj 45 201 hsl 128 15 0 127 0 0 empty 123 empty -2 -8 0 10 -262144
+-1 -1 0 1;
 #X msg 42 353 symbol 123;
 #X obj 42 375 print empty_symbol;
 #X msg 151 457 123;
@@ -66,33 +60,38 @@ a symbol-atom after you click "Ok" or "Apply" in the "Properties" dialogue.
 #X text 255 509 symbol-atom;
 #X obj 130 503 send;
 #X floatatom 93 479 5 0 0 0 - - -;
-#X text 19 395 The [makefilename] object will do the trick \, however.
-It always outputs a symbol message (remember that a symbol message
-must have a symbol-atom as an element) \, and so it can convert an
-incoming float to a symbol-atom:;
 #X text 19 494 Also see:;
 #X obj 20 514 pddp/helplink zexy/list2symbol;
 #X obj 20 529 pddp/helplink cyclone/tosymbol;
-#X text 19 36 Problem: some objects in Pd expect certain atom types
-and will complain with an error if they receive the wrong type. Other
-objects will silently make the conversion for you.;
-#X text 19 183 Note that there's no visible difference between the
-float "123" and the symbol-atom "123"-- the only difference is in how
-these character are understood by Pd. If I want to send a value to
-the slider using [send] \, there is a problem because [send] doesn't
-do any atom conversion-- if you try to create [send 123] you'll get
-an error.;
 #X text 19 267 However \, you can send a symbol message to the right
 inlet of [send] to specify the send-name. You might think that using
-a symbol message will convert the number to a symbol-atom. Unfortunately
-\, that doesn't work either-- the message box silently ignores the
-float and outputs an empty symbol:;
-#X connect 5 0 6 0;
-#X connect 7 0 9 0;
-#X connect 9 0 13 1;
-#X connect 14 0 13 0;
+a symbol message will convert the float to a symbol-atom. Unfortunately
+\, that doesn't work either-- the message box in Pd silently ignores
+the float and outputs an empty symbol:;
+#X text 19 119 For example \, you can enter a number for the "receive-symbol"
+of the so-called IEMGUIS like the slider below. Since receive-names
+need to be symbol-atoms \, the slider automatically makes "123" a symbol-atom
+after you click "Ok" or "Apply" in the "Properties" dialogue.;
+#X text 181 198 <- [hslider] with receive-symbol "123";
+#X text 19 36 Usually it is easy to distinguish between floats and
+symbol-atoms in Pd. However \, there are times when it can be useful
+to have a symbol-atom that looks like a number. This can quickly get
+confusing because there's no visible difference between the float "123"
+and the symbol-atom "123". The only difference is in how it is understood
+by Pd.;
+#X text 19 225 If I try to send a value to the slider using [send 123]
+\, there will be an error because after I type the argument "123" in
+an object box \, Pd will interpret it as a float.;
+#X text 19 395 Solution: the [makefilename] object. It always outputs
+a symbol message (remember that a symbol message must have a symbol-atom
+as an element) \, and so it will convert an incoming float to a symbol-atom:
+;
+#X connect 3 0 4 0;
+#X connect 5 0 7 0;
+#X connect 7 0 11 1;
+#X connect 12 0 11 0;
 #X restore 43 106 pd float_to_symbol-atom;
-#N canvas 22 133 428 426 multiple_atoms_to_one_symbol-atom 0;
+#N canvas 25 220 428 426 multiple_atoms_to_one_symbol-atom 0;
 #X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 20 10
 1 18 -261106 -33289 0;
 #X text 7 1 Concatenate multiple atoms;
@@ -119,7 +118,7 @@ that contains spaces in it. Use the %c argument with [makefilename].
 #X connect 4 0 5 0;
 #X connect 10 0 11 0;
 #X connect 12 0 10 0;
-#X restore 43 128 pd multiple_atoms_to_one_symbol-atom;
+#X restore 43 150 pd multiple_atoms_to_one_symbol-atom;
 #X text 42 171 See also:;
 #X obj 43 187 pddp/pddplink all_about_message_conversion.pd;
 #X obj 43 202 pddp/pddplink all_about_symbol_construction.pd;
diff --git a/doc/pddp/all_about_atoms.pd b/doc/pddp/all_about_atoms.pd
index bd775df3..108a6b7d 100644
--- a/doc/pddp/all_about_atoms.pd
+++ b/doc/pddp/all_about_atoms.pd
@@ -3,7 +3,7 @@
 -261106 -33289 0;
 #X obj 407 2 pddp/pddplink http://puredata.info/dev/pddp -text pddp
 ;
-#N canvas 14 48 428 202 What_is_an_atom? 0;
+#N canvas 15 77 428 202 What_is_an_atom? 0;
 #X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 20 10
 1 18 -261106 -33289 0;
 #X text 7 1 What is an atom in Pd?;
diff --git a/doc/pddp/all_about_data_types.pd b/doc/pddp/all_about_data_types.pd
index 9fa53203..c9de0c72 100644
--- a/doc/pddp/all_about_data_types.pd
+++ b/doc/pddp/all_about_data_types.pd
@@ -1,52 +1,52 @@
-#N canvas 0 0 448 239 10;

-#X obj 1 1 cnv 15 445 20 empty \$0-pddp.cnv.header data_types 20 10

-1 18 -261106 -33289 0;

-#X obj 407 2 pddp/pddplink http://puredata.info/dev/pddp -text pddp

-;

-#X obj 43 66 pddp/pddplink all_about_atoms.pd;

-#X obj 1 217 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 105 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 85 LIBRARY PDDP;

-#X text 12 5 GENRE all_about_pd;

-#X text 12 25 NAME;

-#X text 12 45 KEYWORDS;

-#X text 12 65 DESCRIPTION list of help patches related to Pd data types

-;

-#X restore 392 219 pd META;

-#X obj 6 219 pddp/pddplink all_about.pd -text All About Pd;

-#N canvas 24 124 428 150 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 Messages- Related Objects;

-#X obj 22 99 bng 15 250 50 0 empty empty list 0 25 0 8 -262144 -1 -1

-;

-#X obj 59 99 bng 15 250 50 0 empty empty bang 0 25 0 8 -262144 -1 -1

-;

-#X obj 97 99 bng 15 250 50 0 empty empty float 0 25 0 8 -262144 -1

--1;

-#X obj 135 99 bng 15 250 50 0 empty empty symbol 0 25 0 8 -262144 -1

--1;

-#X obj 176 99 bng 15 250 50 0 empty empty pop 0 25 0 8 -262144 -1 -1

-;

-#X obj 211 99 bng 15 250 50 0 empty empty none_of_the_above 0 25 0

-8 -262144 -1 -1;

-#X text 276 42 <- Click to find out;

-#X msg 22 43 pop quiz: What type of message is this?;

-#X obj 22 70 route list bang float symbol pop;

-#X connect 9 0 10 0;

-#X connect 10 0 2 0;

-#X connect 10 1 3 0;

-#X connect 10 2 4 0;

-#X connect 10 3 5 0;

-#X connect 10 4 6 0;

-#X connect 10 5 7 0;

-#X restore 103 219 pd Quick_Quiz!;

-#X text 42 36 See:;

-#X obj 43 86 pddp/pddplink all_about_messages.pd;

-#X obj 43 106 pddp/pddplink all_about_message_conversion.pd;

-#X obj 43 126 pddp/pddplink all_about_atom_conversion.pd;

-#X obj 43 146 pddp/pddplink all_about_symbol_construction.pd;

+#N canvas 0 0 448 239 10;
+#X obj 1 1 cnv 15 445 20 empty \$0-pddp.cnv.header data_types 20 10
+1 18 -261106 -33289 0;
+#X obj 407 2 pddp/pddplink http://puredata.info/dev/pddp -text pddp
+;
+#X obj 43 66 pddp/pddplink all_about_atoms.pd;
+#X obj 1 217 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 105 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 85 LIBRARY PDDP;
+#X text 12 5 GENRE all_about_pd;
+#X text 12 25 NAME;
+#X text 12 45 KEYWORDS;
+#X text 12 65 DESCRIPTION list of help patches related to Pd data types
+;
+#X restore 392 219 pd META;
+#X obj 6 219 pddp/pddplink all_about.pd -text All About Pd;
+#N canvas 25 153 428 150 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 Messages- Related Objects;
+#X obj 22 99 bng 15 500 50 0 empty empty list 0 25 0 8 -262144 -1 -1
+;
+#X obj 69 99 bng 15 500 50 0 empty empty bang 0 25 0 8 -262144 -1 -1
+;
+#X obj 117 99 bng 15 500 50 0 empty empty float 0 25 0 8 -262144 -1
+-1;
+#X obj 165 99 bng 15 500 50 0 empty empty symbol 0 25 0 8 -262144 -1
+-1;
+#X obj 213 99 bng 15 500 50 0 empty empty pop 0 25 0 8 -262144 -1 -1
+;
+#X obj 261 99 bng 15 500 50 0 empty empty none_of_the_above 0 25 0
+8 -262144 -1 -1;
+#X text 276 42 <- Click to find out;
+#X msg 22 43 pop quiz: What type of message is this?;
+#X obj 22 70 route list bang float symbol pop;
+#X connect 9 0 10 0;
+#X connect 10 0 2 0;
+#X connect 10 1 3 0;
+#X connect 10 2 4 0;
+#X connect 10 3 5 0;
+#X connect 10 4 6 0;
+#X connect 10 5 7 0;
+#X restore 103 219 pd Quick_Quiz!;
+#X text 42 36 See:;
+#X obj 43 86 pddp/pddplink all_about_messages.pd;
+#X obj 43 106 pddp/pddplink all_about_message_conversion.pd;
+#X obj 43 126 pddp/pddplink all_about_atom_conversion.pd;
+#X obj 43 146 pddp/pddplink all_about_symbol_construction.pd;
diff --git a/doc/pddp/swap-help.pd b/doc/pddp/swap-help.pd
index 9e4b0133..2ab8c4b9 100644
--- a/doc/pddp/swap-help.pd
+++ b/doc/pddp/swap-help.pd
@@ -5,22 +5,23 @@
 -1 0;
 #X obj 0 220 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13
 -228856 -1 0;
-#N canvas 52 246 494 357 META 0;
-#X text 12 145 LIBRARY internal;
-#X text 12 185 WEBSITE http://crca.ucsd.edu/~msp/;
-#X text 12 25 LICENSE SIBSD;
-#X text 12 165 AUTHOR Miller Puckette;
-#X text 12 225 HELP_PATCH_AUTHORS Dave Sabine \, November 12 \, 2002
+#N canvas 53 275 494 357 META 0;
+#X text 12 165 LIBRARY internal;
+#X text 12 205 WEBSITE http://crca.ucsd.edu/~msp/;
+#X text 12 45 LICENSE SIBSD;
+#X text 12 185 AUTHOR Miller Puckette;
+#X text 12 245 HELP_PATCH_AUTHORS Dave Sabine \, November 12 \, 2002
 . Jonathan Wilkes revised the patch to conform to the PDDP template
 for Pd version 0.42.;
-#X text 12 5 KEYWORDS control float list bang;
-#X text 12 45 DESCRIPTION swap two numbers \, respecting right-to-left
+#X text 12 25 KEYWORDS control float list bang;
+#X text 12 65 DESCRIPTION swap two numbers \, respecting right-to-left
 order;
-#X text 12 65 INLET_0 float list bang;
-#X text 12 85 INLET_1 float;
-#X text 12 105 OUTLET_0 float;
-#X text 12 125 OUTLET_1 float;
-#X text 12 205 RELEASE_DATE 1997;
+#X text 12 85 INLET_0 float list bang;
+#X text 12 105 INLET_1 float;
+#X text 12 125 OUTLET_0 float;
+#X text 12 145 OUTLET_1 float;
+#X text 12 225 RELEASE_DATE 1997;
+#X text 12 5 ALIAS fswap;
 #X restore 500 597 pd META;
 #X obj 0 425 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0
 13 -228856 -1 0;
@@ -45,7 +46,7 @@ order;
 #X obj 78 380 cnv 17 3 35 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856
 -162280 0;
 #X text 98 379 float;
-#X obj 493 3 swap;
+#X obj 443 3 swap;
 #X obj 465 20 pddp/pddplink http://wiki.puredata.info/en/swap -text
 pdpedia: swap;
 #X text 98 278 float;
@@ -217,7 +218,10 @@ before packing them up and sending them to the [route] object.;
 #X text 168 456 - outputs the value from the left inlet.;
 #X text 80 503 1) float;
 #X text 168 503 - initializes the value of the right inlet.;
-#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide;
+#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide
+;
+#X obj 503 3 fswap;
+#X text 480 3 or;
 #X connect 24 0 28 0;
 #X connect 24 1 27 0;
 #X connect 25 0 24 0;