Jonathan Wilke's updated bang-help

svn path=/trunk/; revision=17199

1 files changed, 22 insertions, 24 deletions

diff --git a/doc/pddp/bang-help.pd b/doc/pddp/bang-help.pd
index c928a2ab..a72a8ba9 100644
--- a/doc/pddp/bang-help.pd
+++ b/doc/pddp/bang-help.pd
@@ -49,15 +49,10 @@ Pd version 0.42.;
 #X obj 465 20 pddp/pddplink http://wiki.puredata.info/en/bang -text
 pdpedia: bang;
 #X obj 469 3 bang;
-#X obj 139 224 print;
-#X msg 152 171 walk the cat;
-#X msg 139 145 45;
-#X obj 139 199 bang;
-#X obj 288 199 print;
-#X msg 288 147 walk the cat;
-#X obj 288 175 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
--1;
-#X text 310 173 <- gui "bng" object;
+#X obj 249 229 print;
+#X msg 262 169 walk the cat;
+#X msg 249 138 45;
+#X obj 249 199 bang;
 #X text 98 337 anything;
 #N canvas 57 48 428 509 More_bang_objects 0;
 #X obj 23 42 bang;
@@ -83,27 +78,31 @@ pdpedia: bang;
 #X text 151 419 Abbrevation:;
 #X obj 253 419 t b;
 #X obj 271 471 b;
-#X text 43 138 This version uses minimal CPU but serves essentially
-the same purpose as the GUI version below.;
 #X text 42 309 The word "bang" in a message box (CTRL+2) makes a clickable
 bang object. Use commas to send multiple messages:;
 #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 [bang] Common Objects for Sending bang Messages;
-#X text 20 65 The [bang] object is one of the basic building blocks
-of PD and is normally used to activate events. The four basic ways
-to send a "bang" message are:;
 #X text 42 441 When given a single argument of "bang" \, the trigger
 object is essentially the same as #1 above \, so in this case it's
 preferable (and less typing) to use:;
 #X text 67 174 a.k.a. [bng];
-#X text 42 191 This version uses a little more CPU than its cousin
-because it lights up when it receives a message or is clicked on and
-can be coloured \, resized \, or renamed. It is sometimes 'friendlier'
-as well because it can act as its own send and receive object (see
-properties...). This object can be put in a Pd patch either by keyboard
-shortcut: ALT+SHIFT+B or by creating an object (CTRL+1) and naming
-it "bng".;
+#X text 20 65 The [bang] object is one of the basic building blocks
+of PD and is normally used to activate events. It is one of four basic
+ways to send a "bang" message:;
+#X text 43 138 This version uses minimal CPU and will send a bang on
+any message to its inlet.;
+#X text 42 191 This object uses more CPU than its cousin because it
+lights up when it receives a message or is clicked. Some messages are
+reserved for changing its colour \, size \, name \, etc. These messages
+will not cause a bang to be output \, so it shouldn't be used to trigger
+bang messages based on arbitrary data input. This object can be put
+in a Pd patch either by keyboard shortcut: ALT+SHIFT+B or by creating
+an object (CTRL+1) and naming it "bng".;
+#X text 184 348 (Note: the message box reserves some;
+#X text 184 363 messages-- like "set"-- to alter the;
+#X text 184 378 content of the box. So unlike [bang];
+#X text 184 393 you should not sent it arbitrary data.);
 #X connect 11 0 12 0;
 #X connect 12 0 13 0;
 #X connect 12 0 14 0;
@@ -124,11 +123,10 @@ It's neither a zero or a one \; it's not true or false \; it's just
 ;
 #X text 168 337 - [bang] takes any message supplied to its inlet and
 outputs a bang message in response.;
-#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 521 3 b;
 #X text 501 3 or;
 #X connect 15 0 17 0;
 #X connect 16 0 17 0;
 #X connect 17 0 14 0;
-#X connect 19 0 20 0;
-#X connect 20 0 18 0;