portals-pluto-scm mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From e..@apache.org
Subject svn commit: r642585 [1/4] - in /portals/pluto/trunk: ./ maven-pluto-plugin/ maven-pluto-plugin/src/site/ maven-pluto-plugin/src/site/apt/ pluto-ant-tasks/src/site/ pluto-ant-tasks/src/site/apt/ pluto-container/ pluto-container/src/site/ pluto-container...
Date Sat, 29 Mar 2008 19:05:26 GMT
Author: esm
Date: Sat Mar 29 12:05:20 2008
New Revision: 642585

URL: http://svn.apache.org/viewvc?rev=642585&view=rev
Log:
Updated the website structure.  Updated to use site plugin version beta-7-SNAPSHOT.

Added:
    portals/pluto/trunk/maven-pluto-plugin/src/site/apt/
    portals/pluto/trunk/maven-pluto-plugin/src/site/apt/index.apt
    portals/pluto/trunk/pluto-ant-tasks/src/site/apt/index.apt
      - copied unchanged from r642508, portals/pluto/trunk/pluto-ant-tasks/src/site/apt/getting-started.apt
    portals/pluto/trunk/pluto-container/src/site/xdoc/index.xml
      - copied unchanged from r642508, portals/pluto/trunk/pluto-container/src/site/xdoc/getting-started.xml
    portals/pluto/trunk/pluto-descriptor-api/src/site/apt/
    portals/pluto/trunk/pluto-descriptor-api/src/site/apt/index.apt
    portals/pluto/trunk/pluto-descriptor-impl/src/site/
    portals/pluto/trunk/pluto-descriptor-impl/src/site/apt/
    portals/pluto/trunk/pluto-descriptor-impl/src/site/apt/index.apt
    portals/pluto/trunk/pluto-descriptor-impl/src/site/site.xml   (with props)
    portals/pluto/trunk/pluto-portal-driver-impl/src/site/
    portals/pluto/trunk/pluto-portal-driver-impl/src/site/apt/
    portals/pluto/trunk/pluto-portal-driver-impl/src/site/apt/index.apt
    portals/pluto/trunk/pluto-portal-driver-impl/src/site/site.xml   (with props)
    portals/pluto/trunk/pluto-portal-driver/src/site/apt/
    portals/pluto/trunk/pluto-portal-driver/src/site/apt/index.apt
    portals/pluto/trunk/pluto-portal-driver/src/site/site.xml   (with props)
    portals/pluto/trunk/pluto-portal/src/site/apt/index.apt
    portals/pluto/trunk/pluto-site-skin/src/main/resources/images/apache-portals.gif   (with props)
    portals/pluto/trunk/pluto-site-skin/src/main/resources/images/architecture.png   (with props)
    portals/pluto/trunk/pluto-site-skin/src/main/resources/images/banner.png   (with props)
    portals/pluto/trunk/pluto-site-skin/src/main/resources/images/download.gif   (with props)
    portals/pluto/trunk/pluto-site-skin/src/site/
    portals/pluto/trunk/pluto-site-skin/src/site/apt/
    portals/pluto/trunk/pluto-site-skin/src/site/apt/index.apt
    portals/pluto/trunk/pluto-site-skin/src/site/site.xml   (with props)
    portals/pluto/trunk/pluto-taglib/src/site/apt/
    portals/pluto/trunk/pluto-taglib/src/site/apt/index.apt
    portals/pluto/trunk/pluto-testsuite/src/site/
    portals/pluto/trunk/pluto-testsuite/src/site/apt/
    portals/pluto/trunk/pluto-testsuite/src/site/apt/index.apt
    portals/pluto/trunk/pluto-testsuite/src/site/site.xml   (with props)
    portals/pluto/trunk/pluto-util/src/site/
    portals/pluto/trunk/pluto-util/src/site/apt/
    portals/pluto/trunk/pluto-util/src/site/apt/index.apt
    portals/pluto/trunk/pluto-util/src/site/site.xml   (with props)
    portals/pluto/trunk/portlet2-api/src/site/
    portals/pluto/trunk/portlet2-api/src/site/apt/
    portals/pluto/trunk/portlet2-api/src/site/apt/index.apt
    portals/pluto/trunk/portlet2-api/src/site/site.xml   (with props)
    portals/pluto/trunk/src/
    portals/pluto/trunk/src/site/
    portals/pluto/trunk/src/site/fml/
    portals/pluto/trunk/src/site/fml/faq.fml
    portals/pluto/trunk/src/site/fml/helping.fml
    portals/pluto/trunk/src/site/resources/
    portals/pluto/trunk/src/site/resources/css/
    portals/pluto/trunk/src/site/resources/css/site.css   (with props)
    portals/pluto/trunk/src/site/resources/xsd/
    portals/pluto/trunk/src/site/resources/xsd/pluto-portal-driver-config.xsd   (with props)
    portals/pluto/trunk/src/site/site.xml   (with props)
    portals/pluto/trunk/src/site/xdoc/
    portals/pluto/trunk/src/site/xdoc/download.xml   (with props)
    portals/pluto/trunk/src/site/xdoc/index.xml   (with props)
    portals/pluto/trunk/src/site/xdoc/mission.xml   (with props)
    portals/pluto/trunk/src/site/xdoc/news.xml   (with props)
    portals/pluto/trunk/src/site/xdoc/powered.xml   (with props)
    portals/pluto/trunk/src/site/xdoc/v101/
    portals/pluto/trunk/src/site/xdoc/v101/developer/
    portals/pluto/trunk/src/site/xdoc/v101/developer/arch.xml   (with props)
    portals/pluto/trunk/src/site/xdoc/v101/developer/build_source.xml   (with props)
    portals/pluto/trunk/src/site/xdoc/v101/developer/index.xml   (with props)
    portals/pluto/trunk/src/site/xdoc/v101/developer/integrate.xml   (with props)
    portals/pluto/trunk/src/site/xdoc/v101/developer/subversion.xml   (with props)
    portals/pluto/trunk/src/site/xdoc/v101/install.xml   (with props)
    portals/pluto/trunk/src/site/xdoc/v101/resources.xml   (with props)
    portals/pluto/trunk/src/site/xdoc/v101/userguide/
    portals/pluto/trunk/src/site/xdoc/v101/userguide/index.xml   (with props)
    portals/pluto/trunk/src/site/xdoc/v101/userguide/portal.xml   (with props)
    portals/pluto/trunk/src/site/xdoc/v101/userguide/testsuite.xml   (with props)
    portals/pluto/trunk/src/site/xdoc/v11/
    portals/pluto/trunk/src/site/xdoc/v11/app-servers.xml   (with props)
    portals/pluto/trunk/src/site/xdoc/v11/architecture.xml   (with props)
    portals/pluto/trunk/src/site/xdoc/v11/deploying.xml   (with props)
    portals/pluto/trunk/src/site/xdoc/v11/getting-started.xml   (with props)
    portals/pluto/trunk/src/site/xdoc/v11/release-notes.xml   (with props)
    portals/pluto/trunk/src/site/xdoc/v11/resources.xml   (with props)
    portals/pluto/trunk/src/site/xdoc/v11/subprojects.xml   (with props)
Removed:
    portals/pluto/trunk/pluto-ant-tasks/src/site/apt/getting-started.apt
    portals/pluto/trunk/pluto-container/src/site/xdoc/getting-started.xml
    portals/pluto/trunk/pluto-portal-driver/site
    portals/pluto/trunk/pluto-portal/src/site/apt/getting-started.apt
Modified:
    portals/pluto/trunk/maven-pluto-plugin/pom.xml
    portals/pluto/trunk/maven-pluto-plugin/src/site/site.xml
    portals/pluto/trunk/pluto-ant-tasks/src/site/site.xml
    portals/pluto/trunk/pluto-container/pom.xml
    portals/pluto/trunk/pluto-container/src/site/site.xml
    portals/pluto/trunk/pluto-descriptor-api/pom.xml
    portals/pluto/trunk/pluto-descriptor-api/src/site/site.xml
    portals/pluto/trunk/pluto-portal-driver-impl/pom.xml
    portals/pluto/trunk/pluto-portal-driver/pom.xml
    portals/pluto/trunk/pluto-portal/pom.xml
    portals/pluto/trunk/pluto-portal/src/site/site.xml
    portals/pluto/trunk/pluto-taglib/pom.xml
    portals/pluto/trunk/pluto-taglib/src/site/site.xml
    portals/pluto/trunk/pluto-testsuite/pom.xml
    portals/pluto/trunk/pluto-util/pom.xml
    portals/pluto/trunk/pom.xml

