[解決済み] Boost:asioに最適なドキュメントは？

質問

のドキュメントは ブーストウェブサイト で利用できるドキュメントは...限られています。

私が読んだ限りでは、boost::asioライブラリに関する良いドキュメントを見つけるのは単に難しいというのが一般的な意見です。

これは本当にそうなのでしょうか？ もしそうなら、なぜですか？

注意事項

• すでに、（ブースト以外の） アシオのウェブサイト - を見つけ、ドキュメントはブーストウェブサイトのものと同じようです。
• Boost::asioが新しいことは知っています! 私は言い訳ではなく、解決策を探しています。

編集する

• には TR2 の標準ライブラリにネットワークライブラリを追加する提案 の作者(Christopher Kohlhoff)によって書かれたものがあります。 これはboost:asioのドキュメントではありませんが、TR2提案のベースとしてboost:asioを使用しています。 作者がこの文書に力を注いだので、リファレンスとまではいかないまでも、少なくとも概要としてはある程度役に立つと思います。

どのように解決するのか？

まず、私はBoost.Asioをすでにかなり長い間使用しており、あなたの懸念を共有しています。あなたの質問に答えるために。

• Boost.Asioに関するドキュメントは、イントロダクションとチュートリアルを除けば、本当にわずかです。私は著者ではありませんが、これは、非同期 IO ライブラリのような低レベルのものに対してドキュメント化するものがあまりにも多すぎることが主な理由です。
• 例題はチュートリアルよりも多くのことを教えてくれます。もしあなたが、さまざまな例を見るために少しの時間を費やしても構わないのであれば、あなたが始めるにはそれで十分だと思います。もし、あなたがそれを実行したいのであれば、リファレンスドキュメントが大いに役立つはずです。
• 本当に行き詰まったり、特定のガイダンスを探している場合は、Boost Users and Boost Developersメーリングリストに尋ねてみてください。メーリングリストでは、多くの人があなたの悩みを解決してくれると思います。

Boost.Asio の一部ではありませんが、多くの機能と可能な代替ユースケースを公開するための取り組みがあります。これは、せいぜいブログおよびパッケージ化されていないドキュメントの他のフォームでウェブ上に散らばっています。

不明確で、Boost.Asio ライブラリの作者と開発者との密接な調整を本当に必要とする 1 つのことは、特定のプラットフォームのためにそれを拡張およびカスタマイズするか、特定の新機能を追加することです。これは改善されるべきですが、良いことは、Asioが将来的に標準ライブラリ技術報告（STLの非同期IOライブラリ）の参照実装になるように見えるということです。