https://svn.boost.org/trac10/ticket/12709 <p> In <a href="http://www.boost.org/doc/libs/1_62_0/libs/coroutine2/doc/html/coroutine2/motivation.html">http://www.boost.org/doc/libs/1_62_0/libs/coroutine2/doc/html/coroutine2/motivation.html</a> there is a code sample using <code>boost::asio::yield</code> to demonstrate the benefits of using coroutines. </p> <p> This code sample seems to be copy-pasted from Boost.Coroutine v1 <a href="http://www.boost.org/doc/libs/1_62_0/libs/coroutine/doc/html/coroutine/motivation.html">http://www.boost.org/doc/libs/1_62_0/libs/coroutine/doc/html/coroutine/motivation.html</a>, and it's <strong>quite misleading</strong> since from what I can tell (documentation and include chains in the code, <code>boost::asio::yield</code> is built on top of Coroutine v1 and not Coroutine2. </p> <p> 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. </p> <p> 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. </p> en-us /htdocs/site/boost.png https://svn.boost.org/trac10/ticket/12709 Trac 1.4.3 Kohei Takahashi Fri, 23 Dec 2016 07:35:40 GMT https://svn.boost.org/trac10/ticket/12709#comment:1 https://svn.boost.org/trac10/ticket/12709#comment:1 <ul> <li><strong>owner</strong> changed from <span class="trac-author">Matias Capeletto</span> to <span class="trac-author">olli</span> </li> </ul> Ticket anonymous Sat, 04 Nov 2017 02:36:12 GMT https://svn.boost.org/trac10/ticket/12709#comment:2 https://svn.boost.org/trac10/ticket/12709#comment:2 <ul> <li><strong>component</strong> <span class="trac-field-old">Documentation</span> → <span class="trac-field-new">coroutine</span> </li> </ul> Ticket