axis-java-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From rang...@apache.org
Subject cvs commit: ws-axis/c/docs antbuild-guide.html
Date Tue, 11 Jan 2005 03:29:20 GMT
rangika     2005/01/10 19:29:20

  Modified:    c/docs   antbuild-guide.html
  Log:
  "AXISJAVA_LIBS" was changed  to "AXISJAVA_LIB" in the ant build documentation.
  
  Revision  Changes    Path
  1.7       +247 -563  ws-axis/c/docs/antbuild-guide.html
  
  Index: antbuild-guide.html
  ===================================================================
  RCS file: /home/cvs/ws-axis/c/docs/antbuild-guide.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- antbuild-guide.html	16 Dec 2004 10:52:21 -0000	1.6
  +++ antbuild-guide.html	11 Jan 2005 03:29:20 -0000	1.7
  @@ -1,574 +1,258 @@
  -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
   <html>
   <head>
  -<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
  -<!--*** This is a generated file.  Do not edit.  ***-->
  -<link rel="stylesheet" href="../skin/tigris.css" type="text/css">
  -<link rel="stylesheet" href="../skin/mysite.css" type="text/css">
  -<link rel="stylesheet" href="../skin/site.css" type="text/css">
  -<link media="print" rel="stylesheet" href="../skin/print.css" type="text/css">
  -<title>ANT Build Guide</title>
  +  <title>ANT Build Guide</title>
  +  <meta name="Author" content="Adrian Dick">
  +  <meta name="Keywords" content="">
  +  <meta name="Description" content="">
   </head>
  -<body bgcolor="white" class="composite">
  -<!--================= start Banner ==================-->
  -<div id="banner">
  -<table width="100%" cellpadding="8" cellspacing="0" summary="banner" border="0">
  -<tbody>
  -<tr>
  -<!--================= start Group Logo ==================-->
  -<td align="left">
  -<div class="groupLogo">
  -<a href="http://ws.apache.org/"><img border="0" class="logoImage" alt="The Apache
WebServices Project" src="../images/project-logo.jpg"></a>
  -</div>
  -</td>
  -<!--================= end Group Logo ==================-->
  -<!--================= start Project Logo ==================--><td align="right">
  -<div class="projectLogo">
  -<a href="http://ws.apache.org/axis/"><img border="0" class="logoImage" alt="The
Apache Axis Project" src="../images/axis.jpg"></a>
  -</div>
  -</td>
  -<!--================= end Project Logo ==================-->
  -<!--================= start Search ==================--><td valign="top" rowspan="2"
align="right" class="search">
  -<form target="_blank" action="http://www.google.com/search" method="get">
  -<table summary="search" border="0" cellspacing="0" cellpadding="0">
  -<tr>
  -<td bgcolor="#a5b6c6" colspan="3"><img height="10" width="1" alt="" src="../skin/images/spacer.gif"
class="spacer"></td>
  -</tr>
  -<tr>
  -<td colspan="3"><img height="8" width="1" alt="" src="../skin/images/spacer.gif"
class="spacer"></td>
  -</tr>
  -<tr>
  -<td><img height="1" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td
nowrap="nowrap"><input value="ws.apache.org" name="sitesearch" type="hidden"><input
size="10" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../skin/images/spacer.gif"
class="spacer"><input name="Search" value="GO" type="submit">
  -<br>
  -                          Search WS</td><td><img height="1" width="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
  -</tr>
  -<tr>
  -<td colspan="3"><img height="7" width="1" alt="" src="../skin/images/spacer.gif"
class="spacer"></td>
  -</tr>
  -<tr>
  -<td class="bottom-left-thick"></td><td bgcolor="#a5b6c6"><img height="1"
width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td class="bottom-right-thick"></td>
  -</tr>
  -</table>
  -</form>
  -</td>
  -<!--================= end Search ==================-->
  -</tr>
  -</tbody>
  -</table>
  -</div>
  -<!--================= end Banner ==================-->
  -<!--================= start Main ==================-->
  -<table width="100%" cellpadding="0" cellspacing="0" border="0" summary="nav" id="breadcrumbs">
  -<tbody>
  -<!--================= start Status ==================-->
  -<tr class="status">
  -<td>
  -<!--================= start BreadCrumb ==================--><a href="http://www.apache.org/">Apache</a>
