Damn, edited this before and lost the update. More data features.

Took about 12 patches.

svn path=/trunk/; revision=3006

1 files changed, 174 insertions, 209 deletions

diff --git a/pd/doc/1.manual/x3.htm b/pd/doc/1.manual/x3.htm
index 5f4f178f..9bc0f537 100644
--- a/pd/doc/1.manual/x3.htm
+++ b/pd/doc/1.manual/x3.htm
@@ -33,6 +33,8 @@ In case of trouble also consult the Pd mailing list archive on
 , which often has late-breaking news about configuration problems and solutions.
 The rest of this section describes how to get audio and MIDI to work.
 
+<H3> <A name=s1.0> 3.1. Audio and MIDI </A> </H3>
+
 <P>
 To test audio and MIDI, start Pd and select "test Audio and MIDI" from the
 "Media" menu.  You should see a window like this:
@@ -132,35 +134,36 @@ more than one, hit "use multiple devices" and you'll be allowed up to 4
 in and 4 out.  Each audio device is 2 channels by default, but you may
 specify more if your hardware supports it.
 
-<H3> <A name=s1.1> 3.1. Installing Pd in Microsoft Windows </A> </H3>
+Other parameters may be tweaked using the command line; see under
+<A href=#s4> preferences and startup options </A>.
 
-<P> Pd is compiled under NT, but should work under any version of Windows since
-95.  Pd will appear as a self-extracting archive (a ".exe" file). Run this and
-select a destination directory when prompted, such as "\pd" or "Program
-Files\pd".
+<H6> MIDI </H6>
 
-<P>
-If for example you put Pd in "C:Program Files\pd", the executable program will be
-"C:Program Files\pd\bin\pd".   You can simply adjust your path to include
-C:\pd\bin and then
-invoke "pd" in a command prompt window. You can also make a shortcut to the
-executable program (left-click on it and drag to the desktop, for example.)
+<A> The "channel message" midi objects in Pd
+such as notein or pgmout will take channels 1-16 to mean the first open MIDI
+port, 17-32 the second one, and so on.  The midiin, sysexin, midiout objects
+give you a separate inlet to specify which of the open MIDI port numbers
+you want.
+
+<P> System exclusive MIDI message input and output is theoretically supported
+in version 0.37 but does not work correctly on windows, even in 0.38.
 
-<P> Pd requires "TCP/IP networking" to be turned on.  This doesn't mean you
-have to be on a real network, but simply that Pd actually consists of two
-programs that make a "network link" (locally) to intercommunicate.
 
-<H4> The vanishing window </H4>
+<H3> <A name=s1.1> 3.2. Installing Pd in Microsoft Windows </A> </H3>
 
-<P> Pd is a "command line" program.  Most error and diagnostic
-messages from Pd appear on the command prompt window Pd runs from.  
+<P> Pd should work under any version of Windows since 95.  You can download as
+a self-extracting archive (a ".exe" file). Run this and select a destination
+directory when prompted, such as "\pd" or "Program Files\pd".
 
-<P> If you start Pd from the "run" menu or as a shortcut, and if there's
-a problem with run-time flags (see the Pd command line below), Pd will
-print an error and exit.  You won't see this error unless you arrange for the
-"command prompt" or "msdos" window to stay open after Pd exits.  One way
-to do this is to make a "batch" file ("run.bat", say) containing the Pd
-command line.
+<P> If for example you put Pd in "C:Program Files\pd", the executable program
+will be "C:Program Files\pd\bin\pd".   You can simply adjust your path to
+include C:\pd\bin and then invoke "pd" in a command prompt window. You can also
+make a shortcut to the executable program (left-click on it and drag to the
+desktop, for example.)
+
+<P> Pd requires "TCP/IP networking" to be turned on.  This doesn't mean you
+have to be on a real network, but simply that Pd actually consists of two
+programs that make a "network link" (locally) to intercommunicate.
 
 <H4> Audio in Microsoft Windows </H4>
 
@@ -169,7 +172,8 @@ 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.
+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
@@ -190,10 +194,6 @@ simply terrible.  W98, with either audio input or output suppressed, offers
 fairly good MIDI timing (~5 msec jitter).  The "first edition" used to crash
 occasionally; this might be fixed in the "second edition".
 
