new grabbag testers

[platform/upstream/flac.git] / README

diff --git a/README b/README
index e50cecd..2b7a4d5 100644 (file)
--- a/README
+++ b/README
@@ -39,7 +39,7 @@ License (GFDL).
 
 
 ===============================================================================
-FLAC - 1.0.4_beta - Contents
+FLAC - 1.0.4 - Contents
 ===============================================================================
 
 - Introduction
@@ -150,13 +150,49 @@ not an x86, change -DFLAC__CPU_IA32 to -DFLAC__CPU_UNKNOWN.
 Building with MSVC
 ===============================================================================
 
-There is no overall make system for MSVC but the individual
-source directories with a 'Makefile.vc' file in them allow
-building with MSVC.  Just 'nmake /f Makefile.vc'.  Currently
-the Makefile.vc for libFLAC is hardcoded to use nasm.  If
-you don't have nasm, or don't want any assembly optimizations,
-edit the makefile, adding '/D FLAC__NO_ASM', and delete the
-rules which compile the .nasm files.
+There are two ways to build with MSVC:
+@@@@Prerequisite: Ogg headers/libs
+
+  1. Project Files
+  ----------------
+  Prerequisite: you must have nasm installed, and have the environment
+  variable FLAC_NASM set to the full path to nasmw.exe, e.g
+
+    C:\nasm\nasmw.exe
+
+  To build everything, run Developer Studio, do File|Open Workspace,
+  and open FLAC.dsw.  Switch to the 'Files' tab, select 'all files'
+  from the tree, do right-mouse-button and 'Set as active project'.
+  The default build mode will probably be Debug; to change to release
+  do Build|Set Active Configuration and select 'all - Win32 Release'.
+  Then do Project|Build.  The libraries will be built as and DLLs and
+  you'll need to install these as well.
+
+  2. nmake
+  --------
+  Prerequisite: you must have nasm installed and nasmw.exe must be in
+  your path.
+
+  To build everything, open a Command window, cd to the top-level
+  directory (where this README is) and do
+
+    nmake /f Makefile.vc
+
+  This will recur into all the source directories in the right order
+  and build everything.  The libraries will be build only as static
+  libs.  You need only to install the binaries.  To clean up everything
+  you can do
+
+    nmake /f Makefile.vc clean
+
+  from the top level directory, or any directory which has a
+  Makefile.vc
+
+Everything will end up in the 'obj' directory.  DLLs and .exe files
+are all that are needed and can be copied to an installation area an
+added to the PATH.  The plugins have to be copied to their appropriate
+place in the player area.  For Winamp2 this is <winamp2-dir>\Plugins
+and for Winamp3 this is <winamp3-dir>\Wacs.
 
 
 ===============================================================================