Added macro to docs

This commit is contained in:
Nikita Kniazev 2019-02-24 03:42:11 +03:00
parent df4e29cf1e
commit 11d03f3b51
2 changed files with 31 additions and 8 deletions

View File

@ -212,6 +212,8 @@
<description> <description>
<simpara>Returns <code>true</code> when <code>*this</code> <simpara>Returns <code>true</code> when <code>*this</code>
contains a value.</simpara> contains a value.</simpara>
<simpara>Note: When <macroname>BOOST_VARIANT_NO_RECURSIVE_WRAPPER_POINTER_STEALING</macroname>
compatibility macro is defined &ndash; always returns <code>false</code>.</simpara>
</description> </description>
<throws>Will not throw.</throws> <throws>Will not throw.</throws>
@ -309,4 +311,21 @@
</class> </class>
</namespace> </namespace>
<macro name="BOOST_VARIANT_NO_RECURSIVE_WRAPPER_POINTER_STEALING">
<purpose>
<simpara>A backward-compatibility/migration macro for reverting to the
previous never-empty <code><classname>recursive_wrapper</classname></code>.</simpara>
</purpose>
<description>
<para>
Defining the macro disables <code><classname>recursive_wrapper</classname></code> pointer
stealing from an other <code><classname>recursive_wrapper</classname></code> on move
construction.
</para>
<para>
Not defined by default. Appeared in Boost 1.70.
</para>
</description>
</macro>
</header> </header>

View File

@ -508,14 +508,18 @@
<method name="empty" cv="const"> <method name="empty" cv="const">
<type>bool</type> <type>bool</type>
<returns><itemizedlist> <returns>
<listitem><code>false</code>: when is not a recursive <code>variant <itemizedlist>
</code> &ndash; it always contains exactly one of its bounded types. <listitem><code>false</code>: when is not a recursive <code>variant
(See <xref linkend="variant.design.never-empty"/> for more </code> &ndash; it always contains exactly one of its bounded types.
information.)</listitem> (See <xref linkend="variant.design.never-empty"/> for more
<listitem><code>true</code>: when a recursive <code>variant</code> information.)</listitem>
value was moved out.</listitem> <listitem><code>true</code>: when a recursive <code>variant</code>
</itemizedlist></returns> value was moved out.</listitem>
</itemizedlist>
<simpara>Note: When <macroname>BOOST_VARIANT_NO_RECURSIVE_WRAPPER_POINTER_STEALING</macroname>
compatibility macro is defined &ndash; always returns <code>false</code>.</simpara>
</returns>
<rationale> <rationale>
<simpara>Facilitates generic compatibility with <simpara>Facilitates generic compatibility with