-<P> Some NT and W98 drivers greet you with a constant trail of "resyncing
-audio" messages.  Sometimes you can fix this by invoking Pd with the "-noresync"
-flag.
-
 <H4> ASIO </H4>
 
 <P> As of version 0.35 Pd supports ASIO.  Invoke Pd as "pd -asio" and, if
@@ -203,7 +203,7 @@ 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.
 
-<H3> <A name=s1.2> 3.2. Installing Pd in Linux </A> </H3>
+<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
 or Red Hat). The instructions here should work for Pd 0.33 and up regardless of
@@ -311,14 +311,9 @@ audio latency your audio system can handle.
 <P>
 Be forewarned: installing and testing audio and MIDI drivers in Linux can take
 days or weeks.  There apears to be no single place where you can get detailed
-information on Linux audio.
-
-<P>
-Depending on your hardware and software, you might or might not be able to
-run "full duplex," i.e., use audio input and output at the same time.  For
-many applications it's important to be able to do this, but if by any chance
-you don't need simultaneous input and output you will have much less trouble
-than if you do. 
+information on Linux audio.  One good source of information lives at:
+<A href=http://www.djcj.org/LAU/guide/index.php>
+http://www.djcj.org/LAU/guide/index.php </A>.
 
 <P>
 There are two widely-used driver sets, called "OSS" and "ALSA".  OSS is 
@@ -331,95 +326,24 @@ releases.  You can get ALSA from
 
 <P> ALSA is able to emulate OSS, so that you can usually run Pd using the
 default "OSS" settings even if it's actually ALSA that's running.
-
-<H4> Installing and configuring FREE OSS </H4>
-
-<P>
-OSS is really a collection of loadable device drivers.  The commands
-for loading and unloading the drivers are "insmod" and "rmmod".
-You can see if the audio drivers are
-running using "lsmod" (as root.)  If you see something like:
-<PRE>
-
-Module         Pages    Used by
-eepro100           3            1 (autoclean)
-opl3               3            0
-opl3sa2            1            0
-ad1848             4    [opl3sa2]       0
-mpu401             5    [opl3sa2]       0
-sound             15    [opl3 opl3sa2 ad1848 mpu401]    0
-soundcore          1    [sound] 6
-soundlow           1    [sound] 0
-aic7xxx           23            2
-
-</PRE>
-
-<P>then OSS is running, and if all you see is:
-
-<PRE>
-
-eepro100           3            1 (autoclean)
-aic7xxx           23            2
-
-</PRE>
-<P>then it isn't.  You can turn OSS off by running "rmmod" repeatedly, starting
-with "opl3" (or whatever) so as not to remove any module before you remove
-all the modules that depend on it.  In the above listing, "opl3*" is device
-dependent and you might see different names.
-
-<P>
-The file, "/etc/modules.conf" apparently controls which sound drivers are
-started at boot time.  The sndconfig program updates this file but you can
-also change things manually, for instance to switch between two different sound
-cards.  In Redhat 6.x and earlier, the file is named "conf.modules."
-
-<P> Here is a modules.conf file for OSS:
-
-<PRE>
-
-alias eth0 e100
-alias parport_lowlevel parport_pc
-alias char-major-81 bttv
-alias usb-controller usb-uhci
-alias sound-slot-0 i810_audio
-alias sound-slot-1 es1371
-
-</PRE>
-
-<P>Here the two sound cards are the (motherboard resident) i810 driver and an
-ensoniq es1371.
-
-<P> In RedHat at least, the "sndconfig" program tries to automatically search
-for your soundcard.  Unfortunlately it only finds the "first" one which is
-often not the one you want to use!
-
-<P> Under OSS, programs can stream sound using either
-"block" or "stream" mode.  Stream mode is the more modern and better of the
-two, but the majority of drivers, even for new sound cards, only
-support "block."  Pd makes "block" the default.
-
-<H4>  ALSA (Advanced Linux Sound Architecture) </H4>
-
-<P> ALSA is newer, hence less stable and harder to use, than OSS.
-Alsa comes in a "finished" version (0.5.x) and a
-different, redesigned, "beta" version, 0.9.   Installing ALSA can be tricky
-and/or confusing.
-
-<P> As of version 0.37 Pd works only with 0.9.x versions.  
-The RPM version of Pd is compiled for 0.9.x.
+ALSA is newer, hence less stable and harder to use, than OSS.
+Installing ALSA can be tricky and/or confusing.
 
 <P> By default, Pd uses OSS.  If you are running ALSA, Pd will use ALSA's OSS
 emulation.  To make Pd use ALSA "natively", i.e., the way ALSA is designed
