Polishing.

Author: schauder

spring-data-relational/src/main/java/org/springframework/data/relational/core/mapping/RelationalPersistentEntity.java

@@ -50,7 +50,7 @@ default SqlIdentifier getQualifiedTableName() {
 	 * Returns the column representing the identifier.
 	 *
 	 * @return will never be {@literal null}.
-	 * @deprecated use {@code AggregatePath.getTableInfo().getIdColumnInfos()} instead.
+	 * @deprecated because an entity may have multiple id columns. Use {@code AggregatePath.getTableInfo().getIdColumnInfos()} instead.
 	 */
 	@Deprecated(forRemoval = true)
 	SqlIdentifier getIdColumn();

spring-data-relational/src/main/java/org/springframework/data/relational/core/sql/TupleExpression.java

@@ -1,14 +1,28 @@
-package org.springframework.data.relational.core.sql;
+/*
+ * Copyright 2025 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
 
-import org.jetbrains.annotations.NotNull;
+package org.springframework.data.relational.core.sql;
 
 import static java.util.stream.Collectors.*;
 
 import java.util.List;
 
 /**
  * A tuple as used in conditions like
- * 
+ *
  * <pre>
  *   WHERE (one, two) IN (select x, y from some_table)
  * </pre>

spring-data-relational/src/test/java/org/springframework/data/relational/core/mapping/ColumnInfosUnitTests.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2024 the original author or authors.
+ * Copyright 2025 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

spring-data-relational/src/test/java/org/springframework/data/relational/core/sql/TupleExpressionUnitTests.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2024 the original author or authors.
+ * Copyright 2025 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -22,6 +22,11 @@
 
 import org.junit.jupiter.api.Test;
 
+/**
+ * Unit tests for construction of {@link TupleExpression}.
+ *
+ * @author Jens Schauder
+ */
 class TupleExpressionUnitTests {
 
 	@Test // GH-574