/* FLAC - Free Lossless Audio Codec
- * Copyright (C) 2001,2002,2003,2004 Josh Coalson
+ * Copyright (C) 2001,2002,2003,2004,2005 Josh Coalson
*
* This file is part the FLAC project. FLAC is comprised of several
* components distributed under difference licenses. The codec libraries
===============================================================================
-FLAC - 1.1.1-beta1 - Contents
+FLAC - 1.1.1 - Contents
===============================================================================
- Introduction
+- Prerequisites
- Building in a GNU environment
- Building with Makefile.lite
- Building with MSVC
This is the source release for the FLAC project. See
- doc/index.html
+ doc/html/index.html
for full documentation.
===============================================================================
+Prerequisites
+===============================================================================
+
+To build FLAC with support for Ogg FLAC you must have built and installed
+libogg according to the specific instructions below. You must have
+libogg 1.1.2 or greater, or there will be seeking problems with Ogg FLAC.
+
+If you are building on x86 and want the assembly optimizations, you will
+need to have NASM >= 0.98.30 installed according to the specific instructions
+below.
+
+
+===============================================================================
Building in a GNU environment
===============================================================================
(usually /usr/lib/xmms/Input).
--with-ogg=
---with-id3lib=
--with-xmms-prefix=
--with-libiconv-prefix=
Use these if you have these packages but configure can't find them.
Prerequisite: you must have the Ogg libraries installed as described
later.
-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
+Prerequisite: you must have nasm installed, and nasmw.exe must be in
+your PATH, or the path to nasmw.exe must be added to the list of
+directories for executable files in the MSVC global options.
To build everything, run Developer Studio, do File|Open Workspace,
and open FLAC.dsw. Select "Build | Set active configuration..."
Don't worry about the rest of the stuff that is in build/ or
the stuff that was already there before building.
+The Project Builder project requires that you have libiconv and
+libogg in /sw, ala fink. If you don't, you'll need to install
+them somewhere and change the path to them in the Library Paths
+section of several targets.
+
+It also assumes the CPU supports Altivec instructions. If it does
+not, you will also have to add -DFLAC__NO_ASM to the CFLAGS in the
+libFLAC target.
+
There currently is no install procedure; you will have to
manually copy the tools to wherever you need them.