-to be used, include the "-alsa" flag in the command line.
+to be used, include the "-alsa" flag in the command line or bang on the "media"
+menu items.
 
-<P> In ALSA, you can specify which sound card to use using the "-alsadev"
-flag.  So, for instance, "-alsadev 3" means your third card, counting from
-one.  You can also specify it the ALSA way: "-alsadev hw:3,0".
+<P> You can add ALSA devices by name on the Pd command line:
+<PRE>
+    pd -alsaadd loupgarou
+</PRE>
+instructs Pd to offer the 'loupgarou' audio device in the Audio Settings panel.
 
-<H4> Which sound card? </H4>
+<H4> Experiences with particular soudcards </H4>
 
 <P>
-Here's a rundown on my experiences with sound cards so far.  See
+Here are some of my own experiences with sound cards so far.  See
 also the Pd mailing list archives.
 
 <H6> RME 9652 (Hammerfall) </H6>
@@ -429,60 +353,54 @@ I/O ports and one SPDIF.  There is a "baby hammerfall" also, which I think is
 the "9632."  DO NOT CONFUSE THE 9652/9632 WITH OTHER RME BOARDS WHICH  MIGHT
 NOT WORK WITH PD.
 
-<P> Word on the Pd mailing list is that the only way at present (7/04) to use 
-Hammerfall boards in Pd is via ALSA and jack.
+<P> The easiest way to use 
+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.
 
 <H6> MIDIMAN </H6>
 
 <P>Midiman sells PCI devices (delta 44, 66, 1010, and 1010LT)
 with between 4 and 10 channels in and out, for
