From 5b20025c30d23d521e12c1f33ec8fa6b821952cd Mon Sep 17 00:00:00 2001 From: dim Date: Sat, 22 Dec 2012 15:00:54 +0000 Subject: Vendor import of clang tags/RELEASE_32/final r170710 (effectively, 3.2 release): http://llvm.org/svn/llvm-project/cfe/tags/RELEASE_32/final@170710 --- docs/ReleaseNotes.html | 106 +++++++++++++++++++++++++++---------------------- 1 file changed, 59 insertions(+), 47 deletions(-) (limited to 'docs') diff --git a/docs/ReleaseNotes.html b/docs/ReleaseNotes.html index 8a195f0..a1ba15c 100644 --- a/docs/ReleaseNotes.html +++ b/docs/ReleaseNotes.html @@ -43,12 +43,6 @@ td {

Written by the LLVM Team

-

These are in-progress notes for the upcoming Clang 3.2 -release.
-You may prefer the -Clang 3.1 -Release Notes.

-

Introduction

@@ -91,7 +85,7 @@ explain them more clearly, and provide more accurate source information about them. The improvements since the 3.1 release include:

@@ -215,6 +206,35 @@ function call.

pointer_with_type_tag and type_tag_for_datatype attributes in Clang language extensions documentation.

+

Documentation comment support

+

Clang now supports documentation comments written in a Doxygen-like syntax. +Clang parses the comments and can detect syntactic and semantic errors in +comments. These warnings are off by default. Pass -Wdocumentation +flag to enable warnings about documentation comments.

+ +

For example, given:

+ +
/// \param [in] Str the string.
+/// \returns a modified string.
+void do_something(const std::string &str);
+ +

clang -Wdocumentation will emit two warnings:

+ +
doc-test.cc:3:6: warning: '\returns' command used in a comment that is attached to a function returning void [-Wdocumentation]
+/// \returns a modified string.
+    ~^~~~~~~~~~~~~~~~~~~~~~~~~~
+doc-test.cc:2:17: warning: parameter 'Str' not found in the function declaration [-Wdocumentation]
+/// \param [in] Str the string.
+                ^~~
+doc-test.cc:2:17: note: did you mean 'str'?
+/// \param [in] Str the string.
+                ^~~
+                str
+ +

libclang includes a new API, clang_FullComment_getAsXML, to convert +comments to XML documents. This API can be used to build documentation +extraction tools.

+

New Compiler Flags

@@ -239,7 +259,8 @@ attributes in Clang language extensions documentation.

C11 Feature Support

-

...

+

Clang 3.2 adds support for the C11 _Alignof keyword, pedantic warning through option + -Wempty-translation-unit (C11 6.9p1)

C++ Language Changes in Clang

@@ -247,40 +268,42 @@ attributes in Clang language extensions documentation.

C++11 Feature Support

-

...

- - -

Objective-C Language Changes in Clang

- +

Clang 3.2 supports most of the language features + added in the latest ISO C++ standard,C++ 2011. + Use -std=c++11 or -std=gnu++11 to enable support for these features. In addition to the features supported by Clang 3.1, the + following features have been added:

-

...

+ -

Internal API Changes

+

Objective-C Language Changes in Clang

-

These are major API changes that have happened since the 3.1 release of - Clang. If upgrading an external codebase that uses Clang as a library, this - section should help get you past the largest hurdles of upgrading.

- -

API change 1

- -

...

+

Bug-fixes, no functionality changes.

Python Binding Changes

-The following methods have been added: +The following classes and methods have been added: -

Significant Known Problems

- - -

Additional Information

@@ -296,17 +319,6 @@ The following methods have been added: the mailing list.

- - - - -- cgit v1.1