From ed932acb5860bf8b9296169676499562a55d139e Mon Sep 17 00:00:00 2001 From: Miller Puckette Date: Mon, 6 Sep 2004 20:20:36 +0000 Subject: checking in version 0.38test5. Oops, I realize I forgot some more nice files, will add them and re-commit. svn path=/trunk/; revision=2010 --- pd/doc/1.manual/1.introduction.txt | 6 ++++- pd/doc/1.manual/x1.htm | 2 +- pd/doc/1.manual/x2.htm | 2 +- pd/doc/1.manual/x3.htm | 54 +++++++++++--------------------------- pd/doc/1.manual/x5.htm | 43 ++++++++++++++++++++++++++++++ 5 files changed, 66 insertions(+), 41 deletions(-) (limited to 'pd/doc/1.manual') diff --git a/pd/doc/1.manual/1.introduction.txt b/pd/doc/1.manual/1.introduction.txt index c8fa88a8..f9209702 100644 --- a/pd/doc/1.manual/1.introduction.txt +++ b/pd/doc/1.manual/1.introduction.txt @@ -8,12 +8,16 @@ Pd is copyrighted, but is free for you to use for any reasonable purpose. See the file: PD_BASEDIR/LICENSE.txt -HTML documentation for Pd lives in: +Reference documentation for Pd lives in: file:PD_BASEDIR/doc/1.manual/index.htm or: http://www.crca.ucsd.edu/~msp/Pd_documentation/index.htm +Much more documentation and other resources live on: + http://puredata.org + The Pd mailing list archive lives in: http://iem.kug.ac.at/mailinglists/pd-list/ + Many more useful links are listed in the HTML documentation, section 1.2. diff --git a/pd/doc/1.manual/x1.htm b/pd/doc/1.manual/x1.htm index e46098cd..c115a510 100644 --- a/pd/doc/1.manual/x1.htm +++ b/pd/doc/1.manual/x1.htm @@ -71,7 +71,7 @@ To get started writing your own C extensions, refer to chapter 4 of this manual.

1.2. other resources

There is a new Pd community web site, - pure-data.org, which aims to be the + pure-data.info, which aims to be the central resource for Pd, from documentation and downloads; to forums, member pages, a patch exchange. diff --git a/pd/doc/1.manual/x2.htm b/pd/doc/1.manual/x2.htm index 8d656a64..f68dfe0a 100644 --- a/pd/doc/1.manual/x2.htm +++ b/pd/doc/1.manual/x2.htm @@ -393,7 +393,7 @@ scheduler will wake the delay back up later. 2.3.3. hot and cold inlets and right to left outlet order

With few exceptions (notably "timer"), objects treat their leftmost -inlet as "hot" in the sense that messages to right inlets can result in output +inlet as "hot" in the sense that messages to left inlets can result in output messages. So the following is a legal (and reasonable) loop construct:

diff --git a/pd/doc/1.manual/x3.htm b/pd/doc/1.manual/x3.htm index d432a2a9..f23e09a6 100644 --- a/pd/doc/1.manual/x3.htm +++ b/pd/doc/1.manual/x3.htm @@ -246,7 +246,7 @@ to file such as "pd-linux-033.tar.gz". Open a "shell" window, cd to the directory containing the file, and type the command, 

-    zcat pd-linux-033.tar.gz | tar xf -
+    tar xzf pd-linux-033.tar.gz

which creates a directory named "pd". I do this from my home directory. Next, compile it. "CD" to pd and read the INSTALL.txt, or else just cd @@ -262,11 +262,13 @@ to "pd/src" and type 

     To enable debugging (and losing code optimization) add "--enable-debug".
-    To enable ALSA 0.9x or up, add "--enable-alsa".
     To use Portaudio version 19 (experimental), add "--enable-portaudio".
     To put Pd in /usr/bin instead of /usr/local/bin, add "--prefix=/bin".
+Alsa and Jack support should auto-configure, but "--enable-alsa" od +"--enable-jack" will force their inclusion. +

After "make", just type "~/pd/bin/pd" to run pd.

Alternatively, as superuser, you can run "make install" after "make depend" @@ -427,17 +429,14 @@ 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. -

