Author: steveh
Date: Tue Mar 15 14:15:54 2005
New Revision: 157595
URL: http://svn.apache.org/viewcvs?view=rev&rev=157595
Log:
Adding rudimentary build targets and XSLT sheets for eventual annotation doclet.
(Currently, none of the main build processes depend on these doclet
targets--these targets are entirely manual.)
Added:
incubator/beehive/trunk/docs/tools/xslt/anno_ref.xslt
Modified:
incubator/beehive/trunk/docs/build.xml
incubator/beehive/trunk/docs/updating_livesite.txt
Modified: incubator/beehive/trunk/docs/build.xml
URL:
http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/build.xml?view=diff&r1=157594&r2=157595
==============================================================================
--- incubator/beehive/trunk/docs/build.xml (original)
+++ incubator/beehive/trunk/docs/build.xml Tue Mar 15 14:15:54 2005
@@ -16,6 +16,102 @@
<delete dir="forrest/build"/>
</target>
+ <target name="generate-anno-ref">
+ <antcall target="generate-anno-xml"/>
+ <antcall target="transform-to-forrestxml"/>
+ </target>
+
+ <!--
+ Before runnng this target you must
+ (1) install DocBook Doclet (ver. 0.63.0) on your machine (download:
http://www.dbdoclet.org/index.html)
+ (2) set these properties below: dbdoclet.home and controls.src.api
+ -->
+ <target name="generate-anno-xml" description="Generates DocBook XML
from the annotation handler classes.">
+ <property name="dbdoclet.home" value="C:/Program Files/DocBook
Doclet"/>
+ <property name="controls.src.api"
value="C:/dev-apache/beehive/trunk/controls/src/api/org/apache/beehive/controls/api"/>
+ <property name="docbook.xml.dest.dir"
value="build/temp/anno_ref/docbook"/>
+ <!-- Running with ControlInterface.java included causes DocBook
XML validation errors. -->
+ <javadoc
+ destdir="${docbook.xml.dest.dir}/controls/"
+
sourcefiles="${controls.src.api}/bean/AnnotationConstraints.java,
+
${controls.src.api}/bean/AnnotationMemberTypes.java,
+
${controls.src.api}/bean/Control.java,
+
${controls.src.api}/bean/ControlExtension.java,
+
${controls.src.api}/bean/ControlImplementation.java,
+
${controls.src.api}/bean/ControlReferences.java,
+
${controls.src.api}/bean/ExternalPropertySets.java,
+
${controls.src.api}/bean/Threading.java,
+
${controls.src.api}/context/Context.java,
+
${controls.src.api}/context/ControlBeanContext.java,
+
${controls.src.api}/events/Client.java,
+
${controls.src.api}/events/EventHandler.java,
+
${controls.src.api}/events/EventSet.java,
+
${controls.src.api}/packaging/BeanInfo.java,
+
${controls.src.api}/packaging/EventSetInfo.java,
+
${controls.src.api}/packaging/FeatureAttribute.java,
+
${controls.src.api}/packaging/FeatureInfo.java,
+
${controls.src.api}/packaging/ManifestAttribute.java,
+
${controls.src.api}/packaging/PropertyInfo.java,
+
${controls.src.api}/packaging/PropertyInfo.java,
+
${controls.src.api}/properties/AnnotatedElementMap.java,
+
${controls.src.api}/properties/BaseMap.java,
+
${controls.src.api}/properties/BaseProperties.java,
+
${controls.src.api}/properties/BeanPropertyMap.java,
+
${controls.src.api}/properties/PropertyKey.java,
+
${controls.src.api}/properties/PropertyMap.java,
+
${controls.src.api}/properties/PropertySet.java,
+
${controls.src.api}/properties/PropertySetProxy.java,
+
${controls.src.api}/versioning/Version.java,
+
${controls.src.api}/versioning/VersionRequired.java,
+
${controls.src.api}/versioning/VersionSupported.java"
+ docencoding="UTF-8" encoding="ISO-8859-15" failonerror="yes"
maxmemory="512m" source="1.5">
+ <classpath refid="controls.dependency.path"/>
+ <doclet name="org.dbdoclet.doclet.docbook.DocBookDoclet"
path="${dbdoclet.home}/jars/dbdoclet.jar"/>
+ </javadoc>
+
+ <javadoc
+ destdir="${docbook.xml.dest.dir}/pageflow"
+ docencoding="UTF-8" encoding="ISO-8859-15" failonerror="yes"
maxmemory="512m"
+
sourcefiles="../netui/src/pageflow/org/apache/beehive/netui/pageflow/annotations/Jpf.java">
+ <!--<classpath refid="javadoc.classpath"/>-->
+ <doclet name="org.dbdoclet.doclet.docbook.DocBookDoclet"
path="${dbdoclet.home}/jars/dbdoclet.jar"/>
+ </javadoc>
+
+ <javadoc
+ destdir="${docbook.xml.dest.dir}/wsm"
+ docencoding="UTF-8" encoding="ISO-8859-15" failonerror="yes"
maxmemory="512m"
+ sourcefiles="../wsm/src/api/javax/jws/HandlerChain.java,
+ ../wsm/src/api/javax/jws/Oneway.java,
+ ../wsm/src/api/javax/jws/WebMethod.java,
+ ../wsm/src/api/javax/jws/WebParam.java,
+ ../wsm/src/api/javax/jws/WebResult.java,
+ ../wsm/src/api/javax/jws/WebService.java,
+
../wsm/src/api/javax/jws/security/SecurityIdentity.java,
+
../wsm/src/api/javax/jws/security/SecurityRoles.java,
+ ../wsm/src/api/javax/jws/soap/InitParam.java,
+ ../wsm/src/api/javax/jws/soap/SOAPBinding.java,
+
../wsm/src/api/javax/jws/soap/SOAPMessageHandler.java,
+
../wsm/src/api/javax/jws/soap/SOAPMessageHandlers.java">
+ <!--<classpath refid="javadoc.classpath"/>-->
+ <doclet name="org.dbdoclet.doclet.docbook.DocBookDoclet"
path="${dbdoclet.home}/jars/dbdoclet.jar"/>
+ </javadoc>
+ </target>
+
+ <target name="transform-to-forrestxml" description="Transforms DocBook
XML into Forrest XML.">
+ <xslt
+ in="build/temp/anno_ref/docbook/controls/Reference.xml"
+ out="build/temp/anno_ref/forrest/control_annotations.xml"
+ style="tools/xslt/anno_ref.xslt"/>
+ <xslt
+ in="build/temp/anno_ref/docbook/pageflow/Reference.xml"
+ out="build/temp/anno_ref/forrest/pageflow_annotations.xml"
+ style="tools/xslt/anno_ref.xslt"/>
+ <xslt
+ in="build/temp/anno_ref/docbook/wsm/Reference.xml"
+ out="build/temp/anno_ref/forrest/wsm_annotations.xml"
+ style="tools/xslt/anno_ref.xslt"/>
+ </target>
+
<target name="gen.config.ref.html">
<xslt in="../netui/src/util/schema/netui-config.xsd"
out="build/temp/mytest.html"
Added: incubator/beehive/trunk/docs/tools/xslt/anno_ref.xslt
URL:
http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/tools/xslt/anno_ref.xslt?view=auto&rev=157595
==============================================================================
--- incubator/beehive/trunk/docs/tools/xslt/anno_ref.xslt (added)
+++ incubator/beehive/trunk/docs/tools/xslt/anno_ref.xslt Tue Mar 15 14:15:54
2005
@@ -0,0 +1,52 @@
+<?xml version="1.0" encoding="UTF-8"?>
+ <!DOCTYPE xsl:stylesheet [
+ <!ENTITY nbsp " "> <!-- white space in XSL -->
+ ]>
+<xsl:stylesheet version="1.0"
+ xmlns:xsl="http://www.w3.org/1999/XSL/Transform";
+ xmlns:ref="http://www.w3.org/2001/XMLSchema";
+ exclude-result-prefixes="ref">
+ <!--<xsl:preserve-space elements="*"/>-->
+ <xsl:output doctype-public="-//APACHE//DTD Documentation V2.0//EN"
doctype-system="http://forrest.apache.org/dtd/document-v20.dtd"/>
+
+ <xsl:template match="/">
+
+ <document>
+ <header>
+ <title>Reference Documentation: <xsl:value-of
select="[EMAIL PROTECTED]"/></title>
+ </header>
+ <body>
+ <!-- ############### Description Section
################-->
+ <xsl:for-each select="//sect1//indexterm/secondary">
+ <section>
+ <title></title>
+ <p><xsl:value-of select="."/></p>
+ </section>
+ </xsl:for-each>
+ <!-- ############### Elements Section
################-->
+ <section>
+ <title>Elements</title>
+ <xsl:for-each
select="//ref:indexterm/ref:primary">
+ <section>
+ <title><<xsl:value-of
select="."/>></title>
+ <p><xsl:value-of select="."/>
</p>
+ </section>
+ </xsl:for-each>
+ </section>
+ <!-- ############### Example Section ################-->
+ <xsl:for-each select="//ref:annotation">
+ <xsl:if test="@id = 'example'">
+ <section>
+ <title>Example</title>
+ <p><xsl:value-of
select="ref:documentation"/></p>
+ </section>
+ </xsl:if>
+ </xsl:for-each>
+ </body>
+ </document>
+
+
+ </xsl:template>
+
+
+</xsl:stylesheet>
Modified: incubator/beehive/trunk/docs/updating_livesite.txt
URL:
http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/updating_livesite.txt?view=diff&r1=157594&r2=157595
==============================================================================
--- incubator/beehive/trunk/docs/updating_livesite.txt (original)
+++ incubator/beehive/trunk/docs/updating_livesite.txt Tue Mar 15 14:15:54 2005
@@ -108,10 +108,10 @@
For example, to recursively remove the all contents of the directory 'foo',
use the
following command:
- rm -r foo.
+ rm -r foo
To ignore write-protection in the directory, use:
- rm -r -f foo.
+ rm -r -f foo
Obviously: be careful when deleting content from the site!