-which there are ALSA drivers.  The driver name is "ice1712".
+which there are ALSA drivers.  These are also very good, and they are a
+bit cheaper than Hammerfalls.  The driver name is "ice1712".
 
 <P> Alsa provides an "envy24control" program (in "utils".  You should run
 this and check that your ice1712's sync source is internal if you have no
 SPDIF input, or "SPDIF" if you do.  I think the default is now "internal"
 but don't take it for granted...
 
-<H6> i810/i815 </H6>
+<H6> warning about i810/i815 drivers...</H6>
 
-<P>In RedHat 7.0, motherboards with native i810 audio systems don't work in
-full duplex (they crash linux).  Either run Pd -noadc or else (better) install
-ALSA.
+<P>As of RedHat 7.0, motherboards with native i810 audio systems didn't work in
+full duplex (they crashed linux).  Either run Pd -noadc or else (better)
+install ALSA.  This ought to be fixed by now...
 
-<H3> <A name="s1.3"> 3.3. Installing Pd in Macintosh OSX </A> </H3>
+<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.
 
-<P> To install Pd you can always just download 
-the sources and compile them yourself, or (easier) 
-find a MacOSX-style "package".  The first package was put together by Adam 
-Lindsay; the most current one is by Hans-Christof Steiner
-on
-<A http://puredata.info/Members/hans">
-http://puredata.info/Members/hans</A>.
-The package simply installs itself 
-and you needn't follow the directions below. 
-</P>
+<P> To install Pd you can always just 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">
+http://crca.ucsd.edu/~msp/software.html</A>.
 
-<H4> To install on OSX from the binary tarball: </H4>
+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> The binary tarballs on 
-<A HREF="http://www.crca.ucsd.edu/~msp/software.html">
-http://www.crca.ucsd.edu/~msp/software.html</A>
-take more steps to install but are more "official".  To install them:
+<P> The package by Hans-Christoph Steiner, on
 
-<P> If you haven't already, first download and install Tcl/Tk; there are pointers on
-Hans's page, or try: http://tcltkaqua.sourceforge.net/
-<A href="http://tcltkaqua.sourceforge.net/">
-http://tcltkaqua.sourceforge.net/</A>.  Double click on what you
-get (a disk image opens) and then double click on the "package" icon, and the
-installer should tell you how to proceed from there.
+<A href="http://at.or.at/hans/pd/installers.html">
+http://at.or.at/hans/pd/installers.html</A>,
 
-<P>  Then download a tarball like pd-0.37-0.mac.tar.gz, and expand it
-(I think that's done just by clicking on the thing in OSX.)  You can install
-it into your home directory for example.  Then start a shell window and
-type "~/pd/bin/pd" to it, and pd should start.
+has many updates and extensions
+which are not included in the original Pd distribution.  Download this and
+follow the (simple) instructions found there. 
+</P>
 
 <H4> To install on OSX from source: </H4>
 
@@ -497,7 +415,10 @@ specifically in
 /Applications/Wish Shell.app   
 and  /Library/Frameworks/Tk.framework and /Library/Frameworks/Tcl.framework.
 
-<P> First download and install TK for OSX as described above.
+<P> First download and install TK for OSX.  I get it from:
+<A href=http://tcltkaqua.sourceforge.net/>
+http://tcltkaqua.sourceforge.net/. </A>
+
 
 <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"
@@ -509,7 +430,8 @@ and "make".  Then type ~/pd-0.36-0/bin/pd to a shell and enjoy!
     alias pd ~/pd/bin/pd
 </pre>
 
-<P>in the file, ~/.tcshrc, so that you can later just type "pd" to a shell.  (The
+<P>in the file, ~/.tcshrc, so that you can later just type "pd" to a shell.
+(The
 shell only reads the ~/.tcshrc file on startup, so this won't take effect in
 any existing shells unless you specially type
 <pre>
@@ -517,23 +439,14 @@ any existing shells unless you specially type
 </pre>
 <P>to them.)
 
-<P> In some cases you have to explicitly give "-soundindev" and "-soundoutdev"
-flags for Pd to open audio correctly; "pd -listdev" should show you the
-correct device numbers.
+<P> Follow the general directions above for testing audio and/or MIDI
+as needed.
 
 <P> To get MIDI working, you have to do the Mac OSX magic to get a USB
 MIDI interface installed.  I've seen this done with Midisport devices and
 I think you just download the OSX driver and follow directions.
 
-<P> On the machine I tried, it was necessary to type,
-
-<pre>
-    pd -midiindev 1 -midioutdev 2
-</pre>
-
-<P>to get MIDI working.  
-
-<H3> <A name=s1.4> 3.4. Installing Pd in IRIX (SGI machines) </A> </H3>
+<H3> <A name=s1.4> 3.5. Installing Pd in IRIX (SGI machines) </A> </H3>
 
 <P> (NOTE: as of release 0.35 I haven't had an IRIX machine to compile   
 Pd on.  Soeren Bovbjerg has kindly compiled 0.35 and 0.36 for IRIX;   
@@ -636,20 +549,66 @@ Opcode Studio 3 interface but in principle any Mac-compatible one should work.
 The O2 apparently has RS232 ports, not RS422.  I think SGI's web site says
 something about how to deal with this.
 
+<H3> <A name=s4> 3.6. Preferences and startup options </A> </H3>
 
-<H3> <A name=s3> 3.5. graphics rendering using GEM </A> </H3>
+<P> Pd's behavior may be customized to instruct it where to find files, which
+audio devices to open, what font size to use, and so on.  Most of
+these may also be changed using the various dialogs you can open from Pd's
+menus.  Others take effect only when Pd starts up; some of these appear
+on the ``startup" dialog and some of them, too cranky to put in a GUI, must
+be typed as <I> command line arguments </I>.
 
-<P>
-GEM, originally by Mark Danks but now supported by Iohannes Zmoelnig, is essentially an extension of Pd that allows you to do OpenGL programming
-using a suite of "GEM objects" roughly parallel to the tilde objects built
-into Pd for audio.  Find out more from 
-<a href="http://iem.kug.ac.at/~zmoelnig/index.html"> Johannes's page</a>.  
+<P> In addition to the Audio and MIDI settings (see 
+<A href="#s1.0"> Audio and MIDI </A>), you can customize font size (from the
+``edit" menu), directories to search for files (see 
+<A href="#s5"> How Pd searches for files </A>), and additional startup
+parameters described below.
 
+<P> All of these settings may be saved automatically between Pd sessions. 
+It is also possible to specify settings directly via the <I> command
+line </I>.  (A third mechanism, using configuration files, is deprecated and
+isn't described here.)  The Pd command line is described in the next
+section.  Command line settings, if given, each override the corresponding
+setting that was saved from Pd.
 
-<H3> <A name=s4> 3.6. The Pd command line </A> </H3>
+<P>  The startup settings (i.e., those that take effect only when Pd is started)
+are controlled using the ``startup..." dialog from the File menu.  The
+dialog appears as follows:
 
-<P>Pd is a "command line" program.  The best way to run it is from your
-"terminal emulator," "shell," or "MSDOS prompt."  The command line is:
+<CENTER><P>
+    <IMG src="fig11.3.png" ALT="startup dialog">
+</P></CENTER>
+
+The slots at top each specify a binary ``library" for Pd to load on startup.
+These may be for Gem, pdp, zexy, iemlib, cyclone, and so on.  Typically, a
+single binary object (an ``extern") is left for Pd to load automatically;
+startup library loading is appropriate for collections of many objects
+specified by a single binary library.
+
+<P> The ``defeat real-time scheduling" contol, if enabled, makes Pd run without
+its usual effort to become a real-time process (whatever this means in the
+operating system you are using.)  In Unix, Pd must usually be setuid to allow
+real-time scheduling at all.
+
+<P> The ``startup flags" allow you to add to Pd's command line on startup. This
+is specified as described below, except that the initial word, ``pd", is
+understood.  For example, putting ``-rt" in this field sets real-time
+scheduling; ``-sleepgrain 1" sets the sleep grain to 1 (see under MIDI below),
+and typing "-rt -sleepgrain 1" does both.
+
+<P> You may save the current settings for future Pd sessions with the
+``save all settings" button; this saves not only the path but all other
+settings as well.
+
+<H6> Command line arguments </A> </H3>
+
+<P>Pd may be run as a "command line" program from your "terminal emulator,"
+"shell," or "MSDOS prompt."  In Windows, if Pd is started using a "shortcut"
+it is also run from a command line which you can edit using the ``properties"
+dialog for the shortcut.  In any operating system, Pd can be called from a
+script (called a <I> batch file </I> on Windows or a <I> shell script </I>
+on OSX or unix).  The command line is just a line of text, which should be
+of the form:
 
 <PRE>
 
@@ -702,6 +661,8 @@ MIDI configuration flags:
 
 general flags:
 -path &lt;path&gt;     -- add to file search path
+-nostdpath       -- don't search standard ("extra") directory
+-stdpath         -- search standard directory (true by default)
 -helppath &lt;path&gt; -- add to help search path
 -open &lt;file&gt;     -- open file(s) on startup
 -lib &lt;file&gt;      -- load object library(s)
@@ -710,10 +671,13 @@ general flags:
 -version         -- don't run Pd; just print out which version it is
 -d &lt;n&gt;           -- specify debug level
 -noloadbang      -- suppress all loadbangs
+-stderr          -- send printout to standard error instead of GUI
 -nogui           -- suppress starting the GUI
+-guiport &lt;n&gt;     -- connect to pre-existing GUI over port 'n'
 -guicmd "cmd..." -- substitute another GUI program (e.g., rsh)
 -send "msg..."   -- send a message at startup (after patches are loaded)
 -rt or -realtime -- use real-time priority (needs root privilege)
+-nrt             -- don't use real-time priority
 
 </PRE> 
 
@@ -739,7 +703,7 @@ and input devices are running at different rates, Pd will constantly drop frames
 to re-sync them, which will sound bad.  You can disable input or output if this
 is a problem.
 
-<H4> audio buffer size, block size, and sleep grain. </H4>
+<H4> audio buffer size and block size </H4>
 
 <P>You can specify an audio buffer size in milliseconds, typically between 10 and
 300, depending on how responsive your OS and drivers are.  If this is set too
@@ -747,26 +711,10 @@ low there will be audio I/O errors ("data late").  The higher the value is,
 on the other hand, the more throughput delay you will hear from the audio
 and/or control inputs (MIDI, GUI) and the audio coming out.
 
-<P> You can also specify the audio block size in sample
-frames.  This is 64 by default (except for MMIO for which it's 256), and may
-be 64, 128, or 256.  
-
-
-<P> The "sleepgrain" controls how long (in milliseconds) Pd sleeps between
-periods of computation.  This is normally the audio buffer divided by 4, but
-no less than 0.1 and no more than 5.  On most OSes, ingoing and outgoing MIDI
-is quantized to this value, so if you care about MIDI timing, reduce this to 1. 
+<P> You can also specify the audio block size in sample frames.  This is 64 by
+default (except for MMIO for which it's 256), and may be 64, 128, or 256.  
 
-<H4> MIDI </H4>
-
-<A> The "channel message" midi objects in Pd
-such as notein or pgmout will take channels 1-16 to mean the first open MIDI
-port, 17-32 the second one, and so on.  The midiin, sysexin, midiout objects
-give you a separate inlet to specify which of the open MIDI port numbers
-you want.
-
-<P> System exclusive MIDI message inupt and output is theoretically supported
-in version 0.37 but has not been tested.
+<H4> MIDI and sleepgrain</H4>
 
 <P> In Linux, if you
 ask for "pd -midioutdev 1" for instance, you get /dev/midi0 or /dev/midi00
@@ -775,7 +723,13 @@ number 0 is the "MIDI mapper", which is the default MIDI device you selected
 from the control panel; counting from one, the device numbers are card
 numbers as listed by "pd -listdev."
 
-<H3> <A name="s5"> 3.7. dealing with files </A> </H3>
+<P> The "sleepgrain" controls how long (in milliseconds) Pd sleeps between
+periods of computation.  This is normally the audio buffer divided by 4, but
+no less than 0.1 and no more than 5.  On most OSes, ingoing and outgoing MIDI
+is quantized to this value, so if you care about MIDI timing, reduce this to 1
+or less. 
+
+<H3> <A name="s5"> 3.7. How Pd searches for files </A> </H3>
 
 <P>Pd has a search path feature; you specify the path on the command line
 using the "-path" option.  Paths may contain any number of files.  If you
@@ -783,15 +737,26 @@ specify several files in a single "-path" option they're separated by colons
 in unix or semicolons in NT.  
 
 <P> You can see and edit the path while Pd is running using the "path..."
-item in the "File" menu.  The path must be correctly set before you load
-a patch or it may fail to find abstractions, etc., that are needed to
-construct the patch.
+item in the "File" menu:
+
+<CENTER><P>
+    <IMG src="fig11.4.png" ALT="startup dialog">
+</P></CENTER>
 
-<P>When Pd searches for an abstraction or an
+<P>  The path must be correctly set before you load
+a patch or it may fail to find abstractions, etc., that are needed to
+construct the patch.  When Pd searches for an abstraction or an
 "extern" it uses the path to try to find the necessary file.  The "read"
-messages to qlists and arrays (aka tables) work the same way.  NO SPACES MAY
-APPEAR ANYWHERE IN THE SEARCH PATH, e.g., "c:\my nonsense\goobers" won't
-work.
+messages to qlists and arrays (aka tables) do this too.
+
+<P> If ``use standard extensions" is enabled, the usual ``extras" directory
+is also searched.  This contains standard external objects like ``expr" and
+``fiddle", and perhaps much more depending on the distribution of Pd
+you're using.
+
+<P> You may save the current settings for future Pd sessions with the
+``save all settings" button; this saves not only the path but all other
+settings as well.
 
 <P> Path entries may be relative to the patch directory; for instance,
 if your path has an item, "../sound", and your patch is in "my stuff/all mine",
@@ -801,9 +766,9 @@ you have a patch and supporting files (even a supporting snapshot of pd)
 that you want to distribute or carry around together.
 
 <P> Regardless of path, Pd should look first in the directory containing
-the patch before searching down the path.  (However, sometimes, for
-reasons I can't explain yet, you have to put the entry "." in the 
-search path for this to happen, as least within linux!) 
+the patch before searching down the path.  Pd does not automatically look
+in the <I> current directory </I> however; to enable that, include ``." in
+the path.  The ``extra" directory, if enabled, is searched last.
 
 <P> Filenames in Pd are always separated by (unix-style) forward slashes, even
 if you're on Windows (which uses backslashes).  This is so that patches can be
@@ -813,11 +778,11 @@ separator should agree with the operating system. <BR>
 
 <P> If a filename specified in a patch has any "/" characters in it, the "path"
 is not used; thus, "../sounds/sample1.wav" causes Pd only to look relative to
-the directory containing the patch.  (You may also invoke externs that way.)
+the directory containing the patch.  You may also invoke externs that way.
 
 <P> As of version 0.35, there may be spaces in the path to Pd itself; also,
-the "openpanel" and "savepanel" objects can handle spaces.  But still not
-the search path.
+the "openpanel" and "savepanel" objects can handle spaces.  Spaces in the
+path should work as of version 0.38.
 
 </BODY>
 </HTML>