""

svn path=/trunk/; revision=1636

1 files changed, 31 insertions, 24 deletions

diff --git a/externals/grill/xsample/readme.txt b/externals/grill/xsample/readme.txt
index 1b9f5fc0..20aa53df 100644
--- a/externals/grill/xsample/readme.txt
+++ b/externals/grill/xsample/readme.txt
@@ -4,7 +4,11 @@ Copyright (c)2001-2004 Thomas Grill (t.grill@gmx.net)
 For information on usage and redistribution, and for a DISCLAIMER OF ALL
 WARRANTIES, see the file, "license.txt," in this distribution.  
 
-Donations for further development of the package are highly appreciated.
+----------------------------------------------------------------------------
+
+Maximum care has been taken to prepare a delightful experience for you electronic artists.
+Donations for further development of the package are HIGHLY APPRECIATED.
+
 Visit https://www.paypal.com/xclick/business=t.grill%40gmx.net&item_name=xsample&no_note=1&tax=0&currency_code=EUR
 
 ----------------------------------------------------------------------------
@@ -12,22 +16,21 @@ Visit https://www.paypal.com/xclick/business=t.grill%40gmx.net&item_name=xsample
 IMPORTANT INFORMATION for all MaxMSP users:
 
 1) 
-For OSX it is best to put the xsample file somewhere in your Max/MSP search path and drop the file 
-xsample-objectmappings.txt into the folder /Library/Application Support/Cycling '74/init .
-
-For Windows put the xsample file somewhere in your Max/MSP search path and drop the file
-xsample-objectmappings-win.txt in
+For Mac OSX it is best to put the max-osx/xsample.mxd file into the folder 
+/Library/Application Support/Cycling '74/externals
+and the file maxmsp/xsample-objectmappings.txt into the folder 
+/Library/Application Support/Cycling '74/init .
+
+For Windows put the max-msvc\xsample.mxe file into the folder
+C:\program files\common files\Cycling '74\externals (english version)
+and the file maxmsp/xsample-objectmappings.txt in
 C:\program files\common files\Cycling '74\init (english version)
-or
-C:\Programme\Gemeinsame Dateien\Cycling '74\init (german version)
 
-2) 
-Otherwise (or for OS9) it is advisable to put the xsample shared library file into the "max-startup" folder. 
-Hence it will be loaded at Max startup.
+Put the maxmsp/xsample.help file into the max-help folder.
 
-3) 
-If you want to load the xsample library on demand, use the "install" option of the Max file menu
-and point it to the xsample file or create a [xsample] object in Max/MSP.
+2) 
+Alternatively (or for OS9) it is advisable to put the xsample.mxd or xsample.mxe file 
+into the "max-startup" folder. Hence it will be loaded at Max startup.
 
 ----------------------------------------------------------------------------
 
@@ -46,30 +49,30 @@ see http://www.parasitaere-kapazitaeten.net/ext
 Package files:
 - readme.txt: this one
 - gpl.txt,license.txt: GPL license stuff
-- main.h,main.cpp,inter.cpp,inter.ci: base class definition for all the other objects
+- main.h,main.cpp,inter.cpp,inter.h: base class definition for all the other objects
 - record.cpp: xrecord~
 - play.cpp: xplay~
 - groove.cpp: xgroove~
 
 ----------------------------------------------------------------------------
 
-BUILDING XSAMPLE
-----------------
+BUILDING XSAMPLE from source
+----------------------------
 
 The package should at least compile (and is tested) with the following compilers:
 
 pd - Windows:
 -------------
-o Microsoft Visual C++ 6 command line: edit "config-pd-msvc.txt" and run "build-pd-msvc.bat"
-
-o Microsoft Visual C++ 6 IDE: edit "xsample.dsp" project file
-> due to a compiler bug the optimization using templates is not functional
+o Microsoft Visual C++ 6 or .NET command line: edit "config-pd-msvc.txt" and run "build-pd-msvc.bat"
 
 o BCC: edit "config-pd-bcc.txt" and run "build-pd-bcc.bat"
 
 o Cygwin GCC: edit "config-pd-cygwin.txt" and run "sh ./build-pd-cygwin.sh"
 > various versions of GCC die during compile with template optimization turned on 
 
+o MinGW: edit "config-pd-mingw.txt" and run "build-pd-mingw.bat"
+> MinGW binary folder must be included in the system path!
+
 pd - linux:
 -----------
 o GCC: edit "config-pd-linux.txt" and run "sh ./build-pd-linux.sh"
@@ -82,13 +85,17 @@ o GCC: edit "config-pd-darwin.txt" and run "sh ./build-pd-darwin.sh"
 
 Max/MSP - MacOS9:
 ----------------
-o Metrowerks CodeWarrior: edit "xsample.cw" project file functions
+o Metrowerks CodeWarrior: "xsample.cw" project file
 
 o Apple MPW-PR: edit & use the "flext.mpw" makefile
 
 Max/MSP - MacOSX:
 ----------------
-o Metrowerks CodeWarrior: edit "xsample.cw" project file functions
+o Metrowerks CodeWarrior: "xsample.cw" project file
+
+Max/MSP - Windows:
+----------------
+o Microsoft Visual C++ 6 or .NET command line: edit "config-max-msvc.txt" and run "build-max-msvc.bat"
 
 
 ----------------------------------------------------------------------------
@@ -102,7 +109,7 @@ Goals/features of the package:
 - multi-channel capability 
 - live update of respective buffer/array content
 - switchable 4-point or linear interpolation for xplay~/xgroove~ object
-- cross-fading loop zone (inside or outside to loop) for xgroove~
+- cross-fading loop zone for xgroove~
 
 ----------------------------------------------------------------------------