81 lines
2.9 KiB
Plaintext
81 lines
2.9 KiB
Plaintext
$Header: /Users/cvs/dt/README.txt,v 1.2 2008/01/25 20:18:02 tberes Exp $
|
|
|
|
README FIRST
|
|
|
|
|
|
|
|
Licensing
|
|
--------------------------------------------------------------------------------------
|
|
This package (Dovetail Core Libraries and Frameworks) is licensed and copyrighted by
|
|
Dovetail Software, Inc. Portions of third party libraries have their own licensing
|
|
restrictions.
|
|
|
|
Copies of licenses can be found in the "src/licenses" folder, along with being
|
|
copied (e.g. built) to the output folder(s).
|
|
|
|
This software requires validily executed license agreements to be agreed upon by
|
|
the licensee/customer and Dovetail. Please see:
|
|
|
|
"src/licenses/DovetailSourceCodeLicense.html"
|
|
"src/licenses/Exhibit-A(sample).html"
|
|
|
|
A signed copy of the Exhibit A must be executed in order to use, examine
|
|
or otherwise possess this package.
|
|
|
|
Files and Directories
|
|
--------------------------------------------------------------------------------------
|
|
All files, with the exception of "deploy.properties" are version controlled using
|
|
CVS (see CVS section below for more information).
|
|
|
|
- README.txt -- this file
|
|
- build.xml -- build the various output artifacts
|
|
- src/ -- source files
|
|
- deploy.properties -- [NON CVS] override default build properties. Optional.
|
|
- staging -- [NON CVS] build output root
|
|
|
|
Build Configuration
|
|
--------------------------------------------------------------------------------------
|
|
|
|
Environment Settings
|
|
====================
|
|
Set the following variables in your .bashrc or other startup profile script:
|
|
|
|
DT_HOME=/Users/tim/Development/dt
|
|
CATALINA_HOME=/usr/local/tomcat
|
|
ANT_HOME=/usr/local/ant
|
|
STRUTS_HOME=/usr/local/struts
|
|
FMPP_HOME=/usr/local/fmpp
|
|
JGROUSE_HOME=/usr/local/jGrouse
|
|
JAVA_OPTS=-Xms384m -Xmx1400m
|
|
JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Versions/1.6/Home
|
|
LANG=en_IE.UTF-8
|
|
MYSQL_HOME=/usr/local/mysql
|
|
PATH= {insure following in PATH:
|
|
$JAVA_HOME/bin:
|
|
$JAVA_HOME/jre/bin:
|
|
$MYSQL_HOME/bin:
|
|
$ANT_HOME/bin:
|
|
$CATALINA_HOME/bin}
|
|
|
|
Tool and Framework Dependencies
|
|
================================
|
|
0. Insure you have a functioning "cvs" program.
|
|
1. Install Java 6 JDK or later.
|
|
2. Install Ant 1.6 (1.7 preferred) or later.
|
|
3. Install Struts 1.2.9.
|
|
4. Install FMPP 0.9.11 or later.
|
|
5. Install and configure MySQL 5.0 or later (5.1.xx preferred).
|
|
6. Install jGrouseDoc 0.8.5 or later.
|
|
7. Install and configure Tomcat 5.5.xx.
|
|
|
|
Building the Software
|
|
================================
|
|
$ cd $DT_HOME
|
|
$ ant onetime # one time setup; copies and configures ANT and checks env
|
|
$ # next three targets typically invoked from an app build file
|
|
$ ant build # build output files
|
|
$ ant jsdoc # create Javascript documentation
|
|
$ ant javadoc # create Java documentation
|
|
|
|
END OF DOCUMENT
|