| <a href="http://ws.apache.org/">WS</a><a href=""></a>
  -<!--================= end BreadCrumb ==================--></td><td id="tabs">
  -<!--================= start Tabs ==================-->
  -<div class="tab">
  -<span class="selectedTab"><a class="base-selected" href="../index.html">WebServices-Axis</a></span>
  -</div>
  -<!--================= end Tabs ==================-->
  -</td>
  -</tr>
  -</tbody>
  -</table>
  -<!--================= end Status ==================-->
  -<table id="main" width="100%" cellpadding="8" cellspacing="0" summary="" border="0">
  -<tbody>
  -<tr valign="top">
  -<!--================= start Menu ==================-->
  -<td id="leftcol">
  -<div id="navcolumn">
  -<div class="menuBar">
  -<div class="menu">
  -<span class="menuLabel">Axis</span>
  - 
  -<div class="menuItem">
  -<a href="../index.html">Introduction</a>
  -</div>
  - 
  -<div class="menuItem">
  -<a href="../news.html">News</a>
  -</div>
  -
  - 
  -<div class="menuItem">
  -<a href="http://nagoya.apache.org/wiki/apachewiki.cgi?AxisProjectPages">FAQ/Wiki</a>
  -</div>
  - 
  -<div class="menu">
  -<span class="menuLabel">Get Involved</span>
  -  
  -<div class="menuItem">
  -<a href="../overview.html">Overview</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../cvs.html">CVS Repository</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../mail.html">Mailing Lists</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../ref.html">Reference Library</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../bugs.html">Bugs</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../howtobuild.html">HowToBuildSite</a>
  -</div>
  - 
  -</div>
  - 
  -<div class="menu">
  -<span class="menuLabel">Axis (Java)</span>
  -  
  -<div class="menuItem">
  -<a href="../java/index.html">Documentation</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../java/install.html">Installation</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../java/user-guide.html">User's Guide</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../java/developers-guide.html">Developer's Guide</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../java/integration-guide.html">Integration Guide</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../java/architecture-guide.html">Architecture Guide</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../java/reference.html">Reference Guide</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../java/reading.html">Reading Guide</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../java/requirements.html">Requirements</a>
  -</div>
  - 
  -</div>
  - 
  -<div class="menu">
  -<span class="menuLabel">Axis (C++)</span>
  -  
  -<div class="menuItem">
  -<a href="../cpp/index.html">Latest Axis C++ Release!</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../cpp/documentation.html">Documentation</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../cpp/download.html">Download</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="http://nagoya.apache.org/wiki/apachewiki.cgi?AxisCPPProjectPages">Wiki Pages</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../cpp/who.html">Who we are</a>
  -</div>
  -  
  -</div>
  -
  -<div class="menu">
  -<span class="menuLabel">Downloads</span>
  -  
  -<div class="menuItem">
  -<a href="../releases.html">Releases</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../interim.html">Interim Drops</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="http://cvs.apache.org/viewcvs/ws-axis/">Source Code</a>
  -</div>
  -
  -</div>
  -
  -<div class="menu">
  -<span class="menuLabel">Translation</span>
  -  
  -<div class="menuItem">
  -<a href="http://ws.apache.org/axis/jp/">Japanese (Unofficial)</a>
  -</div>
  -
  -</div>
  -
  -<div class="menu">
  -<span class="menuLabel">Related Projects</span>
  -  
  -<div class="menuItem">
  -<a href="http://ws.apache.org/wsif/">WSIF</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="http://cvs.apache.org/viewcvs/*checkout*/ws-wsil/java/README.htm">WSIL</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="http://www-124.ibm.com/developerworks/projects/wsdl4j/">WSDL4J</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="http://www.uddi4j.org/">UDDI4J</a>
  -</div>
  -
  -</div>
  -
  -<div class="menu">
  -<span class="menuLabel">Misc</span>
  -  
  -<div class="menuItem">
  -<a href="../site.html">Whole Site</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../who.html">Who We Are</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../contact.html">Contact</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../legal.html">Legal</a>
  -</div>
  -  
  -<div class="menuItem">
  -<a href="../docs.html">Notes/Docs</a>
  -</div>
  -
  -</div>
  -
  -
  -</div>
  -</div>
  -</div>
  -</td>
  -<!--================= end Menu ==================-->
  -<!--================= start Content ==================--><td>
  -<div id="bodycol">
  -<div class="app">
  -<div align="center">
  -<h1>ANT Build Guide</h1>
  -</div>
  -<div class="h3">
  -<div class="h3">
  -<h3>Axis C++ ANT Build Guide</h3>
  -</div>
  -<br>
  -<br>
  -<ul>
  -<li>
  -<a href="#prepareSystem">Preparing system</a>
  -</li>
  -<li>
  -<a href="#thirdPartySoftware">Getting necessary third party software</a>
  -</li>
  -<li>
  -<a href="#PropertyFiles">Property Files</a>
  -</li>
  -<li>
  -<a href="#cvsExtract">Getting a CVS checkout</a>
  -</li>
  -<li>
  -<a href="#SettingTheEnvironment">Setting the Environment</a>
  -</li>
  -<li>
  -<a href="#runningTheBuild">Running the ANT build</a>
  -</li>
  -<li>
  -<a href="#EnablingTraceAndDebug">Enabling Trace and Debug</a>
  -</li>
  -<li>
  -<a href="#addingExtraPlatform">Adding an extra platform</a>
  -</li>
  -</ul>
  -<p>
  -<a name="prepareSystem"></a>
  -</p>
  -<div class="h4">
  -<h4>Preparing system</h4>
  -</div>
  -<p>To use the ANT based build you will need to install the following:</p>
  -<ul>
  -<li>Apache ANT <ul>
  -<li>Available from <a href="http://ant.apache.org">http://ant.apache.org</a>
  -</li>
  -<li>These scripts have been developed and tested using version 1.6.x</li>
  -</ul>
  -</li>
  -<li>Java SDK - required for running of ANT scripts, and the compilation of WSDL2Ws
