From cfd5c1aed2f6cac4a8a61f8576ef1037b9cbe465 Mon Sep 17 00:00:00 2001 From: Esteban Zimanyi Date: Wed, 30 Sep 2026 16:51:26 +0200 Subject: [PATCH] Write the javadoc of the object layer and the R-tree search operators as javadoc reads it ObjectLayerGenerator names the object-model class a generated interface serves as code, not as a link: the class is a MEOS object-model key, and TBigint, TNumber, TInt and TFloat are not types the generated package imports. RTreeSearchOp documents each operator in a javadoc comment before its constant. Witness. The build reported 33 javadoc warnings: "reference not found" for TBigint, TFloat, TInt and TNumber, six times each, and "invalid input: '<'" for the three trailing /**< comments of RTreeSearchOp, three times each. Measured. Against the catalog and libmeos of MobilityDB 8a23781e4c with MEOS-API 8dddf59, the build reports no javadoc warning, and the suites run 106 and 1,810 tests, all passing. --- codegen/src/main/java/ObjectLayerGenerator.java | 2 +- jmeos-core/src/main/java/functions/RTreeSearchOp.java | 9 ++++++--- 2 files changed, 7 insertions(+), 4 deletions(-) diff --git a/codegen/src/main/java/ObjectLayerGenerator.java b/codegen/src/main/java/ObjectLayerGenerator.java index 9d6a7bf4d..8d9b23d1f 100644 --- a/codegen/src/main/java/ObjectLayerGenerator.java +++ b/codegen/src/main/java/ObjectLayerGenerator.java @@ -888,7 +888,7 @@ private String generateInterface(List methods) { sb.append("\nimport static types.temporal.TemporalType.*;\n"); } sb.append("\n/**\n"); - sb.append(" * Generated OO surface for {@link ").append(spec.objectKey()).append("}.\n"); + sb.append(" * Generated OO surface for {@code ").append(spec.objectKey()).append("}.\n"); sb.append(" *\n"); sb.append(" *

Derived from the MEOS object model (objectModel.classes.").append(spec.objectKey()); sb.append(") by ObjectLayerGenerator. Each method carries the canonical camelCase name from the\n"); diff --git a/jmeos-core/src/main/java/functions/RTreeSearchOp.java b/jmeos-core/src/main/java/functions/RTreeSearchOp.java index 0991c1d3e..cd00d8b14 100644 --- a/jmeos-core/src/main/java/functions/RTreeSearchOp.java +++ b/jmeos-core/src/main/java/functions/RTreeSearchOp.java @@ -1,9 +1,12 @@ package functions; public enum RTreeSearchOp { - RTREE_OVERLAPS(0), /**< Find stored boxes that overlap the query */ - RTREE_CONTAINS(1), /**< Find stored boxes that contain the query */ - RTREE_CONTAINED_BY(2); /**< Find stored boxes contained by the query */ + /** Find stored boxes that overlap the query */ + RTREE_OVERLAPS(0), + /** Find stored boxes that contain the query */ + RTREE_CONTAINS(1), + /** Find stored boxes contained by the query */ + RTREE_CONTAINED_BY(2); private final int value;