IKaitaiEnum: improve code comments

Author: generalmimon

src/main/java/io/kaitai/struct/IKaitaiEnum.java

@@ -24,18 +24,18 @@
 package io.kaitai.struct;
 
 /**
- * Interface, implemented by every enum class generated by Kaitai Struct compiler.
+ * Interface implemented by every enum class generated by Kaitai Struct compiler.
  *
  * @since 0.11
  */
 public interface IKaitaiEnum {
     /**
-     * Base class for all unknown variants of Kaitai-generated enums.
+     * Base class for all unknown values of Kaitai-generated enums.
      *
-     * If you want to determine is the variant that you have is known or not,
-     * you can use {@code <variant> instanceof IKaitaiEnum.Unknown}.
+     * If you want to determine is the enum value you have is known or not,
+     * you can use {@code <value> instanceof IKaitaiEnum.Unknown}.
      *
-     * The descendants of this class have value semantic, like enums: their
+     * The descendants of this class have value semantics like enums: their
      * {@code equals} method compares inner long values of the same class (so
      * {@code Unknown} values of different Kaitai enums are not equal) and
      * {@code hashCode} method returns {@code Objects.hash("<enum-name>", this.id())}.
@@ -48,6 +48,6 @@ public abstract class Unknown implements IKaitaiEnum {
         public long id() { return id; }
     }
 
-    /** Returns the underlying number which represents this enum variant. */
+    /** Returns the underlying integer which represents this enum value. */
     public long id();
 }