checked in pd-0.43-1test4.src.tar.gz

svn path=/trunk/; revision=15558

4 files changed, 98 insertions, 66 deletions

diff --git a/pd/doc/1.manual/x1.htm b/pd/doc/1.manual/x1.htm
index 92585e69..6a77a925 100644
--- a/pd/doc/1.manual/x1.htm
+++ b/pd/doc/1.manual/x1.htm
@@ -101,18 +101,8 @@ Guenter Geiger, and now maintained by Iohannes Zmoelnig.  You can get
 it from: <A href="http://iem.at/GEM">http://iem.kug.ac.at/GEM</A>, or by
 installing Pd Extended.
 
-<P>
-Here are some more Pd links (updated 2/2011): <BR>
-<a href="http://obiwannabe.co.uk/tutorials/html/tutorials_main.html">
-Andy Farnell's Tutorial</A><BR>
-<a href="http://sites.google.com/site/porres/TutorialPd.zip">
-Alexandre Porres's Tutorial (Portuguese)</A><BR>
-<A HREF="http://www.crca.ucsd.edu/~msp/techniques.htm">
-Puckette's book, <I> Theory and Techniques of Electronic Music</A> </I> <br>
-<a href="http://www.crca.ucsd.edu/~msp"> Miller Puckette's home page</a><br>
-<a href="http://iem.at/~zmoelnig/index.html">
-    Johannes M Zmoelnig</a><br>
-<a href="http://www-ccrma.stanford.edu/planetccrma/software/soundapps.html#pd">
-Fernando Pablo Lopez's RPMs from Planet CCRMA</a><br>
+<P> Here are some 
+<a href="http://crca.ucsd.edu/~msp/external-links.htm">
+more external links</A>.
 </BODY>
 </HTML>
diff --git a/pd/doc/1.manual/x3.htm b/pd/doc/1.manual/x3.htm
index 747c6548..a8916e4b 100644
--- a/pd/doc/1.manual/x3.htm
+++ b/pd/doc/1.manual/x3.htm
@@ -49,8 +49,8 @@ To test audio and MIDI, start Pd and select "test Audio and MIDI" from the
 <P> First, try to get Pd to play a sine wave over your speakers.  The "TEST
 TONE" control at top left turns this on and off.  Normally, all the output
 channels are turned on so that when you turn the tone on (to a soft -40 dB or a
-louder -20 dB) you should get output on the first six of your output channels.
-(If you have fewer than six output channnels open, the extra
+louder -20 dB) you should get output on the first eight of your output channels.
+(If you have fewer than 8 output channnels open, the extra
 channels aren't played; and if you have more, this particular patch won't
 use them.)
 
@@ -112,10 +112,13 @@ start or stop Pd's audio computation.
 
 <P> If there is a choice of
 audio API to make, the Media menu will display them.  (On Linux, they are
-OSS, ALSA, and Portaudio; on Windows, you get MMIO and ASIO).  More information
+OSS, ALSA, and Portaudio; on Windows, you get MMIO and ASIO).  On Mac the only
+one is portaudio. More information
 about the APIs appears in the sections below.
 
