svn commit: r115 - trunk/www/docs/OpenSourceBuild__README.html

Mon Dec 4 19:03:12 EST 2006

Author: gregboone
Date: 2006-12-05 00:03:12+0000
New Revision: 115

Modified:
   trunk/www/docs/OpenSourceBuild__README.html

Log:
FDO111: Update FDO Web Documentation (3.2.0)

Modified: trunk/www/docs/OpenSourceBuild__README.html
Url: https://fdo.osgeo.org/source/browse/fdo/trunk/www/docs/OpenSourceBuild__README.html?view=diff&rev=115&p1=trunk/www/docs/OpenSourceBuild__README.html&p2=trunk/www/docs/OpenSourceBuild__README.html&r1=114&r2=115
==============================================================================

--- trunk/www/docs/OpenSourceBuild__README.html	(original)
+++ trunk/www/docs/OpenSourceBuild__README.html	2006-12-05 00:03:12+0000
@@ -14,20 +14,37 @@
 Ensure you read through this document before building.
 
 Contents:
+
 Windows Instructions
-   - Windows Notes
-   - Windows Build Instructions
+   - Build Instructions
+   - Build Notes
+   - Running the FDO Unit Tests
 Linux Instructions
-   - Linux Notes
-   - Linux Build Instructions
+   - Build Instructions
+   - Build Notes
+   - Running the FDO Unit Tests
 
 -----------------------------
 Windows Instructions
 -----------------------------
 
-I. Windows Notes: 
+I. Build Instructions
+
+  1. cd [FDO OpenSource]
+
+  2. Open and modify setenvironment.bat to specify the locations of the Thirdparty SDK 
+     components and build tools. (Refer to Build notes below)
+
+  3. call setenvironment.bat
+
+  4. call build_thirdparty.bat
+
+  5. call build.bat
+
 
-  In preparation for building the Windows Open Source FDO Binaries
+II. Build Notes
+
+  In preparation for building the Windows Open Source FDO Binaries:
 
   1. The FDO open source build process supports the usage of either the Visual 
      Studio Express, Standard or Professional editions. 
@@ -183,15 +200,12 @@
         set PATH=%PATH%;C:\Program Files\doxygen\bin
         set PATH=%PATH%;C:\Program Files\ATT\Graphviz\bin
 
-  9. NOTE: Use the [FDO OpenSource]\setenvironment.bat script to assist in setting and
+  9. Use the [FDO OpenSource]\setenvironment.bat script to assist in setting and
      maintaing the correct environment settings for the FDO build process. 
      This script can be modifed and used to set the correct environment variables 
      and PATH settings.
 
- 
-II. Windows Build Instructions:
-
-  1. Use the build_thirdparty.bat file to build the FDO Thirdparty binaries. The following 
+ 10. The build_thirdparty.bat file is ude to build the FDO Thirdparty binaries. The following 
      is a general guideline on how to use the build_thirdparty.bat build script.
   
            **************************************************************************
@@ -225,8 +239,7 @@
             **** Build Thirdparty components for for the WMS and WFS Providers
             build_thirdparty -w=wms -w=wfs
 
-
-  2. Use the build.bat file to build the FDO binaries. The following 
+ 11. The build.bat file is used to build the FDO binaries. The following 
      is a general guideline on how to use the build.bat build script.
   
            **************************************************************************
@@ -281,7 +294,13 @@
             **** Build documentation and install all files to C:\Fdo
             build -a=install -o=C:\Fdo -d=build 
 
-  3.   In order to run the FDO API, WMS, SHP, SDF, ArcSDE, GDAL, MySql and Odbc Provider Unit Tests
+ 
+III. Running the FDO Unit Tests
+
+    The FDO API and the FDO providers come with unit tests that will allow the various 
+    products to be tested once the build is complete. In order to run the FDO API, 
+    WMS, SHP, SDF, ArcSDE, GDAL, MySql and Odbc Provider Unit Tests, follow the following
+    instructions once the build has completed
 
         FDO:
 
@@ -384,7 +403,37 @@
 Linux Instructions
 -----------------------------
  
-I. Linux Notes:
+I. Build Instructions
+
+  1. cd [FDO OpenSource]
+
+  2. Open and modify setenvironment.sh to specify the locations of the Thirdparty SDK 
+     components and build tools. (Refer to Build notes below)
+
+  3. source ./setenvironment.sh
+
+  4. ./build_thirdparty.sh
+
+  5. ./build_linux.sh
+
+  NOTE: build_linux.sh is a simple helper script that assists developers to build the FDO 
+        components. These scripts supplement standard support of configure and make. 
+
+        The implementation of the above build_linux.sh script in essence calls ...
+ 
+        aclocal
+        libtoolize --force
+        automake --add-missing --copy
+        autoconf
+        ./configure
+        make
+        make install
+
+        for the fdo core API components as well as the set of FDO providers that are 
+        currently supported in the automated build process. Users are free to call configure 
+        and make without using the build_linux.sh helper script.
+
+II. Build Notes
 
   In preparation for building the Linux Open Source FDO Binaries
 
@@ -490,10 +539,8 @@
      This script can be modifed and used to set the correct environment variables 
      and PATH settings.
 
-II. Linux Build Instructions:
-
-  1. Use the build_thirdparty.sh script to build the FDO Thirdparty binaries. The following 
-     is a general guideline on how to use the build_thirdparty.bat build script.
+ 11. The build_thirdparty.sh script is used to build the FDO Thirdparty binaries. 
+     The following is a general guideline on how to use the build_thirdparty.bat build script.
   
            **************************************************************
            build_thirdparty.sh [--h] [--a Action] [--m ConfigMakefiles]
@@ -518,7 +565,8 @@
             **** Clean up all Thirdparty components
             build_thirdparty --a clean
 
-  2. Use the build_linux.sh script to build and install the FDO OpenSource 
+
+ 12. The build_linux.sh script is used to build and install the FDO OpenSource 
      libraries. The following is a general guideline on how to use build_linux.sh
 
            **************************************************************
@@ -574,28 +622,13 @@
             **** Configure and Build both the WMS and WFS Providers
             build_linux.sh --a build --w wms --w wfs
 
-     NOTE: build_linux.sh is a simple helper script that assists developers to build the FDO 
-           components. These scripts supplement standard support of configure and make. We have 
-           many components in the FDO architecture and building them all was getting somewhat 
-           tedious using straight calls to configure and make. We also found that some 
-           developers were not interested in building all components or were only interested 
-           in building a subset of the components. 
-
-           The implementation of the above build_linux.sh script in essence calls ...
- 
-               aclocal
-               libtoolize --force
-               automake --add-missing --copy
-               autoconf
-               ./configure
-               make
-               make install
-
-           ... for the fdocore components as well as the set of FDO providers that are 
-           currently supported on the OSGeo site. 
 
-  3. In order to run the FDO API, WMS, SDF, SHP, ArcSDE, GDAL, MySQL and Odbc Provider Unit Tests:
+III. Running the FDO Unit Tests
 
+    The FDO API and the FDO providers come with unit tests that will allow the various 
+    products to be tested once the build is complete. In order to run the FDO API, 
+    WMS, SHP, SDF, ArcSDE, GDAL, MySql and Odbc Provider Unit Tests, follow the following
+    instructions once the build has completed
         
         FDO:
 


