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-lang.git
The following commit(s) were added to refs/heads/master by this push:
new 4eb7bdfb8 Javadoc
4eb7bdfb8 is described below
commit 4eb7bdfb8b6f54219342fbaf8a36f6af94e3e481
Author: Gary Gregory <[email protected]>
AuthorDate: Sun Feb 1 07:58:31 2026 -0500
Javadoc
---
.../java/org/apache/commons/lang3/Conversion.java | 10 +++++---
.../java/org/apache/commons/lang3/StringUtils.java | 6 +++--
.../commons/lang3/text/ExtendedMessageFormat.java | 9 +++++--
.../commons/lang3/time/DurationFormatUtils.java | 29 +++++++++++++++-------
4 files changed, 38 insertions(+), 16 deletions(-)
diff --git a/src/main/java/org/apache/commons/lang3/Conversion.java
b/src/main/java/org/apache/commons/lang3/Conversion.java
index 95618f5d3..2b858a059 100644
--- a/src/main/java/org/apache/commons/lang3/Conversion.java
+++ b/src/main/java/org/apache/commons/lang3/Conversion.java
@@ -23,9 +23,11 @@
* Static methods to convert a type into another, with endianness and bit
ordering awareness.
*
* <p>
- * The methods names follow a naming rule:<br>
- * {@code <source type>[source endianness][source bit ordering]To<destination
type>[destination endianness][destination bit ordering]}
+ * The methods names follow a naming rule:
* </p>
+ * <pre>{@code
+ * <source type>[source endianness][source bit ordering]To<destination
type>[destination endianness][destination bit ordering]
+ * }</pre>
* <p>
* Source/destination type fields is one of the following:
* </p>
@@ -39,7 +41,9 @@
* <li>uuid</li>
* </ul>
* <p>
- * Endianness field: little-endian is the default, in this case the field is
absent. In case of big-endian, the field is "Be".<br>
+ * Endianness field: little-endian is the default, in this case the field is
absent. In case of big-endian, the field is "Be".
+ * </p>
+ * <p>
* Bit ordering: LSB0 is the default, in this case the field is absent. In
case of MSB0, the field is "Msb0" (Camel-case).
* </p>
* <p>
diff --git a/src/main/java/org/apache/commons/lang3/StringUtils.java
b/src/main/java/org/apache/commons/lang3/StringUtils.java
index 40abdcaee..162724af0 100644
--- a/src/main/java/org/apache/commons/lang3/StringUtils.java
+++ b/src/main/java/org/apache/commons/lang3/StringUtils.java
@@ -6301,9 +6301,11 @@ public static String replaceChars(final String str,
final char searchChar, final
* Replaces multiple characters in a String in one go. This method can
also be used to delete characters.
*
* <p>
- * For example:<br>
- * {@code replaceChars("hello", "ho", "jy")
= jelly}.
+ * For example:
* </p>
+ * <pre>
+ * replaceChars("hello", "ho", "jy") = jelly.
+ * </pre>
*
* <p>
* A {@code null} string input returns {@code null}. An empty ("") string
input returns an empty string. A null or empty set of search characters returns
diff --git
a/src/main/java/org/apache/commons/lang3/text/ExtendedMessageFormat.java
b/src/main/java/org/apache/commons/lang3/text/ExtendedMessageFormat.java
index 72b13c019..000e80e8d 100644
--- a/src/main/java/org/apache/commons/lang3/text/ExtendedMessageFormat.java
+++ b/src/main/java/org/apache/commons/lang3/text/ExtendedMessageFormat.java
@@ -31,15 +31,20 @@
/**
* Extends {@link java.text.MessageFormat} to allow pluggable/additional
formatting
- * options for embedded format elements. Client code should specify a registry
+ * options for embedded format elements.
+ * <p>
+ * Client code should specify a registry
* of {@link FormatFactory} instances associated with {@link String}
* format names. This registry will be consulted when the format elements are
* parsed from the message pattern. In this way custom patterns can be
specified,
* and the formats supported by {@link java.text.MessageFormat} can be
overridden
* at the format and/or format style level (see MessageFormat). A "format
element"
- * embedded in the message pattern is specified (<strong>()?</strong>
signifies optionality):<br>
+ * embedded in the message pattern is specified (<strong>()?</strong>
signifies optionality):
+ * </p>
+ * <p>
* <code>{</code><em>argument-number</em><strong>(</strong>{@code
,}<em>format-name</em><b>
* (</b>{@code ,}<em>format-style</em><strong>)?)?</strong><code>}</code>
+ * </p>
*
* <p>
* <em>format-name</em> and <em>format-style</em> values are trimmed of
surrounding whitespace
diff --git
a/src/main/java/org/apache/commons/lang3/time/DurationFormatUtils.java
b/src/main/java/org/apache/commons/lang3/time/DurationFormatUtils.java
index d318724f6..c89ecc786 100644
--- a/src/main/java/org/apache/commons/lang3/time/DurationFormatUtils.java
+++ b/src/main/java/org/apache/commons/lang3/time/DurationFormatUtils.java
@@ -32,7 +32,8 @@
/**
* Duration formatting utilities and constants. The following table describes
the tokens
* used in the pattern language for formatting.
- * <table border="1">
+ *
+ * <table>
* <caption>Pattern Tokens</caption>
* <tr><th>character</th><th>duration element</th></tr>
* <tr><td>y</td><td>years</td></tr>
@@ -46,24 +47,32 @@
* </table>
*
* <strong>Note: It's not currently possible to include a single-quote in a
format.</strong>
- * <br>
+ * <p>
* Token values are printed using decimal digits.
* A token character can be repeated to ensure that the field occupies a
certain minimum
* size. Values will be left-padded with 0 unless padding is disabled in the
method invocation.
- * <br>
+ * </p>
+ * <p>
* Tokens can be marked as optional by surrounding them with brackets [ ].
These tokens will
* only be printed if the token value is non-zero. Literals within optional
blocks will only be
* printed if the preceding non-literal token is non-zero. Leading optional
literals will only
* be printed if the following non-literal is non-zero.
* Multiple optional blocks can be used to group literals with the desired
token.
+ * </p>
+ * <p>
+ * Notes on Optional Tokens:
+ * </p>
* <p>
- * Notes on Optional Tokens:<br>
- * <strong>Multiple optional tokens without literals can result in impossible
to understand output.</strong><br>
- * <strong>Patterns where all tokens are optional can produce empty
strings.</strong><br>
- * (See examples below)
+ * <strong>Multiple optional tokens without literals can result in impossible
to understand output.</strong>
* </p>
- * <br>
- * <table border="1">
+ * <p>
+ * <strong>Patterns where all tokens are optional can produce empty
strings.</strong>
+ * </p>
+ * <p>
+ * See the following examples.
+ * </p>
+ *
+ * <table>
* <caption>Example Output</caption>
*
<tr><th>pattern</th><th>Duration.ofDays(1)</th><th>Duration.ofHours(1)</th><th>Duration.ofMinutes(1)</th><th>Duration.ZERO</th></tr>
*
<tr><td>d'd'H'h'm'm's's'</td><td>1d0h0m0s</td><td>0d1h0m0s</td><td>0d0h1m0s</td><td>0d0h0m0s</td></tr>
@@ -74,7 +83,9 @@
*
<tr><td>['{'dd'}']['<'HH'>']['('mm')']</td><td>{01}</td><td><01></td><td>(00)</td><td></td></tr>
* <tr><td>[dHms]</td><td>1</td><td>1</td><td>1</td><td></td></tr>
* </table>
+ * <p>
* <strong>Note: Optional blocks cannot be nested.</strong>
+ * </p>
*
* @since 2.1
*/
