main.qbk 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204
  1. [/
  2. Copyright (c) 2016-2019 Vinnie Falco (vinnie dot falco at gmail dot com)
  3. Distributed under the Boost Software License, Version 1.0. (See accompanying
  4. file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
  5. Official repository: https://github.com/boostorg/beast
  6. ]
  7. [library Boost.Beast
  8. [id beast]
  9. [quickbook 1.6]
  10. [copyright 2016 - 2019 Vinnie Falco]
  11. [purpose Networking Protocol Library]
  12. [license
  13. Distributed under the Boost Software License, Version 1.0.
  14. (See accompanying file LICENSE_1_0.txt or copy at
  15. [@http://www.boost.org/LICENSE_1_0.txt])
  16. ]
  17. [authors [Falco, Vinnie]]
  18. [category template]
  19. [category generic]
  20. ]
  21. [template mdash[] '''— ''']
  22. [template indexterm1[term1] '''<indexterm><primary>'''[term1]'''</primary></indexterm>''']
  23. [template indexterm2[term1 term2] '''<indexterm><primary>'''[term1]'''</primary><secondary>'''[term2]'''</secondary></indexterm>''']
  24. [template path_link[path name] '''<ulink url="../../'''[path]'''">'''[name]'''</ulink>''']
  25. [template include_file[path][^<'''<ulink url="../../../../'''[path]'''">'''[path]'''</ulink>'''>]]
  26. [template issue[n] '''<ulink url="https://github.com/boostorg/beast/issues/'''[n]'''">#'''[n]'''</ulink>''']
  27. [def __N3747__ [@http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2013/n3747.pdf [*N3747]]]
  28. [def __NetTS__ [@http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2018/n4771.pdf Networking TS]]
  29. [def __rfc6455__ [@https://tools.ietf.org/html/rfc6455 rfc6455]]
  30. [def __rfc7230__ [@https://tools.ietf.org/html/rfc7230 rfc7230]]
  31. [def __Asio__ [@boost:/libs/asio/index.html Boost.Asio]]
  32. [def __async_initfn__ [@boost:/doc/html/boost_asio/reference/asynchronous_operations.html initiating function]]
  33. [/ C++ Named Requirements ]
  34. [def __Allocator__ [@https://en.cppreference.com/w/cpp/named_req/Allocator ['Allocator]]]
  35. [/ Networking Identifiers ]
  36. [def __asio_handler_allocate__ [@boost:/doc/html/boost_asio/reference/asio_handler_allocate.html `asio_handler_allocate`]]
  37. [def __asio_handler_invoke__ [@boost:/doc/html/boost_asio/reference/asio_handler_invoke.html `asio_handler_invoke`]]
  38. [def __basic_stream_socket__ [@boost:/doc/html/boost_asio/reference/basic_stream_socket.html `basic_stream_socket`]]
  39. [def __const_buffer__ [@boost:/doc/html/boost_asio/reference/const_buffer.html `const_buffer`]]
  40. [def __deduced__ [@boost:/doc/html/boost_asio/reference/asynchronous_operations.html#boost_asio.reference.asynchronous_operations.automatic_deduction_of_initiating_function_return_type ['DEDUCED]]]
  41. [def __executor_work_guard__ [@boost:/doc/html/boost_asio/reference/executor_work_guard.html `net::executor_work_guard`]]
  42. [def __get_associated_allocator__ [@boost:/doc/html/boost_asio/reference/get_associated_allocator.html `net::get_associated_allocator`]]
  43. [def __get_associated_executor__ [@boost:/doc/html/boost_asio/reference/get_associated_executor.html `net::get_associated_executor`]]
  44. [def __io_context__ [@boost:/doc/html/boost_asio/reference/io_context.html `net::io_context`]]
  45. [def __mutable_buffer__ [@boost:/doc/html/boost_asio/reference/mutable_buffer.html `mutable_buffer`]]
  46. [def __post__ [@boost:/doc/html/boost_asio/reference/post.html `net::post`]]
  47. [def __socket__ [@boost:/doc/html/boost_asio/reference/ip__tcp/socket.html `tcp::socket`]]
  48. [def __strand__ [@boost:/doc/html/boost_asio/reference/strand.html `net::strand`]]
  49. [def __ssl_context__ [@boost:/doc/html/boost_asio/reference/ssl__context.html `net::ssl::context`]]
  50. [def __ssl_stream__ [@boost:/doc/html/boost_asio/reference/ssl__stream.html `net::ssl::stream`]]
  51. [def __streambuf__ [@boost:/doc/html/boost_asio/reference/streambuf.html `net::streambuf`]]
  52. [def __system_executor__ [@boost:/doc/html/boost_asio/reference/system_executor.html `net::system_executor`]]
  53. [def __use_future__ [@boost:/doc/html/boost_asio/reference/use_future_t.html `net::use_future`]]
  54. [def __yield_context__ [@boost:/doc/html/boost_asio/reference/yield_context.html `net::yield_context`]]
  55. [/ Networking Named Requirements]
  56. [def __AsyncReadStream__ [@boost:/doc/html/boost_asio/reference/AsyncReadStream.html ['AsyncReadStream]]]
  57. [def __AsyncWriteStream__ [@boost:/doc/html/boost_asio/reference/AsyncWriteStream.html ['AsyncWriteStream]]]
  58. [def __CompletionCondition__ [@boost:/doc/html/boost_asio/reference/CompletionCondition.html ['CompletionCondition]]]
  59. [def __CompletionHandler__ [@boost:/doc/html/boost_asio/reference/CompletionHandler.html ['CompletionHandler]]]
  60. [def __CompletionToken__ [@boost:/doc/html/boost_asio/reference/asynchronous_operations.html#boost_asio.reference.asynchronous_operations.completion_tokens_and_handlers ['CompletionToken]]]
  61. [def __ConnectCondition__ [@boost:/doc/html/boost_asio/reference/ConnectCondition.html ['ConnectCondition]]]
  62. [def __ConnectHandler__ [@boost:/doc/html/boost_asio/reference/ConnectHandler.html ['ConnectHandler]]]
  63. [def __ConstBufferSequence__ [@boost:/doc/html/boost_asio/reference/ConstBufferSequence.html ['ConstBufferSequence]]]
  64. [def __EndpointSequence__ [@boost:/doc/html/boost_asio/reference/EndpointSequence.html ['EndpointSequence]]]
  65. [def __Executor__ [@boost:/doc/html/boost_asio/reference/Executor1.html ['Executor]]]
  66. [def __Executor1__ [@boost:/doc/html/boost_asio/reference/Executor1.html ['Executor1]]]
  67. [def __Executor2__ [@boost:/doc/html/boost_asio/reference/Executor1.html ['Executor2]]]
  68. [def __ExecutionContext__ [@boost:/doc/html/boost_asio/reference/ExecutionContext.html ['ExecutionContext]]]
  69. [def __Handler__ [@boost:/doc/html/boost_asio/reference/Handler.html ['Handler]]]
  70. [def __IteratorConnectHandler__ [@boost:/doc/html/boost_asio/reference/IteratorConnectHandler.html ['IteratorConnectHandler]]]
  71. [def __MutableBufferSequence__ [@boost:/doc/html/boost_asio/reference/MutableBufferSequence.html ['MutableBufferSequence]]]
  72. [def __Protocol__ [@boost:/doc/html/boost_asio/reference/Protocol.html ['Protocol]]]
  73. [def __RangeConnectHandler__ [@boost:/doc/html/boost_asio/reference/RangeConnectHandler.html ['RangeConnectHandler]]]
  74. [def __ReadHandler__ [@boost:/doc/html/boost_asio/reference/ReadHandler.html ['ReadHandler]]]
  75. [def __SyncReadStream__ [@boost:/doc/html/boost_asio/reference/SyncReadStream.html ['SyncReadStream]]]
  76. [def __SyncWriteStream__ [@boost:/doc/html/boost_asio/reference/SyncWriteStream.html ['SyncWriteStream]]]
  77. [def __WriteHandler__ [@boost:/doc/html/boost_asio/reference/WriteHandler.html ['WriteHandler]]]
  78. [/ Beast Named Requirements ]
  79. [def __AsyncStream__ [link beast.concepts.streams.AsyncStream ['AsyncStream]]]
  80. [def __Body__ [link beast.concepts.Body ['Body]]]
  81. [def __BodyReader__ [link beast.concepts.BodyReader ['BodyReader]]]
  82. [def __BodyWriter__ [link beast.concepts.BodyWriter ['BodyWriter]]]
  83. [def __BufferSequence__ [link beast.concepts.BufferSequence ['BufferSequence]]]
  84. [def __DynamicBuffer__ [link beast.concepts.DynamicBuffer ['DynamicBuffer]]]
  85. [def __Fields__ [link beast.concepts.Fields ['Fields]]]
  86. [def __FieldsWriter__ [link beast.concepts.FieldsWriter ['FieldsWriter]]]
  87. [def __File__ [link beast.concepts.File ['File]]]
  88. [def __RatePolicy__ [link beast.concepts.RatePolicy ['RatePolicy]]]
  89. [def __Stream__ [link beast.concepts.streams ['Stream]]]
  90. [def __SyncStream__ [link beast.concepts.streams.SyncStream ['SyncStream]]]
  91. [/ Beast Identifiers ]
  92. [def __basic_fields__ [link beast.ref.boost__beast__http__basic_fields `basic_fields`]]
  93. [def __basic_multi_buffer__ [link beast.ref.boost__beast__basic_multi_buffer `basic_multi_buffer`]]
  94. [def __basic_parser__ [link beast.ref.boost__beast__http__basic_parser `basic_parser`]]
  95. [def __bind_handler__ [link beast.ref.boost__beast__bind_handler `bind_handler`]]
  96. [def __buffer_body__ [link beast.ref.boost__beast__http__buffer_body `buffer_body`]]
  97. [def __fields__ [link beast.ref.boost__beast__http__fields `fields`]]
  98. [def __flat_buffer__ [link beast.ref.boost__beast__flat_buffer `flat_buffer`]]
  99. [def __header__ [link beast.ref.boost__beast__http__header `header`]]
  100. [def __message__ [link beast.ref.boost__beast__http__message `message`]]
  101. [def __multi_buffer__ [link beast.ref.boost__beast__multi_buffer `multi_buffer`]]
  102. [def __parser__ [link beast.ref.boost__beast__http__parser `parser`]]
  103. [def __serializer__ [link beast.ref.boost__beast__http__serializer `serializer`]]
  104. [def __flat_static_buffer__ [link beast.ref.boost__beast__flat_static_buffer `flat_static_buffer`]]
  105. [def __flat_static_buffer_base__ [link beast.ref.boost__beast__flat_static_buffer_base `flat_static_buffer_base`]]
  106. [def __websocket_stream__ [link beast.ref.boost__beast__websocket__stream `websocket::stream`]]
  107. [/ Dingbat Legend]
  108. [def __new__ [role green \u2605]]
  109. [def __example__ \U0001f4a1]
  110. [def __video__ \U0001f3a6]
  111. [def __report__ \U0001f4cb]
  112. [def __star__ \u2b50]
  113. [/
  114. VFALCO unfortunately quickbook wants relative paths and we have no
  115. variables so all of the .cpp and .hpp files are placed here to keep
  116. the paths close to absolute.
  117. ]
  118. [import ../../example/doc/http_examples.hpp]
  119. [import ../../example/echo-op/echo_op.cpp]
  120. [import ../../example/http/client/sync/http_client_sync.cpp]
  121. [import ../../example/websocket/client/sync/websocket_client_sync.cpp]
  122. [import ../../include/boost/beast/http/basic_file_body.hpp]
  123. [import ../../include/boost/beast/websocket/stream_fwd.hpp]
  124. [import ../../test/doc/exemplars.cpp]
  125. [import ../../test/doc/core_snippets.cpp]
  126. [import ../../test/doc/http_snippets.cpp]
  127. [import ../../test/doc/core_1_refresher.cpp]
  128. [import ../../test/doc/core_3_timeouts.cpp]
  129. [import ../../test/doc/core_4_layers.cpp]
  130. [import ../../test/doc/http_10_custom_parser.cpp]
  131. [import ../../test/doc/websocket_common.ipp]
  132. [import ../../test/doc/websocket.cpp]
  133. [import ../../test/doc/websocket_1_connecting.cpp]
  134. [import ../../test/doc/websocket_2_handshaking.cpp]
  135. [import ../../test/doc/websocket_3_decorator.cpp]
  136. [import ../../test/doc/websocket_4_messages.cpp]
  137. [import ../../test/doc/websocket_5_control_frames.cpp]
  138. [import ../../test/doc/websocket_6_timeouts.cpp]
  139. [import ../../test/doc/websocket_7_teardown.cpp]
  140. [import ../../test/doc/websocket_8_notes.cpp]
  141. [import ../../include/boost/beast/core/detect_ssl.hpp]
  142. [import ../../test/beast/core/rate_policy.cpp]
  143. __new__ indicates a new or updated section in this version.
  144. __example__ contains example source code.
  145. __video__ contains video presentation content
  146. [section:quickref Reference]
  147. __new__ indicates an item that was recently added.
  148. [xinclude quickref.xml]
  149. [endsect]
  150. [block'''<reference id="beast_hidden"><title>This Page Intentionally Left Blank 1/2</title>''']
  151. [section:ref This Page Intentionally Left Blank 2/2]
  152. [include reference.qbk]
  153. [endsect]
  154. [block'''</reference>''']
  155. [include release_notes.qbk]
  156. [include 01_intro/_intro.qbk]
  157. [include 02_examples/_examples.qbk]
  158. [include 03_core/_core.qbk]
  159. [include 04_http/_http.qbk]
  160. [include 05_http_examples/_http_examples.qbk]
  161. [include 06_websocket/_websocket.qbk]
  162. [include 07_concepts/_concepts.qbk]
  163. [include 08_design/_design.qbk]
  164. [section:moved1 Release Notes (Moved)]
  165. The Release Notes have been moved to the top of the table of contents.
  166. [endsect]
  167. [section:moved2 Reference (Moved)]
  168. The Reference has been moved to the top of the table of contents.
  169. [endsect]
  170. [xinclude index.xml]