svn commit: r348687 - in /forrest/trunk/plugins/org.apache.forrest.plugin.input.projectInfo: resources/stylesheets/changes-to-document.xsl src/documentation/content/xdocs/index.xml

[rg...@apache.org]

Author: rgardler
Date: Thu Nov 24 00:32:22 2005
New Revision: 348687

URL: http://svn.apache.org/viewcvs?rev=348687&view=rev
Log:
add list of contributors and committers to changes document

Modified:
    forrest/trunk/plugins/org.apache.forrest.plugin.input.projectInfo/resources/stylesheets/changes-to-document.xsl
    forrest/trunk/plugins/org.apache.forrest.plugin.input.projectInfo/src/documentation/content/xdocs/index.xml

Modified: forrest/trunk/plugins/org.apache.forrest.plugin.input.projectInfo/resources/stylesheets/changes-to-document.xsl
URL: http://svn.apache.org/viewcvs/forrest/trunk/plugins/org.apache.forrest.plugin.input.projectInfo/resources/stylesheets/changes-to-document.xsl?rev=348687&r1=348686&r2=348687&view=diff
==============================================================================
--- forrest/trunk/plugins/org.apache.forrest.plugin.input.projectInfo/resources/stylesheets/changes-to-document.xsl (original)
+++ forrest/trunk/plugins/org.apache.forrest.plugin.input.projectInfo/resources/stylesheets/changes-to-document.xsl Thu Nov 24 00:32:22 2005
@@ -36,6 +36,9 @@
 
  <xsl:param name="bugtracking-url" select="$bugzilla"/>
 
+ <xsl:key name="contexts" match="changes/release/action" use="concat(../@version, '_', @context)"/>
+ <xsl:key name="distinct-contributor" match="changes/release/action" use="@due-to"/>
+ 
  <xsl:template match="/">
   <xsl:apply-templates select="//changes"/>
  </xsl:template>
@@ -72,12 +75,24 @@
         <xsl:apply-templates/>
       </xsl:otherwise>
     </xsl:choose>
+    <xsl:if test="//developers">
+       <section>
+         <title>Committers</title>
+         <p>This is a list of all people, in alphabetic order, who have been 
+         voted in as committers on this project.</p>
+         
+         <ul>
+           <xsl:for-each select="//developers/person">
+             <xsl:sort select="@name"/>
+             <li><xsl:value-of select="@name"/> (<xsl:value-of select="@id"/>)</li>
+           </xsl:for-each>
+         </ul>
+       </section>
+    </xsl:if>
     </body>
   </document>
  </xsl:template>
 
- <xsl:key name="contexts" match="changes/release/action" use="concat(../@version, '_', @context)"/>
-
  <xsl:template match="release">
   <section id="version_{@version}">
    <title>Version <xsl:value-of select="@version"/> (<xsl:value-of select="@date"/>)</title>
@@ -102,6 +117,21 @@
      </ul>
     </section>
    </xsl:for-each>
+   <xsl:if test="action[@due-to]">
+     <section>
+       <title>Contributors</title>
+       <p>This is a list of all people who have contributed to this release, but 
+       were full developers on the project. We thank these people for their 
+       contributions.</p>
+       
+       <ul>
+         <xsl:for-each select="action[generate-id()=generate-id(key('distinct-contributor', @due-to))]">
+           <xsl:sort select="@due-to"/>
+           <li><xsl:value-of select="@due-to"/></li>
+         </xsl:for-each>
+       </ul>
+     </section>
+   </xsl:if>
   </section>
  </xsl:template>
 

Modified: forrest/trunk/plugins/org.apache.forrest.plugin.input.projectInfo/src/documentation/content/xdocs/index.xml
URL: http://svn.apache.org/viewcvs/forrest/trunk/plugins/org.apache.forrest.plugin.input.projectInfo/src/documentation/content/xdocs/index.xml?rev=348687&r1=348686&r2=348687&view=diff
==============================================================================
--- forrest/trunk/plugins/org.apache.forrest.plugin.input.projectInfo/src/documentation/content/xdocs/index.xml (original)
+++ forrest/trunk/plugins/org.apache.forrest.plugin.input.projectInfo/src/documentation/content/xdocs/index.xml Thu Nov 24 00:32:22 2005
@@ -84,6 +84,26 @@
     </section>
     
     <section>
+      <title>Developers List</title>
+      <p>The status.xml file can also contain a list of committers and 
+      contributors which can, optionally, be displayed as part of the changes file.</p>
+      
+      <p>At the time of writing this functionality is quite minimal, being just
+      a list of authors at the end of the changes document. However, in future 
+      releases it is intended that a more configurable output will be 
+      available.</p>
+      
+      <section>
+        <title>Contributor List</title>
+        <p>It may be that some items have been contributed by authors other
+        than those listed in the developer list. These are accredited in a
+        <code>due-to</code> attribute of the <code>action</code> element in
+        status.xml. A list of this contributors is made available at the
+        end of the release notes for each version.</p>
+      </section>
+    </section>
+    
+    <section>
       <title>Project Details</title>
       <p>Project details are generated from a project descriptor file.
       This file can be in any of the followin formats:</p>