Modified: portals/pluto/trunk/maven-pluto-plugin/pom.xml
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/maven-pluto-plugin/pom.xml?rev=642585&r1=642584&r2=642585&view=diff
==============================================================================
--- portals/pluto/trunk/maven-pluto-plugin/pom.xml (original)
+++ portals/pluto/trunk/maven-pluto-plugin/pom.xml Sat Mar 29 12:05:20 2008
@@ -87,12 +87,6 @@
     </resources>
     <plugins>
       <plugin>
-        <artifactId>maven-site-plugin</artifactId>
-        <configuration>
-          <resourcesDirectory>${basedir}/../pluto-site/src/site/resources</resourcesDirectory>
-        </configuration>
-      </plugin>
-      <plugin>
         <artifactId>maven-plugin-plugin</artifactId>        
         <configuration>
           <goalPrefix>pluto</goalPrefix>

Added: portals/pluto/trunk/maven-pluto-plugin/src/site/apt/index.apt
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/maven-pluto-plugin/src/site/apt/index.apt?rev=642585&view=auto
==============================================================================
--- portals/pluto/trunk/maven-pluto-plugin/src/site/apt/index.apt (added)
+++ portals/pluto/trunk/maven-pluto-plugin/src/site/apt/index.apt Sat Mar 29 12:05:20 2008
@@ -0,0 +1,27 @@
+~~ 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.
+
+ ---
+ Pluto Maven Plugin
+ ---
+ Elliot Metsger
+ ---
+ March 29, 2006
+
+Pluto Maven Plugin
+
+    More documentation to come.

Modified: portals/pluto/trunk/maven-pluto-plugin/src/site/site.xml
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/maven-pluto-plugin/src/site/site.xml?rev=642585&r1=642584&r2=642585&view=diff
==============================================================================
--- portals/pluto/trunk/maven-pluto-plugin/src/site/site.xml (original)
+++ portals/pluto/trunk/maven-pluto-plugin/src/site/site.xml Sat Mar 29 12:05:20 2008
@@ -15,30 +15,12 @@
   See the License for the specific language governing permissions and
   limitations under the License.
 -->
-<project name="Maven">
-  <bannerLeft>
-    <name>Pluto Maven Plugin</name>
-    <src>http://portals.apache.org/pluto/images/pluto.png</src>
-    <href>http://portals.apache.org/pluto</href>
-  </bannerLeft>
-  <bannerRight>
-    <src>http://portals.apache.org/pluto/images/banner.png</src>
-  </bannerRight>
-
-  <skin>  
-      <groupId>org.apache.pluto</groupId>
-      <artifactId>pluto-site-skin</artifactId>
-      <version>2.0.0-SNAPSHOT</version>
-  </skin> 
-
+<project name="Pluto Maven Plugin">
   <body>
-    <links>
-      <item name="Pluto Home" href="http://portals.apache.org/pluto"/>
-      <item name="JSR 168" href="http://jcp.org/en/jsr/detail?id=168"/>
-	  <item name="Chinese Translation" href="http://heavyz.sourceforge.net/pluto_zh/pluto-container"/>
-    </links>
-
-    ${reports}
-
+    <menu name="Pluto Maven Plugin">
+      <item name="About" href="/index.html"/>
+    </menu>
+    <menu ref="parent"/>
+    <menu ref="reports"/>
   </body>
 </project>

Modified: portals/pluto/trunk/pluto-ant-tasks/src/site/site.xml
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/pluto-ant-tasks/src/site/site.xml?rev=642585&r1=642584&r2=642585&view=diff
==============================================================================
--- portals/pluto/trunk/pluto-ant-tasks/src/site/site.xml (original)
+++ portals/pluto/trunk/pluto-ant-tasks/src/site/site.xml Sat Mar 29 12:05:20 2008
@@ -15,33 +15,16 @@
   See the License for the specific language governing permissions and
   limitations under the License.
 -->
-<project name="Maven">
-  <bannerLeft>
-    <name>Pluto Ant Plugin</name>
-    <src>http://portals.apache.org/pluto/images/pluto.png</src>
-    <href>http://portals.apache.org/pluto</href>
-  </bannerLeft>
-  <bannerRight>
-    <src>http://portals.apache.org/pluto/images/banner.png</src>
-  </bannerRight>
-
-  <skin>  
-      <groupId>org.apache.pluto</groupId>
-      <artifactId>pluto-site-skin</artifactId>
-      <version>2.0.0-SNAPSHOT</version>
-  </skin> 
-
+<project name="Pluto Ant Tasks">
   <body>
-    <links>
-      <item name="Pluto Home" href="http://portals.apache.org/pluto"/>
-      <item name="JSR 168" href="http://jcp.org/en/jsr/detail?id=168"/>
-	  <item name="Chinese Translation" href="http://heavyz.sourceforge.net/pluto_zh/pluto-container"/>
-    </links>
 
 	<menu name="Pluto Ant Tasks">
-      <item name="Getting Started" href="/getting-started.html"/>
+      <item name="Getting Started" href="/index.html"/>
 	</menu>
 
-    ${reports}
+    <menu ref="parent"/>
+
+    <menu ref="reports"/>
+
   </body>
 </project>

Modified: portals/pluto/trunk/pluto-container/pom.xml
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/pluto-container/pom.xml?rev=642585&r1=642584&r2=642585&view=diff
==============================================================================
--- portals/pluto/trunk/pluto-container/pom.xml (original)
+++ portals/pluto/trunk/pluto-container/pom.xml Sat Mar 29 12:05:20 2008
@@ -161,12 +161,12 @@
           </excludes>
         </configuration>
       </plugin>
-      <plugin>
+      <!--plugin>
         <artifactId>maven-site-plugin</artifactId>
         <configuration>
           <resourcesDirectory>${basedir}/../pluto-site/src/site/resources</resourcesDirectory>
         </configuration>
-      </plugin>
+      </plugin-->
       <plugin>
       	<groupId>org.apache.maven.plugins</groupId>
       	<artifactId>maven-compiler-plugin</artifactId>

Modified: portals/pluto/trunk/pluto-container/src/site/site.xml
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/pluto-container/src/site/site.xml?rev=642585&r1=642584&r2=642585&view=diff
==============================================================================
--- portals/pluto/trunk/pluto-container/src/site/site.xml (original)
+++ portals/pluto/trunk/pluto-container/src/site/site.xml Sat Mar 29 12:05:20 2008
@@ -20,38 +20,17 @@
 
 <project name="Pluto Portlet Container">
   
-  <bannerLeft>
-    <name>Pluto</name>
-    <src>http://portals.apache.org/pluto/images/pluto.png</src>
-    <href>http://portals.apache.org/pluto</href>
-  </bannerLeft>
-  <bannerRight>
-    <src>http://portals.apache.org/pluto/images/banner.png</src>
-  </bannerRight>
-
-  <skin>  
-      <groupId>org.apache.pluto</groupId>
-      <artifactId>pluto-site-skin</artifactId>
-      <version>2.0.0-SNAPSHOT</version>
-  </skin> 
-  
   <body>
     
-    <links>
-      <item name="Pluto Home" href="http://portals.apache.org/pluto/"/>
-      <item name="JSR 168" href="http://jcp.org/en/jsr/detail?id=168"/>
-      <item name="JSR 286" href="http://jcp.org/en/jsr/detail?id=286"/>
-      <item name="Chinese Translation" href="http://people.apache.org/~zheng/pluto/chinese/"/>
-    </links>
-    
-    <menu name="Portlet Container">
-      <item name="Getting Started" href="/getting-started.html"/>
+    <menu name="Portlet Container" inherit="top">
+      <item name="Getting Started" href="/index.html"/>
       <item name="Embedding Pluto" href="/embed.html"/>
     </menu>
     
-    ${reports}
+    <menu ref="parent"/>
+
+    <menu ref="reports"/>
     
   </body>
   
 </project>
-

