This is an automated email from the ASF dual-hosted git repository.
reschke pushed a commit to branch OAK-11650
in repository https://gitbox.apache.org/repos/asf/jackrabbit-oak.git
The following commit(s) were added to refs/heads/OAK-11650 by this push:
new c8a07199d1 OAK-11650: Fix Javadoc errors - <p/>
c8a07199d1 is described below
commit c8a07199d16053de69d17413b0a905956a1aa13a
Author: Julian Reschke <[email protected]>
AuthorDate: Thu Apr 17 10:24:21 2025 +0100
OAK-11650: Fix Javadoc errors - <p/>
---
.../java/org/apache/jackrabbit/oak/commons/junit/LogDumper.java | 1 -
.../org/apache/jackrabbit/oak/commons/junit/LogLevelModifier.java | 1 -
.../oak/plugins/index/datastore/DataStoreTextWriter.java | 2 +-
.../apache/jackrabbit/oak/security/internal/Preconditions.java | 6 +++---
.../org/apache/jackrabbit/oak/run/FrozenNodeReferenceCreator.java | 4 ++--
.../jackrabbit/oak/plugins/index/search/util/LMSEstimator.java | 2 +-
.../apache/jackrabbit/oak/segment/ExternalBlobReferenceTest.java | 8 ++++----
.../org/apache/jackrabbit/oak/plugins/document/Sweep2Helper.java | 2 +-
.../apache/jackrabbit/oak/plugins/document/VersionGCSupport.java | 2 --
.../jackrabbit/oak/plugins/document/VersionGarbageCollector.java | 2 +-
.../oak/plugins/document/mongo/MongoVersionGCSupport.java | 1 -
.../jackrabbit/oak/plugins/document/CollisionRollbackTest.java | 2 +-
.../apache/jackrabbit/oak/plugins/document/Sweep2TestHelper.java | 6 +++---
13 files changed, 17 insertions(+), 22 deletions(-)
diff --git
a/oak-commons/src/test/java/org/apache/jackrabbit/oak/commons/junit/LogDumper.java
b/oak-commons/src/test/java/org/apache/jackrabbit/oak/commons/junit/LogDumper.java
index 4cd3b12a97..dec3196bdf 100644
---
a/oak-commons/src/test/java/org/apache/jackrabbit/oak/commons/junit/LogDumper.java
+++
b/oak-commons/src/test/java/org/apache/jackrabbit/oak/commons/junit/LogDumper.java
@@ -35,7 +35,6 @@ import org.slf4j.LoggerFactory;
* locally upon test failure. This simplifies determining failure
* cause by providing all required data locally. This would be specially
useful when running test
* in CI server where server logs gets cluttered with all other test executions
- * <p/>
* <pre>
* public class LoginTestIT {
*
diff --git
a/oak-commons/src/test/java/org/apache/jackrabbit/oak/commons/junit/LogLevelModifier.java
b/oak-commons/src/test/java/org/apache/jackrabbit/oak/commons/junit/LogLevelModifier.java
index d83c5424e3..cd9acaab54 100644
---
a/oak-commons/src/test/java/org/apache/jackrabbit/oak/commons/junit/LogLevelModifier.java
+++
b/oak-commons/src/test/java/org/apache/jackrabbit/oak/commons/junit/LogLevelModifier.java
@@ -42,7 +42,6 @@ import ch.qos.logback.core.filter.Filter;
* The LogLevelModifier Rule can be used to fine-tune log levels during a
particular
* test. This could be used together with LogDumper to have enough details
* in case of test failure without setting the global log level to DEBUG for
example.
- * <p/>
* <pre>
* public class LoginTestIT {
*
diff --git
a/oak-core/src/main/java/org/apache/jackrabbit/oak/plugins/index/datastore/DataStoreTextWriter.java
b/oak-core/src/main/java/org/apache/jackrabbit/oak/plugins/index/datastore/DataStoreTextWriter.java
index b9ea2643a6..ba64e898a7 100644
---
a/oak-core/src/main/java/org/apache/jackrabbit/oak/plugins/index/datastore/DataStoreTextWriter.java
+++
b/oak-core/src/main/java/org/apache/jackrabbit/oak/plugins/index/datastore/DataStoreTextWriter.java
@@ -182,7 +182,7 @@ public class DataStoreTextWriter implements TextWriter,
Closeable, PreExtractedT
/**
* Returns the identified file. This method implements the pattern
* used to avoid problems with too many files in a single directory.
- * <p/>
+ * <p>
* No sanity checks are performed on the given identifier.
*
* @param identifier file name
diff --git
a/oak-core/src/main/java/org/apache/jackrabbit/oak/security/internal/Preconditions.java
b/oak-core/src/main/java/org/apache/jackrabbit/oak/security/internal/Preconditions.java
index a8d1914e4f..7d17f74d5b 100644
---
a/oak-core/src/main/java/org/apache/jackrabbit/oak/security/internal/Preconditions.java
+++
b/oak-core/src/main/java/org/apache/jackrabbit/oak/security/internal/Preconditions.java
@@ -23,15 +23,15 @@ import java.util.Set;
/**
* Represents a preconditions set that may be satisfied by adding the right
* candidates.
- * <p/>
+ * <p>
* Initially, a set of preconditions is empty. An empty set of preconditions is
* always satisfied. If candidates are added, but the precondition set is
empty,
* the preconditions are considered satisfied.
- * <p/>
+ * <p>
* When some preconditions are added, the preconditions set may enter into the
* unsatisfied state. In this case, the preconditions set may be come satisfied
* again only with the addition of the right candidates.
- * <p/>
+ * <p>
* This class doesn't admit duplicates for preconditions or candidates. Adding
* the same precondition (or candidate) twice doesn't have any effect on the
* state of the preconditions set.
diff --git
a/oak-run/src/test/java/org/apache/jackrabbit/oak/run/FrozenNodeReferenceCreator.java
b/oak-run/src/test/java/org/apache/jackrabbit/oak/run/FrozenNodeReferenceCreator.java
index cd47c137ba..91097659b4 100644
---
a/oak-run/src/test/java/org/apache/jackrabbit/oak/run/FrozenNodeReferenceCreator.java
+++
b/oak-run/src/test/java/org/apache/jackrabbit/oak/run/FrozenNodeReferenceCreator.java
@@ -37,10 +37,10 @@ import joptsimple.OptionSpec;
/**
* Test class that simplifies creation of a property of type Reference, as
that's not
* easily achievable without a tool.
- * <p/>
+ * <p>
* The idea is that this might help testing the corresponding
FrozenNodeRefsByScanningCommand
* and FrozenNodeRefsUsingIndexCommand commands.
- * <p/>
+ * <p>
* Example:
* <pre>
* java -mx4g -cp oak-run-*-tests.jar
org.apache.jackrabbit.oak.run.FrozenNodeReferenceCreator
mongodb://localhost/<dbname> -user=admin -password=admin
-testCreateRefPath=<mypath> -testCreateRefProp=<mypropertyname>
-testCreateRefUuid=<myuuid> -read-write=true
diff --git
a/oak-search/src/main/java/org/apache/jackrabbit/oak/plugins/index/search/util/LMSEstimator.java
b/oak-search/src/main/java/org/apache/jackrabbit/oak/plugins/index/search/util/LMSEstimator.java
index 2e8ba2a8a7..d32e2ca041 100644
---
a/oak-search/src/main/java/org/apache/jackrabbit/oak/plugins/index/search/util/LMSEstimator.java
+++
b/oak-search/src/main/java/org/apache/jackrabbit/oak/plugins/index/search/util/LMSEstimator.java
@@ -74,7 +74,7 @@ public class LMSEstimator {
/**
* Get the input value for a certain feature (by index) in the given
filter.
- * <p/>
+ * <p>
* A filter is represented as a vector in R^5 where
* i_0 : no. of property restrictions
* i_1 : 1 if any native constraint exists in the filter, 0 otherwise
diff --git
a/oak-segment-tar/src/test/java/org/apache/jackrabbit/oak/segment/ExternalBlobReferenceTest.java
b/oak-segment-tar/src/test/java/org/apache/jackrabbit/oak/segment/ExternalBlobReferenceTest.java
index 84a23eb22b..130b3cdbe5 100644
---
a/oak-segment-tar/src/test/java/org/apache/jackrabbit/oak/segment/ExternalBlobReferenceTest.java
+++
b/oak-segment-tar/src/test/java/org/apache/jackrabbit/oak/segment/ExternalBlobReferenceTest.java
@@ -62,12 +62,12 @@ public class ExternalBlobReferenceTest {
* is between 0 and {@code Segment.BLOB_ID_SMALL_LIMIT - 1} bytes. It
should
* be possible to correctly read the blob ID back and pass it to the {@code
* BlobStore} to obtain information about the blob.
- * <p/>
+ * <p>
* This code path executes only if the written stream is {@code
* Segment.MEDIUM_LIMIT} bytes long (or more). If the length of the stream
* is smaller, the binary value is inlined in the segment and the {@code
* BlobStore} is never called.
- * <p/>
+ * <p>
* See OAK-3105.
*/
@Test
@@ -82,12 +82,12 @@ public class ExternalBlobReferenceTest {
* and an alternate encoding is used. It should be possible to correctly
* read the blob ID back and pass it to the {@code BlobStore} to obtain
* information about the blob.
- * <p/>
+ * <p>
* This code path executes only if the written stream is {@code
* Segment.MEDIUM_LIMIT} bytes long (or more). If the length of the stream
* is smaller, the binary value is inlined in the segment and the {@code
* BlobStore} is never called.
- * <p/>
+ * <p>
* See OAK-3105 and OAK-3107.
*/
@Test
diff --git
a/oak-store-document/src/main/java/org/apache/jackrabbit/oak/plugins/document/Sweep2Helper.java
b/oak-store-document/src/main/java/org/apache/jackrabbit/oak/plugins/document/Sweep2Helper.java
index ad6f226afa..01216f5e1a 100644
---
a/oak-store-document/src/main/java/org/apache/jackrabbit/oak/plugins/document/Sweep2Helper.java
+++
b/oak-store-document/src/main/java/org/apache/jackrabbit/oak/plugins/document/Sweep2Helper.java
@@ -90,7 +90,7 @@ public class Sweep2Helper {
/**
* Acquires a cluster singleton lock for doing a sweep2 unless a sweep2
was already done.
- * <p/>
+ * <p>
* 'If necessary' refers to the sweep2 status in the settings collection -
no further
* check is done based on content in the nodes collection in this method.
* @return <ul>
diff --git
a/oak-store-document/src/main/java/org/apache/jackrabbit/oak/plugins/document/VersionGCSupport.java
b/oak-store-document/src/main/java/org/apache/jackrabbit/oak/plugins/document/VersionGCSupport.java
index c1735d7369..a32f1cc493 100644
---
a/oak-store-document/src/main/java/org/apache/jackrabbit/oak/plugins/document/VersionGCSupport.java
+++
b/oak-store-document/src/main/java/org/apache/jackrabbit/oak/plugins/document/VersionGCSupport.java
@@ -87,8 +87,6 @@ public class VersionGCSupport {
* since the epoch and the implementation will convert them to seconds at
* the granularity of the {@link NodeDocument#MODIFIED_IN_SECS} field and
* then perform the comparison.
- * <p/>
- *
*
* @param fromModified the lower bound modified timestamp (inclusive)
* @param toModified the upper bound modified timestamp (exclusive)
diff --git
a/oak-store-document/src/main/java/org/apache/jackrabbit/oak/plugins/document/VersionGarbageCollector.java
b/oak-store-document/src/main/java/org/apache/jackrabbit/oak/plugins/document/VersionGarbageCollector.java
index 271604d61f..db3116bd40 100644
---
a/oak-store-document/src/main/java/org/apache/jackrabbit/oak/plugins/document/VersionGarbageCollector.java
+++
b/oak-store-document/src/main/java/org/apache/jackrabbit/oak/plugins/document/VersionGarbageCollector.java
@@ -1462,7 +1462,7 @@ public class VersionGarbageCollector {
* establishes whether a branch commit revision is committed or not -
this is no
* longer checked in this method. The resulting operations are added
to the
* provided updateOp.
- * <p/>
+ * <p>
* The actions depend on the exacty property key - here's the
comprehensive list
* of system properties and how they are handled:
* <ul>
diff --git
a/oak-store-document/src/main/java/org/apache/jackrabbit/oak/plugins/document/mongo/MongoVersionGCSupport.java
b/oak-store-document/src/main/java/org/apache/jackrabbit/oak/plugins/document/mongo/MongoVersionGCSupport.java
index 3af598091c..6b58b0438f 100644
---
a/oak-store-document/src/main/java/org/apache/jackrabbit/oak/plugins/document/mongo/MongoVersionGCSupport.java
+++
b/oak-store-document/src/main/java/org/apache/jackrabbit/oak/plugins/document/mongo/MongoVersionGCSupport.java
@@ -237,7 +237,6 @@ public class MongoVersionGCSupport extends VersionGCSupport
{
* since the epoch and the implementation will convert them to seconds at
* the granularity of the {@link NodeDocument#MODIFIED_IN_SECS} field and
* then perform the comparison.
- * <p/>
*
* @param fromModified the lower bound modified timestamp in millis
(inclusive)
* @param toModified the upper bound modified timestamp in millis
(exclusive)
diff --git
a/oak-store-document/src/test/java/org/apache/jackrabbit/oak/plugins/document/CollisionRollbackTest.java
b/oak-store-document/src/test/java/org/apache/jackrabbit/oak/plugins/document/CollisionRollbackTest.java
index 326426f7cb..d52d28a972 100644
---
a/oak-store-document/src/test/java/org/apache/jackrabbit/oak/plugins/document/CollisionRollbackTest.java
+++
b/oak-store-document/src/test/java/org/apache/jackrabbit/oak/plugins/document/CollisionRollbackTest.java
@@ -103,7 +103,7 @@ public class CollisionRollbackTest {
* MongoDocumentStore's nodesCache: when a document is read into
* the nodesCache shortly before a collision is rolled back,
* it runs risk of later making uncommitted changes visible.
- * <p/>
+ * <p>
* The test case works as follows:
* <ul>
* <li>consider clusterId 2 and 4 being active in a cluster</li>
diff --git
a/oak-store-document/src/test/java/org/apache/jackrabbit/oak/plugins/document/Sweep2TestHelper.java
b/oak-store-document/src/test/java/org/apache/jackrabbit/oak/plugins/document/Sweep2TestHelper.java
index f8cc03118c..7e3fc3af11 100644
---
a/oak-store-document/src/test/java/org/apache/jackrabbit/oak/plugins/document/Sweep2TestHelper.java
+++
b/oak-store-document/src/test/java/org/apache/jackrabbit/oak/plugins/document/Sweep2TestHelper.java
@@ -215,7 +215,7 @@ public class Sweep2TestHelper {
/**
* Removes the "sweep2Status" from the settings collection as well
* as emptying the "_sweepRev" from the "0:/" root if desired.
- * <p/>
+ * <p>
* The reason for emptying the "_sweepRev", and not straight removing it,
* is that it has an influence on whether Sweep2Helper.isSweep2Necessary
* considers a sweep2 necessary or not: if it's not there, then the
@@ -247,7 +247,7 @@ public class Sweep2TestHelper {
* This simulates the provided store having done the changes
* "pre 1.8" - ie it "ages" the document in a way that it looks
* like they were applied "pre 1.8".
- * <p/>
+ * <p>
* The way this is done is to remove all the "_bc" entries
* (as they didn't exist before 1.8) - *and then* doing a normal sweep (ie
"sweep1")
*/
@@ -259,7 +259,7 @@ public class Sweep2TestHelper {
* This simulates the provided store having done the changes
* "pre 1.8" - ie it "ages" the document in a way that it looks
* like they were applied "pre 1.8".
- * <p/>
+ * <p>
* The way this is done is to remove all the "_bc" entries
* (as they didn't exist before 1.8) - *and then* doing a normal sweep (ie
"sweep1")
*/
