This is an automated email from the ASF dual-hosted git repository. ggregory pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/commons-validator.git
The following commit(s) were added to refs/heads/master by this push: new 5969b6da Javadoc 5969b6da is described below commit 5969b6dad1c9a65389d1d4039377a808085d6c28 Author: Gary Gregory <garydgreg...@gmail.com> AuthorDate: Sun Jul 21 11:50:27 2024 -0400 Javadoc Use HTML 'em' tag instead of 'i' tag --- .../routines/AbstractCalendarValidator.java | 12 +- .../routines/AbstractFormatValidator.java | 8 +- .../routines/AbstractNumberValidator.java | 10 +- .../validator/routines/BigDecimalValidator.java | 16 +- .../validator/routines/BigIntegerValidator.java | 16 +- .../commons/validator/routines/ByteValidator.java | 16 +- .../validator/routines/CalendarValidator.java | 20 +-- .../commons/validator/routines/CodeValidator.java | 12 +- .../validator/routines/CurrencyValidator.java | 12 +- .../commons/validator/routines/DateValidator.java | 20 +-- .../validator/routines/DoubleValidator.java | 16 +- .../commons/validator/routines/FloatValidator.java | 16 +- .../validator/routines/IntegerValidator.java | 16 +- .../commons/validator/routines/LongValidator.java | 18 +-- .../validator/routines/PercentValidator.java | 10 +- .../commons/validator/routines/RegexValidator.java | 20 +-- .../commons/validator/routines/ShortValidator.java | 16 +- .../commons/validator/routines/TimeValidator.java | 20 +-- .../routines/checkdigit/ABANumberCheckDigit.java | 4 +- .../routines/checkdigit/CASNumberCheckDigit.java | 4 +- .../routines/checkdigit/CUSIPCheckDigit.java | 4 +- .../validator/routines/checkdigit/CheckDigit.java | 2 +- .../routines/checkdigit/EAN13CheckDigit.java | 6 +- .../routines/checkdigit/ECNumberCheckDigit.java | 4 +- .../routines/checkdigit/IBANCheckDigit.java | 4 +- .../routines/checkdigit/ISBN10CheckDigit.java | 4 +- .../routines/checkdigit/ISINCheckDigit.java | 4 +- .../routines/checkdigit/LuhnCheckDigit.java | 6 +- .../routines/checkdigit/ModulusCheckDigit.java | 8 +- .../routines/checkdigit/ModulusTenCheckDigit.java | 14 +- .../routines/checkdigit/SedolCheckDigit.java | 4 +- .../routines/checkdigit/VerhoeffCheckDigit.java | 4 +- .../routines/checkdigit/package-info.java | 2 +- .../commons/validator/routines/package-info.java | 166 ++++++++++----------- 34 files changed, 257 insertions(+), 257 deletions(-) diff --git a/src/main/java/org/apache/commons/validator/routines/AbstractCalendarValidator.java b/src/main/java/org/apache/commons/validator/routines/AbstractCalendarValidator.java index 804ebf0a..298e9398 100644 --- a/src/main/java/org/apache/commons/validator/routines/AbstractCalendarValidator.java +++ b/src/main/java/org/apache/commons/validator/routines/AbstractCalendarValidator.java @@ -29,7 +29,7 @@ import org.apache.commons.validator.GenericValidator; /** * <p>Abstract class for Date/Time/Calendar validation.</p> * - * <p>This is a <i>base</i> class for building Date / Time + * <p>This is a <em>base</em> class for building Date / Time * Validators using format parsing.</p> * * @since 1.3.0 @@ -49,8 +49,8 @@ public abstract class AbstractCalendarValidator extends AbstractFormatValidator private final int timeStyle; /** - * Constructs an instance with the specified <i>strict</i>, - * <i>time</i> and <i>date</i> style parameters. + * Constructs an instance with the specified <em>strict</em>, + * <em>time</em> and <em>date</em> style parameters. * * @param strict {@code true} if strict * <code>Format</code> parsing should be used. @@ -114,7 +114,7 @@ public abstract class AbstractCalendarValidator extends AbstractFormatValidator * * @param value The Calendar value. * @param compare The <code>Calendar</code> to check the value against. - * @param field The field <i>level</i> to compare to - e.g. specifying + * @param field The field <em>level</em> to compare to - e.g. specifying * <code>Calendar.MONTH</code> will compare the year and month * portions of the calendar. * @return Zero if the first value is equal to the second, -1 @@ -192,7 +192,7 @@ public abstract class AbstractCalendarValidator extends AbstractFormatValidator * * @param value The Calendar value. * @param compare The <code>Calendar</code> to check the value against. - * @param field The field <i>level</i> to compare to - e.g. specifying + * @param field The field <em>level</em> to compare to - e.g. specifying * <code>Calendar.MINUTE</code> will compare the hours and minutes * portions of the calendar. * @return Zero if the first value is equal to the second, -1 @@ -358,7 +358,7 @@ public abstract class AbstractCalendarValidator extends AbstractFormatValidator } /** - * <p>Returns a <code>DateFormat</code> for the specified <i>pattern</i> + * <p>Returns a <code>DateFormat</code> for the specified <em>pattern</em> * and/or <code>Locale</code>.</p> * * @param pattern The pattern used to validate the value against or diff --git a/src/main/java/org/apache/commons/validator/routines/AbstractFormatValidator.java b/src/main/java/org/apache/commons/validator/routines/AbstractFormatValidator.java index 661c90f2..75b4f9b5 100644 --- a/src/main/java/org/apache/commons/validator/routines/AbstractFormatValidator.java +++ b/src/main/java/org/apache/commons/validator/routines/AbstractFormatValidator.java @@ -22,9 +22,9 @@ import java.text.ParsePosition; import java.util.Locale; /** - * <p>Abstract class for <i>Format</i> based Validation.</p> + * <p>Abstract class for <em>Format</em> based Validation.</p> * - * <p>This is a <i>base</i> class for building Date and Number + * <p>This is a <em>base</em> class for building Date and Number * Validators using format parsing.</p> * * @since 1.3.0 @@ -109,7 +109,7 @@ public abstract class AbstractFormatValidator implements Serializable { } /** - * <p>Returns a <code>Format</code> for the specified <i>pattern</i> + * <p>Returns a <code>Format</code> for the specified <em>pattern</em> * and/or <code>Locale</code>.</p> * * @param pattern The pattern used to validate the value against or @@ -162,7 +162,7 @@ public abstract class AbstractFormatValidator implements Serializable { } /** - * <p>Validate using the specified <i>pattern</i>. + * <p>Validate using the specified <em>pattern</em>. * * @param value The value validation is being performed on. * @param pattern The pattern used to validate the value against. diff --git a/src/main/java/org/apache/commons/validator/routines/AbstractNumberValidator.java b/src/main/java/org/apache/commons/validator/routines/AbstractNumberValidator.java index 8226e20f..ad1756ca 100644 --- a/src/main/java/org/apache/commons/validator/routines/AbstractNumberValidator.java +++ b/src/main/java/org/apache/commons/validator/routines/AbstractNumberValidator.java @@ -27,7 +27,7 @@ import org.apache.commons.validator.GenericValidator; /** * <p>Abstract class for Number Validation.</p> * - * <p>This is a <i>base</i> class for building Number + * <p>This is a <em>base</em> class for building Number * Validators using format parsing.</p> * * @since 1.3.0 @@ -56,8 +56,8 @@ public abstract class AbstractNumberValidator extends AbstractFormatValidator { private final int formatType; /** - * Constructs an instance with specified <i>strict</i> - * and <i>decimal</i> parameters. + * Constructs an instance with specified <em>strict</em> + * and <em>decimal</em> parameters. * * @param strict {@code true} if strict * <code>Format</code> parsing should be used. @@ -73,7 +73,7 @@ public abstract class AbstractNumberValidator extends AbstractFormatValidator { } /** - * <p>Returns the <i>multiplier</i> of the <code>NumberFormat</code>.</p> + * <p>Returns the <em>multiplier</em> of the <code>NumberFormat</code>.</p> * * @param format The <code>NumberFormat</code> to determine the * multiplier of. @@ -144,7 +144,7 @@ public abstract class AbstractNumberValidator extends AbstractFormatValidator { } /** - * <p>Returns a <code>NumberFormat</code> for the specified <i>pattern</i> + * <p>Returns a <code>NumberFormat</code> for the specified <em>pattern</em> * and/or <code>Locale</code>.</p> * * @param pattern The pattern used to validate the value against or diff --git a/src/main/java/org/apache/commons/validator/routines/BigDecimalValidator.java b/src/main/java/org/apache/commons/validator/routines/BigDecimalValidator.java index c766b791..de8600ba 100644 --- a/src/main/java/org/apache/commons/validator/routines/BigDecimalValidator.java +++ b/src/main/java/org/apache/commons/validator/routines/BigDecimalValidator.java @@ -37,7 +37,7 @@ import java.util.Locale; * * <p>Use one of the <code>isValid()</code> methods to just validate or * one of the <code>validate()</code> methods to validate and receive a - * <i>converted</i> <code>BigDecimal</code> value.</p> + * <em>converted</em> <code>BigDecimal</code> value.</p> * * <p>Fraction/decimal values are automatically trimmed to the appropriate length.</p> * @@ -52,8 +52,8 @@ import java.util.Locale; * a specified range of values.</li> * </ul> * - * <p>So that the same mechanism used for parsing an <i>input</i> value - * for validation can be used to format <i>output</i>, corresponding + * <p>So that the same mechanism used for parsing an <em>input</em> value + * for validation can be used to format <em>output</em>, corresponding * <code>format()</code> methods are also provided. That is you can * format either:</p> * <ul> @@ -80,7 +80,7 @@ public class BigDecimalValidator extends AbstractNumberValidator { } /** - * Constructs a <i>strict</i> instance. + * Constructs a <em>strict</em> instance. */ public BigDecimalValidator() { this(true); @@ -105,11 +105,11 @@ public class BigDecimalValidator extends AbstractNumberValidator { * are:</p> * <ul> * <li>AbstractNumberValidator.STANDARD_FORMAT -to create - * <i>standard</i> number formats (the default).</li> + * <em>standard</em> number formats (the default).</li> * <li>AbstractNumberValidator.CURRENCY_FORMAT -to create - * <i>currency</i> number formats.</li> + * <em>currency</em> number formats.</li> * <li>AbstractNumberValidator.PERCENT_FORMAT -to create - * <i>percent</i> number formats (the default).</li> + * <em>percent</em> number formats (the default).</li> * </ul> * * @param strict {@code true} if strict @@ -212,7 +212,7 @@ public class BigDecimalValidator extends AbstractNumberValidator { /** * <p>Validate/convert a <code>BigDecimal</code> using the - * specified <i>pattern</i>. + * specified <em>pattern</em>. * * @param value The value validation is being performed on. * @param pattern The pattern used to validate the value against, or the diff --git a/src/main/java/org/apache/commons/validator/routines/BigIntegerValidator.java b/src/main/java/org/apache/commons/validator/routines/BigIntegerValidator.java index 7ec0fcca..db5ab9e7 100644 --- a/src/main/java/org/apache/commons/validator/routines/BigIntegerValidator.java +++ b/src/main/java/org/apache/commons/validator/routines/BigIntegerValidator.java @@ -36,7 +36,7 @@ import java.util.Locale; * * <p>Use one of the <code>isValid()</code> methods to just validate or * one of the <code>validate()</code> methods to validate and receive a - * <i>converted</i> <code>BigInteger</code> value.</p> + * <em>converted</em> <code>BigInteger</code> value.</p> * * <p>Once a value has been successfully converted the following * methods can be used to perform minimum, maximum and range checks:</p> @@ -49,8 +49,8 @@ import java.util.Locale; * a specified range of values.</li> * </ul> * - * <p>So that the same mechanism used for parsing an <i>input</i> value - * for validation can be used to format <i>output</i>, corresponding + * <p>So that the same mechanism used for parsing an <em>input</em> value + * for validation can be used to format <em>output</em>, corresponding * <code>format()</code> methods are also provided. That is you can * format either:</p> * <ul> @@ -77,7 +77,7 @@ public class BigIntegerValidator extends AbstractNumberValidator { } /** - * Constructs a <i>strict</i> instance. + * Constructs a <em>strict</em> instance. */ public BigIntegerValidator() { this(true, STANDARD_FORMAT); @@ -92,11 +92,11 @@ public class BigIntegerValidator extends AbstractNumberValidator { * are:</p> * <ul> * <li>AbstractNumberValidator.STANDARD_FORMAT -to create - * <i>standard</i> number formats (the default).</li> + * <em>standard</em> number formats (the default).</li> * <li>AbstractNumberValidator.CURRENCY_FORMAT -to create - * <i>currency</i> number formats.</li> + * <em>currency</em> number formats.</li> * <li>AbstractNumberValidator.PERCENT_FORMAT -to create - * <i>percent</i> number formats (the default).</li> + * <em>percent</em> number formats (the default).</li> * </ul> * * @param strict {@code true} if strict @@ -184,7 +184,7 @@ public class BigIntegerValidator extends AbstractNumberValidator { /** * <p>Validate/convert a <code>BigInteger</code> using the - * specified <i>pattern</i>. + * specified <em>pattern</em>. * * @param value The value validation is being performed on. * @param pattern The pattern used to validate the value against. diff --git a/src/main/java/org/apache/commons/validator/routines/ByteValidator.java b/src/main/java/org/apache/commons/validator/routines/ByteValidator.java index a21cbfbc..77337e58 100644 --- a/src/main/java/org/apache/commons/validator/routines/ByteValidator.java +++ b/src/main/java/org/apache/commons/validator/routines/ByteValidator.java @@ -35,7 +35,7 @@ import java.util.Locale; * * <p>Use one of the <code>isValid()</code> methods to just validate or * one of the <code>validate()</code> methods to validate and receive a - * <i>converted</i> <code>Byte</code> value.</p> + * <em>converted</em> <code>Byte</code> value.</p> * * <p>Once a value has been successfully converted the following * methods can be used to perform minimum, maximum and range checks:</p> @@ -48,8 +48,8 @@ import java.util.Locale; * a specified range of values.</li> * </ul> * - * <p>So that the same mechanism used for parsing an <i>input</i> value - * for validation can be used to format <i>output</i>, corresponding + * <p>So that the same mechanism used for parsing an <em>input</em> value + * for validation can be used to format <em>output</em>, corresponding * <code>format()</code> methods are also provided. That is you can * format either:</p> * <ul> @@ -76,7 +76,7 @@ public class ByteValidator extends AbstractNumberValidator { } /** - * Constructs a <i>strict</i> instance. + * Constructs a <em>strict</em> instance. */ public ByteValidator() { this(true, STANDARD_FORMAT); @@ -91,11 +91,11 @@ public class ByteValidator extends AbstractNumberValidator { * are:</p> * <ul> * <li>AbstractNumberValidator.STANDARD_FORMAT -to create - * <i>standard</i> number formats (the default).</li> + * <em>standard</em> number formats (the default).</li> * <li>AbstractNumberValidator.CURRENCY_FORMAT -to create - * <i>currency</i> number formats.</li> + * <em>currency</em> number formats.</li> * <li>AbstractNumberValidator.PERCENT_FORMAT -to create - * <i>percent</i> number formats (the default).</li> + * <em>percent</em> number formats (the default).</li> * </ul> * * @param strict {@code true} if strict @@ -230,7 +230,7 @@ public class ByteValidator extends AbstractNumberValidator { /** * <p>Validate/convert a <code>Byte</code> using the - * specified <i>pattern</i>. + * specified <em>pattern</em>. * * @param value The value validation is being performed on. * @param pattern The pattern used to validate the value against. diff --git a/src/main/java/org/apache/commons/validator/routines/CalendarValidator.java b/src/main/java/org/apache/commons/validator/routines/CalendarValidator.java index 47a77b5d..12de0384 100644 --- a/src/main/java/org/apache/commons/validator/routines/CalendarValidator.java +++ b/src/main/java/org/apache/commons/validator/routines/CalendarValidator.java @@ -42,10 +42,10 @@ import java.util.TimeZone; * * <p>Use one of the <code>isValid()</code> methods to just validate or * one of the <code>validate()</code> methods to validate and receive a - * <i>converted</i> <code>Calendar</code> value.</p> + * <em>converted</em> <code>Calendar</code> value.</p> * * <p>Implementations of the <code>validate()</code> method are provided - * to create <code>Calendar</code> objects for different <i>time zones</i> + * to create <code>Calendar</code> objects for different <em>time zones</em> * if the system default is not appropriate.</p> * * <p>Alternatively the CalendarValidator's <code>adjustToTimeZone()</code> method @@ -72,14 +72,14 @@ import java.util.TimeZone; * whether the first year is equal, before or after the second.</li> * </ul> * - * <p>So that the same mechanism used for parsing an <i>input</i> value - * for validation can be used to format <i>output</i>, corresponding + * <p>So that the same mechanism used for parsing an <em>input</em> value + * for validation can be used to format <em>output</em>, corresponding * <code>format()</code> methods are also provided. That is you can * format either:</p> * <ul> * <li>using a specified pattern</li> * <li>using the format for a specified <code>Locale</code></li> - * <li>using the format for the <i>default</i> <code>Locale</code></li> + * <li>using the format for the <em>default</em> <code>Locale</code></li> * </ul> * * @since 1.3.0 @@ -119,7 +119,7 @@ public class CalendarValidator extends AbstractCalendarValidator { } /** - * Constructs a <i>strict</i> instance with <i>short</i> + * Constructs a <em>strict</em> instance with <em>short</em> * date style. */ public CalendarValidator() { @@ -127,8 +127,8 @@ public class CalendarValidator extends AbstractCalendarValidator { } /** - * Constructs an instance with the specified <i>strict</i> - * and <i>date style</i> parameters. + * Constructs an instance with the specified <em>strict</em> + * and <em>date style</em> parameters. * * @param strict {@code true} if strict * <code>Format</code> parsing should be used. @@ -269,7 +269,7 @@ public class CalendarValidator extends AbstractCalendarValidator { /** * <p>Validate/convert a <code>Calendar</code> using the specified - * <i>pattern</i> and default <code>TimeZone</code>. + * <em>pattern</em> and default <code>TimeZone</code>. * * @param value The value validation is being performed on. * @param pattern The pattern used to validate the value against. @@ -310,7 +310,7 @@ public class CalendarValidator extends AbstractCalendarValidator { /** * <p>Validate/convert a <code>Calendar</code> using the specified - * <i>pattern</i> and <code>TimeZone</code>. + * <em>pattern</em> and <code>TimeZone</code>. * * @param value The value validation is being performed on. * @param pattern The pattern used to validate the value against. diff --git a/src/main/java/org/apache/commons/validator/routines/CodeValidator.java b/src/main/java/org/apache/commons/validator/routines/CodeValidator.java index 82bc35e1..3d3a6434 100644 --- a/src/main/java/org/apache/commons/validator/routines/CodeValidator.java +++ b/src/main/java/org/apache/commons/validator/routines/CodeValidator.java @@ -29,9 +29,9 @@ import org.apache.commons.validator.routines.checkdigit.CheckDigit; * <ul> * <li>if the code is null, return null/false as appropriate</li> * <li>trim the input. If the resulting code is empty, return null/false as appropriate</li> - * <li>Check the <i>format</i> of the code using a <i>regular expression.</i> (if specified)</li> - * <li>Check the <i>minimum</i> and <i>maximum</i> length (if specified) of the <i>parsed</i> code - * (i.e. parsed by the <i>regular expression</i>).</li> + * <li>Check the <em>format</em> of the code using a <em>regular expression.</em> (if specified)</li> + * <li>Check the <em>minimum</em> and <em>maximum</em> length (if specified) of the <em>parsed</em> code + * (i.e. parsed by the <em>regular expression</em>).</li> * <li>Performs {@link CheckDigit} validation on the parsed code (if specified).</li> * <li>The {@link #validate(String)} method returns the trimmed, parsed input (or null if validation failed)</li> * </ul> @@ -58,9 +58,9 @@ import org.apache.commons.validator.routines.checkdigit.CheckDigit; * <li><code>String validate(code)</code></li> * </ul> * <p> - * Codes often include <i>format</i> characters - such as hyphens - to make them + * Codes often include <em>format</em> characters - such as hyphens - to make them * more easily human readable. These can be removed prior to length and check digit - * validation by specifying them as a <i>non-capturing</i> group in the regular + * validation by specifying them as a <em>non-capturing</em> group in the regular * expression (i.e. use the <code>(?: )</code> notation). * <br> * Or just avoid using parentheses except for the parts you want to capture @@ -211,7 +211,7 @@ public final class CodeValidator implements Serializable { } /** - * Gets the <i>regular expression</i> validator. + * Gets the <em>regular expression</em> validator. * <p> * <b>N.B.</b> Optional, if not set no regular * expression validation will be performed on the code. diff --git a/src/main/java/org/apache/commons/validator/routines/CurrencyValidator.java b/src/main/java/org/apache/commons/validator/routines/CurrencyValidator.java index 4a57520c..a143b0fa 100644 --- a/src/main/java/org/apache/commons/validator/routines/CurrencyValidator.java +++ b/src/main/java/org/apache/commons/validator/routines/CurrencyValidator.java @@ -24,20 +24,20 @@ import java.text.Format; * * <p>This is one implementation of a currency validator that has the following features:</p> * <ul> - * <li>It is <i>lenient</i> about the presence of the <i>currency symbol</i></li> + * <li>It is <em>lenient</em> about the presence of the <em>currency symbol</em></li> * <li>It converts the currency to a <code>java.math.BigDecimal</code></li> * </ul> * - * <p>However any of the <i>number</i> validators can be used for <i>currency</i> validation. - * For example, if you wanted a <i>currency</i> validator that converts to a + * <p>However any of the <em>number</em> validators can be used for <em>currency</em> validation. + * For example, if you wanted a <em>currency</em> validator that converts to a * <code>java.lang.Integer</code> then you can simply instantiate an - * <code>IntegerValidator</code> with the appropriate <i>format type</i>:</p> + * <code>IntegerValidator</code> with the appropriate <em>format type</em>:</p> * * <p><code>... = new IntegerValidator(false, IntegerValidator.CURRENCY_FORMAT);</code></p> * * <p>Pick the appropriate validator, depending on the type (e.g Float, Double, Integer, Long etc) * you want the currency converted to. One thing to note - only the CurrencyValidator - * implements <i>lenient</i> behavior regarding the currency symbol.</p> + * implements <em>lenient</em> behavior regarding the currency symbol.</p> * * @since 1.3.0 */ @@ -59,7 +59,7 @@ public class CurrencyValidator extends BigDecimalValidator { } /** - * Constructs a <i>strict</i> instance. + * Constructs a <em>strict</em> instance. */ public CurrencyValidator() { this(true, true); diff --git a/src/main/java/org/apache/commons/validator/routines/DateValidator.java b/src/main/java/org/apache/commons/validator/routines/DateValidator.java index 6c62b58a..ec16b916 100644 --- a/src/main/java/org/apache/commons/validator/routines/DateValidator.java +++ b/src/main/java/org/apache/commons/validator/routines/DateValidator.java @@ -43,10 +43,10 @@ import java.util.TimeZone; * * <p>Use one of the <code>isValid()</code> methods to just validate or * one of the <code>validate()</code> methods to validate and receive a - * <i>converted</i> <code>Date</code> value.</p> + * <em>converted</em> <code>Date</code> value.</p> * * <p>Implementations of the <code>validate()</code> method are provided - * to create <code>Date</code> objects for different <i>time zones</i> + * to create <code>Date</code> objects for different <em>time zones</em> * if the system default is not appropriate.</p> * * <p>Once a value has been successfully converted the following @@ -69,14 +69,14 @@ import java.util.TimeZone; * whether the first year is equal, before or after the second.</li> * </ul> * - * <p>So that the same mechanism used for parsing an <i>input</i> value - * for validation can be used to format <i>output</i>, corresponding + * <p>So that the same mechanism used for parsing an <em>input</em> value + * for validation can be used to format <em>output</em>, corresponding * <code>format()</code> methods are also provided. That is you can * format either:</p> * <ul> * <li>using a specified pattern</li> * <li>using the format for a specified <code>Locale</code></li> - * <li>using the format for the <i>default</i> <code>Locale</code></li> + * <li>using the format for the <em>default</em> <code>Locale</code></li> * </ul> * * @since 1.3.0 @@ -96,7 +96,7 @@ public class DateValidator extends AbstractCalendarValidator { } /** - * Constructs a <i>strict</i> instance with <i>short</i> + * Constructs a <em>strict</em> instance with <em>short</em> * date style. */ public DateValidator() { @@ -104,8 +104,8 @@ public class DateValidator extends AbstractCalendarValidator { } /** - * Constructs an instance with the specified <i>strict</i> - * and <i>date style</i> parameters. + * Constructs an instance with the specified <em>strict</em> + * and <em>date style</em> parameters. * * @param strict {@code true} if strict * <code>Format</code> parsing should be used. @@ -279,7 +279,7 @@ public class DateValidator extends AbstractCalendarValidator { /** * <p>Validate/convert a <code>Date</code> using the specified - * <i>pattern</i> and default <code>TimeZone</code>. + * <em>pattern</em> and default <code>TimeZone</code>. * * @param value The value validation is being performed on. * @param pattern The pattern used to validate the value against, or the @@ -321,7 +321,7 @@ public class DateValidator extends AbstractCalendarValidator { /** * <p>Validate/convert a <code>Date</code> using the specified - * <i>pattern</i> and <code>TimeZone</code>. + * <em>pattern</em> and <code>TimeZone</code>. * * @param value The value validation is being performed on. * @param pattern The pattern used to validate the value against, or the diff --git a/src/main/java/org/apache/commons/validator/routines/DoubleValidator.java b/src/main/java/org/apache/commons/validator/routines/DoubleValidator.java index 3b68ad4a..8d11f940 100644 --- a/src/main/java/org/apache/commons/validator/routines/DoubleValidator.java +++ b/src/main/java/org/apache/commons/validator/routines/DoubleValidator.java @@ -35,7 +35,7 @@ import java.util.Locale; * * <p>Use one of the <code>isValid()</code> methods to just validate or * one of the <code>validate()</code> methods to validate and receive a - * <i>converted</i> <code>Double</code> value.</p> + * <em>converted</em> <code>Double</code> value.</p> * * <p>Once a value has been successfully converted the following * methods can be used to perform minimum, maximum and range checks:</p> @@ -48,8 +48,8 @@ import java.util.Locale; * a specified range of values.</li> * </ul> * - * <p>So that the same mechanism used for parsing an <i>input</i> value - * for validation can be used to format <i>output</i>, corresponding + * <p>So that the same mechanism used for parsing an <em>input</em> value + * for validation can be used to format <em>output</em>, corresponding * <code>format()</code> methods are also provided. That is you can * format either:</p> * <ul> @@ -76,7 +76,7 @@ public class DoubleValidator extends AbstractNumberValidator { } /** - * Constructs a <i>strict</i> instance. + * Constructs a <em>strict</em> instance. */ public DoubleValidator() { this(true, STANDARD_FORMAT); @@ -91,11 +91,11 @@ public class DoubleValidator extends AbstractNumberValidator { * are:</p> * <ul> * <li>AbstractNumberValidator.STANDARD_FORMAT -to create - * <i>standard</i> number formats (the default).</li> + * <em>standard</em> number formats (the default).</li> * <li>AbstractNumberValidator.CURRENCY_FORMAT -to create - * <i>currency</i> number formats.</li> + * <em>currency</em> number formats.</li> * <li>AbstractNumberValidator.PERCENT_FORMAT -to create - * <i>percent</i> number formats (the default).</li> + * <em>percent</em> number formats (the default).</li> * </ul> * * @param strict {@code true} if strict @@ -224,7 +224,7 @@ public class DoubleValidator extends AbstractNumberValidator { /** * <p>Validate/convert a <code>Double</code> using the - * specified <i>pattern</i>. + * specified <em>pattern</em>. * * @param value The value validation is being performed on. * @param pattern The pattern used to validate the value against. diff --git a/src/main/java/org/apache/commons/validator/routines/FloatValidator.java b/src/main/java/org/apache/commons/validator/routines/FloatValidator.java index 180f976a..95d20c13 100644 --- a/src/main/java/org/apache/commons/validator/routines/FloatValidator.java +++ b/src/main/java/org/apache/commons/validator/routines/FloatValidator.java @@ -35,7 +35,7 @@ import java.util.Locale; * * <p>Use one of the <code>isValid()</code> methods to just validate or * one of the <code>validate()</code> methods to validate and receive a - * <i>converted</i> <code>Float</code> value.</p> + * <em>converted</em> <code>Float</code> value.</p> * * <p>Once a value has been successfully converted the following * methods can be used to perform minimum, maximum and range checks:</p> @@ -48,8 +48,8 @@ import java.util.Locale; * a specified range of values.</li> * </ul> * - * <p>So that the same mechanism used for parsing an <i>input</i> value - * for validation can be used to format <i>output</i>, corresponding + * <p>So that the same mechanism used for parsing an <em>input</em> value + * for validation can be used to format <em>output</em>, corresponding * <code>format()</code> methods are also provided. That is you can * format either:</p> * <ul> @@ -76,7 +76,7 @@ public class FloatValidator extends AbstractNumberValidator { } /** - * Constructs a <i>strict</i> instance. + * Constructs a <em>strict</em> instance. */ public FloatValidator() { this(true, STANDARD_FORMAT); @@ -91,11 +91,11 @@ public class FloatValidator extends AbstractNumberValidator { * are:</p> * <ul> * <li>AbstractNumberValidator.STANDARD_FORMAT -to create - * <i>standard</i> number formats (the default).</li> + * <em>standard</em> number formats (the default).</li> * <li>AbstractNumberValidator.CURRENCY_FORMAT -to create - * <i>currency</i> number formats.</li> + * <em>currency</em> number formats.</li> * <li>AbstractNumberValidator.PERCENT_FORMAT -to create - * <i>percent</i> number formats (the default).</li> + * <em>percent</em> number formats (the default).</li> * </ul> * * @param strict {@code true} if strict @@ -242,7 +242,7 @@ public class FloatValidator extends AbstractNumberValidator { /** * <p>Validate/convert a <code>Float</code> using the - * specified <i>pattern</i>. + * specified <em>pattern</em>. * * @param value The value validation is being performed on. * @param pattern The pattern used to validate the value against. diff --git a/src/main/java/org/apache/commons/validator/routines/IntegerValidator.java b/src/main/java/org/apache/commons/validator/routines/IntegerValidator.java index 267fc0f3..9dc8e2d3 100644 --- a/src/main/java/org/apache/commons/validator/routines/IntegerValidator.java +++ b/src/main/java/org/apache/commons/validator/routines/IntegerValidator.java @@ -35,7 +35,7 @@ import java.util.Locale; * * <p>Use one of the <code>isValid()</code> methods to just validate or * one of the <code>validate()</code> methods to validate and receive a - * <i>converted</i> <code>Integer</code> value.</p> + * <em>converted</em> <code>Integer</code> value.</p> * * <p>Once a value has been successfully converted the following * methods can be used to perform minimum, maximum and range checks:</p> @@ -48,8 +48,8 @@ import java.util.Locale; * a specified range of values.</li> * </ul> * - * <p>So that the same mechanism used for parsing an <i>input</i> value - * for validation can be used to format <i>output</i>, corresponding + * <p>So that the same mechanism used for parsing an <em>input</em> value + * for validation can be used to format <em>output</em>, corresponding * <code>format()</code> methods are also provided. That is you can * format either:</p> * <ul> @@ -76,7 +76,7 @@ public class IntegerValidator extends AbstractNumberValidator { } /** - * Constructs a <i>strict</i> instance. + * Constructs a <em>strict</em> instance. */ public IntegerValidator() { this(true, STANDARD_FORMAT); @@ -91,11 +91,11 @@ public class IntegerValidator extends AbstractNumberValidator { * are:</p> * <ul> * <li>AbstractNumberValidator.STANDARD_FORMAT -to create - * <i>standard</i> number formats (the default).</li> + * <em>standard</em> number formats (the default).</li> * <li>AbstractNumberValidator.CURRENCY_FORMAT -to create - * <i>currency</i> number formats.</li> + * <em>currency</em> number formats.</li> * <li>AbstractNumberValidator.PERCENT_FORMAT -to create - * <i>percent</i> number formats (the default).</li> + * <em>percent</em> number formats (the default).</li> * </ul> * * @param strict {@code true} if strict @@ -230,7 +230,7 @@ public class IntegerValidator extends AbstractNumberValidator { /** * <p>Validate/convert an <code>Integer</code> using the - * specified <i>pattern</i>. + * specified <em>pattern</em>. * * @param value The value validation is being performed on. * @param pattern The pattern used to validate the value against. diff --git a/src/main/java/org/apache/commons/validator/routines/LongValidator.java b/src/main/java/org/apache/commons/validator/routines/LongValidator.java index edd69d5a..0b95e48a 100644 --- a/src/main/java/org/apache/commons/validator/routines/LongValidator.java +++ b/src/main/java/org/apache/commons/validator/routines/LongValidator.java @@ -35,7 +35,7 @@ import java.util.Locale; * * <p>Use one of the <code>isValid()</code> methods to just validate or * one of the <code>validate()</code> methods to validate and receive a - * <i>converted</i> <code>Long</code> value.</p> + * <em>converted</em> <code>Long</code> value.</p> * * <p>Once a value has been successfully converted the following * methods can be used to perform minimum, maximum and range checks:</p> @@ -48,14 +48,14 @@ import java.util.Locale; * a specified range of values.</li> * </ul> * - * <p>So that the same mechanism used for parsing an <i>input</i> value - * for validation can be used to format <i>output</i>, corresponding + * <p>So that the same mechanism used for parsing an <em>input</em> value + * for validation can be used to format <em>output</em>, corresponding * <code>format()</code> methods are also provided. That is you can * format either:</p> * <ul> * <li>using a specified pattern</li> * <li>using the format for a specified <code>Locale</code></li> - * <li>using the format for the <i>default</i> <code>Locale</code></li> + * <li>using the format for the <em>default</em> <code>Locale</code></li> * </ul> * * @since 1.3.0 @@ -75,7 +75,7 @@ public class LongValidator extends AbstractNumberValidator { } /** - * Constructs a <i>strict</i> instance. + * Constructs a <em>strict</em> instance. */ public LongValidator() { this(true, STANDARD_FORMAT); @@ -90,11 +90,11 @@ public class LongValidator extends AbstractNumberValidator { * are:</p> * <ul> * <li>AbstractNumberValidator.STANDARD_FORMAT -to create - * <i>standard</i> number formats (the default).</li> + * <em>standard</em> number formats (the default).</li> * <li>AbstractNumberValidator.CURRENCY_FORMAT -to create - * <i>currency</i> number formats.</li> + * <em>currency</em> number formats.</li> * <li>AbstractNumberValidator.PERCENT_FORMAT -to create - * <i>percent</i> number formats (the default).</li> + * <em>percent</em> number formats (the default).</li> * </ul> * * @param strict {@code true} if strict @@ -225,7 +225,7 @@ public class LongValidator extends AbstractNumberValidator { /** * <p>Validate/convert a <code>Long</code> using the - * specified <i>pattern</i>. + * specified <em>pattern</em>. * * @param value The value validation is being performed on. * @param pattern The pattern used to validate the value against. diff --git a/src/main/java/org/apache/commons/validator/routines/PercentValidator.java b/src/main/java/org/apache/commons/validator/routines/PercentValidator.java index 408783d2..8767865f 100644 --- a/src/main/java/org/apache/commons/validator/routines/PercentValidator.java +++ b/src/main/java/org/apache/commons/validator/routines/PercentValidator.java @@ -25,14 +25,14 @@ import java.text.Format; * * <p>This is one implementation of a percent validator that has the following features:</p> * <ul> - * <li>It is <i>lenient</i> about the presence of the <i>percent symbol</i></li> + * <li>It is <em>lenient</em> about the presence of the <em>percent symbol</em></li> * <li>It converts the percent to a <code>java.math.BigDecimal</code></li> * </ul> * - * <p>However any of the <i>number</i> validators can be used for <i>percent</i> validation. - * For example, if you wanted a <i>percent</i> validator that converts to a + * <p>However any of the <em>number</em> validators can be used for <em>percent</em> validation. + * For example, if you wanted a <em>percent</em> validator that converts to a * <code>java.lang.Float</code> then you can simply instantiate an - * <code>FloatValidator</code> with the appropriate <i>format type</i>:</p> + * <code>FloatValidator</code> with the appropriate <em>format type</em>:</p> * * <p><code>... = new FloatValidator(false, FloatValidator.PERCENT_FORMAT);</code></p> * @@ -64,7 +64,7 @@ public class PercentValidator extends BigDecimalValidator { } /** - * Constructs a <i>strict</i> instance. + * Constructs a <em>strict</em> instance. */ public PercentValidator() { this(true); diff --git a/src/main/java/org/apache/commons/validator/routines/RegexValidator.java b/src/main/java/org/apache/commons/validator/routines/RegexValidator.java index 4be97d6b..520dc8a2 100644 --- a/src/main/java/org/apache/commons/validator/routines/RegexValidator.java +++ b/src/main/java/org/apache/commons/validator/routines/RegexValidator.java @@ -25,9 +25,9 @@ import java.util.regex.Pattern; * <b>Regular Expression</b> validation (using the JRE's regular expression support). * <p> * Constructs the validator either for a single regular expression or a set (array) of - * regular expressions. By default validation is <i>case sensitive</i> but constructors - * are provided to allow <i>case in-sensitive</i> validation. For example to create - * a validator which does <i>case in-sensitive</i> validation for a set of regular + * regular expressions. By default validation is <em>case sensitive</em> but constructors + * are provided to allow <em>case in-sensitive</em> validation. For example to create + * a validator which does <em>case in-sensitive</em> validation for a set of regular * expressions: * </p> * <pre> @@ -77,7 +77,7 @@ public class RegexValidator implements Serializable { private final Pattern[] patterns; /** - * Constructs a <i>case sensitive</i> validator that matches any one + * Constructs a <em>case sensitive</em> validator that matches any one * in the list of regular expressions. * * @param regexs The set of regular expressions this validator will @@ -88,7 +88,7 @@ public class RegexValidator implements Serializable { } /** - * Constructs a <i>case sensitive</i> validator for a single + * Constructs a <em>case sensitive</em> validator for a single * regular expression. * * @param regex The regular expression this validator will @@ -99,7 +99,7 @@ public class RegexValidator implements Serializable { } /** - * Constructs a <i>case sensitive</i> validator that matches any one + * Constructs a <em>case sensitive</em> validator that matches any one * in the array of regular expressions. * * @param regexs The set of regular expressions this validator will @@ -116,7 +116,7 @@ public class RegexValidator implements Serializable { * @param regex The regular expression this validator will * validate against * @param caseSensitive when {@code true} matching is <i>case - * sensitive</i>, otherwise matching is <i>case in-sensitive</i> + * sensitive</i>, otherwise matching is <em>case in-sensitive</em> */ public RegexValidator(final String regex, final boolean caseSensitive) { this(new String[] { regex }, caseSensitive); @@ -129,7 +129,7 @@ public class RegexValidator implements Serializable { * @param regexs The set of regular expressions this validator will * validate against * @param caseSensitive when {@code true} matching is <i>case - * sensitive</i>, otherwise matching is <i>case in-sensitive</i> + * sensitive</i>, otherwise matching is <em>case in-sensitive</em> */ public RegexValidator(final String[] regexs, final boolean caseSensitive) { if (regexs == null || regexs.length == 0) { @@ -180,7 +180,7 @@ public class RegexValidator implements Serializable { * returning the array of matched groups. * * @param value The value to validate. - * @return String array of the <i>groups</i> matched if + * @return String array of the <em>groups</em> matched if * valid or {@code null} if invalid */ public String[] match(final String value) { @@ -225,7 +225,7 @@ public class RegexValidator implements Serializable { * * @param value The value to validate. * @return Aggregated String value comprised of the - * <i>groups</i> matched if valid or {@code null} if invalid + * <em>groups</em> matched if valid or {@code null} if invalid */ public String validate(final String value) { if (value == null) { diff --git a/src/main/java/org/apache/commons/validator/routines/ShortValidator.java b/src/main/java/org/apache/commons/validator/routines/ShortValidator.java index c1c8ae7b..094adb51 100644 --- a/src/main/java/org/apache/commons/validator/routines/ShortValidator.java +++ b/src/main/java/org/apache/commons/validator/routines/ShortValidator.java @@ -35,7 +35,7 @@ import java.util.Locale; * * <p>Use one of the <code>isValid()</code> methods to just validate or * one of the <code>validate()</code> methods to validate and receive a - * <i>converted</i> <code>Short</code> value.</p> + * <em>converted</em> <code>Short</code> value.</p> * * <p>Once a value has been successfully converted the following * methods can be used to perform minimum, maximum and range checks:</p> @@ -48,8 +48,8 @@ import java.util.Locale; * a specified range of values.</li> * </ul> * - * <p>So that the same mechanism used for parsing an <i>input</i> value - * for validation can be used to format <i>output</i>, corresponding + * <p>So that the same mechanism used for parsing an <em>input</em> value + * for validation can be used to format <em>output</em>, corresponding * <code>format()</code> methods are also provided. That is you can * format either:</p> * <ul> @@ -76,7 +76,7 @@ public class ShortValidator extends AbstractNumberValidator { } /** - * Constructs a <i>strict</i> instance. + * Constructs a <em>strict</em> instance. */ public ShortValidator() { this(true, STANDARD_FORMAT); @@ -91,11 +91,11 @@ public class ShortValidator extends AbstractNumberValidator { * are:</p> * <ul> * <li>AbstractNumberValidator.STANDARD_FORMAT -to create - * <i>standard</i> number formats (the default).</li> + * <em>standard</em> number formats (the default).</li> * <li>AbstractNumberValidator.CURRENCY_FORMAT -to create - * <i>currency</i> number formats.</li> + * <em>currency</em> number formats.</li> * <li>AbstractNumberValidator.PERCENT_FORMAT -to create - * <i>percent</i> number formats (the default).</li> + * <em>percent</em> number formats (the default).</li> * </ul> * * @param strict {@code true} if strict @@ -228,7 +228,7 @@ public class ShortValidator extends AbstractNumberValidator { /** * <p>Validate/convert a <code>Short</code> using the - * specified <i>pattern</i>. + * specified <em>pattern</em>. * * @param value The value validation is being performed on. * @param pattern The pattern used to validate the value against. diff --git a/src/main/java/org/apache/commons/validator/routines/TimeValidator.java b/src/main/java/org/apache/commons/validator/routines/TimeValidator.java index f7b35c35..3516fe0c 100644 --- a/src/main/java/org/apache/commons/validator/routines/TimeValidator.java +++ b/src/main/java/org/apache/commons/validator/routines/TimeValidator.java @@ -42,10 +42,10 @@ import java.util.TimeZone; * * <p>Use one of the <code>isValid()</code> methods to just validate or * one of the <code>validate()</code> methods to validate and receive a - * <i>converted</i> <code>Calendar</code> value for the time.</p> + * <em>converted</em> <code>Calendar</code> value for the time.</p> * * <p>Implementations of the <code>validate()</code> method are provided - * to create <code>Calendar</code> objects for different <i>time zones</i> + * to create <code>Calendar</code> objects for different <em>time zones</em> * if the system default is not appropriate.</p> * * <p>Alternatively the CalendarValidator's <code>adjustToTimeZone()</code> method @@ -69,14 +69,14 @@ import java.util.TimeZone; * whether the first is equal to, before or after the second.</li> * </ul> * - * <p>So that the same mechanism used for parsing an <i>input</i> value - * for validation can be used to format <i>output</i>, corresponding + * <p>So that the same mechanism used for parsing an <em>input</em> value + * for validation can be used to format <em>output</em>, corresponding * <code>format()</code> methods are also provided. That is you can * format either:</p> * <ul> * <li>using a specified pattern</li> * <li>using the format for a specified <code>Locale</code></li> - * <li>using the format for the <i>default</i> <code>Locale</code></li> + * <li>using the format for the <em>default</em> <code>Locale</code></li> * </ul> * * @since 1.3.0 @@ -96,7 +96,7 @@ public class TimeValidator extends AbstractCalendarValidator { } /** - * Constructs a <i>strict</i> instance with <i>short</i> + * Constructs a <em>strict</em> instance with <em>short</em> * time style. */ public TimeValidator() { @@ -104,8 +104,8 @@ public class TimeValidator extends AbstractCalendarValidator { } /** - * Constructs an instance with the specified <i>strict</i> - * and <i>time style</i> parameters. + * Constructs an instance with the specified <em>strict</em> + * and <em>time style</em> parameters. * * @param strict {@code true} if strict * <code>Format</code> parsing should be used. @@ -217,7 +217,7 @@ public class TimeValidator extends AbstractCalendarValidator { } /** - * <p>Validate/convert a time using the specified <i>pattern</i> and + * <p>Validate/convert a time using the specified <em>pattern</em> and * default <code>TimeZone</code>. * * @param value The value validation is being performed on. @@ -258,7 +258,7 @@ public class TimeValidator extends AbstractCalendarValidator { } /** - * <p>Validate/convert a time using the specified <i>pattern</i> + * <p>Validate/convert a time using the specified <em>pattern</em> * and <code>TimeZone</code>. * * @param value The value validation is being performed on. diff --git a/src/main/java/org/apache/commons/validator/routines/checkdigit/ABANumberCheckDigit.java b/src/main/java/org/apache/commons/validator/routines/checkdigit/ABANumberCheckDigit.java index 221d742c..34250b75 100644 --- a/src/main/java/org/apache/commons/validator/routines/checkdigit/ABANumberCheckDigit.java +++ b/src/main/java/org/apache/commons/validator/routines/checkdigit/ABANumberCheckDigit.java @@ -26,7 +26,7 @@ package org.apache.commons.validator.routines.checkdigit; * (ABA stands for the American Bankers Association). * </p> * - * Check digit calculation is based on <i>modulus 10</i> with digits being weighted + * Check digit calculation is based on <em>modulus 10</em> with digits being weighted * based on their position (from right to left) as follows: * * <ul> @@ -60,7 +60,7 @@ public final class ABANumberCheckDigit extends ModulusCheckDigit { } /** - * Calculates the <i>weighted</i> value of a character in the + * Calculates the <em>weighted</em> value of a character in the * code at a specified position. * <p> * ABA Routing numbers are weighted in the following manner: diff --git a/src/main/java/org/apache/commons/validator/routines/checkdigit/CASNumberCheckDigit.java b/src/main/java/org/apache/commons/validator/routines/checkdigit/CASNumberCheckDigit.java index f73807f3..a07db5b4 100644 --- a/src/main/java/org/apache/commons/validator/routines/checkdigit/CASNumberCheckDigit.java +++ b/src/main/java/org/apache/commons/validator/routines/checkdigit/CASNumberCheckDigit.java @@ -29,7 +29,7 @@ import org.apache.commons.validator.routines.CodeValidator; * </p> * * <p> - * Check digit calculation is based on <i>modulus 10</i> with digits being weighted + * Check digit calculation is based on <em>modulus 10</em> with digits being weighted * based on their position (from right to left). * </p> * @@ -86,7 +86,7 @@ public final class CASNumberCheckDigit extends ModulusCheckDigit { } /** - * Calculates the <i>weighted</i> value of a character in the code at a specified position. + * Calculates the <em>weighted</em> value of a character in the code at a specified position. * <p> * CAS numbers are weighted in the following manner: * </p> diff --git a/src/main/java/org/apache/commons/validator/routines/checkdigit/CUSIPCheckDigit.java b/src/main/java/org/apache/commons/validator/routines/checkdigit/CUSIPCheckDigit.java index fbf870dd..b0c589bd 100644 --- a/src/main/java/org/apache/commons/validator/routines/checkdigit/CUSIPCheckDigit.java +++ b/src/main/java/org/apache/commons/validator/routines/checkdigit/CUSIPCheckDigit.java @@ -25,7 +25,7 @@ package org.apache.commons.validator.routines.checkdigit; * </p> * * <p> - * Check digit calculation uses the <i>Modulus 10 Double Add Double</i> technique + * Check digit calculation uses the <em>Modulus 10 Double Add Double</em> technique * with every second digit being weighted by 2. Alphabetic characters are * converted to numbers by their position in the alphabet starting with A being 10. * Weighted numbers greater than ten are treated as two separate numbers. @@ -77,7 +77,7 @@ public final class CUSIPCheckDigit extends ModulusCheckDigit { } /** - * <p>Calculates the <i>weighted</i> value of a character in the + * <p>Calculates the <em>weighted</em> value of a character in the * code at a specified position.</p> * * <p>For CUSIP (from right to left) <b>odd</b> digits are weighted diff --git a/src/main/java/org/apache/commons/validator/routines/checkdigit/CheckDigit.java b/src/main/java/org/apache/commons/validator/routines/checkdigit/CheckDigit.java index 7a4ff792..4c571db2 100644 --- a/src/main/java/org/apache/commons/validator/routines/checkdigit/CheckDigit.java +++ b/src/main/java/org/apache/commons/validator/routines/checkdigit/CheckDigit.java @@ -51,7 +51,7 @@ import org.apache.commons.validator.routines.CodeValidator; public interface CheckDigit { /** - * Calculates the <i>Check Digit</i> for a code. + * Calculates the <em>Check Digit</em> for a code. * * @param code The code to calculate the Check Digit for. * The string must not include the check digit diff --git a/src/main/java/org/apache/commons/validator/routines/checkdigit/EAN13CheckDigit.java b/src/main/java/org/apache/commons/validator/routines/checkdigit/EAN13CheckDigit.java index bb925d33..e6d56e9b 100644 --- a/src/main/java/org/apache/commons/validator/routines/checkdigit/EAN13CheckDigit.java +++ b/src/main/java/org/apache/commons/validator/routines/checkdigit/EAN13CheckDigit.java @@ -20,8 +20,8 @@ package org.apache.commons.validator.routines.checkdigit; * Modulus 10 <b>EAN-13</b> / <b>UPC</b> / <b>ISBN-13</b> Check Digit * calculation/validation. * <p> - * Check digit calculation is based on <i>modulus 10</i> with digits in - * an <i>odd</i> position (from right to left) being weighted 1 and <i>even</i> + * Check digit calculation is based on <em>modulus 10</em> with digits in + * an <em>odd</em> position (from right to left) being weighted 1 and <em>even</em> * position digits being weighted 3. * <p> * For further information see: @@ -56,7 +56,7 @@ public final class EAN13CheckDigit extends ModulusCheckDigit { } /** - * <p>Calculates the <i>weighted</i> value of a character in the + * <p>Calculates the <em>weighted</em> value of a character in the * code at a specified position.</p> * * <p>For EAN-13 (from right to left) <b>odd</b> digits are weighted diff --git a/src/main/java/org/apache/commons/validator/routines/checkdigit/ECNumberCheckDigit.java b/src/main/java/org/apache/commons/validator/routines/checkdigit/ECNumberCheckDigit.java index 3be34804..6ac2ccb4 100644 --- a/src/main/java/org/apache/commons/validator/routines/checkdigit/ECNumberCheckDigit.java +++ b/src/main/java/org/apache/commons/validator/routines/checkdigit/ECNumberCheckDigit.java @@ -29,7 +29,7 @@ import org.apache.commons.validator.routines.CodeValidator; * </p> * * <p> - * Check digit calculation is based on <i>modulus 11</i> with digits being weighted + * Check digit calculation is based on <em>modulus 11</em> with digits being weighted * based on their position (from left to right). * </p> * @@ -74,7 +74,7 @@ public final class ECNumberCheckDigit extends ModulusCheckDigit { } /** - * Calculates the <i>weighted</i> value of a character in the + * Calculates the <em>weighted</em> value of a character in the * code at a specified position. * * <p>For EC number digits are weighted by their position from left to right.</p> diff --git a/src/main/java/org/apache/commons/validator/routines/checkdigit/IBANCheckDigit.java b/src/main/java/org/apache/commons/validator/routines/checkdigit/IBANCheckDigit.java index a09494d8..75687ae2 100644 --- a/src/main/java/org/apache/commons/validator/routines/checkdigit/IBANCheckDigit.java +++ b/src/main/java/org/apache/commons/validator/routines/checkdigit/IBANCheckDigit.java @@ -24,7 +24,7 @@ import java.io.Serializable; * This routine is based on the ISO 7064 Mod 97,10 check digit calculation routine. * <p> * The two check digit characters in a IBAN number are the third and fourth characters - * in the code. For <i>check digit</i> calculation/validation the first four characters are moved + * in the code. For <em>check digit</em> calculation/validation the first four characters are moved * to the end of the code. * So <code>CCDDnnnnnnn</code> becomes <code>nnnnnnnCCDD</code> (where * <code>CC</code> is the country code and <code>DD</code> is the check digit). For @@ -61,7 +61,7 @@ public final class IBANCheckDigit extends AbstractCheckDigit implements Serializ } /** - * Calculate the <i>Check Digit</i> for an IBAN code. + * Calculate the <em>Check Digit</em> for an IBAN code. * <p> * <b>Note:</b> The check digit is the third and fourth * characters and is set to the value "<code>00</code>". diff --git a/src/main/java/org/apache/commons/validator/routines/checkdigit/ISBN10CheckDigit.java b/src/main/java/org/apache/commons/validator/routines/checkdigit/ISBN10CheckDigit.java index 87dc1c3f..bcd60623 100644 --- a/src/main/java/org/apache/commons/validator/routines/checkdigit/ISBN10CheckDigit.java +++ b/src/main/java/org/apache/commons/validator/routines/checkdigit/ISBN10CheckDigit.java @@ -22,7 +22,7 @@ package org.apache.commons.validator.routines.checkdigit; * ISBN-10 Numbers are a numeric code except for the last (check) digit * which can have a value of "X". * <p> - * Check digit calculation is based on <i>modulus 11</i> with digits being weighted + * Check digit calculation is based on <em>modulus 11</em> with digits being weighted * based by their position, from right to left with the first digit being weighted * 1, the second 2 and so on. If the check digit is calculated as "10" it is converted * to "X". @@ -95,7 +95,7 @@ public final class ISBN10CheckDigit extends ModulusCheckDigit { } /** - * Calculates the <i>weighted</i> value of a character in the + * Calculates the <em>weighted</em> value of a character in the * code at a specified position. * * <p>For ISBN-10 (from right to left) digits are weighted diff --git a/src/main/java/org/apache/commons/validator/routines/checkdigit/ISINCheckDigit.java b/src/main/java/org/apache/commons/validator/routines/checkdigit/ISINCheckDigit.java index 1b0341df..d65aa056 100644 --- a/src/main/java/org/apache/commons/validator/routines/checkdigit/ISINCheckDigit.java +++ b/src/main/java/org/apache/commons/validator/routines/checkdigit/ISINCheckDigit.java @@ -25,7 +25,7 @@ package org.apache.commons.validator.routines.checkdigit; * </p> * * <p> - * Check digit calculation uses the <i>Modulus 10 Double Add Double</i> technique + * Check digit calculation uses the <em>Modulus 10 Double Add Double</em> technique * with every second digit being weighted by 2. Alphabetic characters are * converted to numbers by their position in the alphabet starting with A being 10. * Weighted numbers greater than ten are treated as two separate numbers. @@ -87,7 +87,7 @@ public final class ISINCheckDigit extends ModulusCheckDigit { } /** - * <p>Calculates the <i>weighted</i> value of a character in the + * <p>Calculates the <em>weighted</em> value of a character in the * code at a specified position.</p> * * <p>For ISIN (from right to left) <b>odd</b> digits are weighted diff --git a/src/main/java/org/apache/commons/validator/routines/checkdigit/LuhnCheckDigit.java b/src/main/java/org/apache/commons/validator/routines/checkdigit/LuhnCheckDigit.java index e94c9197..46ea0b22 100644 --- a/src/main/java/org/apache/commons/validator/routines/checkdigit/LuhnCheckDigit.java +++ b/src/main/java/org/apache/commons/validator/routines/checkdigit/LuhnCheckDigit.java @@ -25,8 +25,8 @@ package org.apache.commons.validator.routines.checkdigit; * <li><a href="https://en.wikipedia.org/wiki/IMEI">IMEI Numbers</a> - International * Mobile Equipment Identity Numbers</li> * </ul> - * Check digit calculation is based on <i>modulus 10</i> with digits in - * an <i>odd</i> position (from right to left) being weighted 1 and <i>even</i> + * Check digit calculation is based on <em>modulus 10</em> with digits in + * an <em>odd</em> position (from right to left) being weighted 1 and <em>even</em> * position digits being weighted 2 (weighted values greater than 9 have 9 subtracted). * * <p> @@ -53,7 +53,7 @@ public final class LuhnCheckDigit extends ModulusCheckDigit { } /** - * <p>Calculates the <i>weighted</i> value of a character in the + * <p>Calculates the <em>weighted</em> value of a character in the * code at a specified position.</p> * * <p>For Luhn (from right to left) <b>odd</b> digits are weighted diff --git a/src/main/java/org/apache/commons/validator/routines/checkdigit/ModulusCheckDigit.java b/src/main/java/org/apache/commons/validator/routines/checkdigit/ModulusCheckDigit.java index 90df2544..96bfbc73 100644 --- a/src/main/java/org/apache/commons/validator/routines/checkdigit/ModulusCheckDigit.java +++ b/src/main/java/org/apache/commons/validator/routines/checkdigit/ModulusCheckDigit.java @@ -23,10 +23,10 @@ import org.apache.commons.validator.GenericValidator; /** * Abstract <b>Modulus</b> Check digit calculation/validation. * <p> - * Provides a <i>base</i> class for building <i>modulus</i> Check Digit routines. + * Provides a <em>base</em> class for building <em>modulus</em> Check Digit routines. * </p> * <p> - * This implementation only handles <i>single-digit numeric</i> codes, such as <b>EAN-13</b>. For <i>alphanumeric</i> codes such as <b>EAN-128</b> you will need + * This implementation only handles <em>single-digit numeric</em> codes, such as <b>EAN-13</b>. For <em>alphanumeric</em> codes such as <b>EAN-128</b> you will need * to implement/override the <code>toInt()</code> and <code>toChar()</code> methods. * </p> * @@ -76,7 +76,7 @@ public abstract class ModulusCheckDigit extends AbstractCheckDigit implements Se } /** - * Calculate a modulus <i>Check Digit</i> for a code which does not yet have one. + * Calculate a modulus <em>Check Digit</em> for a code which does not yet have one. * * @param code The code for which to calculate the Check Digit; * the check digit should not be included @@ -186,7 +186,7 @@ public abstract class ModulusCheckDigit extends AbstractCheckDigit implements Se } /** - * Calculates the <i>weighted</i> value of a character in the + * Calculates the <em>weighted</em> value of a character in the * code at a specified position. * <p> * Some modulus routines weight the value of a character diff --git a/src/main/java/org/apache/commons/validator/routines/checkdigit/ModulusTenCheckDigit.java b/src/main/java/org/apache/commons/validator/routines/checkdigit/ModulusTenCheckDigit.java index 31e21d5c..4c86fdf0 100644 --- a/src/main/java/org/apache/commons/validator/routines/checkdigit/ModulusTenCheckDigit.java +++ b/src/main/java/org/apache/commons/validator/routines/checkdigit/ModulusTenCheckDigit.java @@ -32,15 +32,15 @@ import org.apache.commons.validator.routines.CodeValidator; * <li>Converting each character to an integer value using * <code>Character.getNumericValue(char)</code> - negative integer values from * that method are invalid.</li> - * <li>Calculating a <i>weighted value</i> by multiplying the character's - * integer value by a <i>weighting factor</i>. The <i>weighting factor</i> is + * <li>Calculating a <em>weighted value</em> by multiplying the character's + * integer value by a <em>weighting factor</em>. The <em>weighting factor</em> is * selected from the configured <code>postitionWeight</code> array based on its * position. The <code>postitionWeight</code> values are used either * left-to-right (when <code>useRightPos=false</code>) or right-to-left (when * <code>useRightPos=true</code>).</li> - * <li>If <code>sumWeightedDigits=true</code>, the <i>weighted value</i> is + * <li>If <code>sumWeightedDigits=true</code>, the <em>weighted value</em> is * re-calculated by summing its digits.</li> - * <li>The <i>weighted values</i> of each character are totalled.</li> + * <li>The <em>weighted values</em> of each character are totalled.</li> * <li>The total modulo 10 will be zero for a code with a valid Check Digit.</li> * </ul> * <h2>Limitations</h2> @@ -76,7 +76,7 @@ import org.apache.commons.validator.routines.CodeValidator; * <p> * <b>CUSIP</b> Check Digit Routine (equivalent of {@link CUSIPCheckDigit}). * Weighting factors are <code>[1, 2]</code> applied from right to left and the - * digits of the <i>weighted value</i> are summed. + * digits of the <em>weighted value</em> are summed. * * <pre> * CheckDigit routine = new ModulusTenCheckDigit(new int[] { 1, 2 }, true, true); @@ -94,7 +94,7 @@ import org.apache.commons.validator.routines.CodeValidator; * <p> * <b>Luhn</b> Check Digit Routine (equivalent of {@link LuhnCheckDigit}). * Weighting factors are <code>[1, 2]</code> applied from right to left and the - * digits of the <i>weighted value</i> are summed. + * digits of the <em>weighted value</em> are summed. * * <pre> * CheckDigit routine = new ModulusTenCheckDigit(new int[] { 1, 2 }, true, true); @@ -228,7 +228,7 @@ public final class ModulusTenCheckDigit extends ModulusCheckDigit { } /** - * Calculates the <i>weighted</i> value of a character in the code at a + * Calculates the <em>weighted</em> value of a character in the code at a * specified position. * * @param charValue The numeric value of the character. diff --git a/src/main/java/org/apache/commons/validator/routines/checkdigit/SedolCheckDigit.java b/src/main/java/org/apache/commons/validator/routines/checkdigit/SedolCheckDigit.java index 2f08fd76..0d75b594 100644 --- a/src/main/java/org/apache/commons/validator/routines/checkdigit/SedolCheckDigit.java +++ b/src/main/java/org/apache/commons/validator/routines/checkdigit/SedolCheckDigit.java @@ -24,7 +24,7 @@ package org.apache.commons.validator.routines.checkdigit; * to identify UK Securities (SEDOL stands for Stock Exchange Daily Official List). * </p> * <p> - * Check digit calculation is based on <i>modulus 10</i> with digits being weighted + * Check digit calculation is based on <em>modulus 10</em> with digits being weighted * based on their position, from left to right, as follows: * </p> * <pre><code> @@ -94,7 +94,7 @@ public final class SedolCheckDigit extends ModulusCheckDigit { } /** - * Calculates the <i>weighted</i> value of a character in the + * Calculates the <em>weighted</em> value of a character in the * code at a specified position. * * @param charValue The numeric value of the character. diff --git a/src/main/java/org/apache/commons/validator/routines/checkdigit/VerhoeffCheckDigit.java b/src/main/java/org/apache/commons/validator/routines/checkdigit/VerhoeffCheckDigit.java index 4df215b9..c5d4ebb1 100644 --- a/src/main/java/org/apache/commons/validator/routines/checkdigit/VerhoeffCheckDigit.java +++ b/src/main/java/org/apache/commons/validator/routines/checkdigit/VerhoeffCheckDigit.java @@ -67,7 +67,7 @@ public final class VerhoeffCheckDigit extends AbstractCheckDigit implements Seri private static final int[] INV_TABLE = {0, 4, 3, 2, 1, 5, 6, 7, 8, 9}; /** - * Calculate a Verhoeff <i>Check Digit</i> for a code. + * Calculate a Verhoeff <em>Check Digit</em> for a code. * * @param code The code to calculate the Check Digit for * @return The calculated Check Digit @@ -107,7 +107,7 @@ public final class VerhoeffCheckDigit extends AbstractCheckDigit implements Seri } /** - * Validate the Verhoeff <i>Check Digit</i> for a code. + * Validate the Verhoeff <em>Check Digit</em> for a code. * * @param code The code to validate * @return {@code true} if the check digit is valid, diff --git a/src/main/java/org/apache/commons/validator/routines/checkdigit/package-info.java b/src/main/java/org/apache/commons/validator/routines/checkdigit/package-info.java index 58a39bd5..ef6a12ed 100644 --- a/src/main/java/org/apache/commons/validator/routines/checkdigit/package-info.java +++ b/src/main/java/org/apache/commons/validator/routines/checkdigit/package-info.java @@ -16,7 +16,7 @@ */ /** - * This package contains <i>Check Digit</i> validation/calculation routines. + * This package contains <em>Check Digit</em> validation/calculation routines. * <p> * Note that these <b>do not validate</b> the input for length or syntax. Such validation is performed by the org.apache.commons.validator.routines.XYZValidator * classes. diff --git a/src/main/java/org/apache/commons/validator/routines/package-info.java b/src/main/java/org/apache/commons/validator/routines/package-info.java index a2a31e5e..750d52d5 100644 --- a/src/main/java/org/apache/commons/validator/routines/package-info.java +++ b/src/main/java/org/apache/commons/validator/routines/package-info.java @@ -16,7 +16,7 @@ */ /** - * This package contains <i>independent</i> validation routines. + * This package contains <em>independent</em> validation routines. * <h2>Table of Contents</h2> * <ul> * <li>1. <a href="#overview">Overview</a></li> @@ -60,7 +60,7 @@ * </p> * <ul> * <li>To provide standard, independent validation routines/functions.</li> - * <li>To provide a <i>mini</i> framework for Validation.</li> + * <li>To provide a <em>mini</em> framework for Validation.</li> * </ul> * <p> * This package has been created, since version 1.3.0, in an attempt to clearly @@ -76,8 +76,8 @@ * <a id="date.overview"></a> * <h2>2.1 Overview</h2> * <p> - * The date and time validators either validate according to a specified <i>format</i> - * or use a standard <i>format</i> for a specified <code>Locale</code>. + * The date and time validators either validate according to a specified <em>format</em> + * or use a standard <em>format</em> for a specified <code>Locale</code>. * </p> * <ul> * <li><a href="DateValidator.html">Date Validator</a> - validates dates @@ -107,35 +107,35 @@ * <p>The following methods are provided to validate a date/time (return a boolean result): * </p> * <ul> - * <li><code>isValid(<i>value</i>)</code></li> - * <li><code>isValid(<i>value</i>, <i>pattern</i>)</code></li> - * <li><code>isValid(<i>value</i>, Locale)</code></li> - * <li><code>isValid(<i>value</i>, <i>pattern</i>, Locale)</code></li> + * <li><code>isValid(<em>value</em>)</code></li> + * <li><code>isValid(<em>value</em>, <em>pattern</em>)</code></li> + * <li><code>isValid(<em>value</em>, Locale)</code></li> + * <li><code>isValid(<em>value</em>, <em>pattern</em>, Locale)</code></li> * </ul> * <p>The following methods are provided to validate a date/time and convert it to either a * <code>java.util.Date</code> or <code>java.util.Calendar</code>: * </p> * <ul> - * <li><code>validate(<i>value</i>)</code></li> - * <li><code>validate(<i>value</i>, <i>pattern</i>)</code></li> - * <li><code>validate(<i>value</i>, Locale)</code></li> - * <li><code>validate(<i>value</i>, <i>pattern</i>, Locale)</code></li> + * <li><code>validate(<em>value</em>)</code></li> + * <li><code>validate(<em>value</em>, <em>pattern</em>)</code></li> + * <li><code>validate(<em>value</em>, Locale)</code></li> + * <li><code>validate(<em>value</em>, <em>pattern</em>, Locale)</code></li> * </ul> * <a id="date.format"></a> * <h2>2.3 Formatting</h2> * <p> * Formatting and validating are two sides of the same coin. Typically - * <i>input</i> values which are converted from Strings according to a - * specified <i>format</i> also have to be rendered for <i>output</i> in + * <em>input</em> values which are converted from Strings according to a + * specified <em>format</em> also have to be rendered for <em>output</em> in * the same format. These validators provide the mechanism for formatting from * date/time objects to Strings. The following methods are provided to format * date/time values as Strings: * </p> * <ul> - * <li><code>format(<i>date/calendar</i>)</code></li> - * <li><code>format(<i>date/calendar</i>, <i>pattern</i>)</code></li> - * <li><code>format(<i>date/calendar</i>, Locale)</code></li> - * <li><code>format(<i>date/calendar</i>, <i>pattern</i>, Locale)</code></li> + * <li><code>format(<em>date/calendar</em>)</code></li> + * <li><code>format(<em>date/calendar</em>, <em>pattern</em>)</code></li> + * <li><code>format(<em>date/calendar</em>, Locale)</code></li> + * <li><code>format(<em>date/calendar</em>, <em>pattern</em>, Locale)</code></li> * </ul> * <a id="date.timezone"></a> * <h2>2.4 Time Zones</h2> @@ -150,19 +150,19 @@ * // Validate/Convert the date using GMT * Date fooDate = validator.validate(fooString, "dd/MM/yyyy", GMT); * </pre> - * <p>The following Time Zone <i>flavors</i> of the Validation/Conversion methods + * <p>The following Time Zone <em>flavors</em> of the Validation/Conversion methods * are provided:</p> * <ul> - * <li><code>validate(<i>value</i>, TimeZone)</code></li> - * <li><code>validate(<i>value</i>, <i>pattern</i>, TimeZone)</code></li> - * <li><code>validate(<i>value</i>, Locale, TimeZone)</code></li> - * <li><code>validate(<i>value</i>, <i>pattern</i>, Locale, TimeZone)</code></li> + * <li><code>validate(<em>value</em>, TimeZone)</code></li> + * <li><code>validate(<em>value</em>, <em>pattern</em>, TimeZone)</code></li> + * <li><code>validate(<em>value</em>, Locale, TimeZone)</code></li> + * <li><code>validate(<em>value</em>, <em>pattern</em>, Locale, TimeZone)</code></li> * </ul> * <a id="date.compare"></a> * <h2>2.5 Comparing Dates and Times</h2> * <p> * As well as validating that a value is a valid date or time, these validators - * also provide <i>date comparison</i> functions. The <code>DateValidator</code> + * also provide <em>date comparison</em> functions. The <code>DateValidator</code> * and <code>CalendarValidator</code> provide functions for comparing years, * quarters, months, weeks and dates and the <code>TimeValidator</code> provides * functions for comparing hours, minutes, seconds and milliseconds. @@ -195,9 +195,9 @@ * <a id="numeric.overview"></a> * <h2>3.1 Overview</h2> * <p> - * The numeric validators either validate according to a specified <i>format</i> - * or use a standard <i>format</i> for a specified <code>Locale</code> or use - * a <i>custom</i> format for a specified <code>Locale</code>. + * The numeric validators either validate according to a specified <em>format</em> + * or use a standard <em>format</em> for a specified <code>Locale</code> or use + * a <em>custom</em> format for a specified <code>Locale</code>. * </p> * <ul> * <li><a href="ByteValidator.html">Byte Validator</a> - validates numbers @@ -226,7 +226,7 @@ * </p> * <p> * The following example validates an integer against a custom pattern - * for the <i>German</i> locale. Please note the format is specified using + * for the <em>German</em> locale. Please note the format is specified using * the standard symbols for <code>java.text.DecimalFormat</code> so although * the decimal separator is indicated as a period (".") in the format, the * validator will check using the German decimal separator - which is a comma (","). @@ -243,41 +243,41 @@ * </pre> * <p>The following methods are provided to validate a number (return a boolean result):</p> * <ul> - * <li><code>isValid(<i>value</i>)</code></li> - * <li><code>isValid(<i>value</i>, <i>pattern</i>)</code></li> - * <li><code>isValid(<i>value</i>, Locale)</code></li> - * <li><code>isValid(<i>value</i>, <i>pattern</i>, Locale)</code></li> + * <li><code>isValid(<em>value</em>)</code></li> + * <li><code>isValid(<em>value</em>, <em>pattern</em>)</code></li> + * <li><code>isValid(<em>value</em>, Locale)</code></li> + * <li><code>isValid(<em>value</em>, <em>pattern</em>, Locale)</code></li> * </ul> * <p>The following methods are provided to validate a number and convert it one of * the <code>java.lang.Number</code> implementations:</p> * <ul> - * <li><code>validate(<i>value</i>)</code></li> - * <li><code>validate(<i>value</i>, <i>pattern</i>)</code></li> - * <li><code>validate(<i>value</i>, Locale)</code></li> - * <li><code>validate(<i>value</i>, <i>pattern</i>, Locale)</code></li> + * <li><code>validate(<em>value</em>)</code></li> + * <li><code>validate(<em>value</em>, <em>pattern</em>)</code></li> + * <li><code>validate(<em>value</em>, Locale)</code></li> + * <li><code>validate(<em>value</em>, <em>pattern</em>, Locale)</code></li> * </ul> * <a id="numeric.format"></a> * <h2>3.3 Formatting</h2> * <p> * Formatting and validating are two sides of the same coin. Typically - * <i>input</i> values which are converted from Strings according to a - * specified <i>format</i> also have to be rendered for <i>output</i> in + * <em>input</em> values which are converted from Strings according to a + * specified <em>format</em> also have to be rendered for <em>output</em> in * the same format. These validators provide the mechanism for formatting from * numeric objects to Strings. The following methods are provided to format * numeric values as Strings: * </p> * <ul> - * <li><code>format(<i>number</i>)</code></li> - * <li><code>format(<i>number</i>, <i>pattern</i>)</code></li> - * <li><code>format(<i>number</i>, Locale)</code></li> - * <li><code>format(<i>number</i>, <i>pattern</i>, Locale)</code></li> + * <li><code>format(<em>number</em>)</code></li> + * <li><code>format(<em>number</em>, <em>pattern</em>)</code></li> + * <li><code>format(<em>number</em>, Locale)</code></li> + * <li><code>format(<em>number</em>, <em>pattern</em>, Locale)</code></li> * </ul> * <a id="numeric.compare"></a> * <h2>3.4 Comparing Numbers</h2> * <p> * As well as validating that a value is a valid number, these validators - * also provide functions for validating the <i>minimum</i>, <i>maximum</i> - * and <i>range</i> of a value. + * also provide functions for validating the <em>minimum</em>, <em>maximum</em> + * and <em>range</em> of a value. * </p> * <pre> * // Check the number is between 25 and 75 @@ -290,11 +290,11 @@ * <h2>3.5 Currency Validation</h2> * <p> * A default <a href="CurrencyValidator.html">Currency Validator</a> - * implementation is provided, although all the <i>numeric</i> validators + * implementation is provided, although all the <em>numeric</em> validators * support currency validation. The default implementation converts * currency amounts to a <code>java.math.BigDecimal</code> and additionally - * it provides <i>lenient</i> currency symbol validation. That is, currency - * amounts are valid with <i>or</i> without the currency symbol. + * it provides <em>lenient</em> currency symbol validation. That is, currency + * amounts are valid with <em>or</em> without the currency symbol. * </p> * <pre> * BigDecimalValidator validator = CurrencyValidator.getInstance(); @@ -312,8 +312,8 @@ * <p> * If, for example, you want to use the <a href="IntegerValidator.html">Integer * Validator</a> to validate a currency, then you can simply create a - * new instance with the appropriate <i>format style</i>. Note that - * the other validators do not support the <i>lenient</i> currency symbol + * new instance with the appropriate <em>format style</em>. Note that + * the other validators do not support the <em>lenient</em> currency symbol * validation. * </p> * <pre> @@ -330,12 +330,12 @@ * <h2>3.6 Percent Validation</h2> * <p> * A default <a href="PercentValidator.html">Percent Validator</a> - * implementation is provided, although the <i>Float</i>, - * <i>Double</i> and <i>BigDecimal</i> validators also support + * implementation is provided, although the <em>Float</em>, + * <em>Double</em> and <em>BigDecimal</em> validators also support * percent validation. The default implementation converts * percent amounts to a <code>java.math.BigDecimal</code> and additionally - * it provides <i>lenient</i> percent symbol validation. That is, percent - * amounts are valid with <i>or</i> without the percent symbol. + * it provides <em>lenient</em> percent symbol validation. That is, percent + * amounts are valid with <em>or</em> without the percent symbol. * </p> * <pre> * BigDecimalValidator validator = PercentValidator.getInstance(); @@ -353,8 +353,8 @@ * <p> * If, for example, you want to use the <a href="FloatValidator.html">Float * Validator</a> to validate a percent, then you can simply create a - * new instance with the appropriate <i>format style</i>. Note that - * the other validators do not support the <i>lenient</i> percent symbol + * new instance with the appropriate <em>format style</em>. Note that + * the other validators do not support the <em>lenient</em> percent symbol * validation. * </p> * <pre> @@ -368,8 +368,8 @@ * </pre> * <p> * <strong>Note</strong>: in theory the other numeric validators besides - * <i>Float</i>, <i>Double</i> and <i>BigDecimal</i> (i.e. <i>Byte</i>, - * <i>Short</i>, <i>Integer</i>, <i>Long</i> and <i>BigInteger</i>) + * <em>Float</em>, <em>Double</em> and <em>BigDecimal</em> (i.e. <em>Byte</em>, + * <em>Short</em>, <em>Integer</em>, <em>Long</em> and <em>BigInteger</em>) * also support percent validation. However, since they don't allow fractions * they will only work with percentages greater than 100%. * </p> @@ -401,25 +401,25 @@ * <a id="other.regex"></a> * <h2>4.2 Regular Expression Validation</h2> * <p> - * Regular expression validation can be done either by using the <i>static</i> + * Regular expression validation can be done either by using the <em>static</em> * methods provied by <a href="RegexValidator.html">RegexValidator</a> or * by creating a new instance, which caches and re-uses compiled Patterns. * </p> * <ul> - * <li><b>Method Flavours</b> - three <i>flavors</i> of validation metods are provided:</li> + * <li><b>Method Flavours</b> - three <em>flavors</em> of validation metods are provided:</li> * <li> * <ul> * <li><code>isValid()</code> methods return true/false to indicate * whether validation was successful.</li> * <li><code>validate()</code> methods return a <code>String</code> - * value of the matched <i>groups</i> aggregated together or + * value of the matched <em>groups</em> aggregated together or * {@code null} if invalid.</li> * <li><code>match()</code> methods return a <code>String</code> array - * of the matched <i>groups</i> or {@code null} if invalid.</li> + * of the matched <em>groups</em> or {@code null} if invalid.</li> * </ul> * </li> * <li><b>Case Sensitivity</b> - matching can be done in either a <i>case - * sensitive</i> or <i>case in-sensitive</i> way.</li> + * sensitive</i> or <em>case in-sensitive</em> way.</li> * <li><b>Multiple Expressions</b> - instances of the * <a href="RegexValidator.html">RegexValidator</a> * can be created to either match against a single regular expression @@ -427,7 +427,7 @@ * </ul> * <p> * Below is an example of using one of the static methods to validate, - * matching in a <i>case insensitive</i> manner and returning a String + * matching in a <em>case insensitive</em> manner and returning a String * of the matched groups (which doesn't include the hyphen). * </p> * <pre> @@ -440,16 +440,16 @@ * <p>The following static methods are provided for regular expression validation: * </p> * <ul> - * <li><code>isValid(<i>value</i>, <i>regex</i>)</code></li> - * <li><code>isValid(<i>value</i>, <i>regex</i>, <i>caseSensitive</i>)</code></li> - * <li><code>validate(<i>value</i>, <i>regex</i>)</code></li> - * <li><code>validate(<i>value</i>, <i>regex</i>, <i>caseSensitive</i>)</code></li> - * <li><code>match(<i>value</i>, <i>regex</i>)</code></li> - * <li><code>match(<i>value</i>, <i>regex</i>, <i>caseSensitive</i>)</code></li> + * <li><code>isValid(<em>value</em>, <em>regex</em>)</code></li> + * <li><code>isValid(<em>value</em>, <em>regex</em>, <em>caseSensitive</em>)</code></li> + * <li><code>validate(<em>value</em>, <em>regex</em>)</code></li> + * <li><code>validate(<em>value</em>, <em>regex</em>, <em>caseSensitive</em>)</code></li> + * <li><code>match(<em>value</em>, <em>regex</em>)</code></li> + * <li><code>match(<em>value</em>, <em>regex</em>, <em>caseSensitive</em>)</code></li> * </ul> * <p> * Below is an example of creating an instance of - * <a href="RegexValidator.html">RegexValidator</a> matching in a <i>case insensitive</i> + * <a href="RegexValidator.html">RegexValidator</a> matching in a <em>case insensitive</em> * manner against a set of regular expressions: * </p> * <pre> @@ -479,9 +479,9 @@ * following methods: * </p> * <ul> - * <li><code>isValid(<i>code</i>)</code> - validates the check digit of a code, + * <li><code>isValid(<em>code</em>)</code> - validates the check digit of a code, * returning {@code true} or {@code false}.</li> - * <li><code>calculate(<i>code</i>)</code> - calulates the check digit for a code + * <li><code>calculate(<em>code</em>)</code> - calulates the check digit for a code * returning the check digit character.</li> * </ul> * <p> @@ -551,11 +551,11 @@ * </p> * <ul> * <li><b>Format</b> - the format of the code is validated using - * a <i>regular expression</i> (see <a href="RegexValidator.html">RegexValidator</a>).</li> + * a <em>regular expression</em> (see <a href="RegexValidator.html">RegexValidator</a>).</li> * <li><b>Length</b> - the minimum/maximum length of the code is * checked - after being parsed by the regular expression - with which - * <i>format</i> characters can be removed with the use of - * <i>non-capturing</i> groups.</li> + * <em>format</em> characters can be removed with the use of + * <em>non-capturing</em> groups.</li> * <li><b>Check Digit</b> - a <a href="checkdigit/CheckDigit.html">CheckDigit</a> * routine checks that code's check digit is valid.</li> * </ul> @@ -575,7 +575,7 @@ * <h2>4.5 ISBN validation</h2> * <p> * <a href="ISBNValidator.html">ISBNValidator</a> provides ISBN-10 - * and ISBN-13 validation and can <i>optionally</i> convert + * and ISBN-13 validation and can <em>optionally</em> convert * ISBN-10 codes to ISBN-13. * </p> * <ul> @@ -585,8 +585,8 @@ * routine.</li> * <li> * <ul> - * <li><code>isValidISBN10(<i>value</i>)</code> - returns a boolean</li> - * <li><code>validateISBN10(<i>value</i>)</code> - returns a reformatted ISBN-10 code</li> + * <li><code>isValidISBN10(<em>value</em>)</code> - returns a boolean</li> + * <li><code>validateISBN10(<em>value</em>)</code> - returns a reformatted ISBN-10 code</li> * </ul> * </li> * <li><b>ISBN-13</b> - validates using a @@ -595,17 +595,17 @@ * routine.</li> * <li> * <ul> - * <li><code>isValidISBN13(<i>value</i>)</code> - returns a boolean</li> - * <li><code>validateISBN13(<i>value</i>)</code> - returns a reformatted ISBN-13 code</li> + * <li><code>isValidISBN13(<em>value</em>)</code> - returns a boolean</li> + * <li><code>validateISBN13(<em>value</em>)</code> - returns a reformatted ISBN-13 code</li> * </ul> * </li> * <li><b>ISBN-10</b> and <b>ISBN-13</b> - validates codes are either * valid ISBN-10 or valid ISBN-13 - optionally can convert ISBN-10 codes to ISBN-13.</li> * <li> * <ul> - * <li><code>isValid(<i>value</i>)</code> - returns a boolean</li> - * <li><code>validate(<i>value</i>)</code> - returns a reformatted ISBN code - * (converts ISBN-10 to ISBN-13 if the <i>convert</i> option is {@code true}).</li> + * <li><code>isValid(<em>value</em>)</code> - returns a boolean</li> + * <li><code>validate(<em>value</em>)</code> - returns a reformatted ISBN code + * (converts ISBN-10 to ISBN-13 if the <em>convert</em> option is {@code true}).</li> * </ul> * </li> * </ul>