From: Dmitry Polukhin Date: Wed, 9 Mar 2016 19:39:16 +0000 (+0000) Subject: NFC fix documentation build by rL263015 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=2a54cbaf170652dfda762cdbd0ddb004dd1c1d55;p=clang NFC fix documentation build by rL263015 This time I hope it will fix the build for real. git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@263052 91177308-0d34-0410-b5e6-96231b3b80d8 --- diff --git a/docs/ItaniumMangleAbiTags.rst b/docs/ItaniumMangleAbiTags.rst index 6d50acad4b..2d65031b70 100644 --- a/docs/ItaniumMangleAbiTags.rst +++ b/docs/ItaniumMangleAbiTags.rst @@ -33,15 +33,18 @@ the same the is. They are mangled as: +.. code-block:: none + ::= * # sort by name ::= B Example: +.. code-block:: c++ + __attribute__((abi_tag("test"))) void Func(); - - gets mangled as: _Z4FuncB4testv (prettified as `Func[abi:test]()`) + // gets mangled as: _Z4FuncB4testv (prettified as `Func[abi:test]()`) Active tags =========== @@ -52,6 +55,8 @@ enum), the explicit tags are the active tags. For variables and functions, the active tags are the explicit tags plus any "required tags" which are not in the "available tags" set: +.. code-block:: none + derived-tags := (required-tags - available-tags) active-tags := explicit-tags + derived-tags @@ -68,15 +73,16 @@ Otherwise the function requires any implicit or explicit tag used in the name for the return type. Example: + +.. code-block:: c++ + namespace A { inline namespace B __attribute__((abi_tag)) { struct C { int x; }; } } - A::C foo(); - - gets mangled as: _Z3fooB1Bv (prettified as `foo[abi:B]()`) + A::C foo(); // gets mangled as: _Z3fooB1Bv (prettified as `foo[abi:B]()`) Required tags for a variable ============================ @@ -99,4 +105,3 @@ in the type of a cast operator) are NOT available. Example: a cast operator to std::string (which is std::__cxx11::basic_string<...>) will use 'cxx11' as an active tag, as it is required from the return type `std::string` but not available. - diff --git a/docs/index.rst b/docs/index.rst index 81a15b8e18..6028fb8ec2 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -76,6 +76,7 @@ Design Documents DriverInternals PTHInternals PCHInternals + ItaniumMangleAbiTags Indices and tables