tool <ul>
  -<li>Require version 1.4+</li>
  -</ul>
  -</li>
  -<li>Ant-Contrib - provide numerous extensions to ANT, including the compilation of
C/C++. <ul>
  -<li>Available from <a href="http://ant-contrib.sourceforge.net">http://ant-contrib.sourceforge.net</a>
  -</li>
  -<li>Place JARs into <span class="codefrag">[ANT INSTALL DIR]/lib</span>.</li>
  -<li>Require both ant-contrib and cpptasks</li>
  -</ul>
  -</li>
  -<li>Doxygen - Used for generating API documentation <ul>
  -<li>Available from <a href="http://www.doxygen.org">http://www.doxygen.org</a>
  -</li>
  -</ul>
  -</li>
  -<li>Compiler / Linker <ul>
  -<li>For Windows - Microsoft Visual C++ v6</li>
  -<li>For Linux - gcc / g++</li>
  -<li>For AIX - IBM Visual Age for C++</li>
  -</ul>
  -</li>
  -</ul>
  +<body>
  +<h1>Axis C++ ANT Build Guide</h1>
   <p>
  -<a name="thirdPartySoftware"></a>
  -</p>
  -<div class="h4">
  -<h4>Getting necessary third party software</h4>
  -</div>
  -<p>Axis Cpp Developers can use either Xerces-c or the XML4C Parsers(Xerces compiled
with ICU4C) to build the Axis Cpp. Additionally, you can opt to build Apache mod files for
Apache 1.3 or 2.0. NOTE: As of 1.4 we no do not support expat due it having too many issues
and no users at this time. If you would like to use expat then please contact the mailing
list and we can give you more information</p>
  +This document provides instructions for using and extending the ANT
  +based build for the AXIS C++ project.</p>
  +<p><a href="#prepareSystem">Preparing system</a><br>
  +<a href="#thirdPartySoftware">Getting necessary third party software</a><BR>
  +<A href="#PropertyFiles">Property Files</A><br>
  +<a href="#cvsExtract">Getting a CVS checkout</a><br>
  +<a href="#SettingTheEnvironment">Setting the Environment</a><br>
  +<a href="#runningTheBuild">Running the ANT build </a><BR>
  +<A href="#EnablingTraceAndDebug">Enabling Trace and Debug</A><br>
  +<a href="#addingExtraPlatform">Adding an extra platform </a></p>
  +<h2><a name="prepareSystem"></a>Preparing system</h2>
   <p>
  -<strong>XML4C XML Parser</strong>
  -</p>
  -<p>For more information about XML4C please go here <a href="http://www.alphaworks.ibm.com/tech/xml4c">http://www.alphaworks.ibm.com/tech/xml4c</a>.</p>
  -<p>
  -<strong>Xerces-C XML Parser</strong>
  -</p>
  -<p>You can get Xerces-C binaries from <a href="http://xerces.apache.org">http://xerces.apache.org</a>.</p>
  -<p>
  -<strong>Apache</strong>
  -</p>
  -<p>You can get Apache 1.3 or 2.0 from <a href="http://httpd.apache.org/">http://httpd.apache.org/</a>
  -</p>
  -<p>
  -<a name="PropertyFiles"></a>
  -</p>
  -<div class="h4">
  -<h4>Property Files</h4>
  -</div>
  -<p>To aid in the portability of the ANT scripts, a number of property files are used.
The script will decide which to use based on the platform in which it is currently running.
The property files are found in <span class="codefrag">ws-axis/c</span> with the
following naming convention:</p>
  -<pre class="code">build.[platform].properties</pre>
  -<p>A number of example property files are provided for Windows, Linux, AIX and Solaris,
it is intended that you update these files to suit your development and buid environment.
This includes location of third party software dependencies and target packaging structure.</p>
  -<p>These property files also allow you to make some selection on which artefacts
will be produced by the build:</p>
  +To use the ANT based build you will need to install the following:</p>
   <ul>
  -<li>Select which XML Parsers to use: <ul>
  -<li>For each one to be built, set the following to true:<br> 
  -<span class="codefrag">xmlParser.xml4c</span>
  -<br> 
  -<span class="codefrag">xmlParser.xerces</span>
  +  <li>Apache ANT
  +    <ul>
  +      <li>Available from <a href="http://ant.apache.org">http://ant.apache.org</a></li>
  +      <li>These scripts have been developed and tested using version
  +1.6.x</li>
  +    </ul>
  +  </li>
  +  <li>Java SDK - required for running of ANT scripts, and the
  +compilation of WSDL2Ws tool
  +    <ul>
  +      <li>Require version 1.4+</li>
  +    </ul>
  +  </li>
  +  <li>Ant-Contrib - provide numerous extensions to ANT, including the
  +compilation of C/C++.
  +    <ul>
  +      <li>Available from <a href="http://ant-contrib.sourceforge.net">http://ant-contrib.sourceforge.net</a></li>
  +      <li>Place JARs into <code>[ANT INSTALL DIR]/lib</code>.</li>
  +      <li>Require both ant-contrib and cpptasks</li>
  +    </ul>
  +  </li>
  +  <li>Doxygen - Used for generating API documentation
  +    <ul>
  +      <li>Available from <a href="http://www.doxygen.org">http://www.doxygen.org</a></li>
  +    </ul>
  +  </li>
  +  <li>Compiler / Linker
  +    <ul>
  +      <li>For Windows - Microsoft Visual C++ v6</li>
  +      <li>For Linux - gcc / g++</li>
  +      <li>For AIX - IBM Visual Age for C++</li>
  +    </ul>
  +  </li>
  +</ul>
  +
  +<h2><a name="thirdPartySoftware"></a>Getting necessary third party
  +software</h2>
  +<p>Axis Cpp Developers can use either Xerces-c or the Expat XML Parsers
  +to build the Axis Cpp. Additionally, you can opt to build Apache mod files for Apache 1.3
