commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From nia...@apache.org
Subject 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
Date Wed, 23 Nov 2005 01:17:37 GMT
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&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;bug_status=NEEDINFO&amp;product=Commons&amp;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&amp;version=unspecified&amp;component=Resources&amp;rep_platform=All&amp;op_sys=All&amp;priority=P1&amp;bug_severity=normal&amp;bug_status=NEW&amp;assigned_to=commons-dev%40jakarta.apache.org&amp;short_desc=%5Bresources%5D%20%22Your%20subject%20heading%20here%22&amp;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.&amp;commentprivacy=0&amp;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&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;bug_status=NEEDINFO&amp;product=Commons&amp;component=Resources">All
Open Resources 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=Resources">All
Closed Resources 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=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&#xA0;Resources">
   <title>Commons&#xA0;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&#xA0;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


Mime
View raw message