fix(quic): resolve dangling KDoc lint errors

Move the feedDatagram KDoc below the MAX_QUIC_OFFSET const so it
attaches to the function declaration, and merge the duplicate KDoc
blocks above TlsResumptionState into a single block.
This commit is contained in:
Claude
2026-05-09 01:40:48 +00:00
parent 5c50e54569
commit 2be76c898c
2 changed files with 5 additions and 9 deletions
@@ -49,6 +49,9 @@ import com.vitorpamplona.quic.packet.ShortHeaderPacket
import com.vitorpamplona.quic.stream.StreamId
import com.vitorpamplona.quic.tls.TlsClient
/** RFC 9000 §16: maximum varint value, also the per-stream offset ceiling. */
private const val MAX_QUIC_OFFSET: Long = (1L shl 62) - 1L
/**
* Decode every QUIC packet inside a single inbound UDP datagram and dispatch
* its frames to [conn]'s state.
@@ -67,10 +70,6 @@ import com.vitorpamplona.quic.tls.TlsClient
* under streamsLock so frame-dispatch / stream creation / level state
* remains a single critical section.
*/
/** RFC 9000 §16: maximum varint value, also the per-stream offset ceiling. */
private const val MAX_QUIC_OFFSET: Long = (1L shl 62) - 1L
fun feedDatagram(
conn: QuicConnection,
datagram: ByteArray,
@@ -668,7 +668,8 @@ interface TlsSecretsListener {
* Self-contained state needed to resume a TLS 1.3 session via PSK on the
* next connection. Produced by the TLS layer when a NewSessionTicket
* arrives; consumed by a fresh [TlsClient] via its `resumption`
* constructor argument.
* constructor argument. Lets the client offer RFC 8446 PSK-resumption +
* RFC 9001 §4.6 0-RTT on the next connection.
*
* Why store all this rather than just the ticket: the PSK derivation
* binds to a specific cipher suite (32-byte hash for our SHA-256 suites)
@@ -676,10 +677,6 @@ interface TlsSecretsListener {
* obfuscation arithmetic on the next connection needs both
* [ticketAgeAdd] and [issuedAtMillis] to compute the obfuscated_ticket_age
* the server expects.
*/
/**
* Cached state from a prior TLS handshake that lets the client offer
* RFC 8446 PSK-resumption + RFC 9001 §4.6 0-RTT on the next connection.
*
* Plain `class` (not `data class`) intentionally:
* - The `data class`-generated `equals` / `hashCode` use reference