You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by ni...@apache.org on 2005/11/23 02:17:37 UTC
svn commit: r348333 - in /jakarta/commons/proper/resources/trunk: maven.xml
project.xml xdocs/cvs-usage.xml xdocs/downloads.xml xdocs/index.xml
xdocs/issue-tracking.xml xdocs/navigation.xml xdocs/todo.xml
Author: niallp
Date: Tue Nov 22 17:17:22 2005
New Revision: 348333
URL: http://svn.apache.org/viewcvs?rev=348333&view=rev
Log:
Improve Commons Resources site and add missing license headers:
* add support, releases and documentation sections to home page
* add improved "Issue Tracking" page
* add improved "Source Repository" page (cvs-usage.xml)
* add "Downloads" page and include on the project menu
Added:
jakarta/commons/proper/resources/trunk/xdocs/cvs-usage.xml (with props)
jakarta/commons/proper/resources/trunk/xdocs/downloads.xml (with props)
jakarta/commons/proper/resources/trunk/xdocs/issue-tracking.xml (with props)
Modified:
jakarta/commons/proper/resources/trunk/maven.xml
jakarta/commons/proper/resources/trunk/project.xml
jakarta/commons/proper/resources/trunk/xdocs/index.xml
jakarta/commons/proper/resources/trunk/xdocs/navigation.xml
jakarta/commons/proper/resources/trunk/xdocs/todo.xml
Modified: jakarta/commons/proper/resources/trunk/maven.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/resources/trunk/maven.xml?rev=348333&r1=348332&r2=348333&view=diff
==============================================================================
--- jakarta/commons/proper/resources/trunk/maven.xml (original)
+++ jakarta/commons/proper/resources/trunk/maven.xml Tue Nov 22 17:17:22 2005
@@ -1,7 +1,40 @@
+<!--
+ Copyright 2004-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.
+-->
+
<project default="jar:jar"
xmlns:j="jelly:core"
xmlns:ant="jelly:ant">
+ <!-- ================================================================== -->
+ <!-- START : C O M M O N S - B U I L D -->
+ <!-- ================================================================== -->
+ <!-- Required: Look and Feel for documentation within distributions -->
+ <!-- ================================================================== -->
+ <postGoal name="xdoc:copy-resources">
+ <copy todir="${maven.build.dir}/docs/style/" failonerror="false">
+ <fileset dir="${basedir}/../commons-build/xdocs/style">
+ <include name='**/*'/>
+ <exclude name='**/CVS/**'/>
+ </fileset>
+ </copy>
+ </postGoal>
+ <!-- ================================================================== -->
+ <!-- END: C O M M O N S - B U I L D -->
+ <!-- ================================================================== -->
+
<postGoal name="jar:jar">
<ant:jar destfile="${maven.build.dir}/commons-resources-tests.jar">
<fileset dir="${maven.build.dir}/test-classes"/>
Modified: jakarta/commons/proper/resources/trunk/project.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/resources/trunk/project.xml?rev=348333&r1=348332&r2=348333&view=diff
==============================================================================
--- jakarta/commons/proper/resources/trunk/project.xml (original)
+++ jakarta/commons/proper/resources/trunk/project.xml Tue Nov 22 17:17:22 2005
@@ -43,6 +43,7 @@
</license>
</licenses>
<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>
Added: jakarta/commons/proper/resources/trunk/xdocs/cvs-usage.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/resources/trunk/xdocs/cvs-usage.xml?rev=348333&view=auto
==============================================================================
--- jakarta/commons/proper/resources/trunk/xdocs/cvs-usage.xml (added)
+++ jakarta/commons/proper/resources/trunk/xdocs/cvs-usage.xml Tue Nov 22 17:17:22 2005
@@ -0,0 +1,45 @@
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+<!--
+ 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 Resources 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/resources/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/resources/trunk/">subversion viewer</a>.
+</p>
+<p>
+ The alternative is to use the
+ <a href="http://svn.apache.org/repos/asf/jakarta/commons/proper/resources/trunk/">native subversion</a> display.
+</p>
+</section>
+<!-- ================================================== -->
+</body>
+</document>
\ No newline at end of file
Propchange: jakarta/commons/proper/resources/trunk/xdocs/cvs-usage.xml
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: jakarta/commons/proper/resources/trunk/xdocs/cvs-usage.xml
------------------------------------------------------------------------------
svn:keywords = Date Author Id Revision HeadURL
Added: jakarta/commons/proper/resources/trunk/xdocs/downloads.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/resources/trunk/xdocs/downloads.xml?rev=348333&view=auto
==============================================================================
--- jakarta/commons/proper/resources/trunk/xdocs/downloads.xml (added)
+++ jakarta/commons/proper/resources/trunk/xdocs/downloads.xml Tue Nov 22 17:17:22 2005
@@ -0,0 +1,51 @@
+<?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>Downloads</title>
+ </properties>
+
+ <body>
+ <section name="Download Resources">
+
+ <subsection name="Releases">
+ <p>Download the <a href="http://jakarta.apache.org/site/downloads/downloads_commons-resources.cgi">Latest Release</a>
+ of Commons Resources.
+ </p>
+ </subsection>
+
+ <subsection name="Nightly Builds">
+ <p>
+ <a href="http://cvs.apache.org/builds/jakarta-commons/nightly/commons-resources/">Nightly Builds</a>
+ are built once a day from the current SVN HEAD. This is (nearly) the latest code and so should
+ be treated with caution.
+ </p>
+ </subsection>
+
+ <subsection name="Archived Releases">
+ <p>
+ Older releases are retained by the Apache Software Foundation but are
+ moved into a
+ <a href="http://archive.apache.org/dist/jakarta/commons/resources/">
+ special archive area</a>.
+ </p>
+ </subsection>
+
+ </section>
+
+ </body>
+</document>
Propchange: jakarta/commons/proper/resources/trunk/xdocs/downloads.xml
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: jakarta/commons/proper/resources/trunk/xdocs/downloads.xml
------------------------------------------------------------------------------
svn:keywords = Date Author Id Revision HeadURL
Modified: jakarta/commons/proper/resources/trunk/xdocs/index.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/resources/trunk/xdocs/index.xml?rev=348333&r1=348332&r2=348333&view=diff
==============================================================================
--- jakarta/commons/proper/resources/trunk/xdocs/index.xml (original)
+++ jakarta/commons/proper/resources/trunk/xdocs/index.xml Tue Nov 22 17:17:22 2005
@@ -1,4 +1,19 @@
<?xml version="1.0"?>
+<!--
+ 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>
@@ -52,16 +67,6 @@
<code>java.util.PropertyResourceBundle</code> class of the standard APIs.</p>
</section>
-
-<section name="Interaction With Other Packages">
-
-<p><em>Resource</em> relies on the standard JDK 1.2 (or later) APIs, plus
-the <code>Collections</code> package from Jakarta Commons.</p>
-
-<p>No external configuration files are utilized.</p>
-</section>
-
-
<section name="Initial Source of the Package">
<p>The four original Java classes (<code>MessageResources</code>,
@@ -76,6 +81,46 @@
<p>The proposed package name for the new component is
<code>org.apache.commons.resources</code>.</p>
+</section>
+
+<section name="Documentation">
+ <p>
+ The JavaDoc API documents are available <a href="apidocs/index.html">here</a>.
+ </p>
+ <p>
+ The following versions of the JavaDoc API documents are available online:
+ </p>
+ <ul>
+ <li>The <a href="http://jakarta.apache.org/commons/resources/api-release/">Current Release</a></li>
+ <li>The <a href="http://jakarta.apache.org/commons/resources/apidocs/">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/resources/trunk/">browsed</a>.
+ </p>
+</section>
+
+<section name="Releases">
+ <p>See the <a href="downloads.html">Downloads</a> page for current/previous
+ releases.
+ </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 [resources].
+ </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 [resources].
+ </p>
</section>
</body>
Added: jakarta/commons/proper/resources/trunk/xdocs/issue-tracking.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/resources/trunk/xdocs/issue-tracking.xml?rev=348333&view=auto
==============================================================================
--- jakarta/commons/proper/resources/trunk/xdocs/issue-tracking.xml (added)
+++ jakarta/commons/proper/resources/trunk/xdocs/issue-tracking.xml Tue Nov 22 17:17:22 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 Resources 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 Resources 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=Resources">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&version=unspecified&component=Resources&rep_platform=All&op_sys=All&priority=P1&bug_severity=normal&bug_status=NEW&assigned_to=commons-dev%40jakarta.apache.org&short_desc=%5Bresources%5D%20%22Your%20subject%20heading%20here%22&comment=Please%20provide%20details%20here.%20Its%20best%20to%20submit%20patches%20that%20alter%0D%0Aexisting%20file%20content%20in%20%22unified%20cvs%20diff%22%20format.%20%0D%0A%0D%0ASubmissions%20that%20provide%20new%20files%20can%20be%20supplied%20as%20direct%20file%0D%0Aattachments%20or%20archives%20in%20zip%20or%20tar.gz%20format.%20please%20be%20kind%20%0D%0Aenough%20to%20identify%20the%20format%20of%20the%20attached%20archive%20as%20bugzilla%0D%0Atends%20to%20strip%20these%20characterstics%20by%20removing%20the%20files%20extension.&commentprivacy=0&form_name=enter_bug">Submit a bug report or enhancement request</a>.
+ Please prefix all new issues with [resources] 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 Resources 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=Resources">All Open Resources 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=Resources">All Closed Resources 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=Resources">All Resources bugs</a></li>
+ </ul>
+</p>
+</section>
+<!-- ================================================== -->
+</body>
+</document>
Propchange: jakarta/commons/proper/resources/trunk/xdocs/issue-tracking.xml
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: jakarta/commons/proper/resources/trunk/xdocs/issue-tracking.xml
------------------------------------------------------------------------------
svn:keywords = Date Author Id Revision HeadURL
Modified: jakarta/commons/proper/resources/trunk/xdocs/navigation.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/resources/trunk/xdocs/navigation.xml?rev=348333&r1=348332&r2=348333&view=diff
==============================================================================
--- jakarta/commons/proper/resources/trunk/xdocs/navigation.xml (original)
+++ jakarta/commons/proper/resources/trunk/xdocs/navigation.xml Tue Nov 22 17:17:22 2005
@@ -1,6 +1,7 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE org.apache.commons.menus SYSTEM '../../commons-build/menus/menus.dtd'>
<!--
- 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.
@@ -15,15 +16,26 @@
limitations under the License.
-->
-<!DOCTYPE project SYSTEM '../../commons-build/menus/menus.dtd'>
<project name="Commons Resources">
<title>Commons Resources</title>
+ <organizationLogo href="/images/jakarta-logo-blue.gif">Jakarta</organizationLogo>
+
<body>
+ <links>
+ <item name="Jakarta"
+ href="http://jakarta.apache.org"/>
+ <item name="Jakarta Commons"
+ href="http://jakarta.apache.org/commons/"/>
+ </links>
+
<menu name="Commons Resources">
<item name="Overview" href="/index.html"/>
+ <item name="Downloads" href="/downloads.html"/>
<item name="To Do List" href="/todo.html"/>
<item name="Javadoc" href="/apidocs/index.html"/>
</menu>
+
&common-menus;
+
</body>
</project>
Modified: jakarta/commons/proper/resources/trunk/xdocs/todo.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/resources/trunk/xdocs/todo.xml?rev=348333&r1=348332&r2=348333&view=diff
==============================================================================
--- jakarta/commons/proper/resources/trunk/xdocs/todo.xml (original)
+++ jakarta/commons/proper/resources/trunk/xdocs/todo.xml Tue Nov 22 17:17:22 2005
@@ -1,4 +1,19 @@
<?xml version="1.0"?>
+<!--
+ 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>
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org