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/14 04:18:46 UTC
svn commit: r344027 - in /jakarta/commons/proper/validator/trunk/xdocs:
changes.xml cvs-usage.xml downloads.xml index.xml issue-tracking.xml
navigation.xml
Author: niallp
Date: Sun Nov 13 19:18:35 2005
New Revision: 344027
URL: http://svn.apache.org/viewcvs?rev=344027&view=rev
Log:
Update Validator site as per suggestions from Stephen Colebourne on Vaidator 1.2.0 RC3.
* Add entry for changes to dependencies to the Change Log
* Improve Validator home page to include release, javadoc and support information (based on Commons IO style)
* Improve "Source Repository" information (based on Commons IO style)
* Add "Issue Tracking" page (based on Commons IO style)
* Improve "Downloads" page
* Add links to the "Release Notes" on the Commons Wiki to the home and download pages
Added:
jakarta/commons/proper/validator/trunk/xdocs/issue-tracking.xml (with props)
Modified:
jakarta/commons/proper/validator/trunk/xdocs/changes.xml
jakarta/commons/proper/validator/trunk/xdocs/cvs-usage.xml
jakarta/commons/proper/validator/trunk/xdocs/downloads.xml
jakarta/commons/proper/validator/trunk/xdocs/index.xml
jakarta/commons/proper/validator/trunk/xdocs/navigation.xml
Modified: jakarta/commons/proper/validator/trunk/xdocs/changes.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/validator/trunk/xdocs/changes.xml?rev=344027&r1=344026&r2=344027&view=diff
==============================================================================
--- jakarta/commons/proper/validator/trunk/xdocs/changes.xml (original)
+++ jakarta/commons/proper/validator/trunk/xdocs/changes.xml Sun Nov 13 19:18:35 2005
@@ -38,10 +38,20 @@
</properties>
<body>
- <release version="1.2.0 (alpha)" date="in SVN">
+ <release version="1.2.0 (RC3)" date="2005-11-02">
<action dev="dgraham" type="add">
Added ISBNValidator for validating book numbers.
<a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=31489">PR# 31489</a>
+ </action>
+ <action dev="dgraham" type="update">
+ Upgrade dependency versions to
+ <a href="http://jakarta.apache.org/commons/beanutils/">Commons BeanUtils</a> 1.7.0,
+ <a href="http://jakarta.apache.org/commons/digester/">Commons Digester</a> 1.6
+ and <a href="http://jakarta.apache.org/commons/logging/">Commons Logging</a> 1.0.4.
+ Remove dependency on
+ <a href="http://jakarta.apache.org/commons/beanutils/">Commons Collections</a>
+ (BeanUtils 1.7.0 has removed its dependency on Collections by including the
+ few Collections classes required in its distribution).
</action>
<action dev="husted" type="add">
Add support for min or max numeric values.
Modified: jakarta/commons/proper/validator/trunk/xdocs/cvs-usage.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/validator/trunk/xdocs/cvs-usage.xml?rev=344027&r1=344026&r2=344027&view=diff
==============================================================================
--- jakarta/commons/proper/validator/trunk/xdocs/cvs-usage.xml (original)
+++ jakarta/commons/proper/validator/trunk/xdocs/cvs-usage.xml Sun Nov 13 19:18:35 2005
@@ -18,20 +18,30 @@
-->
<document>
- <properties>
- <title key="template.cvs_usage.title"
- bundle="plugin-resources.templates.templates" >
- <message key="template.cvs_usage.title"
- bundle="plugin-resources.templates.templates" />
- </title>
- </properties>
- <body>
- <section key="template.cvs_usage.section2.title"
- bundle="plugin-resources.templates.templates"
- name="Web Access">
- <p>
- <a href="http://svn.apache.org/repos/asf/jakarta/commons/proper/validator/trunk">http://svn.apache.org/repos/asf/jakarta/commons/proper/validator/trunk</a>
- </p>
- </section>
- </body>
+ <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 Validator 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/validator/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/validator/trunk/">subversion viewer</a>.
+</p>
+<p>
+ The alternative is to use the
+ <a href="http://svn.apache.org/repos/asf/jakarta/commons/proper/validator/trunk/">native subversion</a> display.
+</p>
+</section>
+<!-- ================================================== -->
+</body>
</document>
Modified: jakarta/commons/proper/validator/trunk/xdocs/downloads.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/validator/trunk/xdocs/downloads.xml?rev=344027&r1=344026&r2=344027&view=diff
==============================================================================
--- jakarta/commons/proper/validator/trunk/xdocs/downloads.xml (original)
+++ jakarta/commons/proper/validator/trunk/xdocs/downloads.xml Sun Nov 13 19:18:35 2005
@@ -20,34 +20,35 @@
</properties>
<body>
- <section name="Releases">
+ <section name="Download Validator">
- <p><strong>Latest Stable Release</strong></p>
- <ul>
- <li><a href="http://jakarta.apache.org/site/binindex.cgi#commons-validator">1.1.4 Binary</a></li>
- <li><a href="http://jakarta.apache.org/site/sourceindex.cgi#commons-validator">1.1.4 Source</a></li>
- </ul>
+ <subsection name="Releases">
+ <p>Download the <a href="http://jakarta.apache.org/site/downloads/downloads_commons-validator.cgi">Latest Release</a>
+ of Commons Validator.
+ </p>
+ <p>For details of whats new in each version see the <a href="changes-report.html">Release History</a>.</p>
+ <p>For a more descriptive explanation see the
+ <a href="http://wiki.apache.org/jakarta-commons/ValidatorReleaseNotes">Release Notes</a> maintained on
+ the <a href="http://wiki.apache.org/jakarta-commons/">Jakarta Commons Wiki</a>.
+ </p>
+ </subsection>
- <p><strong>Latest Development Release</strong></p>
- <ul>
- <li>None currently</li>
- </ul>
+ <subsection name="Nightly Builds">
+ <p>
+ <a href="http://cvs.apache.org/builds/jakarta-commons/nightly/commons-validator/">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>
- <p><strong>Nightly Builds</strong></p>
- <ul>
- <li><a href="http://cvs.apache.org/builds/jakarta-commons/nightly/commons-validator/">Binary/Source</a></li>
- </ul>
-
- <!--
- <p>
- <strong>Archived Releases</strong>
- <br/>
- Older releases are retained by the Apache Software Foundation but are
- moved into a
- <a href="http://archive.apache.org/dist/jakarta/commons/validator/">
+ <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/validator/">
special archive area</a>.
- </p>
- -->
+ </p>
+ </subsection>
</section>
Modified: jakarta/commons/proper/validator/trunk/xdocs/index.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/validator/trunk/xdocs/index.xml?rev=344027&r1=344026&r2=344027&view=diff
==============================================================================
--- jakarta/commons/proper/validator/trunk/xdocs/index.xml (original)
+++ jakarta/commons/proper/validator/trunk/xdocs/index.xml Sun Nov 13 19:18:35 2005
@@ -18,12 +18,12 @@
<document>
<properties>
- <title>Commons</title>
+ <title>Commons Validator</title>
</properties>
<body>
- <section name="Introduction">
+ <section name="Commons Validator">
<p>
A common issue when receiving data either electronically or from
@@ -34,36 +34,21 @@
This package addresses some of these issues to
speed development and maintenance of validation rules.
</p>
+ </section>
- <p>
- In order to use the Validator, the following basic steps are required:
- <ul>
- <li>
- Create a new instance of the
- <code>org.apache.commons.validator.Validator</code> class. Currently
- Validator instances may be safely reused if the current
- ValidatorResources are the same, as long as you have completed any
- previous validation, and you do not try to utilize a particular
- Validator instance from more than one thread at a time.
- </li>
- <li>
- Add any resources needed to perform the validations, such as the
- JavaBean to validate.
- </li>
- <li>
- Call the validate method on
- <code>org.apache.commons.validator.Validator</code>.
- </li>
- </ul>
- </p>
-
- <p>
- For more information, see the <a href="apidocs/index.html">JavaDocs</a>.
- </p>
-
+ <section name="Releases">
+ <p>See the <a href="downloads.html">Downloads</a> page for current/previous
+ releases.
+ </p>
+ <p>For details of whats new in each version see the <a href="changes-report.html">Release History</a>.</p>
+ <p>For a more descriptive explanation see the
+ <a href="http://wiki.apache.org/jakarta-commons/ValidatorReleaseNotes">Release Notes</a> maintained on
+ the <a href="http://wiki.apache.org/jakarta-commons/">Jakarta Commons Wiki</a>.
+ </p>
</section>
-
- <section name="Features">
+
+ <section name="Overview">
+ <subsection name="Features">
<p>Validator provides two distinct sets of functionality:</p>
<ol>
<li>A configurable (typically XML) validation engine</li>
@@ -78,6 +63,65 @@
However, it does have a set of common validation methods
(email addresses, dates, URLs, etc.) that help in creating
pluggable actions.
+ </p>
+ </subsection>
+
+ <subsection name="Usage">
+ <p>
+ In order to use the Validator, the following basic steps are required:
+ <ul>
+ <li>
+ Create a new instance of the
+ <code>org.apache.commons.validator.Validator</code> class. Currently
+ Validator instances may be safely reused if the current
+ ValidatorResources are the same, as long as you have completed any
+ previous validation, and you do not try to utilize a particular
+ Validator instance from more than one thread at a time.
+ </li>
+ <li>
+ Add any resources needed to perform the validations, such as the
+ JavaBean to validate.
+ </li>
+ <li>
+ Call the validate method on
+ <code>org.apache.commons.validator.Validator</code>.
+ </li>
+ </ul>
+ </p>
+ </subsection>
+
+ </section>
+
+ <section name="Documentation">
+ <p>
+ The JavaDoc API documents are available online:
+ </p>
+ <ul>
+ <li>The <a href="api-release/index.html">Current Release</a></li>
+ <li>The <a href="api-1.1.4/index.html">Version 1.1.4</a></li>
+ <li>The <a href="api-1.0.2/index.html">Version 1.0.2</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/validator/trunk/">browsed</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 [validator].
+ </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 [validator].
</p>
</section>
Added: jakarta/commons/proper/validator/trunk/xdocs/issue-tracking.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/validator/trunk/xdocs/issue-tracking.xml?rev=344027&view=auto
==============================================================================
--- jakarta/commons/proper/validator/trunk/xdocs/issue-tracking.xml (added)
+++ jakarta/commons/proper/validator/trunk/xdocs/issue-tracking.xml Sun Nov 13 19:18:35 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 Validator 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 Validator 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=Validator">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=Validator&rep_platform=All&op_sys=All&priority=P1&bug_severity=normal&bug_status=NEW&assigned_to=commons-dev%40jakarta.apache.org&short_desc=%5Bvalidator%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 [validator] 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 Validator 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=Validator">All Open Validator 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=Validator">All Closed Validator 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=Validator">All Validator bugs</a></li>
+ </ul>
+</p>
+</section>
+<!-- ================================================== -->
+</body>
+</document>
Propchange: jakarta/commons/proper/validator/trunk/xdocs/issue-tracking.xml
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: jakarta/commons/proper/validator/trunk/xdocs/issue-tracking.xml
------------------------------------------------------------------------------
svn:keywords = Date Author Id Revision HeadURL
Modified: jakarta/commons/proper/validator/trunk/xdocs/navigation.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/validator/trunk/xdocs/navigation.xml?rev=344027&r1=344026&r2=344027&view=diff
==============================================================================
--- jakarta/commons/proper/validator/trunk/xdocs/navigation.xml (original)
+++ jakarta/commons/proper/validator/trunk/xdocs/navigation.xml Sun Nov 13 19:18:35 2005
@@ -1,7 +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.
@@ -21,6 +21,13 @@
<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="Validator">
<item name="Overview" href="/index.html"/>
<item name="Community" href="/community.html"/>
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org