or 2.0.</p>
  +<p><b>Expat XML Parser</b></p>
  +<p>You can get expat binaries from <a
  + href="http://sourceforge.net/projects/expat/">http://sourceforge.net/projects/expat/</a>.</p>
  +<p><b>Xerces-C XML Parser</b></p>
  +<p>You can get Xerces-C binaries from <a
  + href="http://xerces.apache.org">http://xerces.apache.org</a>.</p>
  +<P><B>Apache</B></P><P>You can get Apache 1.3 or 2.0 from
<A
  +	href="http://httpd.apache.org/">http://httpd.apache.org/</A></P>
  +<H2><A name="PropertyFiles"></A>Property Files</H2>
  +<P>To aid in the portability of the ANT scripts, a number of property
  +files are used. The script will decide which to use based on the
  +platform in which it is currently running. The property files are found
  +in <CODE>ws-axis/c</CODE> with the following naming convention:</P>
  +<BLOCKQUOTE><CODE>build.<I>[platform]</I>.properties</CODE></BLOCKQUOTE>
  +<P>A number of example property files are provided for Windows, Linux,
  +AIX and Solaris, it is intended that you update these files to suit your
  +development and buid environment. This includes location of third party
  +software dependencies and target packaging structure.</P>
  +<P>These property files also allow you to make some selection on which artefacts
will be produced by the build:</P>
  +<UL>
  +	<LI>Select which XML Parsers to use:
  +	<UL>
  +		<LI>For each one to be built, set the following to true:<BR>
  +		<CODE>xmlParser.xml4c</CODE><BR>
  +		<CODE>xmlParser.xerces</CODE><BR>
  +		<CODE>xmlParser.expat</CODE></LI>
  +		</UL>
  +	</LI>
  +	<LI>Select which transport implementation to use:<UL>
  +		<LI>For each one to be built, set the following to true:<BR>
  +		<CODE>transport.axis</CODE><BR>
  +		<CODE>transport.axis2</CODE><BR>
  +		<CODE>transport.libwww</CODE></LI>
  +	</UL>
  +	</LI>
  +	<LI>Select which Apache module to produce:
  +	<UL>
  +		<LI>For each one to be built, set the following to true:<BR>
  +		<CODE>server.apache13</CODE><BR>
  +		<CODE>server.apache20</CODE></LI>
  +	</UL>
  +	</LI>
  +	<LI>Select whether to build Simple Axis Server executable:
  +	<UL>
  +		<LI>If you wish to build this, set the following to true:<BR><CODE>server.simpleAxisServer</CODE>
  +		</LI>
  +	</UL>
  +	</LI>
  +</UL>
  +
  +<P>The default selections are Xerces as XML parser, axis2 transport implementation
and both the Apache 1.3 and Apache 2.0 modules.</P>
  +<h2><A name="SettingTheEnvironment"></A>Setting the Environment</h2>
  +<P>Before running ANT the following environment variables must be
  +set:</P>
  +<UL>
  +	<LI><CODE>ANT_HOME</CODE> - location of ant installation</LI>
  +	<LI><CODE>JAVA_HOME</CODE> - location of java installation</LI>
  +	<LI><CODE>PATH</CODE> - to include <CODE>[ANT_HOME]/bin</CODE>
and <CODE>[JAVA_HOME]/bin</CODE>.
  +	<UL>
  +		<LI>Also ensure doxygen and compilers are available on the system
  +		path.</LI>
  +	</UL>
  +	</LI>
  +</UL>
  +
  +<P>The default property files make use of the following environment variables to
locate the various third party software dependencies.</P>
  +<UL>
  +	<LI><CODE>AXISJAVA_LIB</CODE> - location of Axis Java JAR files, as
required for WSDL2Ws tool</LI>
  +	<LI><CODE>EXPAT_HOME</CODE> - location of Expat installation <I>(if
  +	using Expat</I>)</LI>
  +	<LI><CODE>XERCES_HOME</CODE> - location of Xerces installation (<I>if
  +	using Xerces</I>)</LI>
  +	<LI><CODE>XML4C_HOME</CODE> - location of XML4C installation (<I>if
  +	using XML4C</I>)</LI>
  +	<LI><CODE>APACHE_HOME</CODE> - location of Apache 1.3 installation (<I>if
  +	building Apache 1.3 module</I>)</LI>
  +	<LI><CODE>APACHE2_HOME</CODE> - location of Apache 2.0 installation
