Add document build support - UNIX and WINDOWS can now create Xalan-C project documents
diff --git a/build.bat b/build.bat
deleted file mode 100755
index 36b07e5..0000000
--- a/build.bat
+++ /dev/null
@@ -1,80 +0,0 @@
-@echo off
-rem
-rem ==========================================================================
-rem
-rem = Licensed to the Apache Software Foundation (ASF) under one
-rem = or more contributor license agreements. See the NOTICE file
-rem = distributed with this work for additional information
-rem = regarding copyright ownership. The ASF licenses this file
-rem = to you under the Apache License, Version 2.0 (the "License");
-rem = you may not use this file except in compliance with the License.
-rem = You may obtain a copy of the License at
-rem =
-rem = Unless required by applicable law or agreed to in writing, software
-rem = distributed under the License is distributed on an "AS IS" BASIS,
-rem = WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-rem = See the License for the specific language governing permissions and
-rem = limitations under the License.
-rem ==========================================================================
-rem
-rem build.bat: Xalan-C Documentation Build
-rem Usage: build [ant-options] [targets]
-rem Setup:
-rem - you should set JAVA_HOME
-rem - you can set ANT_HOME if you use your own Ant install
-rem - JAVA_OPTS is added to the java command line
-rem - PARSER_JAR may be set to use alternate parser (default:bin\xercesImpl.jar)
-echo.
-echo Xalan-C Documentation Build
-echo ---------------------------
-
-if not "%JAVA_HOME%" == "" goto setant
-:noJavaHome
-rem Default command used to call java.exe; hopefully it's on the path here
-if "%_JAVACMD%" == "" set _JAVACMD=java
-echo.
-echo Warning: JAVA_HOME environment variable is not set.
-echo If build fails because sun.* classes could not be found
-echo you will need to set the JAVA_HOME environment variable
-echo to the installation directory of java.
-echo.
-
-:setant
-rem Default command used to call java.exe or equivalent
-if "%_JAVACMD%" == "" set _JAVACMD=%JAVA_HOME%\bin\java
-
-rem Default _ANT_HOME to Xalan's checked-in copy if not set
-set _ANT_HOME=%ANT_HOME%
-if "%_ANT_HOME%" == "" set _ANT_HOME=.
-
-rem Default locations of jars we depend on to run Ant on our build.xml file
-rem Set our local vars to all start with _underscore
-set _ANT_JAR=%ANT_JAR%
-if "%_ANT_JAR%" == "" set _ANT_JAR=bin\ant.jar
-set _PARSER_JAR=%PARSER_JAR%
-if "%_PARSER_JAR%" == "" set _PARSER_JAR=bin\xercesImpl.jar
-set _XML-APIS_JAR=%XML-APIS_JAR%
-if "%_XML-APIS_JAR%" == "" set _XML-APIS_JAR=bin\xml-apis.jar
-
-rem Attempt to automatically add system classes to _CLASSPATH
-rem Use _underscore prefix to not conflict with user's settings
-set _CLASSPATH=%CLASSPATH%
-if exist "%JAVA_HOME%\lib\tools.jar" set _CLASSPATH=%CLASSPATH%;%JAVA_HOME%\lib\tools.jar
-if exist "%JAVA_HOME%\lib\classes.zip" set _CLASSPATH=%CLASSPATH%;%JAVA_HOME%\lib\classes.zip
-set _CLASSPATH=%_ANT_JAR%;%_XML-APIS_JAR%;%_PARSER_JAR%;%_CLASSPATH%
-
-@echo on
-"%_JAVACMD%" -mx64m %JAVA_OPTS% -Dant.home="%ANT_HOME%" -classpath "%_CLASSPATH%" org.apache.tools.ant.Main %1 %2 %3 %4 %5 %6 %7 %8 %9
-@echo off
-
-goto end
-
-:end
-rem Cleanup environment variables
-set _JAVACMD=
-set _CLASSPATH=
-set _ANT_HOME=
-set _ANT_JAR=
-set _PARSER_JAR=
-set _XML-APIS_JAR=
-
diff --git a/build.sh b/build.sh
deleted file mode 100644
index 0a008b8..0000000
--- a/build.sh
+++ /dev/null
@@ -1,67 +0,0 @@
-#!/bin/sh
-#
-#
-# Licensed to the Apache Software Foundation (ASF) under one
-# or more contributor license agreements. See the NOTICE file
-# distributed with this work for additional information
-# regarding copyright ownership. The ASF licenses this file
-# to you under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-# http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-#
-###################################################################
-
-echo "Xalan-C Documentation Build"
-echo "---------------------------"
-
-_JAVACMD=$JAVA_HOME/bin/java
-if [ "$JAVA_HOME" = "" ] ; then
- echo "Warning: JAVA_HOME environment variable is not set."
- _JAVACMD=java
-fi
-
-# Default locations of jars we depend on to run Ant on our build.xml file
-if [ "$ANT_HOME" = "" ] ; then
- ANT_HOME=.
-fi
-if [ "$ANT_JAR" = "" ] ; then
- ANT_JAR=./bin/ant.jar
-fi
-if [ "$PARSER_JAR" = "" ] ; then
- PARSER_JAR=./bin/xercesImpl.jar
-fi
-
-if [ "$XML_APIS_JAR" = "" ] ; then
- XML_APIS_JAR=./bin/xml-apis.jar
-fi
-
-# Use _underscore prefix to not conflict with user's settings
-# Default to UNIX-style pathing
-CLPATHSEP=:
-# if we're on a Windows box make it ;
-uname | grep WIN && CLPATHSEP=\;
-_CLASSPATH="$ANT_JAR${CLPATHSEP}$XML_APIS_JAR${CLPATHSEP}$PARSER_JAR${CLPATHSEP}$CLASSPATH"
-
-# Attempt to automatically add system classes to _CLASSPATH
-if [ -f $JAVA_HOME/lib/tools.jar ] ; then
- _CLASSPATH=${_CLASSPATH}${CLPATHSEP}${JAVA_HOME}/lib/tools.jar
-fi
-
-if [ -f $JAVA_HOME/lib/classes.zip ] ; then
- _CLASSPATH=${_CLASSPATH}${CLPATHSEP}${JAVA_HOME}/lib/classes.zip
-fi
-
-
-echo "Starting Ant with targets: $@"
-echo " ...with classpath: $_CLASSPATH"
-
-"$_JAVACMD" $JAVA_OPTS -Dant.home=$ANT_HOME -classpath "$_CLASSPATH" org.apache.tools.ant.Main $@
-
diff --git a/build.xml b/build.xml
deleted file mode 100644
index a86addc..0000000
--- a/build.xml
+++ /dev/null
@@ -1,166 +0,0 @@
-
-<!--
- Licensed to the Apache Software Foundation (ASF) under one
- or more contributor license agreements. See the NOTICE file
- distributed with this work for additional information
- regarding copyright ownership. The ASF licenses this file
- to you under the Apache License, Version 2.0 (the "License");
- you may not use this file except in compliance with the License.
- You may obtain a copy of the License at
-
- http://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License.
- -->
-
-
-<project name="XalanC" default="docs" basedir=".">
-
- <property name="name" value="xalan"/>
- <property name="Name" value="Xalan-C++"/>
- <property name="year" value="2012"/>
-
- <property name="version.VERSION" value="1"/>
- <property name="version.RELEASE" value="10"/>
- <property name="version.MINOR" value="0"/>
-
- <property name="xdocs.dir" value="./xdocs"/>
- <property name="xdocs.book" value="${xdocs.dir}/sources/xalanLocal.xml"/>
- <property name="xdocs.site" value="${xdocs.dir}/sources/xalan.xml"/>
- <property name="xdocs.style" value="${xdocs.dir}/style"/>
- <property name="xdocs.apidocs" value="${xdocs.dir}/html/apiDocs"/>
-
- <property name="doc.generator" value="org.apache.stylebook.StyleBook"/>
- <property name="doc.generator.styletargz" value="${xdocs.dir}/xml-site-style.tar.gz"/>
- <property name="doc.generator.styletar" value="${xdocs.dir}/xml-site-style.tar"/>
-
- <property name="build.dir" value="./build"/>
- <property name="build.docs" value="${build.dir}/docs"/>
- <property name="build.apidocs" value="${build.docs}/apiDocs"/>
- <property name="site.dir" value="./xml-site"/>
-
- <property name="package.name" value="Xalan-C"/>
- <property name="package.version" value="${version.VERSION}_${version.RELEASE}_${version.MINOR}"/>
- <property name="docs.package.name" value="${package.name}_${package.version}-docs"/>
- <property name="webdocs.package.name" value="${package.name}_${package.version}-webdocs"/>
- <property name="src.package.name" value="${package.name}_${package.version}-src"/>
-
- <target name="prepare">
- <gunzip src="${doc.generator.styletargz}"/>
- <untar src="${doc.generator.styletar}" dest="${xdocs.dir}"/>
- <delete file="${doc.generator.styletar}"/>
- <mkdir dir="${build.apidocs}"/>
- <mkdir dir="${site.dir}/apiDocs"/>
- <!--echo message="Transform commits.xml and put the result in ${xdocs.dir}/DONE"/>
- <java fork="yes" classname="org.apache.xalan.xslt.Process" classpath="${java.class.path}">
- <arg line="-in commits.xml -xsl ${xdocs.style}/stylesheets/done-c.xsl -out xdocs/sources/xalan/DONE"/>
- </java-->
-
- </target>
-
- <target name="docs" depends="prepare, apidocs">
- <java fork="yes" classname="${doc.generator}" classpath="${java.class.path}">
- <arg line="targetDirectory=${build.docs} ${xdocs.book} ${xdocs.style}"/>
- </java>
- </target>
-
- <target name="apidocs" depends="prepare">
- <copy todir="${build.apidocs}">
- <fileset dir="${xdocs.apidocs}"/>
- </copy>
- <exec executable="doxygen" dir="${xdocs.dir}">
- <arg value="DoxyfileXalan"/>
- </exec>
- </target>
-
- <target name="site" depends="prepare">
- <java fork="yes" classname="${doc.generator}" classpath="${java.class.path}">
- <arg line="targetDirectory=${site.dir} ${xdocs.site} ${xdocs.style}"/>
- </java>
- <copy todir="${site.dir}/apiDocs">
- <fileset dir="${build.apidocs}"/>
- </copy>
-
- </target>
-
- <target name="clean">
- <delete dir="${build.dir}"/>
- <delete dir="${site.dir}"/>
- </target>
-
- <!-- =================================================================== -->
- <!-- Use FOP to create preliminary print (pdf) doc -->
- <!-- Note: fop.jar and xml.jar (from xml-fop) must be on classpath -->
-
- <!-- This is VERY preliminary, not yet for inclusion in distribution -->
- <!-- =================================================================== -->
-
- <!--Collate the xml sources into a single xml source with a litle extra structure -->
- <target name="print.docs" depends="prepare">
- <echo message="fop.jar and xml.jar must be on the classpath"/>
- <java fork="yes" classname="org.apache.xalan.xslt.Process"
- classpath="${java.class.path}:${build.dir}/xalan.jar">
- <arg line="-xsl ${xdocs.dir}/sources/xalan-c-collate.xsl
- -out ${xdocs.dir}/sources/xalan/xalan-c-collate.xml"/>
- </java>
-
- <!-- Transform collation into Formatting Objects
- (with a little work on links along the way) -->
- <java fork="yes" classname="org.apache.xalan.xslt.Process"
- classpath="${java.class.path}:${build.dir}/xalan.jar">
- <arg line="-in ${xdocs.dir}/sources/xalan/xalan-c-collate.xml
- -param resourceFile '../../sources/xalan/resources.xml'
- -param project ${Name}
- -xsl ${xdocs.style}/stylesheets/xml2fo.xsl
- -out ${build.docs}/xalan-c-collate.fo"/>
- </java>
-
- <!-- Use FOP to generate a pdf file -->
- <java fork="yes" classname="org.apache.fop.apps.CommandLine"
- classpath="${java.class.path}:${build.dir}/xalan.jar:${bin.dir}/fop.jar:${bin.dir}/w3c.jar">
- <arg line="${build.docs}/xalan-c-collate.fo build/docs/xalan-c.pdf"/>
- </java>
- </target>
-
- <!-- package documentation (user guide and apidocs) for distribution -->
- <target name="pack.docs">
- <mkdir dir="${build.dir}/${docs.package.name}"/>
- <copy todir="${build.dir}/${docs.package.name}">
- <fileset dir="${build.docs}"/>
- </copy>
-
- <tar tarfile="${build.dir}/${docs.package.name}.tar" basedir="${build.dir}" includes="${docs.package.name}/**"/>
- <gzip src="${build.dir}/${docs.package.name}.tar" zipfile="${build.dir}/${docs.package.name}.tar.gz"/>
- <delete file="${build.dir}/${docs.package.name}.tar"/>
-
- <zip zipfile="${build.dir}/${docs.package.name}.zip" basedir="${build.dir}" includes="${docs.package.name}/**"/>
- </target>
-
- <!-- package documentation (user guide and apidocs) for transfer to website -->
- <target name="pack.webdocs">
- <tar tarfile="${build.dir}/${webdocs.package.name}.tar" basedir="${site.dir}" includes="**"/>
- <gzip src="${build.dir}/${webdocs.package.name}.tar" zipfile="${build.dir}/${webdocs.package.name}.tar.gz"/>
- <delete file="${build.dir}/${webdocs.package.name}.tar"/>
-
- <zip zipfile="${build.dir}/${webdocs.package.name}.zip" basedir="${site.dir}" includes="**"/>
- </target>
-
- <!-- package source code for distribution -->
- <target name="pack.src">
- <mkdir dir="${build.dir}/${src.package.name}"/>
- <copy todir="${build.dir}/${src.package.name}">
- <fileset dir="../.." excludes="xml-xalan/c/build/** xml-xalan/c/xml-site/**"/>
- </copy>
-
- <tar tarfile="${build.dir}/${src.package.name}.tar" basedir="${build.dir}/${src.package.name}" includes="**" defaultexcludes="no"/>
- <gzip src="${build.dir}/${src.package.name}.tar" zipfile="${build.dir}/${src.package.name}.tar.gz"/>
- <delete file="${build.dir}/${src.package.name}.tar"/>
-
- <zip zipfile="${build.dir}/${src.package.name}.zip" basedir="${build.dir}/${src.package.name}" includes="**" defaultexcludes="no"/>
- </target>
-
-</project>
diff --git a/readme.html b/readme.html
index e2f8f84..9b1a56d 100644
--- a/readme.html
+++ b/readme.html
@@ -21,7 +21,7 @@
</title>
</head>
<body>
-<meta content="0; URL=c/docs/overview.html" http-equiv="Refresh">
+<meta content="0; URL=build/docs/xalan-c/overview.html" http-equiv="Refresh">
Redirecting to <a href="overview.html">Xalan-C++ Overview</a>
</body>
</html>
diff --git a/xdocs/README.txt b/xdocs/README.txt
index aa0730e..8ff186d 100644
--- a/xdocs/README.txt
+++ b/xdocs/README.txt
@@ -1,14 +1,15 @@
XALAN-C++ USER GUIDE DEVELOPER NOTES
+Edited: 2012-09-16
+UNIX platforms can make both the xalan-c API document and the xalan-c website.
-These are some notes for creating the XALAN-C++ User Guide from
-StyleBook XML sources.
+WINDOWS platforms can only make the xalan-c website without the xalan-C apiDocs.
-Java and the Apache StyleBook program are no longer required.
-The XML transformations are now done using a standard XSLT transformation
-utility.
-
+Java and the Apache StyleBook program are no longer reuired.
+The XML transformations are now done using a standard XSLT
+command-line stylesheet transformation utility. The Apache Xalan
+program or Xalan.exe program is used for this transformation.
The resulting web pages have static content without any javascript
or other scripting requirements.
@@ -17,92 +18,127 @@
are rendered as strict, the productions accommodate most browsers that
only render the loose or transitional implementation.
+Download the source package from repository or subversion
--------------------------------------------------------------------------
+ http://www.apache.org/dyn/closer/xalan/xalan-c
+ http://svn.apache.org/repos/asf/xalan/c/trunk
+
+The documentation products will be built to the target directories
+
+ c/trunk/build/docs/apiDocs
+ c/trunk/build/docs/xalan-c
+
+UNIX Build xalan-c apiDocs
+
+ Prerequisite: The Doxygen package must be installed (doxygen) program.
+ Prerequisite: The GraphViz package must be installed (dot) program.
+
+ cd {c/trunk/xdocs}
+ Edit the "make-apiDocs.sh" script
+
+ Run the "make-apiDocs.sh" script
+
+UNIX Build xalan-c website pages
+
+ Prerequisite: The "Xalan" command-line executable must be available
+
+ cd {c/trunk/xdocs/sources}
+ Run the "make-book.sh" script
+
+WINDOWS Build the xalan-c website pages
+
+ Prerequisite: The "xalan.exe" command-line executable must be available
+
+ cd {c/trunk/xdocs/sources}
+ Run the "make-book.bat" script
+
+-------------------------------------------------------------------
+The "sbk:" prefix is non-standard and was recognized by the deprecated
+Apache Stylebook Java program. The "sbk:" prefix has now been replaced
+with relative URLs for use with a standard XSLT stylesheet processor.
+
MANIFEST
-sbk:(Source Tree) = trunk\xdocs
+ {xalan/c/trunk}
- html\ Where StyleBook web pages are created
- html\apiDocs\ Where doxygen API web pages are located
+ bin/
+ Placeholder for Xalan.exe and DLL files for Windows Binary executables.
- style\dtd\ The StyleBook DOCTYPE Definitions
+ build/
+ Placeholder where products are constructed.
- sources\ Where my processing scripts are located
- sources\xalan\ The StyleBook XML for Xalan User Guide
- sources\docs\ The StyleBook - XML test suite
- sources\xalan-graphic\ Image files for xalan StyleBook XML
- sources\xslt-resources\ Resource files for html StyleBook web pages
+ build/docs/appDocs/
+ Placeholder for construction of xalan-c apiDocs.
- sources\entities.ent Version entities for xalan StyleBook XML
- sources\xalan-book.xslt StyleBook XSLT for Xalan StyleBook XML
- sources\make-xalan.bat Transform single xalan StyleBook XML chapter
- sources\make-book.bat Transform all xalan StyleBook XML chapters
+ build/docs/xalan-c/
+ Placeholder for construction of xalan-c webpages.
- sources\mybook.xslt StyleBook XSLT for StyleBook XML Tests
- sources\make-doc.bat Transform a single StyleBook XML Test
- sources\make-tests.bat Transform all StyleBook XML Tests
+ src/
+ Source tree of C/C++ sources for making the xalan library and
+ Xalan command-line processor. The *.hpp source files contain
+ the structured components from which the apiDocs document is
+ constructed.
- sources\xslt-resources\apache-xalan.css The html (css) stylesheet
- sources\xslt-resources\asf_logo.png The ASF logo for header section
+ xdocs/
+ Directory tree of documentation sources and build scripts.
--------------------------------------------------------------------------
+ xdocs/DoxyfileXalan The configuration file for doxygen program.
-xalan and stylebook source edit is required to replace (sbk:) prefix.
+* xdocs/make-apiDocs.sh The Bourne shell script to build apiDocs.
-The (sbk:) uri prefix is non-standard and since replaced with relative
-system URLs. In the (sources\xalan, sources\docs) directories, thex
-(sbk:) is replaced with (../../).
+ xdocs/html/apiDocs/
+ Directory of doxygen include files and Apache feather logo
+ for apiDocs pages.
-The transformed XML places a copyright byline on each web page created.
-You should edit the (make-xalan.bat, make-doc.bat) files to supply a
-proper create-date.
+ xdocs/style/dtd/ The Stylebook validation DTD files.
-You should also edit the (make-xalan.bat, make-doc.bat) to invoke your
-XSLT command line transformation utility.
+ xdocs/sources/
+ Directory tree of sources and scripts to build the xalan-c
+ webpages or User Guide.
-The exslt.exe processor I use for XML transformation is based on the
-xalan command-line transformer. The critical capability is the ability
-to insert top-level xslt parameters into the transformation process.
+ xdocs/sources/entities.ent
+ Some included DTD entity definitions.
-The xslt top-level parameters are:
+ xdocs/sources/xalan-xml
+ The Stylebook XML page navigation source.
- $sectionid = ($sectionid).xml // chapter to transform
- $createdate = "date string" // date of web page creation
+ xdocs/sources/stylebook.xslt
+ The standardized Xalan stylebook transformation stylesheet.
-The $sectionid is used in creating the <div id="navLeft"> html.
+ xdocs/sources/xalan/
+ Directory of Stylebook XML page sources for xalan-c User Guide.
-The $createdate is used in creating the <div id="footer"> html.
+ xdocs/sources/xalan-graphic/
+ Special graphics required by some xdocs/sources/xalan/ sources.
+ These files are copied to build/docs/xalan-c/
--------------------------------------------------------------------------
+ xdocs/sources/xslt-resources/
+ The Xalan LOGOs and css stylesheets for rendering web pages.
+ These files are copied to build/docs/xalan-c/resources/
-After doing the transformations, the following files should be copied
-to the target (html) directory paths.
+* xdocs/sources/make-book.sh
+ The UNIX Bourne shell script to build the xalan-c web pages.
- sources\xslt-resources\* -> html\resources\
+* xdocs/sources/make-book.bat
+ The Windows command script to build the xalan-c web pages.
- sources\xalan-graphic\* -> html\
+-------------------------------------------------------------------
+The Xalan-C website is published to "svnpubsub" by copying
-The Xalan-C++ API Reference Manual created by the Doxygen and GraphVue
-programs is to be copied into the (html\apiDocs\) directory.
+ build/docs/xalan-c/*
--------------------------------------------------------------------------
+to the "svnpubsub" repository tree
-=====
-TO DO
-=====
+ {svn}/xalan/site/docs/xalan/xalan-c/
-Resolve the broken linkages.
+then perform a repository subversion check-in.
+-------------------------------------------------------------------
-Resolve the version packaging information.
+These notes are provided by Steven J. Hathaway for the
+Xalan Documentation Project.
-Prepare an updated product revision history.
-
-Prepare an SVN branch for documentation pre-release (v1.11)
-
-Prepare an SVN branch for source code pre-release (v1.11)
-
-Prepare a repository for specific binary releases (v1.11)
+Current information is available on the Xalan website
+http://xalan.apache.org/xalan-c
diff --git a/xdocs/make-apiDocs.sh b/xdocs/make-apiDocs.sh
new file mode 100755
index 0000000..61f4cbc
--- /dev/null
+++ b/xdocs/make-apiDocs.sh
@@ -0,0 +1,74 @@
+#!/bin/sh
+#
+# Script file to create Xalan-C apiDocs
+#
+# This script requires current versions of "Doxygen" and
+# "GraphViz (dot)" programs to be installed on your UNIX.
+#
+
+# Various OS's have different ways of specifying the library path
+#
+# Solaris and Linux
+ LD_LIBRARY_PATH=/usr/local/lib
+#
+# HP-UX
+# SHLIB_PATH=/usr/local/lib
+#
+# AIX and BSD
+# LIBPATH=/usr/local/lib
+#
+# Mac OS X
+# DYLD_LIBRARY_PATH=/usr/local/lib
+#
+# Cygwin and MinGW
+# PATH=
+#
+
+# Add the current directory to the PATH for nested scripts
+
+PATH=$PATH:.
+
+# Add the PATH for the Xalan program
+
+export PATH=/usr/local/bin:$PATH
+
+# Make the necessary target paths
+
+if [ ! -d ../build/docs/apiDocs ] ; then
+ mkdir -p ../build/docs/apiDocs
+fi
+if [ ! -d ../build/docs/xalan-c ] ; then
+ mkdir -p ../build/docs/xalan-c
+fi
+
+# Create the xalan-c apiDocs using (doxygen) and (dot).
+
+doxygen DoxyfileXalan
+
+# We may not want the many *.md5 files
+
+rm ../build/docs/apiDocs/html/*.md5
+
+# Copy the Apache Trademark Graphic
+
+cp html/apiDocs/asf_logo_wide.gif ../build/docs/apiDocs/html
+
+# Move the apiDocs to the xalan-c website tree
+
+if [ -e ../build/docs/xalan-c/apiDocs ] ; then
+ rm -rf ../build/docs/xalan-c/apiDocs
+fi
+mv ../build/docs/apiDocs/html ../build/docs/xalan-c/apiDocs
+
+#
+# Done with xalan-c apiDocs build
+#
+
+#
+# Chain to sources to create xalan-c website pages
+#
+
+cd sources
+make-book.sh
+cd ..
+
diff --git a/xdocs/sources/make-book.sh b/xdocs/sources/make-book.sh
new file mode 100755
index 0000000..6ee3ae8
--- /dev/null
+++ b/xdocs/sources/make-book.sh
@@ -0,0 +1,54 @@
+#!/bin/sh
+#
+# Bourne shell script to create Xalan-C documentation pages
+#
+# SET THE LIBRARY PATH FOR YOUR OPERATING SYSTEM, REQUIRED BY "Xalan" PROGRAM
+#
+# SOLARIS AND LINUX
+ export LD_LIBRARY_PATH=/usr/local/lib
+#
+# AIX AND BSD
+# export LIBPATH=/usr/local/lib
+#
+# HPUX
+# export SHLIB_PATH=/usr/local/lib
+#
+# MAC OS/X
+# export DYLD_LIBRARY_PATH=/usr/local/lib
+#
+# CYGWIN AND MINGW
+# export PATH=$PATH;/usr/local/lib
+#
+
+umask 0002
+mkdir -p ../../build/docs/xalan-c/resources
+
+make-xalan.sh usagepatterns
+make-xalan.sh samples
+make-xalan.sh resources
+# make-xalan.sh build_instruct
+make-xalan.sh install
+make-xalan.sh download
+make-xalan.sh overview
+make-xalan.sh charter
+# make-xalan.sh history
+make-xalan.sh whatsnew
+make-xalan.sh extensionslib
+make-xalan.sh commandline
+make-xalan.sh readme
+make-xalan.sh releasenotes
+make-xalan.sh programming
+make-xalan.sh getstarted
+make-xalan.sh index
+make-xalan.sh extensions
+make-xalan.sh faq
+# make-xalan.sh test-faqs
+make-xalan.sh license
+
+make-xalan.sh buildlibs
+make-xalan.sh secureweb
+make-xalan.sh builddocs
+
+cp xalan-graphic/*.* ../../build/docs/xalan-c
+cp xslt-resources/*.* ../../build/docs/xalan-c/resources
+
diff --git a/xdocs/sources/make-xalan.sh b/xdocs/sources/make-xalan.sh
new file mode 100755
index 0000000..61557aa
--- /dev/null
+++ b/xdocs/sources/make-xalan.sh
@@ -0,0 +1,128 @@
+#!/bin/sh
+#
+# Bourne shell script to create a single xalan-c webpage
+# Parameter $1 is the basename of the page to generate.
+#
+#-------------------------------------------------------------
+#
+# Set the current path to include the "Xalan" stylesheet transformation utility
+#
+# $1 The document filename (without extension) to transform
+#
+# -- The Environment Variables for this script --
+#
+# ${XALANBOOKXML} The <book> navigation file for this project
+#
+# ${XALANCMD} The Xalan command-line XSLT transformation utility
+#
+# ${XALANSTYLE} The XSLT stylesheet to
+#
+# ${XALANSRCDIR} Source directory of STYLEBOOK markup XML documents
+#
+# ${XALANOUTDIR} Target directory of XHTML web page documents
+#
+# ${XALANLOGOIMG} Web Page Logo
+#
+# ${XALANLOGOWIDTH} Web Page Logo Width
+#
+# ${XALANLOGOHEIGHT} Web Page Logo Height
+#
+# ${XALANLOGOLINK} Active Link for Web Page Logo
+#
+# ${XALANTITLELINK} Active Link for Web Page Title
+#
+# ${WEBCREATED} Web Page Creation Date
+#
+# -- The XSLT Stylesheet Top-Level Parameters
+#
+# sectionid Top-level stylesheet parameter (document file id)
+#
+# createdate Top-level stylesheet parameter (web page creation date)
+#
+# logoimage Apache Trademark Logo Image
+#
+# logolink Logo Image - hot link
+#
+# bookxml The <book>.xml file for navigation
+#
+# booklink The Hot-Link for Book Title in Header
+#
+
+# Set some environment variables
+
+XALANBOOKXML=xalan.xml
+
+XALANCMD=Xalan
+
+XALANSTYLE=stylebook.xslt
+
+XALANSRCDIR=xalan
+
+XALANOUTDIR=../../build/docs/xalan-c
+
+XALANLOGOIMG=resources/XalanC-Logo-tm.png
+
+XALANLOGOWIDTH=190
+
+XALANLOGOHEIGHT=90
+
+XALANLOGOLINK=../index.html
+
+XALANTITLELINK=index.html
+
+WEBCREATED=`date +"%a %F"`
+
+## DEBUG BEGIN
+
+#echo INPUT PARAM = $1
+#echo XALANBOOKXML = ${XALANBOOKXML}
+#echo XALANCMD = ${XALANCMD}
+#echo XALANSTYLE = ${XALANSTYLE}
+#echo XALANSRCDIR = ${XALANSRCDIR}
+#echo XALANOUTDIR = ${XALANOUTDIR}
+#echo XALANLOGOIMG = ${XALANLOGOIMG}
+#echo XALANLOGOWIDTH = ${XALANLOGOWIDTH}
+#echo XALANLOGOHEIGHT = ${XALANLOGOHEIGHT}
+#echo XALANLOGOLINK = ${XALANLOGOLINK}
+#echo XALANTITLELINK = ${XALANTITLELINK}
+#echo WEBCREATED = ${WEBCREATED}
+#exit
+
+## DEBUG END
+
+
+#
+# Create Target Directories
+#
+
+if [ ! -d "${XALANOUTDIR}" ]; then
+ mkdir -p "${XALANOUTDIR}"
+fi
+
+#IF EXIST "%XALANOUTDIR%" GOTO NEXT1
+#MKDIR "%XALANOUTDIR%"
+#:NEXT1
+
+if [ ! -d "${XALANOUTDIR}/resources" ] ; then
+ mkdir -p "${XALANOUTDIR}/resources"
+fi
+
+#IF EXIST "%XALANOUTDIR%/resources" GOTO NEXT2
+#MKDIR "%XALANOUTDIR%/resources"
+#:NEXT2
+
+#
+# Now create the specific web page from StyleBook XML
+#
+
+"${XALANCMD}" \
+ -p sectionid "'$1'" \
+ -p xmlsources "'${XALANSRCDIR}'" \
+ -p createdate "'${WEBCREATED}'" \
+ -p logoimage "'${XALANLOGOIMG}'" \
+ -p logowidth "'${XALANLOGOWIDTH}'" \
+ -p logoheight "'${XALANLOGOHEIGHT}'" \
+ -p logolink "'${XALANLOGOLINK}'" \
+ -p bookxml "'${XALANBOOKXML}'" \
+ -p booklink "'${XALANTITLELINK}'" \
+ "${XALANSRCDIR}/$1.xml" "${XALANSTYLE}" >"${XALANOUTDIR}/$1.html"
