commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From scolebou...@apache.org
Subject svn commit: r344280 - in /jakarta/commons/proper/primitives/trunk: project.properties project.xml xdocs/cvs-usage.xml xdocs/faq.xml xdocs/index.xml xdocs/issue-tracking.xml xdocs/navigation.xml xdocs/proposal.xml xdocs/tasks.xml xdocs/userguide.xml
Date Tue, 15 Nov 2005 00:23:16 GMT
Author: scolebourne
Date: Mon Nov 14 16:23:07 2005
New Revision: 344280

URL: http://svn.apache.org/viewcvs?rev=344280&view=rev
Log:
Update primitives website

Added:
    jakarta/commons/proper/primitives/trunk/xdocs/cvs-usage.xml   (with props)
    jakarta/commons/proper/primitives/trunk/xdocs/issue-tracking.xml   (with props)
    jakarta/commons/proper/primitives/trunk/xdocs/proposal.xml   (with props)
    jakarta/commons/proper/primitives/trunk/xdocs/tasks.xml   (with props)
    jakarta/commons/proper/primitives/trunk/xdocs/userguide.xml   (with props)
Modified:
    jakarta/commons/proper/primitives/trunk/project.properties
    jakarta/commons/proper/primitives/trunk/project.xml
    jakarta/commons/proper/primitives/trunk/xdocs/faq.xml
    jakarta/commons/proper/primitives/trunk/xdocs/index.xml
    jakarta/commons/proper/primitives/trunk/xdocs/navigation.xml

Modified: jakarta/commons/proper/primitives/trunk/project.properties
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/primitives/trunk/project.properties?rev=344280&r1=344279&r2=344280&view=diff
==============================================================================
--- jakarta/commons/proper/primitives/trunk/project.properties (original)
+++ jakarta/commons/proper/primitives/trunk/project.properties Mon Nov 14 16:23:07 2005
@@ -1,4 +1,4 @@
-#   Copyright 2003-2004 The Apache Software Foundation
+#   Copyright 2003-2005 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.
@@ -11,22 +11,41 @@
 #   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.
-maven.checkstyle.properties=checkstyle.xml
 
 maven.changelog.factory=org.apache.maven.svnlib.SvnChangeLogFactory
 
-maven.junit.fork=true
-
 maven.xdoc.jsl=../commons-build/commons-site.jsl
 maven.xdoc.date=left
 maven.xdoc.version=${pom.currentVersion}
 maven.xdoc.developmentProcessUrl=http://jakarta.apache.org/commons/charter.html
 maven.xdoc.poweredby.image=maven-feather.png