(<I>if
  +	building Apache 2.0 module</I>)</LI>
  +</UL>
  +
  +<h2><a name="cvsExtract"></a>Getting a CVS checkout</h2>
  +<p>Visit <a href="windows/cpp/">http://ws.apache.org/</a> Click on
  +&#8220;axis&#8221; and then on &#8220;CVS Repository&#8221; to find details
on how to access
  +the
  +CVS Repository. <br>
  +In short summary:<br>
  +Anyone can checkout the source code from our anonymous CVS server. To
  +do so, simply use the following commands (if you are using a GUI CVS
  +client, configure it appropriately): </p>
  +<blockquote><code>cvs -d
  +:pserver:anoncvs@cvs.apache.org:/home/cvspublic
  +login<br>
  +password: anoncvs<br>
  +  <br>
  +cvs -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic checkout ws-axis</code></blockquote>
  +<p>The checkout of the repository will be created in the current
  +directory
  +in a folder named &#8220;<code>ws-axis</code>&#8221;<br>
   <br>
  -</li>
  -</ul>
  -</li>
  -<li>Select which transport implementation to use NOTE: we have removed support for
transport.axis and libwww in 1.4:<ul>
  -<li>For each one to be built, set the following to true:<br> 
  -<span class="codefrag">transport.axis2</span>
  -<br>
  -</li>
  -</ul>
  -</li>
  -<li>Select which Apache module to produce: <ul>
  -<li>For each one to be built, set the following to true:<br> 
  -<span class="codefrag">server.apache13</span>
  -<br> 
  -<span class="codefrag">server.apache20</span>
  -</li>
  -</ul>
  -</li>
  -<li>Select whether to build Simple Axis Server executable: <ul>
  -<li>If you wish to build this, set the following to true:<br>
  -<span class="codefrag">server.simpleAxisServer</span>
  -</li>
  -</ul>
  -</li>
  -</ul>
  -<p>The default selections are Xerces as XML parser, axis2 transport implementation
and both the Apache 1.3 and Apache 2.0 modules.</p>
  -<p>
  -<a name="SettingTheEnvironment"></a>
  -</p>
  -<div class="h4">
  -<h4>Setting the Environment</h4>
  -</div>
  -<p>Before running ANT the following environment variables must be set:</p>
  -<ul>
  -<li>
  -<span class="codefrag">ANT_HOME</span> - location of ant installation</li>
  -<li>
  -<span class="codefrag">JAVA_HOME</span> - location of java installation</li>
  -<li>
  -<span class="codefrag">PATH</span> - to include <span class="codefrag">[ANT_HOME]/bin</span>
and <span class="codefrag">[JAVA_HOME]/bin</span>. <ul>
  -<li>Also ensure doxygen and compilers are available on the system path.</li>
  -</ul>
  -</li>
  -</ul>
  -<p>The default property files make use of the following environment variables to
locate the various third party software dependencies.</p>
  -<ul>
  -<li>
  -<span class="codefrag">AXISJAVA_LIBS</span> - location of Axis Java JAR files,
as required for WSDL2Ws tool</li>
  -<li>
  -<span class="codefrag">XERCES_HOME</span> - location of Xerces installation
(<em>if using Xerces</em>)</li>
  -<li>
  -<span class="codefrag">XML4C_HOME</span> - location of XML4C installation (<em>if
using XML4C</em>)</li>
  -<li>
  -<span class="codefrag">APACHE_HOME</span> - location of Apache 1.3 installation
(<em>if building Apache 1.3 module</em>)</li>
  -<li>
  -<span class="codefrag">APACHE2_HOME</span> - location of Apache 2.0 installation
(<em>if building Apache 2.0 module</em>)</li>
  -</ul>
  -<p>
  -<a name="cvsExtract"></a>
  -</p>
  -<div class="h4">
  -<h4>Getting a CVS checkout</h4>
  -</div>
  -<p>Visit <a href="windows/cpp/">http://ws.apache.org/</a> Click on &ldquo;axis&rdquo;
and then on &ldquo;CVS Repository&rdquo; to find details on how to access the CVS
Repository.<br>In short summary:<br>Anyone can checkout the source code from our
anonymous CVS server. To do so, simply use the following commands (if you are using a GUI
CVS client, configure it appropriately):</p>
  -<pre class="code">cvs -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic loginpassword:
anoncvs cvs -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic checkout ws-axis</pre>
  -<p>The checkout of the repository will be created in the current directory in a folder
named &ldquo;<span class="codefrag">ws-axis</span>&rdquo;<br>
  -<br>The checked out folder ws-axis/c will be referred to as <span class="codefrag">[CHECKOUT_HOME]</span>
from this point on.</p>
  -<p>
  -<a name="runningTheBuild"></a>
  -</p>
  -<div class="h4">
  -<h4>Running the ANT build</h4>
  -</div>
  -<p>Once you have configured your environment and property files the build is a simple
