[PATCH] D51190: [AttrDocs]: document gnu_inline function attribute

Nick Desaulniers via Phabricator via cfe-commits cfe-commits at lists.llvm.org
Mon Aug 27 14:53:39 PDT 2018

nickdesaulniers updated this revision to Diff 162752.
nickdesaulniers added a comment.

- explicitly mention extern inline

  rC Clang



Index: include/clang/Basic/AttrDocs.td
--- include/clang/Basic/AttrDocs.td
+++ include/clang/Basic/AttrDocs.td
@@ -3505,3 +3505,20 @@
 invoking clang with -fno-c++-static-destructors.
+def GnuInlineDocs : Documentation {
+  let Category = DocCatFunction;
+  let Content = [{
+The ``gnu_inline`` attribute specifies that a function marked ``extern inline``
+should follow the c89 convention that if the function cannot be inlined
+(possibly due to being referred to by function pointer), then no out of line
+definition will be emitted (instead of c99's behaviour of always emitting an
+out of line definition).
+If ``__GNUC_STDC_INLINE__`` is defined, then the current translation unit is
+not being compiled with ``gnu_inline`` semantics, and the ``gnu_inline``
+function attribute can be used to get c89 semantics on a per function basis.
+If ``__GNUC_STDC_INLINE__`` is not defined, then the translation unit is
+already being compiled with c89 semantics as the implied default.
+  }];
Index: include/clang/Basic/Attr.td
--- include/clang/Basic/Attr.td
+++ include/clang/Basic/Attr.td
@@ -1170,7 +1170,7 @@
 def GNUInline : InheritableAttr {
   let Spellings = [GCC<"gnu_inline">];
   let Subjects = SubjectList<[Function]>;
-  let Documentation = [Undocumented];
+  let Documentation = [GnuInlineDocs];
 def Hot : InheritableAttr {

-------------- next part --------------
A non-text attachment was scrubbed...
Name: D51190.162752.patch
Type: text/x-patch
Size: 1494 bytes
Desc: not available
URL: <http://lists.llvm.org/pipermail/cfe-commits/attachments/20180827/1144d812/attachment.bin>

More information about the cfe-commits mailing list