Modified: portals/pluto/trunk/pluto-descriptor-api/pom.xml
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/pluto-descriptor-api/pom.xml?rev=642585&r1=642584&r2=642585&view=diff
==============================================================================
--- portals/pluto/trunk/pluto-descriptor-api/pom.xml (original)
+++ portals/pluto/trunk/pluto-descriptor-api/pom.xml Sat Mar 29 12:05:20 2008
@@ -67,14 +67,6 @@
 
 	<build>
 		<plugins>
-			<plugin>
-				<artifactId>maven-site-plugin</artifactId>
-				<configuration>
-					<resourcesDirectory>
-						${basedir}/../pluto-site/src/site/resources
-					</resourcesDirectory>
-				</configuration>
-			</plugin>
       <plugin>
         <groupId>org.apache.maven.plugins</groupId>
         <artifactId>maven-remote-resources-plugin</artifactId>

Added: portals/pluto/trunk/pluto-descriptor-api/src/site/apt/index.apt
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/pluto-descriptor-api/src/site/apt/index.apt?rev=642585&view=auto
==============================================================================
--- portals/pluto/trunk/pluto-descriptor-api/src/site/apt/index.apt (added)
+++ portals/pluto/trunk/pluto-descriptor-api/src/site/apt/index.apt Sat Mar 29 12:05:20 2008
@@ -0,0 +1,32 @@
+~~ 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.
+
+ ---
+ Pluto Descriptor API
+ ---
+ Elliot Metsger
+ ---
+ March 29, 2008
+
+Pluto Descriptor Service API
+
+    The Pluto descriptor services provide an entry point for reading and 
+writing object models representing the web and portlet descriptor files
+(<<<WEB-INF/web.xml>>> and <<<WEB-INF/portlet.xml>>>).  
+
+    Pluto 1.1.x uses a Castor-based implementation, while Pluto 2.0 uses
+a JAXB implementation.

Modified: portals/pluto/trunk/pluto-descriptor-api/src/site/site.xml
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/pluto-descriptor-api/src/site/site.xml?rev=642585&r1=642584&r2=642585&view=diff
==============================================================================
--- portals/pluto/trunk/pluto-descriptor-api/src/site/site.xml (original)
+++ portals/pluto/trunk/pluto-descriptor-api/src/site/site.xml Sat Mar 29 12:05:20 2008
@@ -15,30 +15,16 @@
   See the License for the specific language governing permissions and
   limitations under the License.
 -->
-<project name="Maven">
-  <bannerLeft>
-    <name>Pluto</name>
-    <src>http://portals.apache.org/pluto/images/pluto11.png</src>
-    <href>http://portals.apache.org/pluto</href>
-  </bannerLeft>
-  <bannerRight>
-    <src>http://portals.apache.org/pluto/images/banner.png</src>
-  </bannerRight>
-
-  <skin>  
-      <groupId>org.apache.pluto</groupId>
-      <artifactId>pluto-site-skin</artifactId>
-      <version>2.0.0-SNAPSHOT</version>
-  </skin> 
+<project name="Pluto Descriptor API">
 
   <body>
-    <links>
-      <item name="Pluto Home" href="http://portals.apache.org/pluto"/>
-      <item name="JSR 168" href="http://jcp.org/en/jsr/detail?id=168"/>
-	  <item name="Chinese Translation" href="http://heavyz.sourceforge.net/pluto_zh/pluto-container"/>
-    </links>
+    <menu name="Pluto Descriptor API">
+      <item name="About" href="/index.html"/>
+    </menu> 
+
+    <menu ref="parent"/>
 
-    ${reports}
+    <menu ref="reports"/>
 
   </body>
 </project>

