TCP/TLS connection pooling for Eio

Fix odoc errors in documentation

- Fix ambiguous {!decode} and {!connection} references by using val- prefix
- Add section IDs to header_parsing.mli and fix cross-references to sections
- Escape curly braces in documentation examples to avoid bad markup errors
- Fix unpaired brace in URL reference in headers.mli
- Indent verbatim block content in mqtte_cmd.mli

Unresolved references to external libraries (Jsont, Tomlt_bytesrw, etc.)
are intentionally kept as cross-references for future resolution.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

+1 -1
+1 -1
lib/conpool.mli
··· 162 162 val connection_with_info : sw:Eio.Switch.t -> t -> Endpoint.t -> connection_with_info 163 163 (** [connection_with_info ~sw pool endpoint] acquires a connection with TLS info. 164 164 165 - Like {!connection}, but returns a record containing both the connection flow 165 + Like {!val-connection}, but returns a record containing both the connection flow 166 166 and TLS epoch data (if the connection uses TLS). 167 167 168 168 This is useful for protocols that need access to TLS session information,