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: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]