Squashed 'doc/docca/' changes from 1bfc5ede..df9bd956

df9bd956 Add deduced alias
220ded9a Add see-below alias

git-subtree-dir: doc/docca
git-subtree-split: df9bd956e2480467447c80ffae3b44b3c0b0756a

doc/docca/example/include/docca/example.hpp

@@ -67,13 +67,19 @@ using t_type = std::vector<T>;
 
     Description
 */
-using vod = void_or_deduced;
+using vod = __deduced__;
+
+/** See below
+
+    Description
+*/
+using sb = __see_below__;
 
 /** Implementation-defined
 
     Description
 */
-using impdef = implementation_defined;
+using impdef = __implementation_defined__;
 
 /** Variable
 

doc/docca/include/docca/doxygen.xsl

@@ -178,11 +178,17 @@
   </xsl:variable>
   <xsl:variable name="cleaned">
     <xsl:choose>
-      <xsl:when test="$type='implementation_defined'">
+      <xsl:when test="$type='__implementation_defined__'">
         <xsl:text>``['implementation-defined]``</xsl:text>
       </xsl:when>
+      <xsl:when test="$type='__see_below__'">
+        <xsl:text>``['see-below]``</xsl:text>
+      </xsl:when>
+      <xsl:when test="$type='__deduced__'">
+        <xsl:text>``__deduced__``</xsl:text>
+      </xsl:when>
       <xsl:when test="$type='void_or_deduced'">
-        <xsl:text>``__void_or_deduced__``</xsl:text>
+        <xsl:text>``__deduced__``</xsl:text>
       </xsl:when>
       <xsl:otherwise>
         <xsl:value-of select="$type"/>

include/boost/beast/core/bind_handler.hpp

@@ -54,7 +54,7 @@ namespace beast {
 */
 template<class Handler, class... Args>
 #if BOOST_BEAST_DOXYGEN
-implementation_defined
+__implementation_defined__
 #else
 detail::bound_handler<
     typename std::decay<Handler>::type, Args...>

include/boost/beast/core/buffered_read_stream.hpp

@@ -174,7 +174,7 @@ public:
         `NextLayer` has a member function named `get_executor`.
     */
 #if BOOST_BEAST_DOXYGEN
-    implementation_defined
+    __implementation_defined__
 #else
     template<
         class T = next_layer_type,

include/boost/beast/core/buffers_adapter.hpp

@@ -77,10 +77,10 @@ public:
 
 #if BOOST_BEAST_DOXYGEN
     /// The type used to represent the input sequence as a list of buffers.
-    using const_buffers_type = implementation_defined;
+    using const_buffers_type = __implementation_defined__;
 
     /// The type used to represent the output sequence as a list of buffers.
-    using mutable_buffers_type = implementation_defined;
+    using mutable_buffers_type = __implementation_defined__;
 
 #else
     class const_buffers_type;

include/boost/beast/core/buffers_cat.hpp

@@ -34,7 +34,7 @@ public:
         Otherwise, `value_type` will be `boost::asio::const_buffer`.
     */
 #if BOOST_BEAST_DOXYGEN
-    using value_type = implementation_defined;
+    using value_type = __implementation_defined__;
 #else
     using value_type = typename
         detail::common_buffers_type<Buffers...>::type;

include/boost/beast/core/buffers_prefix.hpp

@@ -66,7 +66,7 @@ public:
 
 #if BOOST_BEAST_DOXYGEN
     /// A bidirectional iterator type that may be used to read elements.
-    using const_iterator = implementation_defined;
+    using const_iterator = __implementation_defined__;
 
 #else
     class const_iterator;

include/boost/beast/core/buffers_suffix.hpp

@@ -82,7 +82,7 @@ public:
         `boost::asio::const_buffer`.
     */
 #if BOOST_BEAST_DOXYGEN
-    using value_type = implementation_defined;
+    using value_type = __implementation_defined__;
 #else
     using value_type = typename std::conditional<
         std::is_convertible<typename
@@ -94,7 +94,7 @@ public:
 
 #if BOOST_BEAST_DOXYGEN
     /// A bidirectional iterator type that may be used to read elements.
-    using const_iterator = implementation_defined;
+    using const_iterator = __implementation_defined__;
 
 #else
     class const_iterator;

include/boost/beast/core/multi_buffer.hpp

@@ -84,10 +84,10 @@ public:
 
 #if BOOST_BEAST_DOXYGEN
     /// The type used to represent the input sequence as a list of buffers.
