Update Nyquist to v3.09.

lib-src/libnyquist/nyquist/sys/win/README.txt

@@ -0,0 +1,191 @@
+README.txt -- Nyquist information for Windows 
+
+Installation
+------------
+The Win32 version of Nyquist is packaged as a compiled (runtime)
+system in an executable installer. For most users, the runtime version
+contain everything you need to run Nyquist, including the executable,
+examples, and documentation, packaged as an executable installer
+program. After executing the installer, just find Nyquist in your
+Start menu to run it. You may begin typing expressions such as the
+ones in the following "Examples" section of the Nyquist manual (in
+doc/nyquistman.pdf or doc/home.html).
+
+(See "The 'java is not recognized' Error" below if you get this error
+message.)
+
+A source version is also available (the same source download is for
+Win32, Mac OS X, and Linux). The source version is intended for
+developers who want to recompile Nyquist.  The contents of the source
+archive are extracted to the C:\nyquist directory, but you can put it
+anywhere you like. You can then open the workspace file, nyquist.sln,
+using Microsoft Visual C++. You can build and run the command line
+version of Nyquist from within Visual C++. There is a batch file,
+comp-ide.bat, for bulding the Nyquist IDE. This requires the Java SDK
+from Sun Microsystems. 
+
+64-bit Windows
+--------------
+Nyquist runs on 64-bit Windows. Although you can compile a 64-bit
+native version, Nyquist is currently released for 32-bit Windows.
+When running on 64-bit Windows, note that the Registry entries will
+be under HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\CMU\Nyquist. The
+"Wow6432Node" creates a special namespace for 32-bit programs.
+
+Optional
+--------
+Nyquist needs to know where to find the standard runtime files. The
+location of runtime files must be stored in the Registry. The
+installers create a registry entry, but if you move Nyquist or deal
+with different versions, you can edit the Registry manually as
+follows:
+
+    Run the Registry editor (e.g. type regedit into the Start Search
+    box of the Start menu and type the Enter key).
+
+    Find and highlight the SOFTWARE key under HKEY_LOCAL_MACHINE.
+
+    If you are on 64-bit Windows using 32-bit Nyquist, open the
+    Wow6432Node key under SOFTWARE.
+
+    Open the CMU key (if it is not there, use the Edit:New:Key menu
+    item to create a CMU key. CMU is case sensitive.)
+
+    Highlight the new CMU key.
+
+    Open the Nyquist key (if it is not there, use the Edit:New:Key menu
+    item to create a Nyquist key. Nyquist is case sensitive.)
+
+    Highlight the new Nyquist key.
+
+    Find the XLISPPATH string (if it is not there, use the
+    Edit:New:String menu item to create a new string and change the
+    name by typing XLISPPATH).
+
+    Select XLISPPATH and choose the Edit:Modify... menu item.
+    In the String Edit box, type a list of paths you want Nyquist to
+    search for lisp files. For example, if you installed Nyquist as
+    C:\nyquist, then type:
+
+        C:\nyquist\runtime,C:\nyquist\lib
+
+    The paths should be separated by a comma or semicolon and no
+    space. The runtime path is essential, and the lib path may become
+    essential in a future release. You can also add paths to personal
+    libraries of Lisp and Nyquist code. 
+
+    Click the OK button of the string box and exit from the Registry
+    Editor application.
+
+
+What if Nyquist functions are undefined?
+----------------------------------------
+If you do not have administrative privileges for your machine, the
+installer may fail to set up the Registry entry that Nyquist uses to
+find initialization files. In this case, Nyquist will run a lisp
+interpreter, but many Nyquist functions will not be defined. If you
+can log in as administrator, do it and reinstall Nyquist. If you do
+not have permission, you can still run Nyquist as follows: 
+
+Create a file named init.lsp in the same directory as Nyquist.exe
+(the default location is C:\Program Files\Nyquist, but you may
+have installed it in some other location.) Put the following text
+in init.lsp: 
+
+    (setf *search-path* 
+          "C:/Program Files/Nyquist/runtime,C:/Program Files/Nyquist/lib")
+    (load "C:/Program Files/Nyquist/runtime/init.lsp")
+
+Note: in the three places where you see C:/Program Files/Nyquist,
+insert the full path where Nyquist is actually installed. Use forward
+slashes (/) rather than back slashes (\) to separate directories. For
+example, if Nyquist is installed at D:\rbd\nyquist, then init.lsp
+should contain: 
+
+    (setf *search-path* "D:/rbd/nyquist/runtime,D:/rbd/nyquist/lib")
+    (load "d:/rbd/nyquist/runtime/init.lsp")
+
+The variable *search-path*, if defined, is used in place of the
+registry to determine search paths for files.
+
+SystemRoot
+----------
+(Ignore this paragraph if you are not planning to use Open Sound
+Control under Windows.) 
+
+If Nyquist prints an error message and quits when you enable Open
+Sound Control (using osc-enable), check to see if you have an
+environment variable SystemRoot, e.g. type set to a command prompt and
+look for the value of SystemRoot. The normal value is C:\windows. If
+the value is something else, you should put the environment entry, for
+example: 
+
+    SystemRoot="D:\windows"
+
+into a file named systemroot (no extension). Put this file in your
+nyquist directory. When you run jNyqIDE, it will look for this file
+and pass the contents as an environment variable to Nyquist. The
+Nyquist process needs this to open a UDP socket, which is needed for
+Open Sound Control. 
+
+The window vanishes, "java is not recognized", and other errors
+---------------------------------------------------------------
+Sometimes Nyquist pops up a window that closes instantly. This
+indicates that Java was not found.
+
+Sometimes, Nyquist will run directly from the installer, but then it
+will not start from the Windows Start menu. You can try running the
+nyquist/jnyqide.bat program from a Windows command prompt (cmd). 
+If that fails, and you see an error similar to "java is not recognized 
+as in internal or external command error", the problem may be that 
+paths are not set up properly to allow the Windows shell to find java. 
+
+Right click on "My Computer" on the Windows desktop and select
+"Properties." Under the "Advanced" tap, press the "Environment
+Variables" button, and look for PATH under "System Variables." Make
+sure the Java bin directory is on the path. If it is not, you will
+have to find your installation of Java and add the appropriate
+directory to the PATH variable, e.g. "C:\Program
+Files\Java\jdk1.7.0\bin."
+
+Another possible problem is that your Java version is not compatible
+with Nyquist. In that case, you should see an error message 
+complaining about "Unsupported major.minor version...". The current
+major.minor version is 51 and you need to have Java version 1.7 
+installed. (Use the command: java -version to find out your java
+version number.)
+
+You might have to reboot for these changes to take effect.
+
+Compile Nyquist for using Visual Studio
+---------------------------------------
+Nyquist can be compiled using Visual Studio 2010 or 2012. You can
+download Visual C++ Express 2010 and Visual Studio 2012 Express for
+free from Mircosoft website.
+
+If you use Visual C++ 2010 Express, you MUST install SP1 (service pack
+1).
+
+Open nyquist-vc2010.sln; If you are using Visual Studio 2012 or later
+versions, open nyquist.sln instead. 
+
+In Visual Studio,
+	Set solution configuration to "Release" and solution platforms
+	to "Win32".
+	Click Debug->Build Solution (or press F7)
+	
+	Click Debug->Start Debugging (or press F5)
+
+To build jnyqide, 
+	Check if you have installed JDK and have the directory to
+	javac.exe added to your system PATH. 
+	Run comp-ide.bat under the project root. It will compile .java
+	files under jnyqide.
+	For debugging, you can run the IDE immediately. 
+	    First copy nyquist\WinRel\nyquist.exe to nyquist\ (only do
+            	this each time you recompile nyquist.)
+	    Then, run jnyqide.bat.
+        To generate a release:
+	    Run releasenyqide.bat under the project root. It will copy
+                all the necessary files to .\nyqrelide\. You can run
+                jnyqide.bat from there.