From aa9b3e687949b83b4248562eacff9a42511bd85c Mon Sep 17 00:00:00 2001 From: Dan Albert Date: Thu, 7 Apr 2016 17:24:43 -0700 Subject: [PATCH] Word the section about libc++ more strongly. The libc++ support is still pretty awful. We need to make it clear that this is something people should only be using if they are confident in their testing. The test details are out of date (and I don't believe they were ever correct), and always will be since this is under active development. Drop the specifics and just list some big KIs. Also mention that users should check the changelog for other KIs. Bug: http://b/21711315 Change-Id: I42f0c8ab963d7f77462b89335cf0d66cf6035388 --- docs/html/ndk/guides/cpp-support.jd | 18 ++++++++++++++---- 1 file changed, 14 insertions(+), 4 deletions(-) diff --git a/docs/html/ndk/guides/cpp-support.jd b/docs/html/ndk/guides/cpp-support.jd index 0491367f38f4a..f9d51719a99fb 100644 --- a/docs/html/ndk/guides/cpp-support.jd +++ b/docs/html/ndk/guides/cpp-support.jd @@ -204,10 +204,20 @@ LOCAL_LDLIBS += -latomic

Compatibility

-

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}:

+

The NDK's libc++ is not stable. Not all the tests pass, and the test suite is not comprehensive. +Some known issues are:

+ + + +

You should also make sure to check the "Known Issues" section of the changelog for the NDK +release you are using.

+ +

Warning: Attempting to change to an unsupported locale will +not fail. The operation will succeed, but the locale will not change and the +following message will appear in {@code logcat}.

 newlocale() WARNING: Trying to set locale to en_US.UTF-8 other than "", "C" or "POSIX"