-    using const_buffers_type = implementation_defined;
+    using const_buffers_type = __implementation_defined__;
 
     /// The type used to represent the output sequence as a list of buffers.
-    using mutable_buffers_type = implementation_defined;
+    using mutable_buffers_type = __implementation_defined__;
 
 #else
     class const_buffers_type;

include/boost/beast/core/ostream.hpp

@@ -43,7 +43,7 @@ namespace beast {
 */
 template<class ConstBufferSequence>
 #if BOOST_BEAST_DOXYGEN
-implementation_defined
+__implementation_defined__
 #else
 detail::buffers_helper<ConstBufferSequence>
 #endif
@@ -82,7 +82,7 @@ buffers(ConstBufferSequence const& b)
 */
 template<class DynamicBuffer>
 #if BOOST_BEAST_DOXYGEN
-implementation_defined
+__implementation_defined__
 #else
 detail::ostream_helper<
     DynamicBuffer, char, std::char_traits<char>,

include/boost/beast/http/basic_dynamic_body.hpp

@@ -62,7 +62,7 @@ struct basic_dynamic_body
         Meets the requirements of @b BodyReader.
     */
 #if BOOST_BEAST_DOXYGEN
-    using reader = implementation_defined;
+    using reader = __implementation_defined__;
 #else
     class reader
     {
@@ -122,7 +122,7 @@ struct basic_dynamic_body
         Meets the requirements of @b BodyWriter.
     */
 #if BOOST_BEAST_DOXYGEN
-    using writer = implementation_defined;
+    using writer = __implementation_defined__;
 #else
     class writer
     {

include/boost/beast/http/buffer_body.hpp

@@ -96,7 +96,7 @@ struct buffer_body
         Meets the requirements of @b BodyReader.
     */
 #if BOOST_BEAST_DOXYGEN
-    using reader = implementation_defined;
+    using reader = __implementation_defined__;
 #else
     class reader
     {
@@ -154,7 +154,7 @@ struct buffer_body
         Meets the requirements of @b BodyWriter.
     */
 #if BOOST_BEAST_DOXYGEN
-    using writer = implementation_defined;
+    using writer = __implementation_defined__;
 #else
     class writer
     {

include/boost/beast/http/chunk_encode.hpp

@@ -46,7 +46,7 @@ struct chunk_crlf
 
     /// Required for @b ConstBufferSequence
 #if BOOST_BEAST_DOXYGEN
-    using value_type = implementation_defined;
+    using value_type = __implementation_defined__;
 #else
     using value_type = detail::chunk_crlf_iter::value_type;
 #endif
@@ -229,14 +229,14 @@ public:
 
     /// Required for @b ConstBufferSequence
 #if BOOST_BEAST_DOXYGEN
-    using value_type = implementation_defined;
+    using value_type = __implementation_defined__;
 #else
     using value_type = typename view_type::value_type;
 #endif
 
     /// Required for @b ConstBufferSequence
 #if BOOST_BEAST_DOXYGEN
-    using const_iterator = implementation_defined;
+    using const_iterator = __implementation_defined__;
 #else
     using const_iterator = typename view_type::const_iterator;
 #endif
@@ -423,14 +423,14 @@ public:
 
     /// Required for @b ConstBufferSequence
 #if BOOST_BEAST_DOXYGEN
-    using value_type = implementation_defined;
+    using value_type = __implementation_defined__;
 #else
     using value_type = typename view_type::value_type;
 #endif
 
     /// Required for @b ConstBufferSequence
 #if BOOST_BEAST_DOXYGEN
-    using const_iterator = implementation_defined;
+    using const_iterator = __implementation_defined__;
 #else
     using const_iterator = typename view_type::const_iterator;
 #endif
@@ -528,7 +528,7 @@ public:
 
     /// Required for @b ConstBufferSequence
 #if BOOST_BEAST_DOXYGEN
-    using value_type = implementation_defined;
+    using value_type = __implementation_defined__;
 #else
     using value_type =
         typename view_type::value_type;
@@ -536,7 +536,7 @@ public:
 
     /// Required for @b ConstBufferSequence
 #if BOOST_BEAST_DOXYGEN
-    using const_iterator = implementation_defined;
+    using const_iterator = __implementation_defined__;
 #else
     using const_iterator =
         typename view_type::const_iterator;

include/boost/beast/http/detail/basic_parsed_list.hpp

@@ -36,7 +36,7 @@ public:
 
     /// A constant iterator to a list element.
 #if BOOST_BEAST_DOXYGEN
-    using const_iterator = implementation_defined;
+    using const_iterator = __implementation_defined__;
 #else
     class const_iterator;
 #endif

include/boost/beast/http/empty_body.hpp

@@ -57,7 +57,7 @@ struct empty_body
         Meets the requirements of @b BodyReader.
     */
 #if BOOST_BEAST_DOXYGEN
-    using reader = implementation_defined;
+    using reader = __implementation_defined__;
 #else
     struct reader
     {
@@ -95,7 +95,7 @@ struct empty_body
         Meets the requirements of @b BodyWriter.
     */
 #if BOOST_BEAST_DOXYGEN
-    using writer = implementation_defined;
+    using writer = __implementation_defined__;
 #else
     struct writer
     {

include/boost/beast/http/fields.hpp

@@ -117,7 +117,7 @@ public:
         The case-comparison operation is defined only for low-ASCII characters.
     */
 #if BOOST_BEAST_DOXYGEN
-    using key_compare = implementation_defined;
+    using key_compare = __implementation_defined__;
 #else
     struct key_compare : beast::iless
 #endif
@@ -164,7 +164,7 @@ public:
 
     /// The algorithm used to serialize the header
 #if BOOST_BEAST_DOXYGEN
-    using writer = implementation_defined;
+    using writer = __implementation_defined__;
 #else
     class writer;
 #endif
@@ -277,7 +277,7 @@ public:
 public:
     /// A constant iterator to the field sequence.
 #if BOOST_BEAST_DOXYGEN
-    using const_iterator = implementation_defined;
+    using const_iterator = __implementation_defined__;
 #else
     using const_iterator = typename list_t::const_iterator;
 #endif

include/boost/beast/http/rfc7230.hpp

@@ -66,7 +66,7 @@ public:
 
     /// A constant iterator to the list
 #if BOOST_BEAST_DOXYGEN
-    using const_iterator = implementation_defined;
+    using const_iterator = __implementation_defined__;
 #else
     class const_iterator;
 #endif
@@ -155,7 +155,7 @@ public:
 
     /// A constant iterator to the list
 #if BOOST_BEAST_DOXYGEN
-    using const_iterator = implementation_defined;
+    using const_iterator = __implementation_defined__;
 #else
     class const_iterator;
 #endif
@@ -243,7 +243,7 @@ public:
 
     /// A constant iterator to the list
 #if BOOST_BEAST_DOXYGEN
-    using const_iterator = implementation_defined;
+    using const_iterator = __implementation_defined__;
 #else
     class const_iterator;
 #endif

include/boost/beast/http/serializer.hpp

@@ -69,7 +69,7 @@ public:
         implementation of the corresponding @b BodyWriter.
     */
 #if BOOST_BEAST_DOXYGEN
-    using value_type = implementation_defined;
+    using value_type = __implementation_defined__;
 #else
     using value_type = typename std::conditional<
         std::is_constructible<typename Body::writer,

include/boost/beast/http/span_body.hpp

@@ -64,7 +64,7 @@ public:
         Meets the requirements of @b BodyReader.
     */
 #if BOOST_BEAST_DOXYGEN
-    using reader = implementation_defined;
+    using reader = __implementation_defined__;
 #else
     class reader
     {
@@ -125,7 +125,7 @@ public:
         Meets the requirements of @b BodyWriter.
     */
 #if BOOST_BEAST_DOXYGEN
-    using writer = implementation_defined;
+    using writer = __implementation_defined__;
 #else
     class writer
     {

include/boost/beast/http/string_body.hpp

@@ -72,7 +72,7 @@ public:
         Meets the requirements of @b BodyReader.
     */
 #if BOOST_BEAST_DOXYGEN
-    using reader = implementation_defined;
+    using reader = __implementation_defined__;
 #else
     class reader
     {
@@ -153,7 +153,7 @@ public:
         Meets the requirements of @b BodyWriter.
     */
 #if BOOST_BEAST_DOXYGEN
-    using writer = implementation_defined;
+    using writer = __implementation_defined__;
 #else
     class writer
     {

include/boost/beast/http/vector_body.hpp

@@ -67,7 +67,7 @@ public:
         Meets the requirements of @b BodyReader.
     */
 #if BOOST_BEAST_DOXYGEN
-    using reader = implementation_defined;
+    using reader = __implementation_defined__;
 #else
     class reader
     {
@@ -142,7 +142,7 @@ public:
         Meets the requirements of @b BodyWriter.
     */
 #if BOOST_BEAST_DOXYGEN
-    using writer = implementation_defined;
+    using writer = __implementation_defined__;
 #else
     class writer
     {