@@ -86,14 +86,13 @@ public ByteBufferKaitaiStream(ByteBuffer buffer) {
86
86
* which the associated type was parsed, because the underlying {@link ByteBuffer} might
87
87
* contain the data of all parent types and such as well and not only the one the caller is
88
88
* actually interested in.
89
- * </p>
90
89
* <p>
91
90
* The returned {@link ByteBuffer} is always rewinded to position 0, because this stream was
92
91
* most likely used to parse a type already, in which case the former position would have been
93
92
* at the end of the buffer. Such a position doesn't help a common reading user much and that
94
93
* fact can easily be forgotten, repositioning to another index than the start is pretty easy
95
94
* as well. Rewinding/repositioning doesn't even harm performance in any way.
96
- * </p>
95
+ *
97
96
* @return read-only {@link ByteBuffer} to access raw data for the associated type.
98
97
*/
99
98
public ByteBuffer asRoBuffer () {
@@ -115,22 +114,19 @@ public ByteBuffer asRoBuffer() {
115
114
* references to it, which breaks all subsequent <code>read..</code> methods with
116
115
* {@link NullPointerException}. Afterwards, a call to {@link System#gc()} will
117
116
* typically release the mmap, if garbage collection will be triggered.
118
- * </p>
119
117
* <p>
120
118
* There is a <a href="https://bugs.java.com/bugdatabase/view_bug.do?bug_id=4724038">
121
119
* JDK-4724038 request for adding unmap method</a> filed at Java bugtracker since 2002,
122
120
* but as of 2018, it is still unresolved.
123
- * </p>
124
121
* <p>
125
122
* A couple of unsafe approaches (such as using JNI, or using reflection to invoke JVM
126
123
* internal APIs) have been suggested and used with some success, but these are either
127
124
* unportable or dangerous (may crash JVM), so we're not using them in this general
128
125
* purpose code.
129
- * </p>
130
126
* <p>
131
127
* For more examples and suggestions, see:
132
- * https://stackoverflow.com/questions/2972986/how-to-unmap-a-file-from-memory-mapped-using-filechannel-in-java
133
- * </p>
128
+ * <a href=" https://stackoverflow.com/questions/2972986/how-to-unmap-a-file-from-memory-mapped-using-filechannel-in-java">How to unmap a file from memory mapped using FileChannel in java?</a>
129
+ *
134
130
* @throws IOException if FileChannel can't be closed
135
131
*/
136
132
@ Override
0 commit comments