This is an automated email from the ASF dual-hosted git repository.

asf-gitbox-commits pushed a commit to branch geoapi-4.0
in repository https://gitbox.apache.org/repos/asf/sis.git

commit 3f23779ec3af8021525ec24a69fc0490cbadf5f7
Author: Martin Desruisseaux <[email protected]>
AuthorDate: Wed May 13 01:27:46 2026 +0200

    Replace `@todo` Javadoc tag by a new `@Incomplete` annotation for 
identifying the boxes that are not fully implemented.
---
 .../main/org/apache/sis/storage/isobmff/Box.java   |  2 +-
 .../org/apache/sis/storage/isobmff/Incomplete.java | 36 ++++++++++++++++++++++
 .../sis/storage/isobmff/base/MovieHeader.java      |  5 +--
 .../isobmff/base/ProgressiveDownloadInfo.java      |  5 +--
 .../sis/storage/isobmff/base/TrackHeader.java      |  5 +--
 .../sis/storage/isobmff/mpeg/ChromaLocation.java   |  5 +--
 .../isobmff/mpeg/ComponentReferenceLevel.java      |  5 +--
 .../isobmff/mpeg/DepthMappingInformation.java      |  5 +--
 .../storage/isobmff/mpeg/DisparityInformation.java |  5 +--
 .../sis/storage/isobmff/mpeg/FieldInterlace.java   |  5 +--
 .../storage/isobmff/mpeg/FieldInterlaceType.java   |  5 +--
 .../isobmff/mpeg/FramePackingInformation.java      |  5 +--
 .../mpeg/PolarizationPatternDefinition.java        |  5 +--
 .../storage/isobmff/mpeg/SensorBadPixelsMap.java   |  5 +--
 .../mpeg/SensorNonUniformityCorrection.java        |  5 +--
 .../sis/storage/isobmff/mpeg/TAIClockInfo.java     |  6 ++--
 .../sis/storage/isobmff/mpeg/TAITimeStamp.java     |  5 +--
 .../storage/isobmff/video/ContentDescribes.java    |  5 +--
 18 files changed, 86 insertions(+), 33 deletions(-)

diff --git 
a/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/Box.java
 
b/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/Box.java
index 929675474a..088d11c261 100644
--- 
a/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/Box.java
+++ 
b/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/Box.java
@@ -85,7 +85,7 @@ public abstract class Box extends TreeNode {
     }
 
     /**
-     * Returns a human-readable name for this node to shown in the tree.
+     * Returns a human-readable name for this node to show in the tree.
      * This method adds the {@linkplain #typeKey() type} between parenthesis 
after the box name.
      *
      * @return Human-readable name of this node.
diff --git 
a/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/Incomplete.java
 
b/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/Incomplete.java
new file mode 100644
index 0000000000..6732c2dc6a
--- /dev/null
+++ 
b/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/Incomplete.java
@@ -0,0 +1,36 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You 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
+ *
+ *     http://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.
+ */
+package org.apache.sis.storage.isobmff;
+
+import java.lang.annotation.Target;
+import java.lang.annotation.Documented;
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+
+
+/**
+ * Marker annotation for placeholder classes for boxes that are not yet 
implemented or are incomplete.
+ * Often, the reason is that we don't have an access to the specification 
where the box is defined.
+ *
+ * @author Martin Desruisseaux (Geomatys)
+ */
+@Documented
+@Target(ElementType.TYPE)
+@Retention(RetentionPolicy.RUNTIME)
+public @interface Incomplete {
+}
diff --git 
a/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/base/MovieHeader.java
 
b/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/base/MovieHeader.java
index 923c4889e0..4f7e6e1d73 100644
--- 
a/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/base/MovieHeader.java
+++ 
b/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/base/MovieHeader.java
@@ -21,12 +21,12 @@ import java.io.IOException;
 import org.apache.sis.io.stream.ChannelDataInput;
 import org.apache.sis.storage.DataStoreContentException;
 import org.apache.sis.storage.isobmff.Reader;
+import org.apache.sis.storage.isobmff.Incomplete;
 
 
 /**
  * Overall information relevant to the entire presentation considered as a 
whole.
- *
- * @todo Not yet implemented. This is currently an almost empty box.
+ * <b>Not yet implemented.</b>
  *
  * <h4>Container</h4>
  * The container can be a {@link Movie} box.
@@ -34,6 +34,7 @@ import org.apache.sis.storage.isobmff.Reader;
  * @author Johann Sorel (Geomatys)
  * @author Martin Desruisseaux (Geomatys)
  */
