From cff136cda8df668451c3deefc987c296a25f198e Mon Sep 17 00:00:00 2001
From: Richard Smith <richard-llvm@metafoo.co.uk>
Date: Fri, 25 May 2012 02:35:34 +0000
Subject: [PATCH] Release notes update for -Wsometimes-uninitialized.

llvm-svn: 157459
---
 clang/docs/ReleaseNotes.html | 37 +++++++++++++++++++++++++++++++++++--
 clang/www/content.css        |  2 ++
 2 files changed, 37 insertions(+), 2 deletions(-)

diff --git a/clang/docs/ReleaseNotes.html b/clang/docs/ReleaseNotes.html
index badde05..8f30808 100644
--- a/clang/docs/ReleaseNotes.html
+++ b/clang/docs/ReleaseNotes.html
@@ -83,9 +83,42 @@ Release Notes</a>.</h1>
 <h3 id="majorfeatures">Major New Features</h3>
 <!-- = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = -->
 
-<h4 id="majorfeature1">Feature 1</h4>
+<h4 id="diagnostics">Improvements to Clang's diagnostics</h4>
+
+<p>Clang's diagnostics are constantly being improved to catch more issues,
+explain them more clearly, and provide more accurate source information about
+them. The improvements since the 3.1 release include:</p>
+
+<ul>
+  <li><tt>-Wuninitialized</tt> has been taught to recognise uninitialized uses
+  which always occur when an explicitly-written non-constant condition is either
+  <tt>true</tt> or <tt>false</tt>. For example:
+
+<pre>
+int f(bool b) {
+  int n;
+  if (b)
+    n = 1;
+  return n;
+}
+
+<b>sometimes-uninit.cpp:5:10: <span class="warning">warning:</span> variable 'n' is sometimes uninitialized when used here [-Wsometimes-uninitialized]</b>
+  return n;
+         <span class="caret">^</span>
+<b>sometimes-uninit.cpp:3:7: <span class="note">note:</span></b> uninitialized use occurs whenever 'if' condition is false
+  if (b)
+      <span class="caret">^</span>
+<b>sometimes-uninit.cpp:2:8: <span class="note">note:</span></b> initialize the variable 'n' to silence this warning
+  int n;
+       <span class="caret">^</span>
+       <span class="caret"> = 0</span>
+</pre>
+
+  This functionality can be enabled or disabled separately from
+  <tt>-Wuninitialized</tt> with the <tt>-Wsometimes-uninitialized</tt> warning
+  flag.</li>
+</ul>
 
-<p>...</p>
 
 <!-- = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = -->
 <h3 id="cchanges">C Language Changes in Clang</h3>
diff --git a/clang/www/content.css b/clang/www/content.css
index 574b98e..b592556 100644
--- a/clang/www/content.css
+++ b/clang/www/content.css
@@ -24,6 +24,8 @@ IMG.img_slide {
 .itemTitle { color:#2d58b7 }
 
 span.error { color:red }
+span.warning { color:purple }
+span.note { color:gray }
 span.caret { color:green; font-weight:bold }
 
 /* Tables */
-- 
2.7.4