Hammerfalls now have an ALSA driver; aapparently, it works well to install -this and then run Pd using OSS emulation. (Unfortunately, this will only give -you 16 bit resolution. Maybe the also "plug" device will work better; I -haven't tried this.) +

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.

MIDIMAN

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. -I'm running mine in Alsa 0.9 beta 10. The driver name is "ice1712". +which there are ALSA drivers. The driver name is "ice1712".

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 @@ -452,16 +451,16 @@ ALSA.

3.3. Installing Pd in Macintosh OSX

-

Pd version 0.35 and up support Macintosh OSX. You need the Jaguar -distribution (10.2) of OSX. +

Pd version 0.35 and up support Macintosh OSX. You need the OSX Jaguar +distribution (10.2) or later.

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 seems to be the one by Hans on - -http://www.pure-data.org/Members/hans/. + +http://www.pure-data.info/Members/hans/. The package simply installs itself and you needn't follow the directions below.

@@ -474,9 +473,9 @@ http://www.crca.ucsd.edu/~msp/software.html take more steps to install but are more "official". To install them:

If you haven't already, first download and install Tcl/Tk; there are pointers on -Hans's page, or try: - -http://prdownloads.sourceforge.net/tcltkaqua/. Double click on what you +Hans's page, or try: http://tcltkaqua.sourceforge.net/ + +http://tcltkaqua.sourceforge.net/. 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. @@ -498,31 +497,10 @@ specifically in /Applications/Wish Shell.app and /Library/Frameworks/Tk.framework and /Library/Frameworks/Tcl.framework. -

First download and install TK for OSX -(http://sourceforge.net/projects/tcl/). Get a recent one compiled for -OSX, by chasing through "latest file releases", and finding a "download" -link for TCL. Then download "TclTkAqua-8.4.1-Jaguar.dmg" (the version -number may change). Click on this file and a "folder" will open. Click -on the "package" icon in that folder and an auto-installer will put Tcl/Tk -on your system. - -

For old versions of Tcl/Tk you also had to get the "h" files from XFree86 -and put them in -/usr/X11R6/include. You can download just the H files from: - -

       - -http://www.crca.ucsd.edu/~msp/x.tgz - - -

-(the individual files seem to have adequate copyright notices so that -I can just redistribute them.) ((I hope this is no longer necessary but I -notice people keep downloading these files anyway, so I'll leave them there -a while longer until I'm sure they're not needed.)) +

First download and install TK for OSX as described above.

Then, just as for linux, just unload pd-whatever.tar.gz into a directory -such as ~/pd-0.35-test17 , cd to pd-0.36-0/src, type "./configure" +such as ~/pd-0.36-0, cd to pd-0.36-0/src, type "./configure" and "make". Then type ~/pd-0.36-0/bin/pd to a shell and enjoy!

If you wish you can put a line such as, diff --git a/pd/doc/1.manual/x5.htm b/pd/doc/1.manual/x5.htm index ac7b6e5a..1a1b2e2f 100644 --- a/pd/doc/1.manual/x5.htm +++ b/pd/doc/1.manual/x5.htm @@ -20,6 +20,49 @@

5.1. release notes

+

------------------ 0.37.3 -------------------------- + +

Oops- added __i386__ macro to windows makefile so it would test for +underflows correctly. This affects only Microsoft Windows; the other +two platformas are fine as 0.37.2. Thanks to Thomas Musil... + +

------------------ 0.37.2 -------------------------- + +

fixed a bug in soundfile reading (soundfiles now default to wav better.) + +

fixed gfx update problem in hradio and vradio + +

minor changes to built-in Max import feature (but you should +still use cyclone's instead.) + +

colors for scalars fixed (probably never worked before!) + +

added a "set" message to the line object + +

aliased spaces to underscores in GUI labels so that at least they won't +destroy the object. + +

------------------ 0.37.1 -------------------------- + +

fixed the apple key on OSX so it does key accelerators + +

fixed bug in -inchannels/-outchannels arg parsing + +

major editions to the IEM GUIs to fix bugs in how "$" variables are handled. +The code still isn't pretty but hopefully at least works now. + +

bug fix in vd~ for very small delays + +

fixed MSW version not to make windows grow by 2 pixels on save/restore + +

added an "nrt" flag for OSX to defeat real-time priritization +(useful when runnig Gem.) + +

on some platforms, audio open failures are handled more gracefully. + +

added a "changelog" file in the source directory to document source-level +changes. +

------------------ 0.37 --------------------------

Pd is finally fixed so that it can open and close audio and MIDI devices -- cgit v1.2.1