xref: /aosp_15_r20/external/angle/third_party/abseil-cpp/README.chromium (revision 8975f5c5ed3d1c378011245431ada316dfb6f244)
1*8975f5c5SAndroid Build Coastguard WorkerName: Abseil
2*8975f5c5SAndroid Build Coastguard WorkerShort Name: absl
3*8975f5c5SAndroid Build Coastguard WorkerURL: https://github.com/abseil/abseil-cpp
4*8975f5c5SAndroid Build Coastguard WorkerLicense: Apache-2.0
5*8975f5c5SAndroid Build Coastguard WorkerLicense File: LICENSE
6*8975f5c5SAndroid Build Coastguard WorkerVersion: N/A
7*8975f5c5SAndroid Build Coastguard WorkerRevision: b67caffec13292a0abdb024c4a0ae14323ed4b5a
8*8975f5c5SAndroid Build Coastguard WorkerSecurity Critical: yes
9*8975f5c5SAndroid Build Coastguard WorkerShipped: yes
10*8975f5c5SAndroid Build Coastguard Worker
11*8975f5c5SAndroid Build Coastguard WorkerDescription:
12*8975f5c5SAndroid Build Coastguard WorkerThis directory contains the source code of Abseil for C++. This can be used by
13*8975f5c5SAndroid Build Coastguard WorkerChromium, subject to the guidance at
14*8975f5c5SAndroid Build Coastguard Workerhttps://chromium.googlesource.com/chromium/src/+/main/styleguide/c++/c++-features.md;
15*8975f5c5SAndroid Build Coastguard Workerit can be used without restriction by Chromium's dependencies, except that
16*8975f5c5SAndroid Build Coastguard Workerobjects compiled into Chromium itself cannot use anything relying on
17*8975f5c5SAndroid Build Coastguard Workerabsl::base_internal::FastTypeId (see https://crbug.com/1096380).
18*8975f5c5SAndroid Build Coastguard Worker
19*8975f5c5SAndroid Build Coastguard WorkerHow to update Abseil:
20*8975f5c5SAndroid Build Coastguard Worker
21*8975f5c5SAndroid Build Coastguard Worker1. From your source root run third_party/abseil-cpp/roll_abseil.py to download the code from the Abseil git repository and apply chromium specific patches.
22*8975f5c5SAndroid Build Coastguard Worker
23*8975f5c5SAndroid Build Coastguard Worker2. Update BUILD.gn files to match changes in BUILD.bazel
24*8975f5c5SAndroid Build Coastguard Worker
25*8975f5c5SAndroid Build Coastguard WorkerIf there is a new test, add dependcy on it from absl_tests in the
26*8975f5c5SAndroid Build Coastguard Workerthird_party/abseil-cpp/BUILD.gn target
27*8975f5c5SAndroid Build Coastguard Worker
28*8975f5c5SAndroid Build Coastguard Worker3. From your source root run third_party/abseil-cpp/generate_def_files.py to
29*8975f5c5SAndroid Build Coastguard Worker   regenerate Windows symbol definition files.
30*8975f5c5SAndroid Build Coastguard Worker
31*8975f5c5SAndroid Build Coastguard Worker4. If abseil adds new features, update styleguide/c++/c++-features.md and add headers for that feature into exclude list in root DEPS
32*8975f5c5SAndroid Build Coastguard Worker
33*8975f5c5SAndroid Build Coastguard WorkerLocal Modifications:
34*8975f5c5SAndroid Build Coastguard Worker
35*8975f5c5SAndroid Build Coastguard Worker* absl/copts.bzl has been translated to //third_party/absl-cpp/BUILD.gn. Both
36*8975f5c5SAndroid Build Coastguard Worker  files contain lists of compiler flags in order to reduce duplication.
37*8975f5c5SAndroid Build Coastguard Worker
38*8975f5c5SAndroid Build Coastguard Worker* All the BUILD.bazel files have been translated to BUILD.gn files.
39*8975f5c5SAndroid Build Coastguard Worker
40*8975f5c5SAndroid Build Coastguard Worker* Patches from //third_party/abseil-cpp/patches have been applied.
41*8975f5c5SAndroid Build Coastguard Worker
42*8975f5c5SAndroid Build Coastguard Worker* Increment this number to silence presubmits about modifying files in
43*8975f5c5SAndroid Build Coastguard Worker  third_party when regenerating absl .def files: 2
44