two step process. The first step is to build all the generated artefacts. At the comment prompt
change to <span class="codefrag">[CHECKOUT_HOME]</span> and run:</p>
  -<pre class="code">ant</pre>
  -<p>This will carry out the following:</p>
  -<ul>
  -<li>Build Axis C Client library</li>
  -<li>Build Axis C Transport library <ul>
  -<li>Axis, axis2, libwww configurable through the property files</li>
  -</ul>
  -</li>
  -<li>Build Axis C XML Parser library <ul>
  -<li>Expat, Xerces-C, etc configurable through the property files</li>
  -</ul>
  -</li>
  -<li>Build Axis C Server library</li>
  -<li>Build Axis C Apache module<ul>
  -<li>Apache 1.3 or Apache 2.0 configurable through the property files</li>
  -</ul>
  -</li>
  -<li>Build Axis C Simple Server Executable<ul>
  -<li>Configurable through the property files</li>
  -</ul>
  -</li>
  -<li>Build and package WSDL2Ws tool</li>
  -<li>Generate API Documentation</li>
  -<li>Package artefacts into a distributable structure <ul>
  -<li>This structure is configurable through the property files</li>
  -</ul>
  -</li>
  -<li>Validate all artefacts have been correctly generated</li>
  -</ul>
  -<p>The second step is to package the generated artefacts. From <span class="codefrag">[CHECKOUT_HOME]</span>
run:</p>
  -<pre class="code">ant -f package.xml</pre>
  -<p>This will carry out the following:</p>
  -<ul>
  -<li>Package artefacts in to a binary release distributable</li>
  -<li>Package artefacts in to a source release distributable</li>
  -</ul>
  -<p>To remove artefacts from a previous build use the following command:</p>
  -<pre class="code">ant clean</pre>
  -<p>
  -<a name="EnablingTraceAndDebug"></a>
  -</p>
  -<div class="h4">
  -<h4>Enabling Trace and Debug</h4>
  -</div>
  -<p>By default, the ANT build scripts do not produce libraries with trace or debug
symbols. To include these use of one of the following to build:</p>
  -<pre class="code">ant buildWithTrace</pre>
  -<pre class="code">ant buildWithDebug</pre>
  -<pre class="code">ant buildWithTraceAndDebug</pre>
  -<p>The packaging step remains the same. Although it the source release package will
automatically select the trace instrumented source code.</p>
  -<p>When trace is selected, the ant build adds in trace entry and exit statements
into many of the methods in Axis C++. Then at runtime, in axiscpp.conf, set ClientLogPath
to a file in a directory somewhere and Axis C++ will write out trace to that file. Omitting
ClientLogPath from axiscpp.conf switches trace off.</p>
  -<p>
  -<a name="addingExtraPlatform"></a>
  -</p>
  -<div class="h4">
  -<h4>Adding an extra platform</h4>
  -</div>
  -<p>The AXIS community would greatly appreciate your input, if you're working on a
platform not currently supported by the ANT scripts.<br>Below, are the steps required
to add an additional platform;</p>
  +The checked out folder ws-axis/c will be referred to as <code>[CHECKOUT_HOME]</code>
  +from this point on.</p>
  +
  +<h2><a name="runningTheBuild"></a>Running the ANT build</h2>
  +
  +<P>Once you have configured your environment and property files the build is a simple
two step process. The first step is to build all the generated artefacts. At the comment prompt
change to <CODE>[CHECKOUT_HOME]</CODE> and run:</P>
  +
  +<blockquote><code>ant</code></blockquote>
  +<p>This will carry out the following:</p><ul>
  +  <li>Build Axis C Client library</li>
  +  <li>Build Axis C Transport library
  +	<UL>
  +		<LI>Axis, axis2, libwww configurable through the property files</LI>
  +	</UL>
  +	</li>
  +  <li>Build Axis C XML Parser library
  +    <ul>
  +      <li>Expat, Xerces-C, etc configurable through the property files</li>
  +    </ul>
  +  </li>
  +  <li>Build Axis C Server library</li>
  +	<LI>Build Axis C Apache module<UL>
  +		<LI>Apache 1.3 or Apache 2.0 configurable through the property files</LI>
  +	</UL>
  +	</LI>
  +	<LI>Build Axis C Simple Server Executable<UL>
  +		<LI>Configurable through the property files</LI>
  +	</UL>
  +	</LI>
  +	<LI>Build and package WSDL2Ws tool</LI>
  +	<li>Generate API Documentation</li>
  +	<li>Package artefacts into a distributable structure
  +    <ul>
  +      <li>This structure is configurable through the property files</li>
  +    </ul>
  +  </li>
  +  <li>Validate all artefacts have been correctly generated</li>
  +</ul>
  +<P>The second step is to package the generated artefacts. From <CODE>[CHECKOUT_HOME]</CODE>
run:</P>
  +<blockquote><CODE>ant -f package.xml</CODE></blockquote>
  +<P>This will carry out the following:</P>
  +<UL>
  +	<LI>Package artefacts in to a binary release distributable</LI>
  +	<LI>Package artefacts in to a source release distributable</LI>
  +</UL>
  +<p>To remove artefacts from a previous build use the following command:
  +</p>
  +<BLOCKQUOTE><CODE>ant clean</CODE></BLOCKQUOTE>
  +<h2><A name="EnablingTraceAndDebug"></A>Enabling Trace and Debug</h2>
  +<p>By default, the ANT build scripts do not produce libraries with trace or debug