+@Incomplete
 public final class MovieHeader extends HeaderBox {
     /**
      * Numerical representation of the {@code "mvhd"} box type.
diff --git 
a/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/base/ProgressiveDownloadInfo.java
 
b/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/base/ProgressiveDownloadInfo.java
index ad6febe654..0769bff7b4 100644
--- 
a/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/base/ProgressiveDownloadInfo.java
+++ 
b/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/base/ProgressiveDownloadInfo.java
@@ -19,12 +19,12 @@ package org.apache.sis.storage.isobmff.base;
 import java.io.IOException;
 import org.apache.sis.storage.isobmff.FullBox;
 import org.apache.sis.storage.isobmff.Reader;
+import org.apache.sis.storage.isobmff.Incomplete;
 
 
 /**
  * Combination of effective file download bit-rate, together with a suggested 
initial playback delay.
- *
- * @todo Not yet implemented. This is currently an empty box.
+ * <b>Not yet implemented.</b>
  *
  * <h4>Container</h4>
  * The container can be the file.
@@ -32,6 +32,7 @@ import org.apache.sis.storage.isobmff.Reader;
  * @author Johann Sorel (Geomatys)
  * @author Martin Desruisseaux (Geomatys)
  */
+@Incomplete
 public final class ProgressiveDownloadInfo extends FullBox {
     /**
      * Numerical representation of the {@code "pdin"} box type.
diff --git 
a/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/base/TrackHeader.java
 
b/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/base/TrackHeader.java
index b8a7bcfa86..7613a78025 100644
--- 
a/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/base/TrackHeader.java
+++ 
b/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/base/TrackHeader.java
@@ -21,6 +21,7 @@ import java.io.IOException;
 import org.apache.sis.io.stream.ChannelDataInput;
 import org.apache.sis.storage.DataStoreContentException;
 import org.apache.sis.storage.isobmff.Reader;
+import org.apache.sis.storage.isobmff.Incomplete;
 import org.apache.sis.util.collection.TableColumn;
 import org.apache.sis.util.collection.TreeTable;
 
@@ -28,8 +29,7 @@ import org.apache.sis.util.collection.TreeTable;
 /**
  * Characteristics of a single track.
  * Exactly one {@code TrackHeader} is contained in a {@code Track}.
- *
- * @todo Not yet fully implemented.
+ * <b>Not yet fully implemented.</b>
  *
  * <h4>Container</h4>
  * The container can be a {@link Track} box.
@@ -37,6 +37,7 @@ import org.apache.sis.util.collection.TreeTable;
  * @author Johann Sorel (Geomatys)
  * @author Martin Desruisseaux (Geomatys)
  */
+@Incomplete
 public final class TrackHeader extends HeaderBox {
     /**
      * Numerical representation of the {@code "tkhd"} box type.
diff --git 
a/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/ChromaLocation.java
 
b/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/ChromaLocation.java
index 7f8977e3ff..b17bada55a 100644
--- 
a/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/ChromaLocation.java
+++ 
b/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/ChromaLocation.java
@@ -19,12 +19,12 @@ package org.apache.sis.storage.isobmff.mpeg;
 import java.io.IOException;
 import org.apache.sis.storage.isobmff.FullBox;
 import org.apache.sis.storage.isobmff.Reader;
+import org.apache.sis.storage.isobmff.Incomplete;
 
 
 /**
  * Describes the chroma sub-sampling location method used for frames using 
<abbr>YUV</abbr> components.
- *
- * @todo Not yet implemented.
+ * <b>Not yet implemented.</b>
  *
  * <h4>Container</h4>
  * The container can be a {@link ItemPropertyContainer} box.
@@ -32,6 +32,7 @@ import org.apache.sis.storage.isobmff.Reader;
  * @author Johann Sorel (Geomatys)
  * @author Martin Desruisseaux (Geomatys)
  */
+@Incomplete
 public final class ChromaLocation extends FullBox {
     /**
      * Numerical representation of the {@code "cloc"} box type.
diff --git 
a/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/ComponentReferenceLevel.java
 
b/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/ComponentReferenceLevel.java
index 13c42083c2..a6a69bc2ab 100644
--- 
a/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/ComponentReferenceLevel.java
+++ 
b/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/ComponentReferenceLevel.java
@@ -19,12 +19,12 @@ package org.apache.sis.storage.isobmff.mpeg;
 import java.io.IOException;
 import org.apache.sis.storage.isobmff.FullBox;
 import org.apache.sis.storage.isobmff.Reader;
+import org.apache.sis.storage.isobmff.Incomplete;
 
 
 /**
  * Describes the minimum and maximum values for components present in the 
image data.
- *
- * @todo Not yet implemented.
+ * <b>Not yet implemented.</b>
  *
  * <h4>Container</h4>
  * The container can be a {@link ItemPropertyContainer} box.
@@ -32,6 +32,7 @@ import org.apache.sis.storage.isobmff.Reader;
  * @author Johann Sorel (Geomatys)
  * @author Martin Desruisseaux (Geomatys)
  */
+@Incomplete
 public final class ComponentReferenceLevel extends FullBox {
     /**
      * Numerical representation of the {@code "clev"} box type.
diff --git 
a/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/DepthMappingInformation.java
 
b/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/DepthMappingInformation.java
index ddc1d47802..0eabaaa9e6 100644
--- 
a/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/DepthMappingInformation.java
+++ 
b/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/DepthMappingInformation.java
@@ -19,12 +19,12 @@ package org.apache.sis.storage.isobmff.mpeg;
 import java.io.IOException;
 import org.apache.sis.storage.isobmff.FullBox;
 import org.apache.sis.storage.isobmff.Reader;
+import org.apache.sis.storage.isobmff.Incomplete;
 
 
 /**
  * Indicates the number of components to which the disparity information 
applies.
- *
- * @todo Not yet implemented.
+ * <b>Not yet implemented.</b>
  *
  * <h4>Container</h4>
  * The container can be a {@link ItemPropertyContainer} box.
@@ -32,6 +32,7 @@ import org.apache.sis.storage.isobmff.Reader;
  * @author Johann Sorel (Geomatys)
  * @author Martin Desruisseaux (Geomatys)
  */
+@Incomplete
 public final class DepthMappingInformation extends FullBox {
     /**
      * Numerical representation of the {@code "depi"} box type.
diff --git 
a/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/DisparityInformation.java
 
b/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/DisparityInformation.java
index 7abb03e1b3..889864bd4a 100644
--- 
a/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/DisparityInformation.java
+++ 
b/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/DisparityInformation.java
@@ -19,12 +19,12 @@ package org.apache.sis.storage.isobmff.mpeg;
 import java.io.IOException;
 import org.apache.sis.storage.isobmff.FullBox;
 import org.apache.sis.storage.isobmff.Reader;
+import org.apache.sis.storage.isobmff.Incomplete;
 
 
 /**
  * Describes how values of a disparity map should be interpreted.
- *
- * @todo Not yet implemented.
+ * <b>Not yet implemented.</b>
  *
  * <h4>Container</h4>
  * The container can be a {@link ItemPropertyContainer} box.
@@ -32,6 +32,7 @@ import org.apache.sis.storage.isobmff.Reader;
  * @author Johann Sorel (Geomatys)
  * @author Martin Desruisseaux (Geomatys)
  */
+@Incomplete
 public final class DisparityInformation extends FullBox {
     /**
      * Numerical representation of the {@code "disi"} box type.
diff --git 
a/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/FieldInterlace.java
 
b/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/FieldInterlace.java
index 893111f46d..bc686c79cd 100644
--- 
a/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/FieldInterlace.java
+++ 
b/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/FieldInterlace.java
@@ -19,12 +19,12 @@ package org.apache.sis.storage.isobmff.mpeg;
 import java.io.IOException;
 import org.apache.sis.storage.isobmff.FullBox;
 import org.apache.sis.storage.isobmff.Reader;
+import org.apache.sis.storage.isobmff.Incomplete;
 
 
 /**
  * Describes the field layout of an image item in case of interlaced video 
content.
- *
- * @todo Not yet implemented.
+ * <b>Not yet implemented.</b>
  *
  * <h4>Container</h4>
  * The container can be a {@link ItemPropertyContainer} box.
@@ -32,6 +32,7 @@ import org.apache.sis.storage.isobmff.Reader;
  * @author Johann Sorel (Geomatys)
  * @author Martin Desruisseaux (Geomatys)
  */
+@Incomplete
 public final class FieldInterlace extends FullBox {
     /**
      * Numerical representation of the {@code "ilcp"} box type.
diff --git 
a/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/FieldInterlaceType.java
 
b/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/FieldInterlaceType.java
index 3dd371bbb9..d58770afed 100644
--- 
a/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/FieldInterlaceType.java
+++ 
b/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/FieldInterlaceType.java
@@ -19,16 +19,17 @@ package org.apache.sis.storage.isobmff.mpeg;
 import java.io.IOException;
 import org.apache.sis.storage.isobmff.FullBox;
 import org.apache.sis.storage.isobmff.Reader;
+import org.apache.sis.storage.isobmff.Incomplete;
 
 
 /**
  * Describes the field layout in a sample data in case of interlaced video 
content.
- *
- * @todo Not yet implemented.
+ * <b>Not yet implemented.</b>
  *
  * @author Johann Sorel (Geomatys)
  * @author Martin Desruisseaux (Geomatys)
  */
+@Incomplete
 public final class FieldInterlaceType extends FullBox {
     /**
      * Numerical representation of the {@code "ilce"} box type.
diff --git 
a/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/FramePackingInformation.java
 
b/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/FramePackingInformation.java
index 2d16686eb1..db9bdb05d8 100644
--- 
a/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/FramePackingInformation.java
+++ 
b/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/FramePackingInformation.java
@@ -19,12 +19,12 @@ package org.apache.sis.storage.isobmff.mpeg;
 import java.io.IOException;
 import org.apache.sis.storage.isobmff.FullBox;
 import org.apache.sis.storage.isobmff.Reader;
+import org.apache.sis.storage.isobmff.Incomplete;
 
 
 /**
  * Describes how two pictures are packed into a frame for stereoscopic imagery.
- *
- * @todo Not yet implemented.
+ * <b>Not yet implemented.</b>
  *
  * <h4>Container</h4>
  * The container can be a {@link ItemPropertyContainer} box.
@@ -32,6 +32,7 @@ import org.apache.sis.storage.isobmff.Reader;
  * @author Johann Sorel (Geomatys)
  * @author Martin Desruisseaux (Geomatys)
  */
+@Incomplete
 public final class FramePackingInformation extends FullBox {
     /**
      * Numerical representation of the {@code "fpac"} box type.
diff --git 
a/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/PolarizationPatternDefinition.java
 
b/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/PolarizationPatternDefinition.java
index eb0b5cb438..e69a8cf7ea 100644
--- 
a/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/PolarizationPatternDefinition.java
+++ 
b/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/PolarizationPatternDefinition.java
@@ -19,12 +19,12 @@ package org.apache.sis.storage.isobmff.mpeg;
 import java.io.IOException;
 import org.apache.sis.storage.isobmff.FullBox;
 import org.apache.sis.storage.isobmff.Reader;
+import org.apache.sis.storage.isobmff.Incomplete;
 
 
 /**
  * Describes a filter array pattern for sensors that have polarization 
patterns implemented on the image sensor.
- *
- * @todo Not yet implemented.
+ * <b>Not yet implemented.</b>
  *
  * <h4>Container</h4>
  * The container can be a {@link ItemPropertyContainer} box.
@@ -32,6 +32,7 @@ import org.apache.sis.storage.isobmff.Reader;
  * @author Johann Sorel (Geomatys)
  * @author Martin Desruisseaux (Geomatys)
  */
+@Incomplete
 public final class PolarizationPatternDefinition extends FullBox {
     /**
      * Numerical representation of the {@code "splz"} box type.
diff --git 
a/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/SensorBadPixelsMap.java
 
b/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/SensorBadPixelsMap.java
index e4d7b12c39..2e1fe25db5 100644
--- 
a/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/SensorBadPixelsMap.java
+++ 
b/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/SensorBadPixelsMap.java
@@ -19,12 +19,12 @@ package org.apache.sis.storage.isobmff.mpeg;
 import java.io.IOException;
 import org.apache.sis.storage.isobmff.FullBox;
 import org.apache.sis.storage.isobmff.Reader;
+import org.apache.sis.storage.isobmff.Incomplete;
 
 
 /**
  * Identifies bad pixels on a sensor (pixels for which at least one component 
value is corrupted).
- *
- * @todo Not yet implemented.
+ * <b>Not yet implemented.</b>
  *
  * <h4>Container</h4>
  * The container can be a {@link ItemPropertyContainer} box.
@@ -32,6 +32,7 @@ import org.apache.sis.storage.isobmff.Reader;
  * @author Johann Sorel (Geomatys)
  * @author Martin Desruisseaux (Geomatys)
  */
+@Incomplete
 public final class SensorBadPixelsMap extends FullBox {
     /**
      * Numerical representation of the {@code "sbpm"} box type.
diff --git 
a/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/SensorNonUniformityCorrection.java
 
b/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/SensorNonUniformityCorrection.java
index 1aa1047aee..c4c6d78291 100644
--- 
a/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/SensorNonUniformityCorrection.java
+++ 
b/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/SensorNonUniformityCorrection.java
@@ -19,12 +19,12 @@ package org.apache.sis.storage.isobmff.mpeg;
 import java.io.IOException;
 import org.apache.sis.storage.isobmff.FullBox;
 import org.apache.sis.storage.isobmff.Reader;
+import org.apache.sis.storage.isobmff.Incomplete;
 
 
 /**
  * Describes pixel specific gain and offset corrections.
- *
- * @todo Not yet implemented.
+ * <b>Not yet implemented.</b>
  *
  * <h4>Container</h4>
  * The container can be a {@link ItemPropertyContainer} box.
@@ -32,6 +32,7 @@ import org.apache.sis.storage.isobmff.Reader;
  * @author Johann Sorel (Geomatys)
  * @author Martin Desruisseaux (Geomatys)
  */
+@Incomplete
 public final class SensorNonUniformityCorrection extends FullBox {
     /**
      * Numerical representation of the {@code "snuc"} box type.
diff --git 
a/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/TAIClockInfo.java
 
b/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/TAIClockInfo.java
index fe2704b653..3e7f64fc3e 100644
--- 
a/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/TAIClockInfo.java
+++ 
b/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/TAIClockInfo.java
@@ -20,14 +20,15 @@ import java.io.IOException;
 import org.apache.sis.io.stream.ChannelDataInput;
 import org.apache.sis.storage.isobmff.FullBox;
 import org.apache.sis.storage.isobmff.Reader;
+import org.apache.sis.storage.isobmff.Incomplete;
 import org.apache.sis.storage.isobmff.UnsupportedVersionException;
 
 
 /**
  * From ISO/IEC 23001-17:2024 amendment 1.
- *
- * @todo Find box structure, it seems to have a variable size. Document.
  * The specification was not yet published at the time of writing this class.
+ * Therefore, the box structure needs to be verified and may change.
+ * Note that the box structure seems to have a variable size.
  *
  * <h4>Container</h4>
  * The container can be a {@link ItemPropertyContainer} box.
@@ -35,6 +36,7 @@ import 
org.apache.sis.storage.isobmff.UnsupportedVersionException;
  * @author Johann Sorel (Geomatys)
  * @author Martin Desruisseaux (Geomatys)
  */
+@Incomplete
 public final class TAIClockInfo extends FullBox {
     /**
      * Numerical representation of the {@code "taic"} box type.
diff --git 
a/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/TAITimeStamp.java
 
b/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/TAITimeStamp.java
index 7083645c07..7ec2635fed 100644
--- 
a/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/TAITimeStamp.java
+++ 
b/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/mpeg/TAITimeStamp.java
@@ -20,17 +20,18 @@ import java.io.IOException;
 import org.apache.sis.io.stream.ChannelDataInput;
 import org.apache.sis.storage.isobmff.FullBox;
 import org.apache.sis.storage.isobmff.Reader;
+import org.apache.sis.storage.isobmff.Incomplete;
 import org.apache.sis.storage.isobmff.UnsupportedVersionException;
 
 
 /**
  * From ISO/IEC 23001-17:2024 amendment 1.
- *
- * @todo Verify box structure and document.
  * The specification was not yet published at the time of writing this class.
+ * Therefore, the box structure needs to be verified and may change.
  *
  * @author Johann Sorel (Geomatys)
  */
+@Incomplete
 public final class TAITimeStamp extends FullBox {
     /**
      * Numerical representation of the {@code "itai"} box type.
diff --git 
a/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/video/ContentDescribes.java
 
b/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/video/ContentDescribes.java
index f5f7f8a6b1..d468729963 100644
--- 
a/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/video/ContentDescribes.java
+++ 
b/incubator/src/org.apache.sis.storage.geoheif/main/org/apache/sis/storage/isobmff/video/ContentDescribes.java
@@ -18,17 +18,18 @@ package org.apache.sis.storage.isobmff.video;
 
 import java.io.IOException;
 import org.apache.sis.storage.isobmff.Reader;
+import org.apache.sis.storage.isobmff.Incomplete;
 import org.apache.sis.storage.isobmff.base.SingleItemTypeReference;
 
 
 /**
  * Place holder for future work.
- *
- * @todo Not yet implemented.
+ * <b>Not yet implemented.</b>
  *
  * @author Johann Sorel (Geomatys)
  * @author Martin Desruisseaux (Geomatys)
  */
+@Incomplete
 public final class ContentDescribes extends SingleItemTypeReference {
     /**
      * Numerical representation of the {@code "cdsc"} box type.

Reply via email to