+maven.xdoc.copy.excludes=images/file.gif,images/folder-closed.gif,images/folder-open.gif,images/icon_alert.gif,images/icon_alertsml.gif,images/icon_arrowfolder1_sml.gif,images/icon_arrowfolder2_sml.gif,images/icon_arrowmembers1_sml.gif,images/icon_arrowmembers2_sml.gif,images/icon_arrowusergroups1_sml.gif,images/icon_arrowusergroups2_sml.gif,images/icon_confirmsml.gif,images/icon_help_lrg.gif,images/icon_infosml.gif,images/icon_members_sml.gif,images/icon_sortleft.gif,images/icon_sortright.gif,images/icon_usergroups_sml.gif,images/icon_waste_lrg.gif,images/icon_waste_sml.gif,images/none.png,images/nw_maj.gif,images/nw_maj_hi.gif,images/nw_med.gif,images/nw_med_hi.gif,images/nw_med_rond.gif,images/nw_min.gif,images/nw_min_036.gif,images/nw_min_hi.gif,images/poweredby_036.gif,images/product_logo.gif,images/se_maj_rond.gif,images/sw_min.gif,images/logos/**
+maven.xdoc.copy.excludes.classic=images/external-classic.png,images/help_logo.gif,images/icon_arrowfolderclosed1_sml.gif,images/icon_arrowwaste1_sml.gif,images/icon_arrowwaste2_sml.gif,images/icon_doc_lrg.gif,images/icon_doc_sml.gif,images/icon_error_lrg.gif,images/icon_folder_lrg.gif,images/icon_folder_sml.gif,images/icon_help_sml.gif,images/icon_info_lrg.gif,images/icon_members_lrg.gif,images/icon_sortdown.gif,images/icon_sortup.gif,images/icon_success_lrg.gif,images/icon_usergroups_lrg.gif,images/icon_arrowfolderopen2_sml.gif,images/icon_warning_lrg.gif,images/newwindow-classic.png,images/nw_maj_rond.gif,images/strich.gif,images/sw_maj_rond.gif,images/sw_med_rond.gif
 
-maven.javadoc.links=http://java.sun.com/products/j2se/1.4/docs/api
 maven.javadoc.author=false
+maven.javadoc.links=http://java.sun.com/j2se/1.4/docs/api/
+maven.javadoc.source=1.3
+maven.javadoc.overview=src/java/org/apache/commons/io/overview.html
 maven.javadoc.public=true
 maven.javadoc.protected=false
 maven.javadoc.package=false
 maven.javadoc.private=false
 
+maven.checkstyle.properties=checkstyle.xml
+
+maven.jdiff.new.tag=CURRENT
+maven.jdiff.old.tag=PRIMITIVES_1_0
+
+# Generate class files for specific VM version (e.g., 1.1 or 1.2). 
+# Note that the default value depends on the JVM that is running Ant. 
+# In particular, if you use JDK 1.4+ the generated classes will not be usable
+# for a 1.1 Java VM unless you explicitly set this attribute to the value 1.1 
+# (which is the default value for JDK 1.1 to 1.3).
+maven.compile.target = 1.1
+
+# Specifies the source version for the Java compiler.
+# Corresponds to the source attribute for the ant javac task. 
+# Valid values are 1.3, 1.4, 1.5. 
+maven.compile.source = 1.3
+
+maven.junit.fork=true

Modified: jakarta/commons/proper/primitives/trunk/project.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/primitives/trunk/project.xml?rev=344280&r1=344279&r2=344280&view=diff
==============================================================================
--- jakarta/commons/proper/primitives/trunk/project.xml (original)
+++ jakarta/commons/proper/primitives/trunk/project.xml Mon Nov 14 16:23:07 2005
@@ -16,12 +16,13 @@
 -->
 <project>
   <pomVersion>3</pomVersion>
-  
-  <id>commons-primitives</id>
+
+  <groupId>commons-primitives</groupId>
+  <artifactId>commons-primitives</artifactId>
   <name>Commons Primitives</name>
-  <currentVersion>1.1-dev</currentVersion>
+  <currentVersion>1.1-SNAPSHOT</currentVersion>
   <inceptionYear>2002</inceptionYear>
-  <shortDescription>Apache Jakarta Commons Primitives</shortDescription>
+  <shortDescription>Commons Primitives</shortDescription>
   <description>
     Commons Primitives is a set of collection and utility classes for primitive types.
     The Java language has a clear distinction between Object and primitive types.
@@ -30,9 +31,9 @@
     This package addresses this by providing a set of utility and collection classes for
primitives.
   </description>
   <logo>/images/logo.png</logo>
-  
-  <url>http://jakarta.apache.org/commons/${pom.artifactId.substring(8)}/</url>
-  <package>org.apache.commons.${pom.artifactId.substring(8)}</package>
+
+  <url>http://jakarta.apache.org/commons/primitives/</url>
+  <package>org.apache.commons.collections.primitives</package>
 
   <organization>
     <name>The Apache Software Foundation</name>
@@ -50,13 +51,13 @@
   
   <gumpRepositoryId>jakarta</gumpRepositoryId>
   <issueTrackingUrl>http://issues.apache.org/bugzilla/</issueTrackingUrl>
-  <siteAddress>jakarta.apache.org</siteAddress>
-  <siteDirectory>/www/jakarta.apache.org/commons/${pom.artifactId.substring(8)}/</siteDirectory>
-  <distributionDirectory>/www/jakarta.apache.org/builds/jakarta-commons/${pom.artifactId.substring(8)}/</distributionDirectory>
+  <siteAddress>people.apache.org</siteAddress>
+  <siteDirectory>/www/jakarta.apache.org/commons/primitives/</siteDirectory>
+  <distributionDirectory>/www/jakarta.apache.org/builds/jakarta-commons/primitives/</distributionDirectory>
   
   <repository>
-    <connection>scm:svn:http://svn.apache.org/repos/asf/jakarta/commons/proper/${pom.artifactId.substring(8)}/trunk</connection>
-    <url>http://svn.apache.org/repos/asf/jakarta/commons/proper/${pom.artifactId.substring(8)}/trunk</url>
+    <connection>scm:svn:http://svn.apache.org/repos/asf/jakarta/commons/proper/primitives/trunk</connection>
+    <url>http://svn.apache.org/repos/asf/jakarta/commons/proper/primitives/trunk</url>
   </repository>
   
   <mailingLists>
@@ -104,25 +105,31 @@
   </contributors>
 
   <dependencies>
-    <!-- compile time dependencies -->
     <dependency>
-      <id>junit</id>
+      <groupId>junit</groupId>
+      <artifactId>junit</artifactId>
       <version>3.8.1</version>
       <url>http://www.junit.org/</url>
+      <properties>
+        <scope>test</scope>
+          <comment>
+              &lt;strong&gt;Test Only&lt;/strong&gt; - required only for
+              running the Primitives unit tests
+          </comment>
+      </properties>
     </dependency>
     <dependency>
-      <id>commons-collections:commons-collections-testframework</id>
+      <groupId>commons-collections</groupId>
+      <artifactId>commons-collections-testframework</artifactId>
       <version>3.1</version>
       <url>http://jakarta.apache.org/commons/collections/</url>
-    </dependency>
-
-    <!-- run time dependencies -->
-    <!-- none currently -->
-    
-    <!-- maven dependencies -->
-    <dependency>
-      <id>jdepend</id>
-      <version>2.5</version>
+      <properties>
+        <scope>test</scope>
+          <comment>
+              &lt;strong&gt;Test Only&lt;/strong&gt; - required only for
+              running the Primitives unit tests
+          </comment>
+      </properties>
     </dependency>
   </dependencies>
 
@@ -149,6 +156,6 @@
     <report>maven-license-plugin</report>
     <report>maven-tasklist-plugin</report>
   </reports>
-  
+
 </project>
 

Added: jakarta/commons/proper/primitives/trunk/xdocs/cvs-usage.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/primitives/trunk/xdocs/cvs-usage.xml?rev=344280&view=auto
==============================================================================
--- jakarta/commons/proper/primitives/trunk/xdocs/cvs-usage.xml (added)
+++ jakarta/commons/proper/primitives/trunk/xdocs/cvs-usage.xml Mon Nov 14 16:23:07 2005
@@ -0,0 +1,44 @@
+<?xml version="1.0"?>
+<!--
+Copyright 2005 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.
+-->
+<document>
+ <properties>
+  <title>Source repository</title>
+  <author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author>
+ </properties>
+ <body>
+<!-- ================================================== -->
+<section name="Source repository">
+<p>
+  Jakarta Commons Primitives is hosted on the Apache
+  <a href="http://subversion.tigris.org/">subversion</a> repository.
+</p>
+<p>
+  The project URL is:<br />
+  <code>http://svn.apache.org/repos/asf/jakarta/commons/proper/primitives/trunk</code>
+</p>
+<p>
+  The best way to view the repository is via the
+  <a href="http://svn.apache.org/viewcvs.cgi/jakarta/commons/proper/primitives/trunk/">subversion
viewer</a>.
+</p>
+<p>
+  The alternative is to use the
+  <a href="http://svn.apache.org/repos/asf/jakarta/commons/proper/primitives/trunk/">native
subversion</a> display.
+</p>
+</section>
+<!-- ================================================== -->
+</body>
+</document>

Propchange: jakarta/commons/proper/primitives/trunk/xdocs/cvs-usage.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Modified: jakarta/commons/proper/primitives/trunk/xdocs/faq.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/primitives/trunk/xdocs/faq.xml?rev=344280&r1=344279&r2=344280&view=diff
==============================================================================
--- jakarta/commons/proper/primitives/trunk/xdocs/faq.xml (original)
+++ jakarta/commons/proper/primitives/trunk/xdocs/faq.xml Mon Nov 14 16:23:07 2005
@@ -1,6 +1,6 @@
 <?xml version="1.0"?>
 <!--
-   Copyright 2003-2004 The Apache Software Foundation
+   Copyright 2003-2005 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.
@@ -18,13 +18,13 @@
 <document>
 
  <properties>
-  <title>Commons Primitives: FAQ</title>
+  <title>FAQ</title>
   <author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author>
  </properties>
 
  <body>
 
-<section name="The Primitives Component">
+<section name="FAQ">
 <dl>
 <dt>Q: Why would I use the primitive collections?</dt>
 <dd>
@@ -130,7 +130,7 @@
 </p>
 </dd>
 
-<dt>Q: Won't this functionality be available in JDK 1.5 using auto-boxing and generics?</dt>
+<dt>Q: Isn't this functionality available in JDK 1.5 using auto-boxing and generics?</dt>
 <dd>
 <p>
 No.
@@ -140,7 +140,7 @@
 implemenation.  Since the distinction between Java primitives and Java Objects is not going
away, it will
 not be possible to, for example, instantiate a List of ints from that same prototype.
 </p><p>
-Using autoboxing, it will be possible to emulate the syntax of using the primitive collections.
+Using autoboxing, it is possible to emulate the syntax of using the primitive collections.
 For example, <code>list.add(19)</code> will work equally well whether <code>list</code>
is a List or IntList,
 since the compiler will automatically convert <code>list.add(19)</code> into
<code>list.add(new Integer(19))</code>.
 </p><p>

Modified: jakarta/commons/proper/primitives/trunk/xdocs/index.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/primitives/trunk/xdocs/index.xml?rev=344280&r1=344279&r2=344280&view=diff
==============================================================================
--- jakarta/commons/proper/primitives/trunk/xdocs/index.xml (original)
+++ jakarta/commons/proper/primitives/trunk/xdocs/index.xml Mon Nov 14 16:23:07 2005
@@ -1,6 +1,6 @@
 <?xml version="1.0"?>
 <!--
-   Copyright 2003-2004 The Apache Software Foundation
+   Copyright 2003-2005 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.
@@ -14,89 +14,80 @@
    See the License for the specific language governing permissions and
    limitations under the License.
 -->
-
 <document>
-
  <properties>
   <title>Apache Jakarta Commons Primitives</title>
   <author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author>
  </properties>
-
- <body>
-
-<section name="The Primitives Component">
+<body>
+<!-- ================================================== -->
+<section name="Commons Primitives">
+<p>
+The Java language is mostly Object based, however the original designers chose
+to include eight primitive types - boolean, byte, char, double, float, int, long and short.
+Commons Primitives provides a library of collections and utilities specially
+designed for use with primitive types.
+</p>
 <p>
-Apache Jakarta Commons Primitives provides a collection of types and utilities optimized
-for working with Java primitives (boolean, byte, char, double, float, int, long, short).
-Generally, the Commons-Primitives classes are smaller, faster and easier to work with than
+JDK 1.5 added auto-boxing to simplify working with primitive types.
+This is simply a mechanism of automatically converting a primitive to an Object
+and vice versa, an operation with potentially large memory and performance issues.
+Commons Primitives offers collections that hold the primitive type directly, and
+as a result they are usually smaller, faster and easier to work with than
 their purely Object based alternatives.
 </p>
 </section>
-
-<section name="Status">
+<!-- ================================================== -->
+<section name="Documentation">
+<p>
+A getting started <a href="userguide.html">user guide</a> is available,
+along with a <a href="faq.html">FAQ</a>.
+Also online are various <a href="maven-reports.html">project reports</a>.
+</p>
 <p>
-The most recent stable release is version 1.0, released 5 November 2003.  
-<a href="http://jakarta.apache.org/site/binindex.cgi#commons-primitives">Binary</a>
and
-<a href="http://jakarta.apache.org/site/sourceindex.cgi#commons-primitives">source</a>
distributions are available.
-</p><p>
-Daily builds and tarballs are available from
-<a href="http://cvs.apache.org/builds/jakarta-commons/nightly/commons-primitives/">http://cvs.apache.org/builds/jakarta-commons/nightly/commons-primitives/</a>.
+The JavaDoc API documents are available online:
+</p>
+<ul>
+<li>The <a href="api-release/index.html">current release 1.0</a></li>
+<!--li>The <a href="api-1.0/index.html">previous version 1.0</a></li-->
+<li>The <a href="apidocs/index.html">latest SVN</a></li>
+</ul>
+<p>
+The <a href="cvs-usage.html">subversion repository</a> can be
+<a href="http://svn.apache.org/viewcvs.cgi/jakarta/commons/proper/primitives/trunk/">browsed</a>.
 </p>
 </section>
-
-<section name="Overview">
+<!-- ================================================== -->
+<section name="Releases">
 <p>
-Currently Commons Primitives is primarily composed of implementations of the 
-java.util collections adapted for the primitive types.
+The latest version is v1.0, released 5 November 2003. - 
+<a href="http://jakarta.apache.org/site/downloads/downloads_commons-primitives.cgi">Download
now!</a><br />
+<!--The <a href="upgradeto1_1.html">upgrade notes</a> are also available.-->
 </p>
-<blockquote>
-<dl>
-<dt>org.apache.commons.collections.primitives</dt>
-<dd>
-<p>Contains interfaces, base classes and concrete implementations for primitive collections.</p>
-<dl>
-<dt>&lt;Type&gt;Collection</dt><dd>The java.util.Collection interface
adapted for the primitive type &lt;Type&gt;</dd>
-<dt>&lt;Type&gt;Iterator</dt><dd>The java.util.Iterator interface
adapted for the primitive type &lt;Type&gt;</dd>
-<dt>&lt;Type&gt;List</dt><dd>The java.util.List interface adapted
for the primitive type &lt;Type&gt;</dd>
-<dt>&lt;Type&gt;ListIterator</dt><dd>The java.util.ListIterator
interface adapted for the primitive type &lt;Type&gt;</dd>
-<dt>Abstract&lt;Type&gt;Collection</dt><dd>An abstract base for
&lt;Type&gt;Collection implementations</dd>
-<dt>RandomAccess&lt;Type&gt;List</dt><dd>An abstract base for &lt;Type&gt;List
implementations backed by random access data structures like arrays</dd>
-<dt>Array&lt;Type&gt;List</dt><dd>A &lt;Type&gt;List backed
by an array</dd>
-<dt>&lt;Type&gt;Collections</dt><dd>Static utility methods for
working with &lt;Type&gt;Collection instances</dd>
-</dl>  	
-</dd>
-
-<dt>org.apache.commons.collections.primitives.adapters</dt>
-<dd>
-<p>Contains adapters between the Object-based and primitive collections.</p>
-</dd>
-
-<dt>org.apache.commons.collections.primitives.adapters.io</dt>
-<dd>
-<p>Contains adapters that convert between I/O Streams/Readers and byte/char iterators.</p>
-</dd>
-
-<dt>org.apache.commons.collections.primitives.decorators</dt>
-<dd>
-<dl>
-<dt>Umodifiable&lt;Type&gt;List</dt><dd>Makes a &lt;Type&gt;List
unmodifiable</dd>
-<dt>Umodifiable&lt;Type&gt;Iterator</dt><dd>Makes a &lt;Type&gt;Iterator
unmodifiable</dd>
-<dt>Umodifiable&lt;Type&gt;ListIterator</dt><dd>Makes a &lt;Type&gt;ListIterator
unmodifiable</dd>
-</dl>
-</dd>
-
-</dl>
-</blockquote>
-
 <p>
-For more information on Commons Primitives, you might like to visit the 
-<a href="faq.html">FAQ</a>,
-<a href="./apidocs/index.html">JavaDocs</a>, <a href="./project-info.html">project
information</a>
-or <a href="./maven-reports.html">project reports</a>.
+The latest
+<a href="http://cvs.apache.org/builds/jakarta-commons/nightly/commons-primitives/">daily
build</a> is also available.
 </p>
-
+<!--p>
+For previous releases, see the <a href="http://archive.apache.org/dist/jakarta/commons/primitives/">Apache
Archive</a>
+</p-->
 </section>
-
+<!-- ================================================== -->
+<section name="Support">
+<p>
+The <a href="mail-lists.html">commons mailing lists</a> act as the main support
forum.
+The user list is suitable for most library usage queries.
+The dev list is intended for the development discussion.
+Please remember that the lists are shared between all commons components,
+so prefix your email by [primitives].
+</p>
+<p>
+Issues may be reported via <a href="issue-tracking.html">ASF Bugzilla</a>.
+Please remember that Bugzilla is shared between all commons components,
+so prefix your issue by [primitives].
+</p>
+</section>
+<!-- ================================================== -->
 </body>
 </document>
 

Added: jakarta/commons/proper/primitives/trunk/xdocs/issue-tracking.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/primitives/trunk/xdocs/issue-tracking.xml?rev=344280&view=auto
==============================================================================
--- jakarta/commons/proper/primitives/trunk/xdocs/issue-tracking.xml (added)
+++ jakarta/commons/proper/primitives/trunk/xdocs/issue-tracking.xml Mon Nov 14 16:23:07 2005
@@ -0,0 +1,61 @@
+<?xml version="1.0"?>
+<!--
+Copyright 2005 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.
+-->
+<document>
+ <properties>
+  <title>Issue tracking</title>
+  <author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author>
+ </properties>
+<body>
+<!-- ================================================== -->
+<section name="Issue tracking">
+<p>
+  Commons Primitives uses <a href="http://issues.apache.org/bugzilla/">ASF Bugzilla</a>
for tracking issues.
+  To use Bugzilla you may need to <a href="http://issues.apache.org/bugzilla/createaccount.cgi">create
an account</a>.
+</p>
+<p>
+  If you would like to report a bug, or raise an enhancement request with
+  Commons Primitives please do the following:
+  <ol>
+  <li><a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;bug_status=NEEDINFO&amp;product=Commons&amp;component=Primitives">Search
existing open bugs</a>.
+  If you find your issue listed then please add a comment with your details.</li>
+  <li><a href="http://mail-archives.apache.org/mod_mbox/jakarta-commons-dev/">Search
the mailing list archive</a>.
+  You may find your issue or idea has already been discussed.</li>
+  <li><a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Commons&amp;component=Primitives&amp;version=1.0%20Final">Submit
a bug report or enhancement request</a>.
+  Please prefix all new issues with [primitives] in the summary line.
+  </li>
+  </ol>
+</p>
+<p>
+  Please also remember these points:
+  <ul>
+  <li>the more information you provide, the better we can help you</li>
+  <li>test cases are vital, particularly for any proposed enhancements</li>
+  <li>the developers of Commons Primitives are all unpaid volunteers</li>
+  </ul>
+</p>
+<p>
+  You may also find these links useful:
+  <ul>
+  <li><a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;bug_status=NEEDINFO&amp;product=Commons&amp;component=Primitives">All
Open Primitives bugs</a></li>
+  <li><a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=RESOLVED&amp;bug_status=VERIFIED&amp;bug_status=CLOSED&amp;product=Commons&amp;component=Primitives">All
Closed Primitives bugs</a></li>
+  <li><a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;bug_status=NEEDINFO&amp;bug_status=RESOLVED&amp;bug_status=VERIFIED&amp;bug_status=CLOSED&amp;product=Commons&amp;component=Primitives">All
Primitives bugs</a></li>
+  </ul>
+</p>
+</section>
+<!-- ================================================== -->
+</body>
+</document>

Propchange: jakarta/commons/proper/primitives/trunk/xdocs/issue-tracking.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Modified: jakarta/commons/proper/primitives/trunk/xdocs/navigation.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/primitives/trunk/xdocs/navigation.xml?rev=344280&r1=344279&r2=344280&view=diff
==============================================================================
--- jakarta/commons/proper/primitives/trunk/xdocs/navigation.xml (original)
+++ jakarta/commons/proper/primitives/trunk/xdocs/navigation.xml Mon Nov 14 16:23:07 2005
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="ISO-8859-1"?>
 <!--
-   Copyright 2003-2004 The Apache Software Foundation
+   Copyright 2003-2005 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.
@@ -16,21 +16,33 @@
 -->
 <!DOCTYPE org.apache.commons.menus SYSTEM '../../commons-build/menus/menus.dtd'>
 <project name="Primitives">
+
   <title>Primitives</title>
-  <organizationLogo href="/images/jakarta-logo-blue.gif">Jakarta</organizationLogo>
-  <body> 
+
+  <body>
     <links>
       <item name="Jakarta Commons" href="http://jakarta.apache.org/commons/"/>
     </links>
 
     <menu name="Commons Primitives">
       <item name="Overview" href="/index.html"/>
+      <item name="Download" href="http://jakarta.apache.org/site/downloads/downloads_commons-primitives.cgi"/>
+      <item name="Users guide" href="/userguide.html"/>
       <item name="FAQ" href="/faq.html"/>
-      <item name="Javadoc" href="apidocs/index.html"/>
+      <item name="Javadoc (1.0 release)" href="api-release/index.html"/>
+    </menu>
+
+    <menu name="Development">
+      <!--item name="Building" href="/building.html"/-->
       <item name="Mailing lists" href="/mail-lists.html"/>
       <item name="Team" href="/team-list.html"/>
-      <item name="CVS" href="http://cvs.apache.org/viewcvs/jakarta-commons/primitives/"/>
+      <item name="Tasks" href="/tasks.html"/>
+      <item name="Proposal" href="/proposal.html"/>
+      <item name="SVN repository" href="http://svn.apache.org/viewcvs.cgi/jakarta/commons/proper/primitives/trunk/"/>
+      <item name="Javadoc (SVN latest)" href="apidocs/index.html"/>
     </menu>
+
     &common-menus;
+
   </body>
 </project>

Added: jakarta/commons/proper/primitives/trunk/xdocs/proposal.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/primitives/trunk/xdocs/proposal.xml?rev=344280&view=auto
==============================================================================
--- jakarta/commons/proper/primitives/trunk/xdocs/proposal.xml (added)
+++ jakarta/commons/proper/primitives/trunk/xdocs/proposal.xml Mon Nov 14 16:23:07 2005
@@ -0,0 +1,101 @@
+<?xml version="1.0"?>
+<?xml-stylesheet type="text/xsl" href="xdoc.xsl"?>
+<!--
+Copyright 2002-2005 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.
+-->
+<document>
+ <properties>
+  <title>Proposal</title>
+  <author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author>
+ </properties>
+<body>
+<!-- ================================================== -->
+<section name="Proposal for Primitives Component">
+<!-- ================================================== -->
+<subsection name="(0) Rationale">
+<p>
+The Java language has a fundamental distinction between Object and primitive
+types. The JDK provides many method for manipulating and working with
+Objects. However, there is relatively little support for working with
+primitive types.
+</p>
+<p>
+One key example is the Java Collection Framework. This defines a well-known
+and widely used API for object-based collections. The framework requires
+each primitive to be wrapped in an object, such as Integer, before they can
+be used in collections. This has a memory and performance overhead.
+</p>
+<p>
+The primitives component will provide an API for collections and utilities
+based on primitives. Wrappers and adaptors will be provided for integration
+with object-based APIs.
+</p>
+</subsection>
+<!-- ================================================== -->
+<subsection name="(1) Scope of the Package">
+<p>
+The package will create and maintain a set of collections and utilities for
+primitive types, distributed under the ASF license.
+</p>
+</subsection>
+<!-- ================================================== -->
+<subsection name="(1.5) Interaction With Other Packages">
+<p>
+<em>Primitives</em> relies only on standard JDK 1.2 (or later) APIs for
+production deployment.  It utilizes the JUnit unit testing framework for
+developing and executing unit tests, but this is of interest only to
+developers of the component.
+</p>
+<p>
+No external configuration files are utilized.
+</p>
+</subsection>
+<!-- ================================================== -->
+<subsection name="(2) Initial Source of the Package">
+<p>
+The initial codebase was harvested from code in the Commons Collections CVS.
+</p>
+<p>
+The proposed package name for the new component is
+<code>org.apache.commons.primitives</code>.
+</p>
+</subsection>
+<!-- ================================================== -->
+<subsection name="(3)  Required Jakarta-Commons Resources">
+<ul>
+<li>CVS Repository - New directory <code>primitives</code> in the
+    <code>jakarta-commons</code> CVS repository.</li>
+<li>Mailing List - Discussions will take place on the general
+    <em>commons-dev@jakarta.apache.org</em> mailing list.  To help
+    list subscribers identify messages of interest, it is suggested that
+    the message subject of messages about this component be prefixed with
+    [primitives].</li>
+<li>Bugzilla - New component "Primitives" under the "Commons" product
+    category, with appropriate version identifiers as needed.</li>
+<li>Jyve FAQ - New category "commons-primitives" (when available).</li>
+</ul>
+</subsection>
+<!-- ================================================== -->
+<subsection name="(4) Initial Committers">
+<ul>
+   <li>Rodney Waldhoff</li>
+   <li>Stephen Colebourne</li>
+</ul>
+</subsection>
+<!-- ================================================== -->
+</section>
+<!-- ================================================== -->
+</body>
+</document>

Propchange: jakarta/commons/proper/primitives/trunk/xdocs/proposal.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Added: jakarta/commons/proper/primitives/trunk/xdocs/tasks.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/primitives/trunk/xdocs/tasks.xml?rev=344280&view=auto
==============================================================================
--- jakarta/commons/proper/primitives/trunk/xdocs/tasks.xml (added)
+++ jakarta/commons/proper/primitives/trunk/xdocs/tasks.xml Mon Nov 14 16:23:07 2005
@@ -0,0 +1,35 @@
+<?xml version="1.0"?>
+<!--
+Copyright 2005 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.
+-->
+<document>
+ <properties>
+  <title>Tasks</title>
+  <author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author>
+ </properties>
+<body>
+<!-- ================================================== -->
+<section name="Tasks and Ideas for the future">
+<p>
+The following are some of the proposed ideas and tasks for commons-primitives:
+</p>
+<ul>
+<li>Set implementations</li>
+<li>Map implementations</li>
+</ul>
+</section>
+<!-- ================================================== -->
+</body>
+</document>

Propchange: jakarta/commons/proper/primitives/trunk/xdocs/tasks.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Added: jakarta/commons/proper/primitives/trunk/xdocs/userguide.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/primitives/trunk/xdocs/userguide.xml?rev=344280&view=auto
==============================================================================
--- jakarta/commons/proper/primitives/trunk/xdocs/userguide.xml (added)
+++ jakarta/commons/proper/primitives/trunk/xdocs/userguide.xml Mon Nov 14 16:23:07 2005
@@ -0,0 +1,78 @@
+<?xml version="1.0"?>
+<!--
+   Copyright 2005 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.
+-->
+<document>
+ <properties>
+  <title>User guide</title>
+  <author email="commons-dev@jakarta.apache.org">Commons Documentation Team</author>
+ </properties>
+<body>
+<!-- ================================================== -->
+<section name="User guide">
+<p>
+Commons Primitives provides collections implementations and utilities
+for each of the primitive types.
+This guide outlines the naming convention used.
+</p>
+<!-- ================================================== -->
+<blockquote>
+<dl>
+<!-- ================================================== -->
+<dt>org.apache.commons.collections.primitives</dt>
+<dd>
+<p>Contains interfaces, base classes and concrete implementations for primitive collections.</p>
+<dl>
+<dt>&lt;Type&gt;Collection</dt><dd>The java.util.Collection interface
adapted for the primitive type &lt;Type&gt;</dd>
+<dt>&lt;Type&gt;Iterator</dt><dd>The java.util.Iterator interface
adapted for the primitive type &lt;Type&gt;</dd>
+<dt>&lt;Type&gt;List</dt><dd>The java.util.List interface adapted
for the primitive type &lt;Type&gt;</dd>
+<dt>&lt;Type&gt;ListIterator</dt><dd>The java.util.ListIterator
interface adapted for the primitive type &lt;Type&gt;</dd>
+<dt>Abstract&lt;Type&gt;Collection</dt><dd>An abstract base for
&lt;Type&gt;Collection implementations</dd>
+<dt>RandomAccess&lt;Type&gt;List</dt><dd>An abstract base for &lt;Type&gt;List
implementations backed by random access data structures like arrays</dd>
+<dt>Array&lt;Type&gt;List</dt><dd>A &lt;Type&gt;List backed
by an array</dd>
+<dt>&lt;Type&gt;Collections</dt><dd>Static utility methods for
working with &lt;Type&gt;Collection instances</dd>
+</dl>  	
+</dd>
+<!-- ================================================== -->
+<dt>org.apache.commons.collections.primitives.adapters</dt>
+<dd>
+<p>Contains adapters between the Object-based and primitive collections.</p>
+</dd>
+
+<dt>org.apache.commons.collections.primitives.adapters.io</dt>
+<dd>
+<p>Contains adapters that convert between I/O Streams/Readers and byte/char iterators.</p>
+</dd>
+<!-- ================================================== -->
+<dt>org.apache.commons.collections.primitives.decorators</dt>
+<dd>
+<dl>
+<dt>Umodifiable&lt;Type&gt;List</dt><dd>Makes a &lt;Type&gt;List
unmodifiable</dd>
+<dt>Umodifiable&lt;Type&gt;Iterator</dt><dd>Makes a &lt;Type&gt;Iterator
unmodifiable</dd>
+<dt>Umodifiable&lt;Type&gt;ListIterator</dt><dd>Makes a &lt;Type&gt;ListIterator
unmodifiable</dd>
+</dl>
+</dd>
+<!-- ================================================== -->
+</dl>
+</blockquote>
+<!-- ================================================== -->
+<p>
+For more information on Commons Primitives, you might like to visit the 
+<a href="faq.html">FAQ</a> or <a href="api-release/index.html">javadoc</a>.
+</p>
+</section>
+<!-- ================================================== -->
+</body>
+</document>

Propchange: jakarta/commons/proper/primitives/trunk/xdocs/userguide.xml
------------------------------------------------------------------------------
    svn:eol-style = native



---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org


Mime
View raw message