------------------------------------------------------------------------------
README file for Open Federation Library
------------------------------------------------------------------------------
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
  
Copyright (c) 2007 Sun Microsystems, Inc. All Rights Reserved.
 
The contents of this file are subject to the terms
of the Common Development and Distribution License
(the License). You may not use this file except in
compliance with the License.
  
You can obtain a copy of the License at
https://opensso.dev.java.net/public/CDDLv1.0.html or
opensso/legal/CDDLv1.0.txt
See the License for the specific language governing
permission and limitations under the License.
  
When distributing Covered Code, include this CDDL
Header Notice in each file and include the License file
at opensso/legal/CDDLv1.0.txt.
If applicable, add the following below the CDDL Header,
with the fields enclosed by brackets [] replaced by
your own identifying information:
"Portions Copyrighted [year] [name of copyright owner]"
  
$Id: README,v 1.3 2008/06/25 05:46:14 qcheng Exp $


%% Contents:
    %% 1. Build requirements
    %% 2. Library dependencies
    %% 3. Building the workspace


%% 1. Build requirements

The OpenFederation Library workspace uses Apache Ant as the build tool. 
The build scripts in this workspace use features not present in releases 
of Ant prior to 1.6.  Thus, in order to build this workspace you must have 
Ant version 1.6.5 or above installed and available in your system path.
Set the ANT_HOME environment variable to the Ant root directory, and add 
${ANT_HOME}/bin to your PATH environment variable.

The sources in this workspace should be compiled using JDK 5.0 with the source
and target levels set to "1.4". In order to allow this, you must ensure that
JDK 5.0 is present in your system path and the JAVA_HOME environment variable
is setup correctly pointing to its location.

%% 2. Library dependencies

%% 2.1 Follow section 2 of the README under "opensso/products" directory to 
       resolve external library dependencies, and copy corresponding jars to  
       the "opensso/products/extlib" directory of your workspace. 
%% 2.2 Open Federation Library depends on openSSO shared library, you could
       - check out source code under "opensso/products/shared" branch.
       OR
       - download opensso-sharedlib.jar from web site
         https://opensso.dev.java.net/public/use/index.html
	 and copy it to the "opensso/products/federation/library/extlib" 
         directory of your workspace.

%% 3. Building the workspace

The workspace build system offers many build targets. You can view the
available targets by issuing the ant command from the root of the
workspace. The default target that is executed is the usage target which
displays a brief description about the other targets. Currently the main
targets available in the workspace are:
 
     - build      : compiles the sources
     - unittest   : generates unit test zip file
     - publicdoc  : creates javadocs for publicly supported API
     - doc        : creates all implementation javadocs
     - clean      : deletes the generated files
     - usage      : displays this usage message

