std::Pin documentation missing example

[bIgBV]

I think the std::Pin documentation is missing an example. Specifically, the Intrusive linked list example. The heading contains references to the example and the the heading Drop guarantee contains the following line:

If your type uses pinning (such as the two examples above),

This leads me to believe that there is a missing example in the documentation.

[MightyPork]

Was wondering about this too, reading the release notes. Kind of assumed it's "left as an exercise to the reader"

[RalfJung]

Well, the problem is that implementing the intrusive linked list with a safe API is actually non-trivial. I expect >100 lines. That's why the example is left at the conceptual level.

[hkBst]

I cannot find the mentioned text. There is only a single mention of "example" under "Drop guarantee" and it is "For example, if ...". Combined with the explanation by @RalfJung I don't see anything to do here.

[RalfJung]

This issue predates the complete rewrite of the pin docs that happened... some time last year or so.

[RalfJung]

There's also two extensive examples now so I think we can consider this resolved.