doc: fix errors

* remove example usage due to @code block issues with annotations
* other minor fixes

Author: bogovicj

src/main/java/org/janelia/saalfeldlab/n5/Compression.java

@@ -62,13 +62,14 @@
 import java.lang.annotation.Target;
 
 import org.janelia.saalfeldlab.n5.codec.Codec;
+import org.janelia.saalfeldlab.n5.codec.Codec.BytesCodec;
 import org.janelia.saalfeldlab.n5.readdata.ReadData;
 import org.scijava.annotations.Indexable;
 
 /**
  * Deprecated: {@link Compression}s are no longer a special case.
  * <br>
- * Use {@link Codec.BytesCodec} for implementing compressors.
+ * Use the {@link BytesCodec} interface for implementing compressors.
  * <p>
  * Compression scheme interface.
  *

src/main/java/org/janelia/saalfeldlab/n5/serialization/N5Annotations.java

@@ -25,13 +25,6 @@ public interface N5Annotations extends Serializable {
 	 * For example, Zarr uses C-order (row-major) dimension ordering [Z, Y, X], while N5 uses
 	 * F-order (column-major) dimension ordering [X, Y, Z].
 	 * <p>
-	 * Example usage:
-	 * <pre>{@code
-	 * @N5Annotations.ReverseArray
-	 * @NameConfig.Parameter("chunk_shape")
-	 * private final int[] shape;  // Will be reversed when serializing
-	 * }</pre>
-	 * <p>
 	 * This ensures that dimension-related arrays maintain the correct semantic meaning
 	 * across different storage format conventions.
 	 */

src/main/java/org/janelia/saalfeldlab/n5/serialization/NameConfig.java

@@ -36,14 +36,6 @@ public interface NameConfig extends Serializable {
 	 * type name, creating a namespaced identifier. This is useful for organizing
 	 * related components into logical groups, usually all the components implementing
 	 * a particular interface.
-	 * <p>
-	 * Example usage:
-	 * <pre>{@code
-	 * @NameConfig.Prefix("codec")
-	 * public interface Codec extends NameConfig {
-	 *     // ...
-	 * }
-	 * }</pre>
 	 * 
 	 * @see Name
 	 */
@@ -60,14 +52,6 @@ public interface NameConfig extends Serializable {
 	 * This annotation defines the string identifier used during serialization and
 	 * deserialization to identify the type. The name should be unique within its
 	 * namespace and is typically a short, descriptive identifier.
-	 * <p>
-	 * Example usage:
-	 * <pre>{@code
-	 * @NameConfig.Name("gzip")
-	 * public class GzipCompression implements Compression {
-	 *     // ...
-	 * }
-	 * }</pre>
 	 * 
 	 * @see Prefix
 	 */
@@ -87,17 +71,6 @@ public interface NameConfig extends Serializable {
 	 * <p>
 	 * The {@code value} attribute can be used to specify an alternative name for
 	 * the parameter during serialization. If not specified, the field name is used.
-	 * <p>
-	 * Example usage:
-	 * <pre>{@code
-	 * public class GzipCompression implements Compression {
-	 *     @NameConfig.Parameter
-	 *     private final int level;
-	 *     
-	 *     @NameConfig.Parameter(optional = true)
-	 *     private final boolean useZlib;
-	 * }
-	 * }</pre>
 	 * 
 	 * @see Name
 	 */