symbols. To include these make use of one of the following to build:</p>
  +<BLOCKQUOTE><CODE>ant buildWithTrace</CODE></BLOCKQUOTE>
  +<BLOCKQUOTE><CODE>ant buildWithDebug</CODE></BLOCKQUOTE>
  +<BLOCKQUOTE><CODE>ant buildWithTraceAndDebug</CODE></BLOCKQUOTE>
  +<P>The packaging step remains the same. Although it the source release package will
automatically select the trace instrumented source code.</P>
  +<P>When trace is selected, the ant build adds in trace entry and exit
  +statements into many of the methods in Axis C++. Then at runtime, in
  +axiscpp.conf, set ClientLogPath to a file in a directory somewhere and
  +Axis C++ will write out trace to that file. Omitting ClientLogPath from
  +axiscpp.conf switches trace off.</P>
  +<h2><a name="addingExtraPlatform"></a>Adding an extra platform</h2>
  +<p>The AXIS community would greatly appreciate your input, if you're
  +working on a platform not currently supported by the ANT scripts.<br>
  +Below, are the steps required to add an additional platform;</p>
   <ol>
  -<li>Add platform detection to <span class="codefrag">pre-init</span>
target in <span class="codefrag">buildIntialize.xml</span>, eg: <pre>&lt;condition
property="linux"&gt;<br>  &lt;os name="Linux"/&gt;<br>&lt;/condition&gt;</pre>
  -</li>
  -<li>Update platform property within <span class="codefrag">initialize</span>
target in <span class="codefrag">buildIntialize.xml</span>, eg: <pre>&lt;condition
property="platform" value="Linux"&gt;<br>  &lt;isset property="linux"/&gt;<br>&lt;/condition&gt;</pre>
  -</li>
  -<li>Provide an additional property file in <span class="codefrag">ws-axis/c</span>
to match your platform. This uses the naming convention <span class="codefrag">build.[platform].properties</span>,
where platform is as specified in step 2.</li>
  -<li>Provide <span class="codefrag">compiler</span> definition for platform
in <span class="codefrag">buildIntialize.xml</span>, include a condition check
for the correct platform and any debug flags should be conditional on the debug property being
set, eg: <pre>&lt;compiler id="Linuxgcc" name="g++" if="linux"&gt;<br>
 &lt;compilerarg value="-g" if="debug"/&gt;
  -  &lt;compilerarg value="-Wall"/&gt;<br>  &lt;compilerarg value="-Wshadow"/&gt;<br>
 &lt;compilerarg value="-O2"/&gt;<br>  &lt;defineset&gt;<br> 
  &lt;define name="ENABLE_AXIS_EXCEPTION"/&gt;<br>    &lt;define name="HAVE_CONFIG_H"/&gt;<br>
   &lt;define name="PIC"/&gt;<br>  &lt;/defineset&gt;<br>  &lt;includepath
path="${dir.include}"/&gt;<br>&lt;/compiler&gt;</pre>Note: Compilers
may extend one another, which can be useful if an additional platform uses the same compiler,
but maybe only small variations in the parameters.</li>
  -<li>Provide <span class="codefrag">linker</span> definition for platform
in <span class="codefrag">buildIntialize.xml</span>, include a condition check
for the correct platform and any debug flags should be conditional on the debug property being
set, eg: <pre>&lt;linker id="LinuxLinker" name="g++" libtool="true" if="linux"&gt;<br>
 &lt;linkerarg value="-g" if="debug"/&gt;<br>  &lt;libset libs="stdc++"/&gt;<br>&lt;/linker&gt;</pre>Note:
As for compilers, linkers may extend one another.</li>
  -<li>Add new <span class="codefrag">compiler</span> and <span class="codefrag">linker</span>
to the <span class="codefrag">cc</span> task within each of <span class="codefrag">compileAxisClient</span>,
<span class="codefrag">compileAxisTransport</span>, <span class="codefrag">compileAxisXMLParser</span>,
<span class="codefrag">compileSimpleAxisServer</span>, <span class="codefrag">compileAxisServerEngine</span>,
<span class="codefrag">compileApache13Module</span> and <span class="codefrag">compileApache20Module</span>
targets, eg: <pre>&lt;cc outfile="${dir.bin}/${transportLibraryName}" objdir="${dir.objects}"<br>
exceptions="true" failonerror="false" outtype="shared" multithreaded="true"&gt;<br>
 &lt;!-- Compilers --&gt;<br>  &lt;compiler refid="Linuxgcc"/&gt;<br>
 &lt;compiler refid="AIXxlc"/&gt;
  -  ...<br>  &lt;!-- Linkers --&gt;<br>  &lt;linker refid="LinuxLinker"/&gt;<br>
 &lt;linker refid="AIXLinker"/&gt;<br>  ...<br>&lt;/cc&gt;</pre>
  -</li>
  +  <li>Add platform detection to <code>pre-init</code> target in <CODE>buildIntialize.xml</CODE>,
