Skip to content

docs: remove stale TLS warnings that contradict the implemented verification #350

Description

@sgerbino

From the review result:

TLS facilities should either be fully implemented and documented as safe for their advertised use, or unsupported/incomplete security functionality must fail safely and consistently rather than silently degrading security.

Source: Boost review result (conditional acceptance), Boost mailing list, September 2026.

The implementation half is done: opt-in chain and hostname verification landed (#309, #311, #323, #331) and degraded build paths fail closed. But 4l.tls.adoc:443 still warns that set_default_verify_paths() "does not currently load any trust anchors, so it verifies nothing against a real public server". That warning predates #309 wiring it up, while the same page and the https-client example present the call as the verified-safe path. The docs simultaneously claim TLS verification works and that it verifies nothing, which is the exact ambiguity this acceptance condition targets.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    • Status
      Ready

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions