OLD | NEW |
1 C++11 in Skia | 1 C++11 in Skia |
2 ============= | 2 ============= |
3 | 3 |
4 Skia uses C++11. But as a library, we are technically limited by what our | 4 Skia uses C++11. But as a library, we are technically limited by what our |
5 clients support and what our build bots support. | 5 clients support and what our build bots support. |
6 | 6 |
7 Skia may also be limited by restrictions we choose put on ourselves. This | 7 Skia may also be limited by restrictions we choose put on ourselves. This |
8 document is not concerned with C++11 policy in Skia, only its technical | 8 document is not concerned with C++11 policy in Skia, only its technical |
9 feasibility. This is about what we can use, a superset of what we may use. | 9 feasibility. This is about what we can use, a superset of what we may use. |
10 | 10 |
11 The gist: | 11 The gist: |
12 | 12 |
13 - C++11 the language as supported by GCC 4.7 or later is probably usable. | 13 - C++11 the language as supported by GCC 4.7 or later is pretty usable. |
| 14 - The C++11 standard library can generally be used, with some teething. |
14 - If you break a bot, that feature is not usable. | 15 - If you break a bot, that feature is not usable. |
15 - The C++11 standard library can't generally be used. | |
16 - Local statics are not thread safe. | 16 - Local statics are not thread safe. |
17 | 17 |
18 | 18 |
19 Clients | 19 Clients |
20 ------- | 20 ------- |
21 | 21 |
22 The clients we pay most attention to are Chrome, Android, Mozilla, and a few | 22 The clients we pay most attention to are Chrome, Android, Mozilla, and a few |
23 internal Google projects. | 23 internal Google projects. |
24 | 24 |
25 Chrome builds with a recent Clang on Mac and Linux and with a recent MSVC on | 25 Chrome builds with a recent Clang on Mac and Linux and with a recent MSVC on |
26 Windows. These toolchains are new enough to not be the weak link to use any | 26 Windows. These toolchains are new enough to not be the weak link to use any |
27 C++11 language feature. But Chrome still supports Mac OS X 10.6, which does | 27 C++11 language feature. |
28 not ship with a C++11 standard library. So [Chrome has banned the use of the | |
29 C++11 standard library](http://chromium-cpp.appspot.com/). Some header-only | |
30 features are probably technically fine, but the Mac toolchain will prevent us | |
31 from even trying at compile time as long as we target 10.6 as our minimum API | |
32 level. | |
33 | 28 |
34 Chrome intentionally disables thread-safe initialization of static variables, | 29 Chrome intentionally disables thread-safe initialization of static variables, |
35 and MSVC doesn't support it at all, so we cannot rely on that. | 30 so we cannot rely on that. Our bots disable this too, so keep an eye on TSAN. |
36 | 31 |
37 Android builds with either a recent GCC or a recent Clang. They're generally | 32 Android builds with either a somewhat aged GCC or a recent Clang. They're |
38 not a weak link for C++11 language features. Android's C++ standard library | 33 generally not a weak link for C++11 language features. Android's C++ standard |
39 has always been a pain, but since we can't use it anyway (see Chrome), don't | 34 library had historically been a pain, but seems to work fine these days. |
40 worry about it. | |
41 | 35 |
42 Mozilla's current weak link is a minimum requirement of GCC 4.7. Most features | 36 Mozilla's current weak link is a minimum requirement of GCC 4.7. Most features |
43 marked in red on Mozilla's C++11 [feature | 37 marked in red on Mozilla's C++11 [feature |
44 matrix](https://developer.mozilla.org/en-US/docs/Using_CXX_in_Mozilla_code) are | 38 matrix](https://developer.mozilla.org/en-US/docs/Using_CXX_in_Mozilla_code) are |
45 marked that way because they arrived in GCC 4.8. Their minimum-supported Clang | 39 marked that way because they arrived in GCC 4.8. Their minimum-supported Clang |
46 and MSVC toolchains are great. They also appear to ban the C++ standard | 40 and MSVC toolchains are pretty good, but MSVC 2013 will become the weak link soo
n. |
47 library. | |
48 | 41 |
49 Internal Google projects tend to support C++11 completely, including the | 42 Internal Google projects tend to support C++11 completely, including the |
50 full C++11 standard library. | 43 full C++11 standard library. |
51 | 44 |
52 | 45 |
53 Bots | 46 Bots |
54 ---- | 47 ---- |
55 | 48 |
56 Most of our bots are pretty up-to-date: the Windows bots use MSVC 2013, the Mac | 49 Most of our bots are pretty up-to-date: the Windows bots use MSVC 2013, the Mac |
57 bots a recent Clang, and the Linux bots GCC 4.8 or a recent Clang. Our Android | 50 bots a recent Clang, and the Linux bots GCC 4.8 or a recent Clang. Our Android |
58 bots use a recent toolchain from Android (see above), and our Chrome bots use | 51 bots use a recent toolchain from Android (see above), and our Chrome bots use |
59 Chrome's toolchains (see above). I'm not exactly sure what our Chrome OS bots | 52 Chrome's toolchains (see above). I'm not exactly sure what our Chrome OS bots |
60 are using, but they've never been a problem. | 53 are using. They're probably our weak link right now, though problems are rare. |
61 | 54 |
62 I believe our bots' ability to use C++11 matches Mozilla's list nearly identical
ly. | 55 I believe our bots' ability to use C++11 matches Mozilla's list nearly identical
ly. |
OLD | NEW |