1 files changed, 33 insertions, 20 deletions
diff --git a/pd/doc/5.reference/block~-help.pd b/pd/doc/5.reference/block~-help.pd
index 69abe2e2..4d2bdbdc 100644
--- a/pd/doc/5.reference/block~-help.pd
+++ b/pd/doc/5.reference/block~-help.pd
@@ -1,27 +1,26 @@
-#N canvas 322 48 653 647 12;
-#X text 411 630 updated for Pd version 0.37;
+#N canvas 21 2 607 676 12;
 #X obj 48 10 block~;
 #X text 112 11 (and switch~) - block size and on/off control for DSP
 ;
 #X text 44 40 The block~ and switch~ objects set the block size \,
 overlap \, and up/down-sampling ratio for the window. (The overlap
 and resampling ratio are relative to the super-patch.);
-#X text 137 332 INTERACTIONS WITH OTHER OBJECTS:;
 #X text 45 230 You may have at most one block~/switch~ object in any
 window.;
 #X text 45 176 A switch~ with no arguments does not reblock audio computation
 -- in other words \, block size and sample rate are as in the parent
 patch.;
-#X text 46 353 Dac~ and adc~ don't work correctly if reblocked \, nor
-if a parent window is reblocked \, even if the window containing the
-dac~ or adc~ is reblocked back to the default block size and sample
-rate.;
-#X text 48 573 see also:;
-#X obj 136 573 fft~;
-#X text 47 599 ... and the control.blocksize and up.downsampling audio
+#X text 46 531 see also:;
+#X obj 134 531 fft~;
+#X text 44 567 ... and the control.blocksize and up.downsampling audio
 example patches.;
-#X text 180 295 <--- example usage in subpatch;
-#N canvas 351 51 695 365 /SUBPATCH/ 1;
+#X text 194 459 <--- example usage in subpatch;
+#X text 43 92 Switch~ \, in addition \, allows you to switch DSP on
+and off for the window. All subwindows are also switched. (If a subwindow
+of a switched window is also switched \, both switches must be on for
+the subwindow's audio DSP to run. Pd's global DSP must also be on.)
+;
+#N canvas 372 9 695 365 block-example 0;
 #X obj 258 238 bang~;
 #X obj 258 264 t b b;
 #X obj 258 290 timer;
@@ -59,17 +58,31 @@ example patches.;
 #X connect 7 0 10 0;
 #X connect 8 0 10 0;
 #X connect 9 0 10 0;
-#X restore 140 295 pd;
-#X text 47 501 Patches using send~/receive~ or throw~/catch~ to intercommunicate
+#X restore 41 457 pd block-example;
+#N canvas 112 205 599 297 block-interations 0;
+#X text 32 61 Dac~ and adc~ don't work correctly if reblocked \, nor
+if a parent window is reblocked \, even if the window containing the
+dac~ or adc~ is reblocked back to the default block size and sample
+rate.;
+#X text 33 209 Patches using send~/receive~ or throw~/catch~ to intercommunicate
 must have the same blocking -- and if their parents are blocked bigger
 than they are \, there might be wierdness.;
-#X text 45 420 If using send~ or delwrite~ from a switched-off patch
+#X text 31 128 If using send~ or delwrite~ from a switched-off patch
 \, the output of corresponding receive~ and delread~ objects in other
 \, running patches will cycle old input (and sound like garbage). Throw~
 may be switched with impunity \, but not catch~.;
-#X text 43 92 Switch~ \, in addition \, allows you to switch DSP on
-and off for the window. All subwindows are also switched. (If a subwindow
-of a switched window is also switched \, both switches must be on for
-the subwindow's audio DSP to run. Pd's global DSP must also be on.)
+#X text 32 11 INTERACTIONS BETWEEN BLOCK~/SWITCH~ AND OTHER OBJECTS
+IN PD;
+#X restore 40 482 pd block-interations;
+#X text 227 483 INTERACTIONS WITH OTHER OBJECTS;
+#X text 44 269 Pd's default block size is 64 samples. The inlet~ and
+outlet~ objects reblock signals to adjust for differences between parent
+and subpatch \, but only power-of-two adjustments are possible. So
+for "normal" audio computations \, all blocaks should also be power-of-two
+in size. HOWEVER \, if you have no inlet~ or outlet~ you may specify
+any other block size. This is intended for later use in video processing.
 ;
-#X text 44 269 Pd's default block size is 64 samples.;
+#X text 45 395 Switch~ takes a "bang" message that causes one block
+of DSP to be computed. This might be useful for pre-computing waveforms
+or window functions \, or also for video processing.;
+#X text 337 604 updated for Pd version 0.4;