summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
author Dan Albert <danalbert@google.com> 2016-04-12 17:41:34 +0000
committer Android (Google) Code Review <android-gerrit@google.com> 2016-04-12 17:41:35 +0000
commit021c306ed8e9eb04a75b2160978fb510be3c301c (patch)
tree29b3d1d8e6c85fee891e47229c71367b105111db
parent01d3063f885f3937038cc4308f4f9ab429b9e77a (diff)
parentaa9b3e687949b83b4248562eacff9a42511bd85c (diff)
Merge "Word the section about libc++ more strongly." into mnc-mr-docs
-rw-r--r--docs/html/ndk/guides/cpp-support.jd18
1 files changed, 14 insertions, 4 deletions
diff --git a/docs/html/ndk/guides/cpp-support.jd b/docs/html/ndk/guides/cpp-support.jd
index 0491367f38f4..f9d51719a99f 100644
--- a/docs/html/ndk/guides/cpp-support.jd
+++ b/docs/html/ndk/guides/cpp-support.jd
@@ -204,10 +204,20 @@ LOCAL_LDLIBS += -latomic
<h4>Compatibility</h4>
-<p>Around 99% of tests pass when compiling {@code libc++} with Clang 3.4 for all supported ABIs.
-The failures are mostly in the areas of {@code wchar_t} and locales that Android bionic
-doesn't support. Switching locale from the default produces the following warning in
-{@code logcat}:</p>
+<p>The NDK's libc++ is not stable. Not all the tests pass, and the test suite is not comprehensive.
+Some known issues are:</p>
+
+<ul>
+ <li>Using {@code c++_shared} on ARM can crash when an exception is thrown.</li>
+ <li>Support for {@code wchar_t} and the locale APIs is limited.</li>
+</ul>
+
+<p>You should also make sure to check the "Known Issues" section of the changelog for the NDK
+release you are using.</p>
+
+<p class="note"><strong>Warning: </strong>Attempting to change to an unsupported locale will
+<strong>not</strong> fail. The operation will succeed, but the locale will not change and the
+following message will appear in {@code logcat}.</p>
<pre>
newlocale() WARNING: Trying to set locale to en_US.UTF-8 other than "", "C" or "POSIX"