[prev in list] [next in list] [prev in thread] [next in thread] 

List:       cfe-commits
Subject:    Re: [PATCH] Adding doxygen comments to the LLVM intrinsics (part 1, ammintrin.h)
From:       Dmitri Gribenko <gribozavr () gmail ! com>
Date:       2015-05-31 5:42:58
Message-ID: 4eb83d6fc6acd77ecdf8cc15f3df95a9 () localhost ! localdomain
[Download RAW message or body]

> Macros are not getting rendered in XCode at all. To say more, unrelated to the intrinsics headers, I wasn't even able to display documentation for the simplest macro that adds two numbers together. Do you know if we could work around it?


This is a known limitation of Clang.  It does not attach comments to macros.

Changing macro "intrinsics" into functions would be best.


================
Comment at: lib/Headers/ammintrin.h:193-195
@@ +192,5 @@
+///
+/// \code 
+/// This intrinsic corresponds to the \c MOVNTSS instruction.
+/// \endcode 
+///
----------------
Why is this paragraph surrounded by \code?  It is text, not program code.

http://reviews.llvm.org/D8762

EMAIL PREFERENCES
  http://reviews.llvm.org/settings/panel/emailpreferences/



_______________________________________________
cfe-commits mailing list
cfe-commits@cs.uiuc.edu
http://lists.cs.uiuc.edu/mailman/listinfo/cfe-commits
[prev in list] [next in list] [prev in thread] [next in thread]