From 464ef46ac3cf4a1424c7dfdc12a42f2cb5e8c357 Mon Sep 17 00:00:00 2001
From: Pawel Wodnicki
Date: Thu, 20 Dec 2012 07:36:16 +0000
Subject: Added Documentation and ASan notes, clean-up of emtpy sections,
couple of spelling fixes
git-svn-id: https://llvm.org/svn/llvm-project/cfe/branches/release_32@170678 91177308-0d34-0410-b5e6-96231b3b80d8
---
docs/ReleaseNotes.html | 54 +++++++++++++++++++++++++++++++++-----------------
1 file changed, 36 insertions(+), 18 deletions(-)
diff --git a/docs/ReleaseNotes.html b/docs/ReleaseNotes.html
index 5120b0d5ce..a1ba15ce1c 100644
--- a/docs/ReleaseNotes.html
+++ b/docs/ReleaseNotes.html
@@ -85,7 +85,7 @@ explain them more clearly, and provide more accurate source information about
them. The improvements since the 3.1 release include:
- - -Wuninitialized has been taught to recognise uninitialized uses
+
- -Wuninitialized has been taught to recognize uninitialized uses
which always occur when an explicitly-written non-constant condition is either
true or false. For example:
@@ -164,14 +164,11 @@ int f(vector<map<int, double>>);
- - Clang's -fcatch-undefined-behavior option has been renamed to
- -fsanitize=undefined and has grown the ability to check for several
- new types of undefined behavior. See the Users Manual for more information.
-
-
-
-
-
+
- The Address Sanitizer feature and Clang's -fcatch-undefined-behavior option have been moved to a unified flag set:
+ -fsanitize. This flag can be used to enable the different dynamic checking tools when building. For example,
+ -faddress-sanitizer is now -fsanitize=address, and -fcatch-undefined-behavior is now
+ -fsanitize=undefined. With this release the set of checks available continues to grow, see the Clang
+ documentation and specific sanitizer notes below for details.
@@ -209,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
@@ -259,11 +285,7 @@ attributes in Clang language extensions documentation.
Objective-C Language Changes in Clang
-...
-
-
+Bug-fixes, no functionality changes.
Python Binding Changes
@@ -281,10 +303,6 @@ The following classes and methods have been added:
Cursor.is_static_method
-
-Significant Known Problems
-
-
Additional Information
--
cgit v1.2.3