You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by sc...@apache.org on 2005/11/15 01:23:16 UTC
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
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>
+ <strong>Test Only</strong> - 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>
+ <strong>Test Only</strong> - 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><Type>Collection</dt><dd>The java.util.Collection interface adapted for the primitive type <Type></dd>
-<dt><Type>Iterator</dt><dd>The java.util.Iterator interface adapted for the primitive type <Type></dd>
-<dt><Type>List</dt><dd>The java.util.List interface adapted for the primitive type <Type></dd>
-<dt><Type>ListIterator</dt><dd>The java.util.ListIterator interface adapted for the primitive type <Type></dd>
-<dt>Abstract<Type>Collection</dt><dd>An abstract base for <Type>Collection implementations</dd>
-<dt>RandomAccess<Type>List</dt><dd>An abstract base for <Type>List implementations backed by random access data structures like arrays</dd>
-<dt>Array<Type>List</dt><dd>A <Type>List backed by an array</dd>
-<dt><Type>Collections</dt><dd>Static utility methods for working with <Type>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<Type>List</dt><dd>Makes a <Type>List unmodifiable</dd>
-<dt>Umodifiable<Type>Iterator</dt><dd>Makes a <Type>Iterator unmodifiable</dd>
-<dt>Umodifiable<Type>ListIterator</dt><dd>Makes a <Type>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&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=NEEDINFO&product=Commons&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&component=Primitives&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&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=NEEDINFO&product=Commons&component=Primitives">All Open Primitives bugs</a></li>
+ <li><a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&product=Commons&component=Primitives">All Closed Primitives bugs</a></li>
+ <li><a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=NEEDINFO&bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&product=Commons&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><Type>Collection</dt><dd>The java.util.Collection interface adapted for the primitive type <Type></dd>
+<dt><Type>Iterator</dt><dd>The java.util.Iterator interface adapted for the primitive type <Type></dd>
+<dt><Type>List</dt><dd>The java.util.List interface adapted for the primitive type <Type></dd>
+<dt><Type>ListIterator</dt><dd>The java.util.ListIterator interface adapted for the primitive type <Type></dd>
+<dt>Abstract<Type>Collection</dt><dd>An abstract base for <Type>Collection implementations</dd>
+<dt>RandomAccess<Type>List</dt><dd>An abstract base for <Type>List implementations backed by random access data structures like arrays</dd>
+<dt>Array<Type>List</dt><dd>A <Type>List backed by an array</dd>
+<dt><Type>Collections</dt><dd>Static utility methods for working with <Type>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<Type>List</dt><dd>Makes a <Type>List unmodifiable</dd>
+<dt>Umodifiable<Type>Iterator</dt><dd>Makes a <Type>Iterator unmodifiable</dd>
+<dt>Umodifiable<Type>ListIterator</dt><dd>Makes a <Type>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