Fix dangling Javadoc comments, also fixes Javadoc not getting picked up.

Author: greenrobot-team

objectbox-java-api/src/main/java/io/objectbox/annotation/NotNull.java

@@ -30,5 +30,5 @@
  */
 @Retention(RetentionPolicy.CLASS)
 @Target({ElementType.FIELD, ElementType.METHOD, ElementType.PARAMETER})
-/** TODO public */ @interface NotNull {
+/* TODO public */ @interface NotNull {
 }

objectbox-java-api/src/main/java/io/objectbox/annotation/OrderBy.java

@@ -28,7 +28,7 @@
  */
 @Retention(RetentionPolicy.CLASS)
 @Target(ElementType.FIELD)
-/** TODO public */ @interface OrderBy {
+/* TODO public */ @interface OrderBy {
     /**
      * Comma-separated list of properties, e.g. "propertyA, propertyB, propertyC"
      * To specify direction, add ASC or DESC after property name, e.g.: "propertyA DESC, propertyB ASC"

objectbox-java/src/main/java/io/objectbox/Box.java

@@ -19,7 +19,6 @@
 import java.lang.reflect.Field;
 import java.util.ArrayList;
 import java.util.Collection;
-import java.util.Collections;
 import java.util.HashMap;
 import java.util.Iterator;
 import java.util.List;
@@ -443,8 +442,10 @@ public void remove(@Nullable long... ids) {
         }
     }
 
+    /**
+     * @deprecated use {@link #removeByIds(Collection)} instead.
+     */
     @Deprecated
-    /** @deprecated use {@link #removeByIds(Collection)} instead. */
     public void removeByKeys(@Nullable Collection<Long> ids) {
         removeByIds(ids);
     }

objectbox-java/src/main/java/io/objectbox/BoxStoreBuilder.java

@@ -104,8 +104,8 @@ private BoxStoreBuilder() {
         model = null;
     }
 
-    @Internal
     /** Called internally from the generated class "MyObjectBox". Check MyObjectBox.builder() to get an instance. */
+    @Internal
     public BoxStoreBuilder(byte[] model) {
         this.model = model;
         if (model == null) {
@@ -295,8 +295,10 @@ public BoxStoreBuilder maxSizeInKByte(long maxSizeInKByte) {
         return this;
     }
 
+    /**
+     * @deprecated Use {@link #debugFlags} instead.
+     */
     @Deprecated
-    /** @deprecated Use {@link #debugFlags} instead. */
     public BoxStoreBuilder debugTransactions() {
         this.debugFlags |= DebugFlags.LOG_TRANSACTIONS_READ | DebugFlags.LOG_TRANSACTIONS_WRITE;
         return this;

objectbox-java/src/main/java/io/objectbox/Factory.java

@@ -19,10 +19,10 @@
 import io.objectbox.annotation.apihint.Experimental;
 
 
-@Experimental
 /**
  * Generic Factory that provides a resource on demand (if and when it is required).
  */
+@Experimental
 public interface Factory<T> {
     T provide() throws Exception;
 }

objectbox-java/src/main/java/io/objectbox/model/IdUid.java

@@ -23,10 +23,10 @@
 import java.util.*;
 import com.google.flatbuffers.*;
 
-@SuppressWarnings("unused")
 /**
  * ID tuple: besides the main ID there is also a UID for verification
  */
+@SuppressWarnings("unused")
 public final class IdUid extends Struct {
   public void __init(int _i, ByteBuffer _bb) { bb_pos = _i; bb = _bb; }
   public IdUid __assign(int _i, ByteBuffer _bb) { __init(_i, _bb); return this; }

objectbox-java/src/main/java/io/objectbox/model/Model.java

@@ -23,13 +23,13 @@
 import java.util.*;
 import com.google.flatbuffers.*;
 
-@SuppressWarnings("unused")
 /**
  * A model describes all entities and other meta data.
  * The current model of an app is synced against ObjectBox's persisted schema.
  * The model itself is not persisted, and thus may change as long as both ends are consistent (Java and native).
  * There could be multiple models/schemas (one dbi per schema) in the future.
  */
+@SuppressWarnings("unused")
 public final class Model extends Table {
   public static Model getRootAsModel(ByteBuffer _bb) { return getRootAsModel(_bb, new Model()); }
   public static Model getRootAsModel(ByteBuffer _bb, Model obj) { Constants.FLATBUFFERS_1_11_1(); _bb.order(ByteOrder.LITTLE_ENDIAN); return (obj.__assign(_bb.getInt(_bb.position()) + _bb.position(), _bb)); }