org.apache.oro.text.awk.AwkCompiler
-- *
-+ *
- * @param regex The regular expression on which to filter.
- * @param options A set of compilation options.
- * @exception MalformedCachePatternException If there is an error in
---- jakarta-oro-2.0.8/src/java/org/apache/oro/io/GlobFilenameFilter.java 2022-03-19 12:16:14.327229056 +0100
-+++ jakarta-oro-2.0.8/src/java/org/apache/oro/io/GlobFilenameFilter.java 2022-03-19 13:34:36.903481666 +0100
-@@ -83,7 +83,7 @@
- * Construct a filter initialized with the indicated regular expression
- * and accompanying compilation options conforming to those used by
- * org.apache.oro.text.GlobCompiler
-- *
-+ *
- * @param regex The regular expression on which to filter.
- * @param options A set of compilation options.
- * @exception MalformedCachePatternException If there is an error in
---- jakarta-oro-2.0.8/src/java/org/apache/oro/io/Perl5FilenameFilter.java 2022-03-19 12:16:14.327229056 +0100
-+++ jakarta-oro-2.0.8/src/java/org/apache/oro/io/Perl5FilenameFilter.java 2022-03-19 13:30:11.233884317 +0100
-@@ -83,7 +83,7 @@
- * Construct a filter initialized with the indicated regular expression
- * and accompanying compilation options conforming to those used by
- * org.apache.oro.text.regex.Perl5Compiler
-- *
-+ * - * @param regex The regular expression on which to filter. - * @param options A set of compilation options. - * @exception MalformedCachePatternException If there is an error in ---- jakarta-oro-2.0.8/src/java/org/apache/oro/io/RegexFilenameFilter.java 2022-03-19 12:16:14.327229056 +0100 -+++ jakarta-oro-2.0.8/src/java/org/apache/oro/io/RegexFilenameFilter.java 2022-03-19 13:12:46.155601506 +0100 -@@ -101,7 +101,7 @@ - - /** - * Set the regular expression on which to filter. -- *
-+ * - * @param regex The regular expression on which to filter. - * @exception MalformedCachePatternException If there is an error in - * compiling the regular expression. This need not be caught if -@@ -118,7 +118,7 @@ - /** - * Set the regular expression on which to filter along with any - * special options to use when compiling the expression. -- *
-+ * - * @param regex The regular expression on which to filter. - * @param options A set of compilation options specific to the regular - * expression grammar being used. -@@ -138,7 +138,7 @@ - * Filters a filename. Tests if the filename EXACTLY matches the pattern - * contained by the filter. The directory argument is not examined. - * Conforms to the java.io.FilenameFilter interface. -- *
-+ * - * @param dir The directory containing the file. - * @param filename The name of the file. - * @return True if the filename EXACTLY matches the pattern, false if not. -@@ -153,7 +153,7 @@ - * Filters a filename. Tests if the filename EXACTLY matches the pattern - * contained by the filter. The filename is defined as pathname.getName(). - * Conforms to the java.io.FileFilter interface. -- *
-+ * - * @param pathname The file pathname. - * @return True if the filename EXACTLY matches the pattern, false if not. - */ ---- jakarta-oro-2.0.8/src/java/org/apache/oro/text/awk/AwkCompiler.java 2022-03-19 12:16:14.327229056 +0100 -+++ jakarta-oro-2.0.8/src/java/org/apache/oro/text/awk/AwkCompiler.java 2022-03-19 13:13:14.331770872 +0100 -@@ -78,7 +78,7 @@ - *
-+ * - * @param pattern An Awk regular expression to compile. - * @param options A set of flags giving the compiler instructions on - * how to treat the regular expression. Currently the -@@ -843,7 +843,7 @@ - /** - * Compiles an Awk regular expression into an AwkPattern instance that - * can be used by an AwkMatcher object to perform pattern matching. -- *
-+ * - * @param pattern An Awk regular expression to compile. - * @param options A set of flags giving the compiler instructions on - * how to treat the regular expression. Currently the -@@ -874,7 +874,7 @@ - - /** - * Same as calling compile(pattern, AwkCompiler.DEFAULT_MASK); -- *
-+ * - * @param pattern A regular expression to compile. - * @return A Pattern instance constituting the compiled regular expression. - * This instance will always be an AwkPattern and can be reliably -@@ -889,7 +889,7 @@ - - /** - * Same as calling compile(pattern, AwkCompiler.DEFAULT_MASK); -- *
-+ * - * @param pattern A regular expression to compile. - * @return A Pattern instance constituting the compiled regular expression. - * This instance will always be an AwkPattern and can be reliably ---- jakarta-oro-2.0.8/src/java/org/apache/oro/text/awk/AwkMatcher.java 2022-03-19 12:16:14.323229032 +0100 -+++ jakarta-oro-2.0.8/src/java/org/apache/oro/text/awk/AwkMatcher.java 2022-03-19 13:12:25.427476908 +0100 -@@ -110,7 +110,7 @@ - *
- * This method is useful for certain common token identification tasks - * that are made more difficult without this functionality. -- *
-+ * - * @param input The char[] to test for a prefix match. - * @param pattern The Pattern to be matched. - * @param offset The offset at which to start searching for the prefix. -@@ -158,7 +158,7 @@ - *
- * This method is useful for certain common token identification tasks - * that are made more difficult without this functionality. -- *
-+ * - * @param input The char[] to test for a prefix match. - * @param pattern The Pattern to be matched. - * @return True if input matches pattern, false otherwise. -@@ -176,7 +176,7 @@ - *
- * This method is useful for certain common token identification tasks - * that are made more difficult without this functionality. -- *
-+ * - * @param input The String to test for a prefix match. - * @param pattern The Pattern to be matched. - * @return True if input matches pattern, false otherwise. -@@ -199,7 +199,7 @@ - *
- * This method is useful for certain common token identification tasks - * that are made more difficult without this functionality. -- *
-+ * - * @param input The PatternMatcherInput to test for a prefix match. - * @param pattern The Pattern to be matched. - * @return True if input matches pattern, false otherwise. -@@ -247,7 +247,7 @@ - * (for performance reasons), catch a ClassCastException because it - * will never be thrown as long as you use an AwkPattern as the pattern - * parameter. -- *
-+ * - * @param input The char[] to test for an exact match. - * @param pattern The AwkPattern to be matched. - * @return True if input matches pattern, false otherwise. -@@ -295,7 +295,7 @@ - * (for performance reasons), catch a ClassCastException because it - * will never be thrown as long as you use an AwkPattern as the pattern - * parameter. -- *
-+ * - * @param input The String to test for an exact match. - * @param pattern The AwkPattern to be matched. - * @return True if input matches pattern, false otherwise. -@@ -324,7 +324,7 @@ - * indeed should NOT try to (for performance reasons), catch a - * ClassCastException because it will never be thrown as long as you use - * an AwkPattern as the pattern parameter. -- *
-+ * - * @param input The PatternMatcherInput to test for a match. - * @param pattern The AwkPattern to be matched. - * @return True if input matches pattern, false otherwise. -@@ -379,7 +379,7 @@ - * indeed should NOT try to (for performance reasons), catch a - * ClassCastException because it will never be thrown as long as you use - * an AwkPattern as the pattern parameter. -- *
-+ * - * @param input The char[] to test for a match. - * @param pattern The AwkPattern to be matched. - * @return True if the input contains a pattern match, false otherwise. -@@ -426,7 +426,7 @@ - * indeed should NOT try to (for performance reasons), catch a - * ClassCastException because it will never be thrown as long as you use - * an AwkPattern as the pattern parameter. -- *
-+ * - * @param input The String to test for a match. - * @param pattern The AwkPattern to be matched. - * @return True if the input contains a pattern match, false otherwise. -@@ -495,7 +495,7 @@ - * } - * - * -- *
-+ * - * @param input The PatternMatcherInput to test for a match. - * @param pattern The Pattern to be matched. - * @return True if the input contains a pattern match, false otherwise. -@@ -587,7 +587,7 @@ - * } - * - * -- *
-+ * - * @param input The PatternStreamInput to test for a match. - * @param pattern The Pattern to be matched. - * @return True if the input contains a pattern match, false otherwise. -@@ -744,7 +744,7 @@ - /** - * Fetches the last match found by a call to a matches() or contains() - * method. -- *
-+ * - * @return A MatchResult instance containing the pattern match found - * by the last call to any one of the matches() or contains() - * methods. If no match was found by the last call, returns ---- jakarta-oro-2.0.8/src/java/org/apache/oro/text/awk/AwkPattern.java 2022-03-19 12:16:14.327229056 +0100 -+++ jakarta-oro-2.0.8/src/java/org/apache/oro/text/awk/AwkPattern.java 2022-03-19 13:16:02.808783643 +0100 -@@ -190,7 +190,7 @@ - - /** - * This method returns the string representation of the pattern. -- *
-+ * - * @return The original string representation of the regular expression - * pattern. - */ -@@ -200,7 +200,7 @@ - /** - * This method returns an integer containing the compilation options used - * to compile this pattern. -- *
-+ * - * @return The compilation options used to compile the pattern. - */ - public int getOptions() { return _options; } ---- jakarta-oro-2.0.8/src/java/org/apache/oro/text/awk/AwkStreamInput.java 2022-03-19 12:16:14.323229032 +0100 -+++ jakarta-oro-2.0.8/src/java/org/apache/oro/text/awk/AwkStreamInput.java 2022-03-19 13:16:50.229068710 +0100 -@@ -110,7 +110,7 @@ - /** - * Creates an AwkStreamInput instance bound to a Reader with a - * specified initial buffer size and default buffer increment. -- *
-+ * - * @param input The InputStream to associate with the AwkStreamInput - * instance. - * @param bufferIncrement The initial buffer size and the default buffer -@@ -129,7 +129,7 @@ - /** - * Creates an AwkStreamInput instance bound to a Reader with an - * initial buffer size and default buffer increment of 2048 bytes. -- *
-+ * - * @param input The InputStream to associate with the AwkStreamInput - * instance. - */ ---- jakarta-oro-2.0.8/src/java/org/apache/oro/text/GenericPatternCache.java 2022-03-19 12:16:14.323229032 +0100 -+++ jakarta-oro-2.0.8/src/java/org/apache/oro/text/GenericPatternCache.java 2022-03-19 13:33:55.955235458 +0100 -@@ -93,7 +93,7 @@ - * The primary constructor for GenericPatternCache. It has default - * access so it will only be used within the package. It initializes - * _cache and _compiler to the arguments provided. -- *
-+ * - * @param cache The cache with which to store patterns. - * @param compiler The PatternCompiler that should be used to compile - * patterns. -@@ -120,7 +120,7 @@ - *
- * The expected behavior of this method should be to start replacing - * patterns in the cache only after the cache has been filled to capacity. -- *
-+ * - * @param expression The regular expression to add to the cache. - * @param options The compilation options to use when compiling the - * expression. -@@ -177,7 +177,7 @@ - * you are NOT forced to catch it by the compiler. Please refer to - * {@link MalformedCachePatternException} for a discussion of - * when you should and shouldn't catch this exception. -- *
-+ * - * @param expression The regular expression to fetch from the cache in - * compiled form. - * @param options The compilation options to use when compiling the -@@ -221,7 +221,7 @@ - * Returns the number of elements in the cache, not to be confused with - * the {@link #capacity()} which returns the number - * of elements that can be held in the cache at one time. -- *
-+ * - * @return The current size of the cache (i.e., the number of elements - * currently cached). - */ -@@ -229,7 +229,7 @@ - - /** - * Returns the maximum number of patterns that can be cached at one time. -- *
-+ * - * @return The maximum number of patterns that can be cached at one time. - */ - public final int capacity() { return _cache.capacity(); } ---- jakarta-oro-2.0.8/src/java/org/apache/oro/text/GlobCompiler.java 2022-03-19 12:16:14.323229032 +0100 -+++ jakarta-oro-2.0.8/src/java/org/apache/oro/text/GlobCompiler.java 2022-03-19 13:08:23.026019700 +0100 -@@ -180,7 +180,7 @@ - * converting the glob pattern to a Perl5 pattern using this method, and - * then invoking the compile() method of an internally stored Perl5Compiler - * instance. -- *
-+ * - * @param pattern A character array representation of a Glob pattern. - * @return A String representation of a Perl5 pattern equivalent to the - * Glob pattern. -@@ -273,7 +273,7 @@ - /** - * Compiles a Glob expression into a Perl5Pattern instance that - * can be used by a Perl5Matcher object to perform pattern matching. -- *
-+ * - * @param pattern A Glob expression to compile. - * @param options A set of flags giving the compiler instructions on - * how to treat the glob expression. The flags -@@ -307,7 +307,7 @@ - - /** - * Same as calling compile(pattern, GlobCompiler.DEFAULT_MASK); -- *
-+ * - * @param pattern A regular expression to compile. - * @return A Pattern instance constituting the compiled regular expression. - * This instance will always be a Perl5Pattern and can be reliably -@@ -321,7 +321,7 @@ - - /** - * Same as calling compile(pattern, GlobCompiler.DEFAULT_MASK); -- *
-+ * - * @param pattern A regular expression to compile. - * @return A Pattern instance constituting the compiled regular expression. - * This instance will always be a Perl5Pattern and can be reliably -@@ -336,7 +336,7 @@ - /** - * Compiles a Glob expression into a Perl5Pattern instance that - * can be used by a Perl5Matcher object to perform pattern matching. -- *
-+ * - * @param pattern A Glob expression to compile. - * @param options A set of flags giving the compiler instructions on - * how to treat the glob expression. The flags ---- jakarta-oro-2.0.8/src/java/org/apache/oro/text/MalformedCachePatternException.java 2022-03-19 12:16:14.323229032 +0100 -+++ jakarta-oro-2.0.8/src/java/org/apache/oro/text/MalformedCachePatternException.java 2022-03-19 13:34:58.579611992 +0100 -@@ -89,7 +89,7 @@ - - /** - * Simply calls the corresponding constructor of its superclass. -- *
-+ * - * @param message A message indicating the nature of the error. - */ - public MalformedCachePatternException(String message) { ---- jakarta-oro-2.0.8/src/java/org/apache/oro/text/MatchAction.java 2022-03-19 12:16:14.323229032 +0100 -+++ jakarta-oro-2.0.8/src/java/org/apache/oro/text/MatchAction.java 2022-03-19 13:36:00.059981636 +0100 -@@ -76,7 +76,7 @@ - * This method is called by MatchActionProcessor when it finds an associated - * pattern in a line of input. Information pertaining to the matched - * line is included in the MatchActionInfo parameter. -- *
-+ * - * @see MatchActionProcessor - * @see MatchActionInfo - * @param matchInfo The match information associated with the line ---- jakarta-oro-2.0.8/src/java/org/apache/oro/text/MatchActionProcessor.java 2022-03-19 12:16:14.323229032 +0100 -+++ jakarta-oro-2.0.8/src/java/org/apache/oro/text/MatchActionProcessor.java 2022-03-19 13:37:07.452386825 +0100 -@@ -87,7 +87,7 @@ - * classes are used. Here's an example of how you might use - * MatchActionProcessor to extract only the second column of a semicolon - * delimited file: -- *
-+ * - *
- * import java.io.*;
- *
-@@ -154,7 +154,7 @@
- * default, which means that matched lines will not be split into separate
- * fields unless the field separator is set with
- * {@link #setFieldSeparator setFieldSeparator()}.
-- *
-+ *
- * @param compiler The PatternCompiler to use to compile registered
- * patterns.
- * @param matcher The PatternMatcher to use when searching for matches.
-@@ -180,7 +180,7 @@
- * Registers a pattern action pair, providing options to be used to
- * compile the pattern. If a pattern is null, the action
- * is performed for every line of input.
-- *
-+ *
- * @param pattern The pattern to bind to an action.
- * @param options The compilation options to use for the pattern.
- * @param action The action to associate with the pattern.
-@@ -201,7 +201,7 @@
- * used to compile the pattern. The default action is to simply print
- * the matched line to the output. If a pattern is null, the action
- * is performed for every line of input.
-- *
-+ *
- * @param pattern The pattern to bind to an action.
- * @param options The compilation options to use for the pattern.
- * @exception MalformedPatternException If the pattern cannot be compiled.
-@@ -216,7 +216,7 @@
- * Binds a patten to the default action. The default action is to simply
- * print the matched line to the output. If a pattern is null, the action
- * is performed for every line of input.
-- *
-+ *
- * @param pattern The pattern to bind to an action.
- * @exception MalformedPatternException If the pattern cannot be compiled.
- */
-@@ -228,7 +228,7 @@
- /**
- * Registers a pattern action pair. If a pattern is null, the action
- * is performed for every line of input.
-- *
-+ *
- * @param pattern The pattern to bind to an action.
- * @param action The action to associate with the pattern.
- * @exception MalformedPatternException If the pattern cannot be compiled.
-@@ -243,7 +243,7 @@
- * Sets the field separator to use when splitting a line into fields.
- * If the field separator is never set, or set to null, matched input
- * lines are not split into fields.
-- *
-+ *
- * @param separator A regular expression defining the field separator.
- * @param options The options to use when compiling the separator.
- * @exception MalformedPatternException If the separator cannot be compiled.
-@@ -263,7 +263,7 @@
- * Sets the field separator to use when splitting a line into fields.
- * If the field separator is never set, or set to null, matched input
- * lines are not split into fields.
-- *
-+ *
- * @param separator A regular expression defining the field separator.
- * @exception MalformedPatternException If the separator cannot be compiled.
- */
-@@ -290,7 +290,7 @@
- *
- * The input stream, having been exhausted, is closed right before the
- * method terminates and the output stream is flushed.
-- *
-+ *
- * @see MatchActionInfo
- * @param input The input stream from which to read lines.
- * @param output Where to send output.
-@@ -328,7 +328,6 @@
- *
- * The input stream, having been exhausted, is closed right before the
- * method terminates and the output stream is flushed.
-- *
- *
- * @see MatchActionInfo
- * @param input The input stream from which to read lines.
-@@ -359,7 +358,7 @@
- *
- * The input stream, having been exhausted, is closed right before the
- * method terminates and the output stream is flushed.
-- *
-+ *
- * @see MatchActionInfo
- * @param input The input stream from which to read lines.
- * @param output Where to send output.
---- jakarta-oro-2.0.8/src/java/org/apache/oro/text/PatternCacheFIFO2.java 2022-03-19 12:16:14.323229032 +0100
-+++ jakarta-oro-2.0.8/src/java/org/apache/oro/text/PatternCacheFIFO2.java 2022-03-19 13:38:40.012943333 +0100
-@@ -86,7 +86,7 @@
- /**
- * Creates a PatternCacheFIFO2 instance with a given cache capacity,
- * initialized to use a given PatternCompiler instance as a pattern compiler.
-- *
-+ *
- * @param capacity The capacity of the cache.
- * @param compiler The PatternCompiler to use to compile patterns.
- */
---- jakarta-oro-2.0.8/src/java/org/apache/oro/text/PatternCacheFIFO.java 2022-03-19 12:16:14.323229032 +0100
-+++ jakarta-oro-2.0.8/src/java/org/apache/oro/text/PatternCacheFIFO.java 2022-03-19 13:38:35.692917358 +0100
-@@ -79,7 +79,7 @@
- /**
- * Creates a PatternCacheFIFO instance with a given cache capacity,
- * initialized to use a given PatternCompiler instance as a pattern compiler.
-- *
-+ *
- * @param capacity The capacity of the cache.
- * @param compiler The PatternCompiler to use to compile patterns.
- */
---- jakarta-oro-2.0.8/src/java/org/apache/oro/text/PatternCache.java 2022-03-19 12:16:14.323229032 +0100
-+++ jakarta-oro-2.0.8/src/java/org/apache/oro/text/PatternCache.java 2022-03-19 12:50:30.431573186 +0100
-@@ -93,7 +93,7 @@
- *
- * The expected behavior of this method should be to start replacing
- * patterns in the cache only after the cache has been filled to capacity.
-- *
-+ *
- * @param expression The regular expression to add to the cache.
- * @return The Pattern corresponding to the String representation of the
- * regular expression.
-@@ -120,7 +120,7 @@
- *
- * The expected behavior of this method should be to start replacing
- * patterns in the cache only after the cache has been filled to capacity.
-- *
-+ *
- * @param expression The regular expression to add to the cache.
- * @param options The compilation options to use when compiling the
- * expression.
-@@ -144,7 +144,7 @@
- * you are NOT forced to catch it by the compiler. Please refer to
- * {@link MalformedCachePatternException} for a discussion of when you
- * should and shouldn't catch this exception.
-- *
-+ *
- * @param expression The regular expression to fetch from the cache in
- * compiled form.
- * @return The Pattern corresponding to the String representation of the
-@@ -167,7 +167,7 @@
- * you are NOT forced to catch it by the compiler. Please refer to
- * {@link MalformedCachePatternException} for a discussion of when you
- * should and shouldn't catch this exception.
-- *
-+ *
- * @param expression The regular expression to fetch from the cache in
- * compiled form.
- * @param options The compilation options to use when compiling the
-@@ -185,7 +185,7 @@
- * Returns the number of elements in the cache, not to be confused with
- * the {@link #capacity()} which returns the number
- * of elements that can be held in the cache at one time.
-- *
-+ *
- * @return The current size of the cache (i.e., the number of elements
- * currently cached).
- */
-@@ -194,7 +194,7 @@
-
- /**
- * Returns the maximum number of patterns that can be cached at one time.
-- *
-+ *
- * @return The maximum number of patterns that can be cached at one time.
- */
- public int capacity();
---- jakarta-oro-2.0.8/src/java/org/apache/oro/text/PatternCacheLRU.java 2022-03-19 12:16:14.323229032 +0100
-+++ jakarta-oro-2.0.8/src/java/org/apache/oro/text/PatternCacheLRU.java 2022-03-19 13:42:08.118195389 +0100
-@@ -81,7 +81,7 @@
- * Creates a PatternCacheLRU instance with a given cache capacity,
- * and initialized to use a given PatternCompiler instance as a pattern
- * compiler.
-- *
-+ *
- * @param capacity The capacity of the cache.
- * @param compiler The PatternCompiler to use to compile patterns.
- */
---- jakarta-oro-2.0.8/src/java/org/apache/oro/text/PatternCacheRandom.java 2022-03-19 12:16:14.323229032 +0100
-+++ jakarta-oro-2.0.8/src/java/org/apache/oro/text/PatternCacheRandom.java 2022-03-19 13:39:27.317227758 +0100
-@@ -80,7 +80,7 @@
- * Creates a PatternCacheRandom instance with a given cache capacity
- * and initialized to use a given PatternCompiler instance as a pattern
- * compiler.
-- *
-+ *
- * @param capacity The capacity of the cache.
- * @param compiler The PatternCompiler to use to compile patterns.
- */
---- jakarta-oro-2.0.8/src/java/org/apache/oro/text/perl/MalformedPerl5PatternException.java 2022-03-19 12:16:14.327229056 +0100
-+++ jakarta-oro-2.0.8/src/java/org/apache/oro/text/perl/MalformedPerl5PatternException.java 2022-03-19 13:35:39.067855424 +0100
-@@ -91,7 +91,7 @@
-
- /**
- * Simply calls the corresponding constructor of its superclass.
-- *
-+ *
- * @param message A message indicating the nature of the error.
- */
- public MalformedPerl5PatternException(String message) {
---- jakarta-oro-2.0.8/src/java/org/apache/oro/text/perl/Perl5Util.java 2022-03-19 12:16:14.327229056 +0100
-+++ jakarta-oro-2.0.8/src/java/org/apache/oro/text/perl/Perl5Util.java 2022-03-19 13:27:36.984956911 +0100
-@@ -270,7 +270,7 @@
- * then parses the expression and fetches a compiled pattern from the
- * pattern cache. Otherwise, just uses the pattern found in the
- * expression cache. __matchPattern is used to parse the expression.
-- *
-+ *
- * @param pattern The Perl5 match expression to parse.
- * @exception MalformedPerl5PatternException If there is an error parsing
- * the expression.
-@@ -340,7 +340,7 @@
- *
- * The m prefix is optional and the meaning of the optional
- * trailing options are:
-- *
-+ *
- * @param pattern The pattern to search for.
- * @param input The char[] input to search.
- * @return True if the input contains the pattern, false otherwise.
-@@ -390,7 +390,7 @@
- *
- * The m prefix is optional and the meaning of the optional
- * trailing options are:
-- *
-+ *
- * @param pattern The pattern to search for.
- * @param input The String input to search.
- * @return True if the input contains the pattern, false otherwise.
-@@ -430,7 +430,7 @@
- *
- * The m prefix is optional and the meaning of the optional
- * trailing options are:
-- *
-+ * - * @param pattern The pattern to search for. - * @param input The PatternMatcherInput to search. - * @return True if the input contains the pattern, false otherwise. -@@ -484,7 +484,7 @@ - * be used when you want to save MatchResult instances. Otherwise, for - * simply accessing match information, it is more convenient to use the - * Perl5Util methods implementing the MatchResult interface. -- *
-+ *
- * @return The org.apache.oro.text.regex.MatchResult instance containing the
- * last match found.
- */
-@@ -501,7 +501,7 @@
- *
- * The s prefix is mandatory and the meaning of the optional
- * trailing options are:
-- *
-- *- * numSubs = util.substitute(result, "s#/#\\#g", input); - *
-+ * - * @param result The StringBuffer in which to store the result of the - * substitutions. The buffer is only appended to. - * @param expression The Perl5 substitution regular expression. -@@ -717,7 +717,7 @@ - /** - * Substitutes a pattern in a given input with a replacement string. - * The substitution expression is specified in Perl5 native format. -- *
- * The-@@ -755,7 +755,7 @@ - *
m prefix is optional and the meaning of the optional
- * trailing options are:
-- *
-+ *
- * @param results
- * A Collection to which the substrings of the input
- * that occur between the regular expression delimiter occurences
-@@ -802,7 +802,7 @@
- * @param pattern The regular expression to use as a split delimiter.
- * @param input The String to split.
- * @param limit The limit on the size of the returned Vector.
-- * Values <= 0 produce the same behavior as the SPLIT_ALL constant which
-+ * Values <= 0 produce the same behavior as the SPLIT_ALL constant which
- * causes the limit to be ignored and splits to be performed on all
- * occurrences of the pattern. You should use the SPLIT_ALL constant
- * to achieve this behavior instead of relying on the default behavior
-@@ -899,7 +899,7 @@
- *
- * The m prefix is optional and the meaning of the optional
- * trailing options are:
-- *
-+ *
- * @deprecated Use
- * {@link #split(Collection results, String pattern, String input, int limit)}
- * instead.
- * @param pattern The regular expression to use as a split delimiter.
- * @param input The String to split.
- * @param limit The limit on the size of the returned Vector.
-- * Values <= 0 produce the same behavior as the SPLIT_ALL constant which
-+ * Values <= 0 produce the same behavior as the SPLIT_ALL constant which
- * causes the limit to be ignored and splits to be performed on all
- * occurrences of the pattern. You should use the SPLIT_ALL constant
- * to achieve this behavior instead of relying on the default behavior
-@@ -993,7 +993,7 @@
-
- /**
- * Returns the length of the last match found.
-- *
-+ * - * @return The length of the last match found. - */ - public synchronized int length() { -@@ -1014,7 +1014,7 @@ - /** - * Returns the contents of the parenthesized subgroups of the last match - * found according to the behavior dictated by the MatchResult interface. -- *
-+ * - * @param group The pattern subgroup to return. - * @return A string containing the indicated pattern subgroup. Group - * 0 always refers to the entire match. If a group was never -@@ -1029,7 +1029,7 @@ - /** - * Returns the begin offset of the subgroup of the last match found - * relative the beginning of the match. -- *
-+ * - * @param group The pattern subgroup. - * @return The offset into group 0 of the first token in the indicated - * pattern subgroup. If a group was never matched or does -@@ -1046,7 +1046,7 @@ - /** - * Returns the end offset of the subgroup of the last match found - * relative the beginning of the match. -- *
-+ * - * @param group The pattern subgroup. - * @return Returns one plus the offset into group 0 of the last token in - * the indicated pattern subgroup. If a group was never matched -@@ -1062,7 +1062,7 @@ - * Returns an offset marking the beginning of the last pattern match - * found relative to the beginning of the input from which the match - * was extracted. -- *
-+ * - * @param group The pattern subgroup. - * @return The offset of the first token in the indicated - * pattern subgroup. If a group was never matched or does -@@ -1076,7 +1076,7 @@ - * Returns an offset marking the end of the last pattern match found - * relative to the beginning of the input from which the match was - * extracted. -- *
-+ * - * @param group The pattern subgroup. - * @return Returns one plus the offset of the last token in - * the indicated pattern subgroup. If a group was never matched -@@ -1089,7 +1089,7 @@ - - /** - * Returns the same as group(0). -- *
-+ * - * @return A string containing the entire match. - */ - public synchronized String toString() { -@@ -1101,7 +1101,7 @@ - - /** - * Returns the part of the input preceding the last match found. -- *
-+ * - * @return The part of the input following the last match found. - */ - public synchronized String preMatch() { -@@ -1145,7 +1145,7 @@ - - /** - * Returns the part of the input following the last match found. -- *
-+ * - * @return The part of the input following the last match found. - */ - public synchronized String postMatch() { -@@ -1190,7 +1190,7 @@ - * Returns the part of the input preceding the last match found as a - * char array. This method eliminates the extra - * buffer copying caused by preMatch().toCharArray(). -- *
-+ * - * @return The part of the input preceding the last match found as a char[]. - * If the result is of zero length, returns null instead of a zero - * length array. -@@ -1241,7 +1241,7 @@ - * Returns the part of the input following the last match found as a char - * array. This method eliminates the extra buffer copying caused by - * preMatch().toCharArray(). -- *
-+ * - * @return The part of the input following the last match found as a char[]. - * If the result is of zero length, returns null instead of a zero - * length array. ---- jakarta-oro-2.0.8/src/java/org/apache/oro/text/regex/MalformedPatternException.java 2022-03-19 12:16:14.323229032 +0100 -+++ jakarta-oro-2.0.8/src/java/org/apache/oro/text/regex/MalformedPatternException.java 2022-03-19 13:35:18.875734018 +0100 -@@ -84,7 +84,7 @@ - - /** - * Simply calls the corresponding constructor of its superclass. -- *
-+ * - * @param message A message indicating the nature of the parse error. - */ - public MalformedPatternException(String message) { ---- jakarta-oro-2.0.8/src/java/org/apache/oro/text/regex/MatchResult.java 2022-03-19 12:16:14.323229032 +0100 -+++ jakarta-oro-2.0.8/src/java/org/apache/oro/text/regex/MatchResult.java 2022-03-19 13:38:06.548742132 +0100 -@@ -117,7 +117,7 @@ - * System.out.println("Saved Groups: "); - * - * // Start at 1 because we just printed out group 0 -- * for(int group = 1; group < groups; group++) { -+ * for(int group = 1; group < groups; group++) { - * System.out.println(group + ": " + result.group(group)); - * System.out.println("Begin: " + result.begin(group)); - * System.out.println("End: " + result.end(group)); -@@ -136,7 +136,7 @@ - * If you want to get the length of a particular subgroup you should - * use the {@link #group(int)} method to get - * the string and then access its length() method as follows: -- *
-+ * - *
- * int length = -1; // Use -1 to indicate group doesn't exist - * MatchResult result; -@@ -152,11 +152,10 @@ - *- * - * The length() method serves as a more a more efficient way to do: -- *
-+ * - *
-- *- * length = result.group(0).length(); - *- * - * @return The length of the match. - */ -@@ -181,7 +180,7 @@ - *
123.group(2)will return - *nullbecause there is only one subgroup in the original - * pattern. -- *-+ * - * @param group The pattern subgroup to return. - * @return A string containing the indicated pattern subgroup. Group - * 0 always refers to the entire match. If a group was never -@@ -218,7 +217,7 @@ - * Returns an offset marking the beginning of the pattern match - * relative to the beginning of the input from which the match - * was extracted. -- *
-+ * - * @param group The pattern subgroup. - * @return The offset of the first token in the indicated - * pattern subgroup. If a group was never matched or does -@@ -231,7 +230,7 @@ - * Returns an offset marking the end of the pattern match - * relative to the beginning of the input from which the match was - * extracted. -- *
-+ * - * @param group The pattern subgroup. - * @return Returns one plus the offset of the last token in - * the indicated pattern subgroup. If a group was never matched ---- jakarta-oro-2.0.8/src/java/org/apache/oro/text/regex/package.html 2022-03-19 12:16:14.323229032 +0100 -+++ jakarta-oro-2.0.8/src/java/org/apache/oro/text/regex/package.html 2022-03-19 13:19:35.054059533 +0100 -@@ -8,8 +8,7 @@ - Note: The following information will be moved into the user's guide. -
- --Perl5 regular expressions
-- -+Perl5 regular expressions
-- Here we summarize the syntax of Perl5.003 regular expressions, all of - which is supported by the Perl5 classes in this package. However, for -@@ -17,16 +16,15 @@ - -
perlreman page - that accompanies the Perl5 distribution and also the book -- Programming Perl, 2nd Edition from O'Reilly & Associates. -+ Programming Perl, 2nd Edition from O'Reilly & Associates. - We are working toward implementing the features added after Perl5.003 - up to and including Perl 5.6. Please remember, we only guarantee - support for Perl5.003 expressions in version 2.0. - ---
-
-- Alternatives separated by | -
- Quantified atoms --
-+
-
- {n,m}
- Match at least n but not more than m times. -
- {n,}
- Match at least n times. -
- {n}
- Match exactly n times. -@@ -51,7 +49,7 @@ -
- \b is backspace inside a character class -
- Special backslashed characters --
-+
-
- \b
- null token matching a word boundary (\w on one side - and \W on the other) -
- \B
- null token matching a boundary that isn't a -@@ -93,7 +91,7 @@ - causing the rest of the pattern not to match, you may use - a "?" right after the quantifier. - --
-+
-
- *?
- Match 0 or more times -
- +?
- Match 1 or more times -
- ??
- Match 0 or 1 time -@@ -105,7 +103,7 @@ -
- Perl5 extended regular expressions are fully supported. - --
-+
-
- (?#text)
- An embedded comment causing text to be ignored. -
- (?:regexp)
- Groups things like "()" but doesn't cause the - group match to be saved. -@@ -129,7 +127,7 @@ - i enables case insensitivity, m enables multiline - treatment of the input, s enables single line treatment - of the input, and x enables extended whitespace comments. --