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