Improved wording of some javadoc

Author: GreyCat

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

@@ -34,8 +34,12 @@
 
 /**
  * An implementation of {@link KaitaiStream} backed by a {@link ByteBuffer}.
- * It can be either a {@link MappedByteBuffer} backed by {@link FileChannel},
- * or a regular wrapper over a given byte array).
+ * Any underlying implementation of ByteBuffer can be used, for example:
+ * <ul>
+ *     <li>ByteBuffer returned as result of {@link ByteBuffer#wrap}, wrapping
+ *         a byte array into a buffer.</li>
+ *     <li>{@link MappedByteBuffer} backed by {@link FileChannel}</li>
+ * </ul>
  */
 public class ByteBufferKaitaiStream extends KaitaiStream {
     private FileChannel fc;

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

@@ -24,8 +24,11 @@
 package io.kaitai.struct;
 
 /**
- * A custom decoder interface. Implementing classes can be called
- * from inside a .ksy file using `process: XXX` syntax.
+ * Custom decoder interface allows implementation of "byte array in - byte array
+ * out" decoders, compatible with Kaitai Struct. Classes implementing this
+ * interface can be called rom inside a .ksy file using `process: XXX` syntax.
+ * @see <a href="https://doc.kaitai.io/user_guide.html#custom-process">Kaitai
+ *     Struct documentation on custom processing routines</a>
  */
 public interface CustomDecoder {
     /**