Added: portals/pluto/trunk/pluto-descriptor-impl/src/site/apt/index.apt
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/pluto-descriptor-impl/src/site/apt/index.apt?rev=642585&view=auto
==============================================================================
--- portals/pluto/trunk/pluto-descriptor-impl/src/site/apt/index.apt (added)
+++ portals/pluto/trunk/pluto-descriptor-impl/src/site/apt/index.apt Sat Mar 29 12:05:20 2008
@@ -0,0 +1,61 @@
+~~ 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.
+
+ ---
+ Pluto Descriptor Service Implementation
+ ---
+ Elliot Metsger
+ ---
+ March 29, 2006
+
+Pluto Descriptor Service Implementation
+
+    The Pluto descriptor services provide an entry point for reading and 
+writing object models representing the web and portlet descriptor files
+(<<<WEB-INF/web.xml>>> and <<<WEB-INF/portlet.xml>>>).  The Pluto 1.1
+ implementation uses {{{http://www.castor.org}Castor}} for marshalling 
+and unmarshalling the object models.  Pluto 2.0 uses JAXB.
+
+    If you use the Pluto descriptor services in your own project, be
+sure to code to the interfaces <<<org.apache.pluto.descriptors.services.PortletAppDescriptorService>>>
+and <<<org.apache.pluto.descriptors.services.WebAppDescriptorService>>> and 
+not directly to the implementation classes.
+
+* XML parsing in Pluto 2.x
+
+    In Pluto 2.x, JAXB is used to (un)marshal the descriptor files.  Pluto 2.x
+requires JDK 1.5 and will use JAXP for XML parsing.  No XML parsers
+are required to be endorsed.
+
+* XML parsing in Pluto 1.1.x
+
+    In Pluto 1.1.x, Castor is used to (un)marshal the descriptor files.  Pluto
+1.1.x targets JDK 1.4, therefore 1.1.x distributions will include endorsed
+XML libraries in Tomcat 5's <<<common/endorsed>>> directory.
+
+  However, if your runtime is JDK 1.5 or greater and you are running
+Pluto 1.1.5+, Pluto will automatically configure Castor to use JAXP.
+If you meet these criteria (JDK 1.5+, Pluto 1.1.5+), no XML libraries need 
+to be endorsed - simply delete them from Tomcat 5's common/endorsed directory.
+When Castor is configured to use JAXP, the parser that was defined by the 
+Castor property <<<org.exolab.castor.parser>>> is ignored.
+
+    If for some reason you need to override the the use of JAXP, set the system
+property <<<org.apache.pluto.useJaxp>>> to the string <<<false>>>.  When the 
+property is set to <<<false>>>, Castor will use the parser defined by the 
+<<<org.exolab.castor.parser>>> property.  You will be responsible for providing 
+the XML parser APIs and implementation libraries.

Added: portals/pluto/trunk/pluto-descriptor-impl/src/site/site.xml
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/pluto-descriptor-impl/src/site/site.xml?rev=642585&view=auto
==============================================================================
--- portals/pluto/trunk/pluto-descriptor-impl/src/site/site.xml (added)
+++ portals/pluto/trunk/pluto-descriptor-impl/src/site/site.xml Sat Mar 29 12:05:20 2008
@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!--
+  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="Pluto Descriptor Implementation">
+
+  <body>
+    <menu name="Pluto Descriptor Implementation">
+      <item name="About" href="/index.html"/>
+    </menu> 
+
+    <menu ref="parent"/>
+
+    <menu ref="reports"/>
+
+  </body>
+</project>

Propchange: portals/pluto/trunk/pluto-descriptor-impl/src/site/site.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: portals/pluto/trunk/pluto-descriptor-impl/src/site/site.xml
------------------------------------------------------------------------------
    svn:mime-type = text/xml

Modified: portals/pluto/trunk/pluto-portal-driver-impl/pom.xml
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/pluto-portal-driver-impl/pom.xml?rev=642585&r1=642584&r2=642585&view=diff
==============================================================================
--- portals/pluto/trunk/pluto-portal-driver-impl/pom.xml (original)
+++ portals/pluto/trunk/pluto-portal-driver-impl/pom.xml Sat Mar 29 12:05:20 2008
@@ -130,14 +130,6 @@
         		</configuration>
         	</plugin>
         	<plugin>
-        		<artifactId>maven-site-plugin</artifactId>
-        		<configuration>
-        			<resourcesDirectory>
-        				${basedir}/../pluto-site/src/site/resources
-        			</resourcesDirectory>
-        		</configuration>
-        	</plugin>
-        	<plugin>
         		<groupId>org.apache.maven.plugins</groupId>
         		<artifactId>maven-compiler-plugin</artifactId>
         		<!-- best lock down version of the plugin too -->

Added: portals/pluto/trunk/pluto-portal-driver-impl/src/site/apt/index.apt
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/pluto-portal-driver-impl/src/site/apt/index.apt?rev=642585&view=auto
==============================================================================
--- portals/pluto/trunk/pluto-portal-driver-impl/src/site/apt/index.apt (added)
+++ portals/pluto/trunk/pluto-portal-driver-impl/src/site/apt/index.apt Sat Mar 29 12:05:20 2008
@@ -0,0 +1,29 @@
+~~ 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.
+
+ ---
+ Pluto Portal Driver Implementation
+ ---
+ Elliot Metsger
+ ---
+ March 29, 2008
+
+Pluto Portal Driver Implementation
+
+    The Pluto Portal is a simple portal implementation.  The Driver
+Implementation contains the concrete implementations of container callback
+interfaces, and Pluto Portal interface implementations.

Added: portals/pluto/trunk/pluto-portal-driver-impl/src/site/site.xml
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/pluto-portal-driver-impl/src/site/site.xml?rev=642585&view=auto
==============================================================================
--- portals/pluto/trunk/pluto-portal-driver-impl/src/site/site.xml (added)
+++ portals/pluto/trunk/pluto-portal-driver-impl/src/site/site.xml Sat Mar 29 12:05:20 2008
@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!--
+  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="Pluto Portal Driver Implementation">
+
+  <body>
+    <menu name="Pluto Portal Driver Implementation">
+      <item name="About" href="/index.html"/>
+    </menu> 
+
+    <menu ref="parent"/>
+
+    <menu ref="reports"/>
+
+  </body>
+</project>

Propchange: portals/pluto/trunk/pluto-portal-driver-impl/src/site/site.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: portals/pluto/trunk/pluto-portal-driver-impl/src/site/site.xml
------------------------------------------------------------------------------
    svn:mime-type = text/xml

Modified: portals/pluto/trunk/pluto-portal-driver/pom.xml
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/pluto-portal-driver/pom.xml?rev=642585&r1=642584&r2=642585&view=diff
==============================================================================
--- portals/pluto/trunk/pluto-portal-driver/pom.xml (original)
+++ portals/pluto/trunk/pluto-portal-driver/pom.xml Sat Mar 29 12:05:20 2008
@@ -145,12 +145,6 @@
                 </configuration>
             </plugin>
             <plugin>
-                <artifactId>maven-site-plugin</artifactId>
-                <configuration>
-                    <resourcesDirectory>${basedir}/../pluto-site/src/site/resources</resourcesDirectory>
-                </configuration>
-            </plugin>
-            <plugin>
             	<groupId>org.apache.maven.plugins</groupId>
             	<artifactId>maven-compiler-plugin</artifactId>
             	<!-- best lock down version of the plugin too -->

Added: portals/pluto/trunk/pluto-portal-driver/src/site/apt/index.apt
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/pluto-portal-driver/src/site/apt/index.apt?rev=642585&view=auto
==============================================================================
--- portals/pluto/trunk/pluto-portal-driver/src/site/apt/index.apt (added)
+++ portals/pluto/trunk/pluto-portal-driver/src/site/apt/index.apt Sat Mar 29 12:05:20 2008
@@ -0,0 +1,30 @@
+~~ 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.
+
+ ---
+ Pluto Portal Driver
+ ---
+ Elliot Metsger
+ ---
+ March 29, 2008
+
+Pluto Portal Driver
+
+    The Pluto Portal is a simple portal implementation.  The Driver
+project includes common classes and interfaces for the Portal 
+Implementation.  It also contains the various portlets and tag libraries
+distributed in Pluto Portal.

Added: portals/pluto/trunk/pluto-portal-driver/src/site/site.xml
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/pluto-portal-driver/src/site/site.xml?rev=642585&view=auto
==============================================================================
--- portals/pluto/trunk/pluto-portal-driver/src/site/site.xml (added)
+++ portals/pluto/trunk/pluto-portal-driver/src/site/site.xml Sat Mar 29 12:05:20 2008
@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!--
+  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="Pluto Portal Driver">
+
+  <body>
+    <menu name="Pluto Portal Driver">
+      <item name="About" href="/index.html"/>
+    </menu> 
+
+    <menu ref="parent"/>
+
+    <menu ref="reports"/>
+
+  </body>
+</project>

Propchange: portals/pluto/trunk/pluto-portal-driver/src/site/site.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: portals/pluto/trunk/pluto-portal-driver/src/site/site.xml
------------------------------------------------------------------------------
    svn:mime-type = text/xml

Modified: portals/pluto/trunk/pluto-portal/pom.xml
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/pluto-portal/pom.xml?rev=642585&r1=642584&r2=642585&view=diff
==============================================================================
--- portals/pluto/trunk/pluto-portal/pom.xml (original)
+++ portals/pluto/trunk/pluto-portal/pom.xml Sat Mar 29 12:05:20 2008
@@ -141,14 +141,6 @@
       </plugin>
 
       <plugin>
-        <artifactId>maven-site-plugin</artifactId>
-        <version>2.0-beta-5</version>
-        <configuration>
-          <resourcesDirectory>${basedir}/../pluto-site/src/site/resources</resourcesDirectory>
-        </configuration>
-      </plugin>
-
-      <plugin>
         <groupId>org.apache.maven.plugins</groupId>
         <artifactId>maven-remote-resources-plugin</artifactId>
       </plugin>

Added: portals/pluto/trunk/pluto-portal/src/site/apt/index.apt
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/pluto-portal/src/site/apt/index.apt?rev=642585&view=auto
==============================================================================
--- portals/pluto/trunk/pluto-portal/src/site/apt/index.apt (added)
+++ portals/pluto/trunk/pluto-portal/src/site/apt/index.apt Sat Mar 29 12:05:20 2008
@@ -0,0 +1,29 @@
+~~ 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.
+
+ ---
+ Pluto Portal Webapp
+ ---
+ Elliot Metsger
+ ---
+ March 29, 2008
+
+Pluto Portal Webapp
+
+    The Pluto Portal web application is the skeleton structure for the
+Pluto Portal.  It includes resources (CSS, graphics), source JSPs, and
+configuration (.properties, .xml) files.

Modified: portals/pluto/trunk/pluto-portal/src/site/site.xml
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/pluto-portal/src/site/site.xml?rev=642585&r1=642584&r2=642585&view=diff
==============================================================================
--- portals/pluto/trunk/pluto-portal/src/site/site.xml (original)
+++ portals/pluto/trunk/pluto-portal/src/site/site.xml Sat Mar 29 12:05:20 2008
@@ -15,30 +15,16 @@
   See the License for the specific language governing permissions and
   limitations under the License.
 -->
-<project name="Maven">
-  <bannerLeft>
-    <name>Pluto</name>
-    <src>http://portals.apache.org/pluto/images/pluto.png</src>
-    <href>http://portals.apache.org/pluto</href>
-  </bannerLeft>
-  <bannerRight>
-    <src>http://portals.apache.org/pluto/images/banner.png</src>
-  </bannerRight>
-
-  <skin>  
-      <groupId>org.apache.pluto</groupId>
-      <artifactId>pluto-site-skin</artifactId>
-      <version>2.0.0-SNAPSHOT</version>
-  </skin> 
+<project name="Pluto Portal">
 
   <body>
-    <links>
-      <item name="Pluto Home" href="http://portals.apache.org/pluto"/>
-      <item name="JSR 168" href="http://jcp.org/en/jsr/detail?id=168"/>
-	  <item name="Chinese Translation" href="http://heavyz.sourceforge.net/pluto_zh/pluto-container"/>
-    </links>
+    <menu name="Pluto Portal Webapp">
+      <item name="About" href="/index.html"/>
+    </menu> 
+
+    <menu ref="parent"/>
 
-    ${reports}
+    <menu ref="reports"/>
 
   </body>
 </project>

Added: portals/pluto/trunk/pluto-site-skin/src/main/resources/images/apache-portals.gif
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/pluto-site-skin/src/main/resources/images/apache-portals.gif?rev=642585&view=auto
==============================================================================
Binary file - no diff available.

Propchange: portals/pluto/trunk/pluto-site-skin/src/main/resources/images/apache-portals.gif
------------------------------------------------------------------------------
    svn:mime-type = image/gif

Added: portals/pluto/trunk/pluto-site-skin/src/main/resources/images/architecture.png
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/pluto-site-skin/src/main/resources/images/architecture.png?rev=642585&view=auto
==============================================================================
Binary file - no diff available.

Propchange: portals/pluto/trunk/pluto-site-skin/src/main/resources/images/architecture.png
------------------------------------------------------------------------------
    svn:mime-type = image/png

Added: portals/pluto/trunk/pluto-site-skin/src/main/resources/images/banner.png
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/pluto-site-skin/src/main/resources/images/banner.png?rev=642585&view=auto
==============================================================================
Binary file - no diff available.

Propchange: portals/pluto/trunk/pluto-site-skin/src/main/resources/images/banner.png
------------------------------------------------------------------------------
    svn:mime-type = image/png

Added: portals/pluto/trunk/pluto-site-skin/src/main/resources/images/download.gif
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/pluto-site-skin/src/main/resources/images/download.gif?rev=642585&view=auto
==============================================================================
Binary file - no diff available.

Propchange: portals/pluto/trunk/pluto-site-skin/src/main/resources/images/download.gif
------------------------------------------------------------------------------
    svn:mime-type = image/gif

Added: portals/pluto/trunk/pluto-site-skin/src/site/apt/index.apt
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/pluto-site-skin/src/site/apt/index.apt?rev=642585&view=auto
==============================================================================
--- portals/pluto/trunk/pluto-site-skin/src/site/apt/index.apt (added)
+++ portals/pluto/trunk/pluto-site-skin/src/site/apt/index.apt Sat Mar 29 12:05:20 2008
@@ -0,0 +1,27 @@
+~~ 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.
+
+ ---
+ Pluto Portal Driver
+ ---
+ Elliot Metsger
+ ---
+ March 29, 2008
+
+Pluto Website Skin
+
+    Contains resources (CSS, images) for this website.

Added: portals/pluto/trunk/pluto-site-skin/src/site/site.xml
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/pluto-site-skin/src/site/site.xml?rev=642585&view=auto
==============================================================================
--- portals/pluto/trunk/pluto-site-skin/src/site/site.xml (added)
+++ portals/pluto/trunk/pluto-site-skin/src/site/site.xml Sat Mar 29 12:05:20 2008
@@ -0,0 +1,27 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!--
+  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="Pluto Website Skin">
+
+  <body>
+    <menu name="Pluto Website Skin">
+      <item name="About" href="/index.html"/>
+    </menu> 
+
+    <menu ref="parent"/>
+  </body>
+</project>

Propchange: portals/pluto/trunk/pluto-site-skin/src/site/site.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: portals/pluto/trunk/pluto-site-skin/src/site/site.xml
------------------------------------------------------------------------------
    svn:mime-type = text/xml

Modified: portals/pluto/trunk/pluto-taglib/pom.xml
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/pluto-taglib/pom.xml?rev=642585&r1=642584&r2=642585&view=diff
==============================================================================
--- portals/pluto/trunk/pluto-taglib/pom.xml (original)
+++ portals/pluto/trunk/pluto-taglib/pom.xml Sat Mar 29 12:05:20 2008
@@ -83,12 +83,6 @@
                 </configuration>
             </plugin>
             <plugin>
-                <artifactId>maven-site-plugin</artifactId>
-                <configuration>
-                    <resourcesDirectory>${basedir}/../pluto-site/src/site/resources</resourcesDirectory>
-                </configuration>
-            </plugin>
-            <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-remote-resources-plugin</artifactId>
             </plugin>

Added: portals/pluto/trunk/pluto-taglib/src/site/apt/index.apt
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/pluto-taglib/src/site/apt/index.apt?rev=642585&view=auto
==============================================================================
--- portals/pluto/trunk/pluto-taglib/src/site/apt/index.apt (added)
+++ portals/pluto/trunk/pluto-taglib/src/site/apt/index.apt Sat Mar 29 12:05:20 2008
@@ -0,0 +1,27 @@
+~~ 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.
+
+ ---
+ Pluto Tag Library
+ ---
+ Elliot Metsger
+ ---
+ March 29, 2006
+
+Pluto Tag Library
+
+    Contains the tags used by Pluto Portal.

Modified: portals/pluto/trunk/pluto-taglib/src/site/site.xml
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/pluto-taglib/src/site/site.xml?rev=642585&r1=642584&r2=642585&view=diff
==============================================================================
--- portals/pluto/trunk/pluto-taglib/src/site/site.xml (original)
+++ portals/pluto/trunk/pluto-taglib/src/site/site.xml Sat Mar 29 12:05:20 2008
@@ -16,30 +16,13 @@
   limitations under the License.
 -->
 <project name="Pluto Taglib">
-  <bannerLeft>
-    <name>Pluto Taglib</name>
-    <src>http://portals.apache.org/pluto/images/pluto.png</src>
-    <href>http://portals.apache.org/pluto</href>
-  </bannerLeft>
-  <bannerRight>
-    <src>http://portals.apache.org/pluto/images/banner.png</src>
-  </bannerRight>
-
-  <skin>  
-      <groupId>org.apache.pluto</groupId>
-      <artifactId>pluto-site-skin</artifactId>
-      <version>2.0.0-SNAPSHOT</version>
-  </skin> 
-
   <body>
-    <links>
-      <item name="Pluto Home" href="http://portals.apache.org/pluto"/>
-      <item name="JSR 268" href="http://jcp.org/en/jsr/detail?id=286"/>
-	  <item name="Chinese Translation" href="http://heavyz.sourceforge.net/pluto_zh/pluto-container"/>
-    </links>
+    <menu name="Pluto Taglib">
+      <item name="About" href="/index.html"/>
+    </menu>
+    <menu ref="parent"/>
 
-    ${reports}
+    <menu ref="reports"/>
 
-    ${reports}
   </body>
 </project>

Modified: portals/pluto/trunk/pluto-testsuite/pom.xml
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/pluto-testsuite/pom.xml?rev=642585&r1=642584&r2=642585&view=diff
==============================================================================
--- portals/pluto/trunk/pluto-testsuite/pom.xml (original)
+++ portals/pluto/trunk/pluto-testsuite/pom.xml Sat Mar 29 12:05:20 2008
@@ -117,12 +117,6 @@
           </execution>
         </executions>
       </plugin>
-      <plugin>
-        <artifactId>maven-site-plugin</artifactId>
-        <configuration>
-          <resourcesDirectory>${basedir}/../pluto-site/src/site/resources</resourcesDirectory>
-        </configuration>
-      </plugin>
       
       <plugin>
       	<groupId>org.apache.maven.plugins</groupId>

Added: portals/pluto/trunk/pluto-testsuite/src/site/apt/index.apt
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/pluto-testsuite/src/site/apt/index.apt?rev=642585&view=auto
==============================================================================
--- portals/pluto/trunk/pluto-testsuite/src/site/apt/index.apt (added)
+++ portals/pluto/trunk/pluto-testsuite/src/site/apt/index.apt Sat Mar 29 12:05:20 2008
@@ -0,0 +1,29 @@
+~~ 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.
+
+ ---
+ Pluto Testsuite
+ ---
+ Elliot Metsger
+ ---
+ March 29, 2008
+
+Pluto Testsuite
+
+    The Pluto testsuite is comprised of multiple portlets meant to be
+deployed in the portal to be tested.  Portals wanting to embed Pluto
+can use the testsuite to test the correctness of their integration.

Added: portals/pluto/trunk/pluto-testsuite/src/site/site.xml
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/pluto-testsuite/src/site/site.xml?rev=642585&view=auto
==============================================================================
--- portals/pluto/trunk/pluto-testsuite/src/site/site.xml (added)
+++ portals/pluto/trunk/pluto-testsuite/src/site/site.xml Sat Mar 29 12:05:20 2008
@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!--
+  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="Pluto Testsuite">
+
+  <body>
+    <menu name="Pluto Testsuite">
+      <item name="About" href="/index.html"/>
+    </menu> 
+
+    <menu ref="parent"/>
+
+    <menu ref="reports"/>
+
+  </body>
+</project>

Propchange: portals/pluto/trunk/pluto-testsuite/src/site/site.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: portals/pluto/trunk/pluto-testsuite/src/site/site.xml
------------------------------------------------------------------------------
    svn:mime-type = text/xml

Modified: portals/pluto/trunk/pluto-util/pom.xml
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/pluto-util/pom.xml?rev=642585&r1=642584&r2=642585&view=diff
==============================================================================
--- portals/pluto/trunk/pluto-util/pom.xml (original)
+++ portals/pluto/trunk/pluto-util/pom.xml Sat Mar 29 12:05:20 2008
@@ -68,24 +68,11 @@
     
   </dependencies>
 
-  <distributionManagement>
-    <site>
-      <id>website</id>
-      <url>scp://people.apache.org/www/portals.apache.org/pluto/pluto-1.1</url>
-    </site>
-  </distributionManagement>
-  
   <reporting>
     <plugins>
       <plugin>
         <groupId>org.apache.maven.plugins</groupId>
         <artifactId>maven-project-info-reports-plugin</artifactId>
-      </plugin>
-      <plugin>
-        <artifactId>maven-site-plugin</artifactId>
-        <configuration>
-          <resourcesDirectory>${basedir}/../pluto-site/src/site/resources</resourcesDirectory>
-        </configuration>
       </plugin>
       <plugin>
         <groupId>org.apache.maven.plugins</groupId>

Added: portals/pluto/trunk/pluto-util/src/site/apt/index.apt
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/pluto-util/src/site/apt/index.apt?rev=642585&view=auto
==============================================================================
--- portals/pluto/trunk/pluto-util/src/site/apt/index.apt (added)
+++ portals/pluto/trunk/pluto-util/src/site/apt/index.apt Sat Mar 29 12:05:20 2008
@@ -0,0 +1,27 @@
+~~ 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.
+
+ ---
+ Pluto Utilities
+ ---
+ Elliot Metsger
+ ---
+ March 29, 2006
+
+Pluto Utilities
+
+    The utilities project includes the Pluto Assembler and Pluto Installer.

Added: portals/pluto/trunk/pluto-util/src/site/site.xml
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/pluto-util/src/site/site.xml?rev=642585&view=auto
==============================================================================
--- portals/pluto/trunk/pluto-util/src/site/site.xml (added)
+++ portals/pluto/trunk/pluto-util/src/site/site.xml Sat Mar 29 12:05:20 2008
@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!--
+  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="Pluto Utilities">
+
+  <body>
+    <menu name="Pluto Utilities">
+      <item name="About" href="/index.html"/>
+    </menu> 
+
+    <menu ref="parent"/>
+
+    <menu ref="reports"/>
+
+  </body>
+</project>

Propchange: portals/pluto/trunk/pluto-util/src/site/site.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: portals/pluto/trunk/pluto-util/src/site/site.xml
------------------------------------------------------------------------------
    svn:mime-type = text/xml

Modified: portals/pluto/trunk/pom.xml
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/pom.xml?rev=642585&r1=642584&r2=642585&view=diff
==============================================================================
--- portals/pluto/trunk/pom.xml (original)
+++ portals/pluto/trunk/pom.xml Sat Mar 29 12:05:20 2008
@@ -277,7 +277,7 @@
         <module>pluto-ant-tasks</module>
 
         <!-- Pluto Documentations -->
-        <module>pluto-site</module>
+        <!--module>pluto-site</module-->
         <module>pluto-site-skin</module>
     </modules>
 
@@ -314,6 +314,11 @@
             <plugins>
                 <plugin>
                     <groupId>org.apache.maven.plugins</groupId>
+                    <artifactId>maven-site-plugin</artifactId>
+                    <version>2.0-beta-7-SNAPSHOT</version>
+                </plugin>
+                <plugin>
+                    <groupId>org.apache.maven.plugins</groupId>
                     <artifactId>maven-remote-resources-plugin</artifactId>
                     <version>1.0-alpha-5</version>
                     <executions>
@@ -344,6 +349,13 @@
                 </plugin>
             </plugins>
         </pluginManagement>
+        
+        <plugins>
+          <plugin>
+            <groupId>org.apache.maven.plugins</groupId>
+            <artifactId>maven-site-plugin</artifactId>
+          </plugin>
+        </plugins>
     </build>
 
     <reporting>

Added: portals/pluto/trunk/portlet2-api/src/site/apt/index.apt
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/portlet2-api/src/site/apt/index.apt?rev=642585&view=auto
==============================================================================
--- portals/pluto/trunk/portlet2-api/src/site/apt/index.apt (added)
+++ portals/pluto/trunk/portlet2-api/src/site/apt/index.apt Sat Mar 29 12:05:20 2008
@@ -0,0 +1,27 @@
+~~ 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.
+
+ ---
+ Portlet API 2.0 (JSR 286)
+ ---
+ Elliot Metsger
+ ---
+ March 29, 2006
+
+Portlet API 2.0
+
+    About Portlet API 2.0 (JSR 286)

Added: portals/pluto/trunk/portlet2-api/src/site/site.xml
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/portlet2-api/src/site/site.xml?rev=642585&view=auto
==============================================================================
--- portals/pluto/trunk/portlet2-api/src/site/site.xml (added)
+++ portals/pluto/trunk/portlet2-api/src/site/site.xml Sat Mar 29 12:05:20 2008
@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!--
+  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="Portlet API 2.0">
+
+  <body>
+    <menu name="Portlet API 2.0">
+      <item name="About" href="/index.html"/>
+    </menu> 
+
+    <menu ref="parent"/>
+
+    <menu ref="reports"/>
+
+  </body>
+</project>

Propchange: portals/pluto/trunk/portlet2-api/src/site/site.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: portals/pluto/trunk/portlet2-api/src/site/site.xml
------------------------------------------------------------------------------
    svn:mime-type = text/xml

Added: portals/pluto/trunk/src/site/fml/faq.fml
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/src/site/fml/faq.fml?rev=642585&view=auto
==============================================================================
--- portals/pluto/trunk/src/site/fml/faq.fml (added)
+++ portals/pluto/trunk/src/site/fml/faq.fml Sat Mar 29 12:05:20 2008
@@ -0,0 +1,175 @@
+<?xml version="1.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.
+-->
+<!--
+// ======================================================================== 78
+-->
+<faqs title="Frequently Asked Questions">
+  <part id="general">
+    <faq id="version">
+      <question>Which version of Pluto should I use?</question>
+      <answer>
+        <p>
+          The latest release from the 1.1.x series is the current
+          stable release. We recommend that you use this if you
+          are looking for a stable release.
+        </p>
+
+        <p>
+            Pluto 2.x is currently under development. This is the 
+            reference implementation of JSR-286, the 2nd version
+            of the Java Portlet Specification. Pluto 2.x requires
+            the use of Java 5(a.k.a 1.5).
+        </p>
+      </answer>
+    </faq>
+
+    <faq id="10">
+      <question>I've seen references to Pluto 1.0.0. What's the deal?</question>
+      <answer>
+        <p>
+          Pluto 1.0.x is based off of the code base which was
+          originally donated to the ASF by IBM. The first release
+          candidate in this series was published on October 8, 2004.
+        </p>
+        <p>
+          Around the same time that this release occured Pluto
+          1.1.0-ALPHA was imported into our source repository.
+          The 1.1.x series is a refactoring/rewrite of Pluto. It's
+          entire purpose is to simplify the container and make it
+          easier for both Portlet Developers and Portal Developers
+          looking to embed Pluto into their portal to use Pluto.
+        </p>
+        <p>
+          Now that Pluto 1.1.0 has been released, our team highly
+          recommends that you migrate to it. Pluto 1.0.x development
+          has been stagnant for some time and there are no plans to
+          support it in the future. Pluto 1.1.x is also the basis for
+          Pluto 2.x, which is the reference implementation for
+          JSR-286 (Portlet 2.0).
+        </p>
+      </answer>
+    </faq>
+
+    <faq id="portal">
+      <question>Is Pluto an Enterprise Portal?</question>
+      <answer>
+        No, the Pluto project aims to provide a Java Specification
+        compliant Portlet Container. In order to support the container,
+        the Pluto project provides a simple portal, however, this does
+        not provides optional services such as single sign on. If you
+        are looking for an Open Source enterprise Portal implementation,
+        there are several available. Apache Jetspeed is an enterprise
+        portal hosted by the Apache Software Foundation. Sakai and uPortal
+        are both educational portals which utilize Pluto as their container.
+        There are many other open source portals.
+      </answer>
+    </faq>
+
+    <faq id="simple-embed">
+      <question>What's the easiest way to include a portlet in my webapp</question>
+      <answer>
+        <p>
+          Simple, use the Pluto Portal Drivers "PortalDriverFilter". This allows
+          you to embed a portlet directly into a jsp page. To use it, do the following:
+        </p>
+        <p>
+        <ul>
+          <li>Add the Portal Driver listener Configuration to your web.xml
+            <textarea style="border:0; width: 100%; background:transparent; color:#555555" rows="3" readonly="true">
+<listener>
+    <listener-class>org.apache.pluto.driver.PortalStartupListener</listener-class>
+</listener>
+            </textarea>
+          </li>
+          <li>Add the PortalDriverFilter configuration to your web.xml
+            <textarea style="border:0; width: 100%; background:transparent; color:#555555" rows="15" readonly="true">
+<filter>
+  <filter-name>plutoPortalDriver</filter-name>
+  <filter-class>org.apache.pluto.driver.PortalDriverFilter</filter-class>
+</filter>
+
+<filter-mapping>
+  <filter-name>plutoPortalDriver</filter-name>
+  <url-pattern>/about.jsp</url-pattern>
+</filter-mapping>
+
+<filter-mapping>
+  <filter-name>plutoPortalDriver</filter-name>
+  <url-pattern>/about.jsp/*</url-pattern>
+</filter-mapping>
+            </textarea>
+          </li>
+          <li>Include the portlet (and perhaps some controls?) in your jsp.
+            <textarea style="border:0; width: 100%; background:transparent; color:#555555" rows="15" readonly="true">
+%@ taglib uri="http://portals.apache.org/pluto" prefix="pluto" %
+
+<pluto:portlet portletId="${portlet}">
+  <div class="portlet" id='&gt;c:out value="${portlet}"/&gt;'>
+    <div class="header">
+      <h2 class="title"><pluto:title/></h2>
+    </div>
+    <div class="body">
+      <pluto:render/>
+    </div>
+  </div>
+</pluto:portlet>
+            </textarea>
+          </li>
+        </ul>
+        </p>
+      </answer>
+    </faq>
+
+    <faq id="encoding">
+        <question>How can I change the default encoding of the Pluto Portal</question>
+        <answer>
+            <p>As of Pluto 1.1.5 you can change the default encoding of the Pluto Portal by
+               editing the Pluto Portlet Servlet's web.xml.  Add an init-param with
+               the name of "charset" and set the value to the desired character set.</p>
+            <textarea style="border:0; width: 100%; background:transparent; color:#555555" rows="15" readonly="true">
+  <servlet>
+    <servlet-name>plutoPortalDriver</servlet-name>
+    <display-name>Pluto Portal Driver</display-name>
+    <description>Pluto Portal Driver Controller</description>
+    <servlet-class>org.apache.pluto.driver.PortalDriverServlet</servlet-class>
+    <init-param>
+      <param-name>charset</param-name>
+      <param-value>UTF-8</param-value>
+    </init-param>
+  </servlet>
+            </textarea>
+        </answer>
+    </faq>
+      
+    <faq id="xml-parsing">
+        <question>
+            Do I need to have xml parsers in an endorsed classloader? (e.g.in
+            Tomcat's 5.5 common/endorsed directory)
+        </question>
+        <answer>
+            <p>If you have installed Pluto 1.1.5 or greater, and are running on
+            Java 5 or greater, then you do not need to endorse any XML
+            libraries.  Pluto will use JAXP.</p>
+            <p>The Pluto 1.1.x codebase targets Java 1.4, and so the bundled
+            distribution of Pluto includes Tomcat with XML libraries in
+            <code>common/endorsed</code>.  Simply remove the XML libraries
+            from <code>common/endorsed</code> if you meet the above requirements.</p>
+        </answer>
+    </faq>
+  </part>
+</faqs>

Added: portals/pluto/trunk/src/site/fml/helping.fml
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/src/site/fml/helping.fml?rev=642585&view=auto
==============================================================================
--- portals/pluto/trunk/src/site/fml/helping.fml (added)
+++ portals/pluto/trunk/src/site/fml/helping.fml Sat Mar 29 12:05:20 2008
@@ -0,0 +1,463 @@
+<?xml version="1.0"?>
+<!--
+Copyright 1999-2006 The Apache Software Foundation
+Licensed 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.
+-->
+<!--
+// ======================================================================== 78
+-->
+<faqs title="Getting Involved">
+    <part id="general">
+
+        <faq id="involved">
+            <question>Getting Involved</question>
+            <answer>
+
+                <p>
+                    Every volunteer project obtains its strength
+                    from the people involved in it.
+                    We invite you to participate as much or as little as you
+                    choose.
+                    The roles and responsibilities that people can assume in
+                    the project
+                    are based on merit.
+                    Everybody's input matters!
+                </p>
+
+                <p>
+                    Here is one developer's advice how to get involved.
+                    It specifically talks about Tomcat,
+                    but the general idea can applied to any of the Apache
+                    Projects.
+                </p>
+
+                <ul>
+                    <li>
+                        <a href="http://jakarta.apache.org/site/contributing.html">
+                            Contributing</a>
+                        -- Craig R. McClanahan
+                    </li>
+                </ul>
+
+                <p>
+                    Here is another comment that was sent to the Jakarta
+                    Turbine Mailing
+                    List about the open source process and the contrast
+                    between how an
+                    open source product and a proprietary product improve
+                    through the user
+                    community.
+                </p>
+
+                <ul>
+                    <li>
+                        <a href="http://jakarta.apache.org/site/understandingopensource.html">
+                            Understanding Opensource</a>
+                        -- Cameron Riley
+                    </li>
+                </ul>
+
+                <p>
+                    While written for ASF developers,
+                    the Rules for Revolutionaries provides insight into how
+                    the
+                    collaborative process works,
+                    and how our process differs from working on a hierarchical
+                    team.
+                </p>
+
+                <ul>
+                    <li>
+                        <a href="http://incubator.apache.org/learn/rules-for-revolutionaries.html">
+                            Rules for Revolutionaries</a>
+                        -- James Duncan Davidson
+                    </li>
+                </ul>
+
+                <p>
+                    Just using the products is a very important role.
+                    We need people who will report issues, contribute patches,
+                    suggest features, and so forth.
+                    Your feedback helps the technology to evolve.
+                </p>
+
+            </answer>
+        </faq>
+
+        <faq id="mail">
+            <question>Joining the Mailing Lists</question>
+            <answer>
+
+                <p>
+                    There are a variety of ways to participate.
+                    Regardless of how you choose to participate,
+                    we suggest you join our
+                    <a href="mail-lists.html">mailing lists</a>.
+                </p>
+
+
+                <p>
+                    Please do be sure to
+                    <a href="http://expita.com/nomime.html">turn off
+                        HTML</a>
+                    in your email client before posting.
+                </p>
+            </answer>
+        </faq>
+
+        <faq id="patches">
+            <question>How do I create a patch?</question>
+            <answer>
+                <p>
+                    A patch is a machine-readable script that can
+                    automatically
+                    recreate a change to a text file, including source code
+                    and
+                    documentation.
+                    The patch format is also human-readable.
+                    Developers often pass patches around to discuss a change
+                    before
+                    applying it to the main repository.
+                </p>
+
+                <p>
+                    The best way to affect a change to the source code or
+                    documentation
+                    is to provide a patch.
+                    Pluto committers can then review your patch and
+                    decide
+                    whether to apply it to the main repository.
+                </p>
+
+                <p>
+                    To create a patch, you first have to
+                    <a href="source-repository.html">
+                        checkout</a>
+                    a copy of the source code or documentation from the main
+                    repository.
+                    You can then change your copy, and create the patch using
+                    a simple
+                    <a href="http://subversion.org/">Subversion</a>
+                    command, like this:
+                </p>
+
+                <p>
+                    <code>svn diff Main.java &gt;&gt; patchfile.txt</code>
+                </p>
+
+                <p>
+                    Then, create a
+                    <a href="#issues">JIRA
+                        issue</a>
+                    about the change, and attach the patch file.
+                </p>
+
+                <p>
+                    Some Apache projects ask that you to submit your patch to
+                    the mailing
+                    list.
+                    We would prefer that you create a
+                    JIRA issue and then attach the patch to the issue.
+                    To do this, you must first create the issue,
+                    and then modify the report to add your patch.
+                    We realize this is a bit clumsy, but it keeps us from
+                    losing things,
+                    and helps to ensure that your patch will be attended.
+                </p>
+
+                <p>
+                    The
+                    <a href="http://www.netbeans.org/community/contribute/patches.html">
+                        NetBeans community</a>
+                    also has a helpful section on the
+                    subject of creating patches.
+                </p>
+
+            </answer>
+        </faq>
+
+        <faq id="issues">
+            <question>How can I report defects or suggest features?</question>
+            <answer>
+                <p>
+                    Tracking of defect reports and enhancement suggestions for
+                    Apache Pluto
+                    products is handled
+                    through the
+                    <a href="http://issues.apache.org/jira/">Apache Pluto
+                        JIRA instance.</a>
+                    Please select the appropriate Pluto product from
+                    the list,
+                    and then select the component to which you feel this report
+                    relates.
+                    You will automatically be notified by email as the status
+                    of your defect or
+                    enhancement report changes.
+                    Please be sure to read
+                    <a href="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html">
+                        How to
+                        Report Bugs Effectively</a>
+                    before posting a report.
+                </p>
+
+                <p>
+                    If you can't write a
+                    <a href="#patches">patch</a>
+                    to address your issue,
+                    a unit test that demonstrates the problem is also welcome.
+                    (And, of course, unit tests that prove your patch works
+                    are equally welcome.)
+                </p>
+
+                <p>
+                    If the defect or feature is already being tracked,
+                    you can vote for the issue and call more attention to it.
+                    Each user can cast up to six votes at a time.
+                </p>
+
+                <p>
+                    If there is a patch attached to the issue, you can also
+                    try applying
+                    to your local copy of Pluto, and report whether it worked
+                    for you.
+                    Feedback from developers regarding a proposed patch is
+                    really quite
+                    helpful.
+                    Don't hesitate to add a "works for me" note to a ticket
+                    if you've tried the patch yourself and found it useful.
+                </p>
+
+                <p>
+                    Feature suggestions are also maintained in the
+                    <a href="#issues">JIRA issue
+                    tracker.</a>
+                </p>
+
+            </answer>
+        </faq>
+
+        <faq id="contribute">
+            <question>How can I contribute to the Pluto source
+                code?</question>
+            <answer>
+
+                <p>
+                    A very good place to start is by
+                    <strong>reviewing the list of open issues</strong>
+                    and pending feature suggestions in the
+                    <a href="#issues">issue tracker.</a>
+                    If you see an issue that needs a patch you can write,
+                    feel free to annex your patch.
+                    If you seen an issue that needs a unit test to prove its
+                    fixed,
+                    feel free to annex your test case.
+                    If someone has posted a patch to an issue you'd like to
+                    see resolved,
+                    apply the patch to your local development copy of Pluto.
+                    Then let us know if it works for you, and if it does,
+                    cast your vote for the issue and its patch.
+                </p>
+
+                <p>
+                    If none of the pending issues scratch your itch,
+                    another good place to start is by
+                    <strong>contributing unit tests</strong>
+                    for existing features (even those that still work).
+                </p>
+
+                <p>
+                    You can upload a proposed
+                    <a href="#patches">patch</a>
+                    to either the code or documentation by creating a feature
+                    suggestion
+                    in the
+                    <a href="#issues">issue tracker.</a>
+                    <strong>After creating the ticket.</strong>
+                    you can go back and upload a
+                    file containing your patch.
+                </p>
+
+            </answer>
+        </faq>
+
+        <faq id="documentation">
+            <question>How can I contribute to the
+                documentation?</question>
+            <answer>
+            	<p>
+            	    The same way you contribute to the source code.  All
+                documentation is generated using maven.
+
+              </p>
+            </answer>
+        </faq>
+
+        <faq id="release">
+            <question>So when is the next release coming out?</question>
+            <answer>
+
+                <p>
+                    Here is the truth regarding releases:
+                </p>
+
+                <p>
+                    Apache products are released on the basis of merit,
+                    and ~not~ according to a strict timetable.
+                    The volunteers devote whatever time they can to work
+                    on
+                    the product.
+                    But all volunteers have real jobs and real lives, that
+                    do
+                    take precedence.
+                    Since Pluto does not have paid personnel working on
+                    the
+                    project,
+                    we simply cannot make date-oriented commitments.
+                </p>
+
+                <p>
+                    The bottom line is that Apache takes releases very
+                    seriously.
+                    We do not compromise the quality of our software by
+                    watching the calendar
+                    (and then ship something ready or not).
+                    A release is ready when it is ready.
+                </p>
+
+                <p>
+                    That may sound flip, but it ~is~ the truth.
+                    The delivery of production-quality, leading-edge
+                    software
+                    is
+                    not something anyone can prognosticate.
+                    If anyone tries, they are lying to you.
+                    That, we won't do ;-)
+                </p>
+
+                <p>
+                    What we ~will~ do is release all of our development
+                    software as soon as
+                    it is developed.
+                    This way you can judge for yourself how quickly the
+                    development is
+                    proceeding, and whether what is being developed will
+                    meet
+                    your needs.
+                    If you need a feature right now, you can use the
+                    nightly
+                    build, or roll
+                    your own patch.
+                    There are no internal code repositories, private
+                    development lists,
+                    secret chat rooms, or conference calls.
+                    What you see is what we got.
+                    If you are following the DEV list, then you know
+                    everything the
+                    developers know.
+                    Really, you do.
+                </p>
+
+                <p>
+                    <em>So, what do you tell your team?</em>
+                    If you can ship your application based on the nightly
+                    build of your choice,
+                    then consider that an option.
+                    You can still ship yours, even if we don't ship ours,
+                    and you will have access to all the latest patches or
+                    enhancements.
+                    (Just like we were working down the hall.)
+                    If you can only ship your application based on a
+                    release
+                    build of Pluto,
+                    then you should base your development on the release
+                    build
+                    of Pluto,
+                    and keep an eye on what is coming down the pipeline.
+                    This way you are at least forewarned and forearmed.
+                </p>
+
+            </answer>
+        </faq>
+
+
+        <faq id="decides_help">
+            <question>How can I help make the decisions?</question>
+            <answer>
+
+                <p>
+                    A guiding principle of the Apache Software Foundation is
+                    "them that do the work, make the decisions".
+                    This phrase is actually a double-entendre.
+                    A project will make some decisions by voting (very few),
+                    but the real decisions are made when a volunteer actually
+                    does the
+                    work.
+                    Unless someone volunteers to do the work,
+                    other decisions are meaningless.
+                </p>
+
+                <p>
+                    In an ASF project, like Pluto,
+                    volunteers who make sustained contributions to the project
+                    are invited to become "Committers".
+                    In due course, Committers are invited to join the Project
+                    Management
+                    Committee (PMC).
+                    A goal of the ASF is for all Committers to be on the PMC.
+                </p>
+
+                <p>
+                    By "sustained", we mean that an individual has been active
+                    in the project for at least six months.
+                    The contributions should come in the form of both patches
+                    (to code or documentation), and posts to the mailing
+                    lists.
+                    Patches must be competent and accepted into the
+                    repository.
+                    Posts must be consistently helpful, friendly, and
+                    collaborative.
+                    The most important characteristic in a prospective
+                    Committer is an
+                    amicable demeanor that fosters goodwill.
+                </p>
+
+                <p>
+                    As PMC members take note of Portals developers who meet our
+                    qualifications, one of us will call for a vote on the
+                    internal
+                    PMC mailing list.
+                    (This usually happens when someone gets tired of applying
+                    the volunteer's patches!)
+                    The internal list is rarely used, and it is never used for
+                    development discussions.
+                    If the PMC vote passes, we will send the developer a
+                    invitation
+                    privately, to give the individual a chance to accept or
+                    discretely
+                    decline.
+                    If the candidate is able to accept,
+                    the PMC will announce the new member on the dev list.
+                </p>
+
+                <p>
+                    For more about decision-making, see
+                    <a href="http://apache.org/foundation/how-it-works.html">
+                        "How the ASF Works"</a>
+                    and the
+                </p>
+
+            </answer>
+        </faq>
+
+    </part>
+</faqs>



Mime
View raw message