xref: /aosp_15_r20/external/cronet/third_party/abseil-cpp/README.chromium (revision 6777b5387eb2ff775bb5750e3f5d96f37fb7352b)
1Name: Abseil
2Short Name: absl
3URL: https://github.com/abseil/abseil-cpp
4License: Apache 2.0
5License File: LICENSE
6Version: N/A
7Revision: 8f9e5f0203c8a708c71f4498bf59355d1d7bbf87
8Security Critical: yes
9Shipped: yes
10
11Description:
12This directory contains the source code of Abseil for C++. This can be used by
13Chromium, subject to the guidance at
14https://chromium.googlesource.com/chromium/src/+/main/styleguide/c++/c++-features.md;
15it can be used without restriction by Chromium's dependencies, except that
16objects compiled into Chromium itself cannot use anything relying on
17absl::base_internal::FastTypeId (see https://crbug.com/1096380).
18
19How to update Abseil:
20
211. 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
232. Update BUILD.gn files to match changes in BUILD.bazel
24
25If there is a new test, add dependcy on it from absl_tests in the
26third_party/abseil-cpp/BUILD.gn target
27
283. From your source root run third_party/abseil-cpp/generate_def_files.py to
29   regenerate Windows symbol definition files.
30
314. If abseil adds new features, update styleguide/c++/c++-features.md and add headers for that feature into exclude list in root DEPS
32
33Local Modifications:
34
35* absl/copts.bzl has been translated to //third_party/absl-cpp/BUILD.gn. Both
36  files contain lists of compiler flags in order to reduce duplication.
37
38* All the BUILD.bazel files have been translated to BUILD.gn files.
39
40* Patches from //third_party/abseil-cpp/patches have been applied.
41
42* Increment this number to silence presubmits about modifying files in
43  third_party when regenerating absl .def files: 2
44