Boost.Asio uses Boost.Coroutine v1, yet Boost.Coroutine v2 references it as a usage example

[Antoine Poliakov <antoinep92@…>]

In http://www.boost.org/doc/libs/1_62_0/libs/coroutine2/doc/html/coroutine2/motivation.html there is a code sample using boost::asio::yield to demonstrate the benefits of using coroutines.

This code sample seems to be copy-pasted from Boost.Coroutine v1 http://www.boost.org/doc/libs/1_62_0/libs/coroutine/doc/html/coroutine/motivation.html, and it's quite misleading since from what I can tell (documentation and include chains in the code, boost::asio::yield is built on top of Coroutine v1 and not Coroutine2.

So if I try to build the code sample from Coroutine2 documentation, I get a warning saying that Boost.Coroutine is deprecated and I should be using the v2, which I thought I was because that's where the sample came from.

Ideally it would be good if Boost.ASIO was ported to Coroutine v2, but in the meantime it might be better to remove the ASIO code sample in Coroutine v2 documentation.