antlets/src/documentation/content/xdocs index.xml,1.1,1.2
[email protected] Fri, 12 Mar 2004 03:42:00 -0800
| Newsgroups | gmane.comp.krysalis.metamorphosis.cvs |
|---|---|
| Message-ID | <[email protected]> |
Update of /cvsroot/metamorphosis/antlets/src/documentation/content/xdocs
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv23897/src/documentation/content/xdocs
Modified Files:
index.xml
Log Message:
Added some info
Index: index.xml
===================================================================
RCS file: /cvsroot/metamorphosis/antlets/src/documentation/content/xdocs/index.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -d -r1.1 -r1.2
*** index.xml 10 Mar 2004 12:30:57 -0000 1.1
--- index.xml 12 Mar 2004 11:41:57 -0000 1.2
***************
*** 7,16 ****
<body>
<section>
<title>What is an antlet</title>
! <p>An antlet is an ant build file desgined for importing called xbuild.xml and optionally other resources. </p>
<p>Antlets are stored locally in <![CDATA[$ANT_HOME/tools/antlets/<antlet-name>.]]> If the antlet is not found
there importer looks for <![CDATA[<antlet-name>.jar ]]> in the href given. If it is found it is downloaded and
extracted to $ANT_HOME/tools/antlets/<![CDATA[<antlet-name>]]>. </p>
! <p>Antlets can contain any resources need for the build file, xml, xslt, even jars. However it is not recommended
to distribute jars inside the antlet, to keep the anlet size down and reduce jar conflicts. </p>
</section>
--- 7,20 ----
<body>
<section>
+ <title>!This file is under construction!</title>
+ <note>!This file is under construction!</note>
+ </section>
+ <section>
<title>What is an antlet</title>
! <p>An antlet is an ant build file desgined for processing a file called xbuild.xml and optionally other resources. </p>
<p>Antlets are stored locally in <![CDATA[$ANT_HOME/tools/antlets/<antlet-name>.]]> If the antlet is not found
there importer looks for <![CDATA[<antlet-name>.jar ]]> in the href given. If it is found it is downloaded and
extracted to $ANT_HOME/tools/antlets/<![CDATA[<antlet-name>]]>. </p>
! <p>Antlets can contain any necessary resources for the build file, xml, xslt, even jars. However it is not recommended
to distribute jars inside the antlet, to keep the anlet size down and reduce jar conflicts. </p>
</section>
***************
*** 19,36 ****
<title>Write your own antlet</title>
<p>Create a file called xbuild.xml just like any normal ant build.xml file. By convention all properties in the
! antlet start with <![CDATA[<antlet-name>.antlet. <dirname property="java.antlet.dir"
! file="${ant.file.java.antlet}"/>]]> is a convient way to reference resource you ship with your antlet.
<link href="ext:metamorphosis-antlets/jaxb-example">This jaxb-example</link> is a good example.</p>
! <p>When you are ready to publish your antlet simply jar it up in a file called <![CDATA[<antlet-name>.jar.]]></p>
! </section>
!
! <section>
! <title>makeantlet</title>
! <p>The makeantlet antlet can help you with this. Take a look at
<link href="ext:metamorphosis-antlets/antlet-sources">this</link> for a good example.</p>
! <p>With makeantlet a simple</p>
! <p><em>ant install-antlet</em></p>
! <p>will install the antlet for you.</p>
</section>
</body>
--- 23,50 ----
<title>Write your own antlet</title>
<p>Create a file called xbuild.xml just like any normal ant build.xml file. By convention all properties in the
! antlet start with <![CDATA[<antlet-name>-antlet: <dirname property="java-antlet:dir"
! file="${ant.file.java.antlet}"/>]]> is a convenient way to reference resources you ship with your antlet.
<link href="ext:metamorphosis-antlets/jaxb-example">This jaxb-example</link> is a good example.</p>
! <p>When you are ready to publish your antlet simply jar it up in a file called <![CDATA[<antlet-name>.jar.]]>
! The makeantlet antlet can help you with this. Take a look at
<link href="ext:metamorphosis-antlets/antlet-sources">this</link> for a good example.</p>
! <p>With makeantlet a simple <em>ant install-antlet</em> will install the antlet for you.</p>
</section>
+ <section>
+ <title>Using Antworks in your project</title>
+ <p>The build process is influenced by properties that can be set in various ways.
+ First of all the Environment variables are added to the Ant properties.
+ Furthermore the user is given several chances to set or override properties.</p>
+ <p>Please note that ANT allows a property to be set only once so the value that is given the first time cannot be changed.</p>
+ <p><em>In order of processing:</em> </p>
+ <ul>
+ <li>To override for the current project use user-properties.xml</li>
+ <li>To override for all your own builds use ${user.home}/.centipede.user-properties.xml</li>
+ <li>To override for all projects using this centipede install use ${ant.home}/user-properties.xml </li>
+ <li>To set shared properties for the current project use properties.xml</li>
+ <li>Finally properties from module.xml are added to the build environment.</li>
+ </ul>
+ A list of properties will be provided in the near future on this portal.
+ </section>
</body>
-------------------------------------------------------
This SF.Net email is sponsored by: IBM Linux Tutorials
Free Linux tutorial presented by Daniel Robbins, President and CEO of
GenToo technologies. Learn everything from fundamentals to system
administration.http://ads.osdn.com/?ad_id=1470&alloc_id=3638&op=click