-<P> Next is the "Audio settings..." menu item, which opens a dialog like this:
+<P> Selecting an API (even if it's the one already in use), or, alternatively,
+selecting "Audio Settings..." from Preferences, opens
+a dialog panel like this:
 
 <CENTER><P>
     <IMG src="fig11.2.png" ALT="audio settings dialog">
@@ -170,23 +173,8 @@ programs that make a "network link" (locally) to intercommunicate.
 <H4> Audio in Microsoft Windows </H4>
 
 <P>
-You can ask for a list of audio and MIDI devices by typing
-"pd -listdev"; you can then specify which audio and MIDI device to use.
-Type "pd -help" (or make any mistake) to get the syntax for specifying 
-which device to use.  You can modify the Pd shortcut (or batch file) to
-set these, or else use the "startup" dialog (file menu) to specify
-startup arguments.
-
-<P>
-Alternatively, (and especially when just starting out) you can experiment
-with different audio configurations using the "audio settings" 
-item in the Media menu.
-
-<P>
-You can list and
-choose MIDI devices in the same way as audio;  note that, by default, MIDI
-input is disabled in Windows (because it's possible to hang up some MIDI
-devices if Pd exits unexpectedly).
+Pd offers both the ASIO and MMIO APIs in Windows.  Which of these works better
+will depend on your audio hardware.
 
 <P>
 MIDI timing is very poor if you are using simultaneous audio input and output;
@@ -205,6 +193,14 @@ from the default (256 samples) and "-audiobuf" in milliseconds.  Pd will
 round this down to a power of two buffers, each of "-blocksize" in sample
 frames.
 
+<P> TIP:  Often your machine will allow you to use ASIO with built-in PC
+audio hardware.  Sometimes it is necessary to set a ridiculously high block size
+for this to work (on my machine I have to set it to 4096 -- about 1/10 of a
+second!)
+
+<P> Using MMIO I've been able to get very low latencies (6 msec) using M-audio
+PCI converters (Delta 44).
+
 <H3> <A name=s1.2> 3.3. Installing Pd in Linux </A> </H3>
 
 <P> What to do depends on which flavor of Linux you are running (e.g., Debian
@@ -226,6 +222,12 @@ headers.  It should be
 enough to load "tcl-devel", "tk-devel", and "alsa-devel" packages using
 yum or apt-get.
 
+<P> There are two parallel compilation setups now available.  The old one is
+described here; as of 0.43 I still use that but I plan to discontinue this for
+0.44 and start using only the new one (by Hans).  The following description
+applies to the old one.  Look in the INSTALL.txt file to see how to use the
+new one.
+
 <P> 
 Download Pd, perhaps from
     <a href="http://www.crca.ucsd.edu/~msp/software.html">
@@ -340,7 +342,7 @@ Hammerfall boards in Pd is via ALSA and jack; but you can use ALSA alone:
 <PRE>
     pd -alsa -channels 26
 </PRE>
-works for me.  If you don't specify the number of channels correctly Pd crashes.
+works for me.
 
 <H6> MIDIMAN </H6>
 
@@ -352,18 +354,28 @@ bit cheaper than Hammerfalls.  The driver name is "ice1712".
 <H6> USB sound devices</H6>
 
 <P> Ed Kelly reports success with the Lexicon series of USB 1.0 devices  (e.g.,
-the Omega Studio; apparently 4 channels in and 4 out).  Also known to work well is the
-Edirol box (2 channels in and out).
-
-<P> As of Feb. 2011, USB 2.0 devices are starting to appear but the ALSA
-driver support is not yet there; watch the Pd mailing list.
+the Omega Studio; apparently 4 channels in and 4 out).  Also known to work well
+is the Edirol box (2 channels in and out).
+
+<P> As of Sept. 2011, the only multi-channel USB device I've been able to use
+with Pd is the Native Instruments Traktor Audio series.  (I have the Audio
+Traktor 10 which does indeed get 10 discrete channels in and out; the box is
+designed for turntables and the I/O is all RCA.  I haven't yet tested whether
+the inputs are RIAA equalized or flat.  To run this device you'll need to
+compile and install an ALSA snapshot from at least September 2011.  This won't
+start showing up in Linux distros for at least some months.
+
+<P> THe Alsa devel list is reporting progress on the M-audio Ultra series,
+which goes up to 6 in and out (analog) with 2 more as SP/DIF.  Things work
+OK for input or output separately but "full duplex" (in and out simultaneously)
+has sync problems.
 
 <H3> <A name="s1.3"> 3.4. Installing Pd in Macintosh OSX </A> </H3>
 
 <P>Pd version 0.35 and up support Macintosh OSX.  You need the OSX Jaguar
-distribution (10.2) or later.
+distribution (10.2) or later.  Recent versions of Pd require 10.4 or up.
 
-<P> To install Pd you can always just download  the sources and compile them
+<P> To install Pd you can always download  the sources and compile them
 yourself, or (easier)  just download the Mac binary from the download page:
 
 <A href="http://crca.ucsd.edu/~msp/software.html">
@@ -372,6 +384,10 @@ http://crca.ucsd.edu/~msp/software.html</A>.
 This is in the form of a compressed Tar archive; just click on it and the Max
 will extract the Pd application.  Open this and you should be running.
 
+<P> You might get various warnings about Pd trying to open an internet port.
+This is normal although some system administrators will prevent you from
+doing this (in which case you can't run Pd on that machine).
+
 <P> The package by Hans-Christoph Steiner, on
 
 <A href="http://at.or.at/hans/pd/installers.html">
@@ -391,7 +407,7 @@ possibly so that you can get the newest version before it shows up compiled for
 Mac OS X.      
 
 <P> To be able to compile Pd, you must have Tcl/Tk installed in the standard
-places.  I think this is true fro all reasoably recent releases of OSX.
+places.  I think this is true for all reasoably recent releases of OSX.
 
 <P> Then, just as for linux, just unload pd-whatever.tar.gz into a directory
 such as ~/pd-0.36-0, cd to pd-0.36-0/src, type "./configure"
diff --git a/pd/doc/1.manual/x5.htm b/pd/doc/1.manual/x5.htm
index a781ae5c..a36c395c 100644
--- a/pd/doc/1.manual/x5.htm
+++ b/pd/doc/1.manual/x5.htm
@@ -20,6 +20,31 @@
 
 <H3> <A name="s2"> 5.1. release notes </A> </H3>
 
+<P> ------------------ 0.43.1 ---------------------------
+
+<P> bug fix: in "perf mode" (having sent pd the "perf" message to prevent
+undesired patch closure) Pd crashed (oops!) when one asked for the patch to
+close after all.
+
+<P> Improvements to Mac version of bonk~ -- "learn" parameter handled correctly and
+compilation fixes.
+
+<P> Default font size is the same on all platforms.
+
+<P> Bug fixes reading and writing AIFF files, particulatly 24 bit ones
+
+<P> "edit mode" menu checkbox should work now.
+
+<P> X Pasting text into boxes now works in linux.
+
+<P> fixed bug that hung Pd when closing more than one pd~ subpatch out of order.
+
+<P> fixed segfault if DSP loop found and main patch had signal inlets/outlets
+
+<P> miscellaneous cleanups.
+
+<P> STILL BUGGY: when you change the contents of a graph-on-parent subpatch the
+old stuff often doesn't get erased correctly.
 <P> ------------------ 0.43 ---------------------------
 
 <P> Completely new TCL front end, thanks to Hans-Christophe Steiner,
diff --git a/pd/doc/2.control.examples/07.time.pd b/pd/doc/2.control.examples/07.time.pd
index 69398bd9..afb94c91 100644
--- a/pd/doc/2.control.examples/07.time.pd
+++ b/pd/doc/2.control.examples/07.time.pd
@@ -1,39 +1,40 @@
-#N canvas 0 0 724 474 12;
+#N canvas 490 83 724 474 12;
 #X text 34 13 Besides the metronome \, there are three objects for
 dealing with time:;
 #X obj 64 117 print;
 #X msg 64 59 bang;
 #X msg 110 61 stop;
 #X obj 64 89 delay 2000;
-#X text 161 44 The delay objects sechedules an event for a future time
-expressed in milliseconds. Unlike in Max \, time values need not be
-integers. If a delay has been scheduled and you "bang" it again \,
-it is rescheduled (the previously scheduled output is cancelled.);
-#X msg 76 190 bang;
-#X obj 76 237 timer;
+#X msg 76 192 bang;
+#X obj 76 239 timer;
 #X text 160 117 The right inlet can be used to set the time value without
 scheduling any output.;
-#X text 35 156 The timer \, shown below \, measures the time elapsed
-between its left and right inlets:;
-#X obj 106 212 delay 123.45;
-#X floatatom 76 262 0 0 0;
-#X text 29 287 Note that all time calculations are idealized \; they
+#X obj 106 214 delay 123.45;
+#X floatatom 76 264 0 0 0 0 - - -;
+#X text 34 288 Note that all time calculations are idealized \; they
 do not show the effects of computation time or OS latency. This way
 you can write deterministic algorithms dealing with time passage.;
-#X obj 74 385 pipe 2000;
-#X floatatom 74 358 0 0 0;
-#X floatatom 74 411 0 0 0;
-#X text 165 359 The pipe object allocates memory dynamically in order
+#X obj 74 387 pipe 2000;
+#X floatatom 74 360 0 0 0 0 - - -;
+#X floatatom 74 413 0 0 0 0 - - -;
+#X text 165 361 The pipe object allocates memory dynamically in order
 to schedule any number of delayed events. The events may hold any collection
 of data (as usual \, for more details you can consult the help window.)
 ;
-#X text 442 440 updated for Pd version 0.34;
+#X text 442 440 updated for Pd version 0.43;
+#X text 35 154 The timer \, shown below \, measures the time elapsed
+between the arrival of 'bang' messages to its left and right inlets:
+;
+#X text 159 40 The delay object schedules an event for a future time
+expressed in milliseconds. Unlike in Max \, time values need not be
+integers. If a delay has been scheduled and you "bang" it again \,
+it is rescheduled (the previously scheduled output is cancelled.);
 #X connect 2 0 4 0;
 #X connect 3 0 4 0;
 #X connect 4 0 1 0;
-#X connect 6 0 7 0;
-#X connect 6 0 10 0;
-#X connect 7 0 11 0;
-#X connect 10 0 7 1;
-#X connect 13 0 15 0;
-#X connect 14 0 13 0;
+#X connect 5 0 6 0;
+#X connect 5 0 8 0;
+#X connect 6 0 9 0;
+#X connect 8 0 6 1;
+#X connect 11 0 13 0;
+#X connect 12 0 11 0;