[asan docs] explain why asan exits on the first error

git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@167004 91177308-0d34-0410-b5e6-96231b3b80d8

diff --git a/docs/AddressSanitizer.html b/docs/AddressSanitizer.html
index d60cdd9d353c8b3f3dcd6eb6d12d1f08267d9302..4939079917e2dd26f088dcc3581ebd0a143b0175 100644 (file)
--- a/docs/AddressSanitizer.html
+++ b/docs/AddressSanitizer.html
@@ -105,6 +105,13 @@ previously allocated by thread T0 here:
 ==9442== ABORTING
 </pre>
 
+AddressSanitizer exits on the first detected error. This is by design.
+One reason: it makes the generated code smaller and faster (both by ~5%).
+Another reason: this makes fixing bugs unavoidable. With Valgrind, it is often
+the case that users treat Valgrind warnings as false positives
+(which they are not) and don't fix them.
+
+
 <h3 id="has_feature">__has_feature(address_sanitizer)</h3>
 In some cases one may need to execute different code depending on whether
 AddressSanitizer is enabled.