eg:
  +    <pre>&lt;condition property="linux"&gt;<br>  &lt;os name="Linux"/&gt;<br>&lt;/condition&gt;</pre>
  +  </li>
  +  <li>Update platform property within <code>initialize</code> target
in <CODE>buildIntialize.xml</CODE>,
  +eg:
  +    <pre>&lt;condition property="platform" value="Linux"&gt;<br>  &lt;isset
property="linux"/&gt;<br>&lt;/condition&gt;</pre>
  +  </li>
  +  <li>Provide an additional property file in <code>ws-axis/c</code> to
  +match your platform. This uses the naming convention <code>build.[<i>platform</i>].properties</code>,
  +where platform is as specified in step 2.</li>
  +  <li>Provide <code>compiler</code> definition for platform in <CODE>buildIntialize.xml</CODE>,
include a
  +condition check for the correct platform and any debug flags should be conditional on the
debug property being set, eg:
  +    <pre>&lt;compiler id="Linuxgcc" name="g++" if="linux"&gt;<br> 
&lt;compilerarg value="-g" if=&quot;debug&quot;/&gt;
  +  &lt;compilerarg value="-Wall"/&gt;<br>  &lt;compilerarg value="-Wshadow"/&gt;<br>
 &lt;compilerarg value="-O2"/&gt;<br>  &lt;defineset&gt;<br> 
  &lt;define name="ENABLE_AXIS_EXCEPTION"/&gt;<br>    &lt;define name="HAVE_CONFIG_H"/&gt;<br>
   &lt;define name="PIC"/&gt;<br>  &lt;/defineset&gt;<br>  &lt;includepath
path="${dir.include}"/&gt;<br>&lt;/compiler&gt;</pre>
  +Note: Compilers may extend one another, which can be useful if an
  +additional platform uses the same compiler, but maybe only small
  +variations in the parameters.</li>
  +  <li>Provide <code>linker</code> definition for platform in <CODE>buildIntialize.xml</CODE>,
include a
  +condition check for the correct platform and any debug flags should be conditional on the
debug property being set, eg:
  +    <pre>&lt;linker id="LinuxLinker" name="g++" libtool="true" if="linux"&gt;<br>
 &lt;linkerarg value="-g" if=&quot;debug&quot;/&gt;<br>  &lt;libset
libs="stdc++"/&gt;<br>&lt;/linker&gt;</pre>
  +Note: As for compilers, linkers may extend one another.</li>
  +  <li>Add new <code>compiler</code> and <code>linker</code>
to the <code>cc</code>
  +task within each of <code>compileAxisClient</code>, <code>compileAxisTransport</code>,
<code>compileAxisXMLParser</code>, <code>compileSimpleAxisServer</code>,
<code>compileAxisServerEngine</code>, <code>compileApache13Module</code>
and <code>compileApache20Module</code> targets, eg:
  +    <pre>&lt;cc outfile="${dir.bin}/${transportLibraryName}" objdir="${dir.objects}"<br>
exceptions="true" failonerror="false" outtype="shared" multithreaded="true"&gt;<br>
 &lt;!-- Compilers --&gt;<br><FONT
  +		color="green">  &lt;compiler refid="Linuxgcc"/&gt;</FONT><br>
 &lt;compiler refid="AIXxlc"/&gt;
  +  ...<br>  &lt;!-- Linkers --&gt;<br>  <FONT
  +		color="green">&lt;linker refid="LinuxLinker"/&gt;</FONT><br> 
&lt;linker refid="AIXLinker"/&gt;<br>  ...<br>&lt;/cc&gt;</pre>
  +  </li>
   </ol>
  -<div id="pdf" align="right">
  -<a href="antbuild-guide.pdf"><img alt="PDF" src="../skin/images/pdfdoc.gif" class="skin"><br>
  -          PDF</a>
  -</div>
  -</div>
  -</div>
  -</div>
  -</td>
  -<!--================= end Content ==================-->
  -</tr>
  -</tbody>
  -</table>
  -<!--================= end Main ==================-->
  -<!--================= start Footer ==================-->
  -<div id="footer">
  -<table summary="footer" cellspacing="0" cellpadding="4" width="100%" border="0">
  -<tbody>
  -<tr>
  -<!--================= start Copyright ==================-->
  -<td colspan="2">
  -<div align="center">
  -<div class="copyright">
  -              Copyright &copy; 2000-2004&nbsp;The Apache Software Foundation. All
rights reserved.
  -            </div>
  -</div>
  -</td>
  -<!--================= end Copyright ==================-->
  -</tr>
  -<tr>
  -<td align="left">
  -<!--================= start Host ==================-->
  -<!--================= end Host ==================--></td><td align="right">
  -<!--================= start Credits ==================-->
  -<div align="right">
  -<div class="credit"></div>
  -</div>
  -<!--================= end Credits ==================-->
  -</td>
  -</tr>
  -</tbody>
  -</table>
  -</div>
  -<!--================= end Footer ==================-->
   </body>
   </html>
  
  
  

Mime
View raw message