xref: /aosp_15_r20/external/pigweed/third_party/abseil-cpp/docs.rst (revision 61c4878ac05f98d0ceed94b57d316916de578985)
1*61c4878aSAndroid Build Coastguard Worker.. _module-pw_third_party_abseil_cpp:
2*61c4878aSAndroid Build Coastguard Worker
3*61c4878aSAndroid Build Coastguard Worker==========
4*61c4878aSAndroid Build Coastguard WorkerAbseil C++
5*61c4878aSAndroid Build Coastguard Worker==========
6*61c4878aSAndroid Build Coastguard WorkerThe ``$dir_pw_third_party/abseil-cpp/`` module provides build files to allow
7*61c4878aSAndroid Build Coastguard Workeroptionally including upstream Abseil C++.
8*61c4878aSAndroid Build Coastguard Worker
9*61c4878aSAndroid Build Coastguard Worker.. _module-pw_third_party_abseil_cpp-using_upstream:
10*61c4878aSAndroid Build Coastguard Worker
11*61c4878aSAndroid Build Coastguard Worker-------------------------
12*61c4878aSAndroid Build Coastguard WorkerUsing upstream Abseil C++
13*61c4878aSAndroid Build Coastguard Worker-------------------------
14*61c4878aSAndroid Build Coastguard WorkerIf you want to use Abseil C++, you must do the following:
15*61c4878aSAndroid Build Coastguard Worker
16*61c4878aSAndroid Build Coastguard WorkerSubmodule
17*61c4878aSAndroid Build Coastguard Worker=========
18*61c4878aSAndroid Build Coastguard WorkerAdd Abseil C++ to your workspace with the following command.
19*61c4878aSAndroid Build Coastguard Worker
20*61c4878aSAndroid Build Coastguard Worker.. code-block:: sh
21*61c4878aSAndroid Build Coastguard Worker
22*61c4878aSAndroid Build Coastguard Worker   git submodule add https://github.com/abseil/abseil-cpp.git \
23*61c4878aSAndroid Build Coastguard Worker     third_party/abseil-cpp/src
24*61c4878aSAndroid Build Coastguard Worker
25*61c4878aSAndroid Build Coastguard WorkerGN
26*61c4878aSAndroid Build Coastguard Worker==
27*61c4878aSAndroid Build Coastguard Worker* Set the GN var ``dir_pw_third_party_abseil-cpp`` to the location of the
28*61c4878aSAndroid Build Coastguard Worker  Abseil C++ source.
29*61c4878aSAndroid Build Coastguard Worker
30*61c4878aSAndroid Build Coastguard Worker  If you used the command above, this will be
31*61c4878aSAndroid Build Coastguard Worker  ``//third_party/abseil-cpp/src``
32*61c4878aSAndroid Build Coastguard Worker
33*61c4878aSAndroid Build Coastguard Worker  This can be set in your args.gn or .gn file like:
34*61c4878aSAndroid Build Coastguard Worker  ``dir_pw_third_party_abseil_cpp = "//third_party/abseil-cpp/src"``
35*61c4878aSAndroid Build Coastguard Worker
36*61c4878aSAndroid Build Coastguard WorkerUpdating
37*61c4878aSAndroid Build Coastguard Worker========
38*61c4878aSAndroid Build Coastguard WorkerCurrently, all dependencies on Abseil-C++ are indirect and via other third-party
39*61c4878aSAndroid Build Coastguard Workermodules:
40*61c4878aSAndroid Build Coastguard Worker
41*61c4878aSAndroid Build Coastguard Worker* FuzzTest
42*61c4878aSAndroid Build Coastguard Worker
43*61c4878aSAndroid Build Coastguard WorkerThe GN build files for Abseil-C++ will be updated when the build files for those
44*61c4878aSAndroid Build Coastguard Workermodules are updated. See those modules for instructions on updating.
45*61c4878aSAndroid Build Coastguard Worker
46*61c4878aSAndroid Build Coastguard Worker.. DO NOT EDIT BELOW THIS LINE. Generated section.
47*61c4878aSAndroid Build Coastguard Worker
48*61c4878aSAndroid Build Coastguard WorkerVersion
49*61c4878aSAndroid Build Coastguard Worker=======
50*61c4878aSAndroid Build Coastguard WorkerThe update script was last run for revision `e9ca8d1c`_.
51*61c4878aSAndroid Build Coastguard Worker
52*61c4878aSAndroid Build Coastguard Worker.. _e9ca8d1c: https://github.com/abseil/abseil-cpp/tree/e9ca8d1ca225ef94fd20890b5440b22f490a410a
53