Skip to content

Commit 04ee1b4

Browse files
derekmaurocopybara-github
authored andcommitted
Update documentation for v1.17.0
PiperOrigin-RevId: 753214894 Change-Id: I5ec24399301dcc7e70b179db98e175f45374e3c2
1 parent 54915d4 commit 04ee1b4

File tree

4 files changed

+21
-32
lines changed

4 files changed

+21
-32
lines changed

README.md

Lines changed: 4 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -2,30 +2,19 @@
22

33
### Announcements
44

5-
#### Live at Head
6-
7-
GoogleTest now follows the
8-
[Abseil Live at Head philosophy](https://abseil.io/about/philosophy#upgrade-support).
9-
We recommend
10-
[updating to the latest commit in the `main` branch as often as possible](https://github.com/abseil/abseil-cpp/blob/master/FAQ.md#what-is-live-at-head-and-how-do-i-do-it).
11-
We do publish occasional semantic versions, tagged with
12-
`v${major}.${minor}.${patch}` (e.g. `v1.16.0`).
13-
145
#### Documentation Updates
156

167
Our documentation is now live on GitHub Pages at
178
https://google.github.io/googletest/. We recommend browsing the documentation on
189
GitHub Pages rather than directly in the repository.
1910

20-
#### Release 1.16.0
11+
#### Release 1.17.0
2112

22-
[Release 1.16.0](https://github.com/google/googletest/releases/tag/v1.16.0) is
13+
[Release 1.17.0](https://github.com/google/googletest/releases/tag/v1.17.0) is
2314
now available.
2415

25-
The 1.16.x branch requires at least C++14.
26-
27-
The 1.16.x branch will be the last to support C++14. Future development will
28-
[require at least C++17](https://opensource.google/documentation/policies/cplusplus-support#c_language_standard).
16+
The 1.17.x branch [requires at least
17+
C++17]((https://opensource.google/documentation/policies/cplusplus-support#c_language_standard).
2918

3019
#### Continuous Integration
3120

docs/quickstart-bazel.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ we recommend this tutorial as a starting point.
99
To complete this tutorial, you'll need:
1010

1111
* A compatible operating system (e.g. Linux, macOS, Windows).
12-
* A compatible C++ compiler that supports at least C++14.
12+
* A compatible C++ compiler that supports at least C++17.
1313
* [Bazel](https://bazel.build/) 7.0 or higher, the preferred build system used
1414
by the GoogleTest team.
1515

@@ -48,7 +48,7 @@ with the following content:
4848
4949
# Choose the most recent version available at
5050
# https://registry.bazel.build/modules/googletest
51-
bazel_dep(name = "googletest", version = "1.15.2")
51+
bazel_dep(name = "googletest", version = "1.17.0")
5252
```
5353

5454
Now you're ready to build C++ code that uses GoogleTest.
@@ -99,16 +99,16 @@ files, see the
9999
[Bazel C++ Tutorial](https://docs.bazel.build/versions/main/tutorial/cpp.html).
100100

101101
{: .callout .note}
102-
NOTE: In the example below, we assume Clang or GCC and set `--cxxopt=-std=c++14`
103-
to ensure that GoogleTest is compiled as C++14 instead of the compiler's default
104-
setting (which could be C++11). For MSVC, the equivalent would be
105-
`--cxxopt=/std:c++14`. See [Supported Platforms](platforms.md) for more details
106-
on supported language versions.
102+
NOTE: In the example below, we assume Clang or GCC and set `--cxxopt=-std=c++17`
103+
to ensure that GoogleTest is compiled as C++17 instead of the compiler's default
104+
setting. For MSVC, the equivalent would be `--cxxopt=/std:c++17`. See
105+
[Supported Platforms](platforms.md) for more details on supported language
106+
versions.
107107

108108
Now you can build and run your test:
109109

110110
<pre>
111-
<strong>$ bazel test --cxxopt=-std=c++14 --test_output=all //:hello_test</strong>
111+
<strong>$ bazel test --cxxopt=-std=c++17 --test_output=all //:hello_test</strong>
112112
INFO: Analyzed target //:hello_test (26 packages loaded, 362 targets configured).
113113
INFO: Found 1 test target...
114114
INFO: From Testing //:hello_test:

docs/quickstart-cmake.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ this tutorial as a starting point. If your project uses Bazel, see the
1010
To complete this tutorial, you'll need:
1111

1212
* A compatible operating system (e.g. Linux, macOS, Windows).
13-
* A compatible C++ compiler that supports at least C++14.
13+
* A compatible C++ compiler that supports at least C++17.
1414
* [CMake](https://cmake.org/) and a compatible build tool for building the
1515
project.
1616
* Compatible build tools include
@@ -52,8 +52,8 @@ To do this, in your project directory (`my_project`), create a file named
5252
cmake_minimum_required(VERSION 3.14)
5353
project(my_project)
5454
55-
# GoogleTest requires at least C++14
56-
set(CMAKE_CXX_STANDARD 14)
55+
# GoogleTest requires at least C++17
56+
set(CMAKE_CXX_STANDARD 17)
5757
set(CMAKE_CXX_STANDARD_REQUIRED ON)
5858
5959
include(FetchContent)

googletest/README.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ When building GoogleTest as a standalone project, the typical workflow starts
2525
with
2626

2727
```
28-
git clone https://github.com/google/googletest.git -b v1.16.0
28+
git clone https://github.com/google/googletest.git -b v1.17.0
2929
cd googletest # Main directory of the cloned repository.
3030
mkdir build # Create a directory to hold the build output.
3131
cd build
@@ -124,9 +124,9 @@ match the project in which it is included.
124124

125125
#### C++ Standard Version
126126

127-
An environment that supports C++14 is required in order to successfully build
127+
An environment that supports C++17 is required in order to successfully build
128128
GoogleTest. One way to ensure this is to specify the standard in the top-level
129-
project, for example by using the `set(CMAKE_CXX_STANDARD 14)` command along
129+
project, for example by using the `set(CMAKE_CXX_STANDARD 17)` command along
130130
with `set(CMAKE_CXX_STANDARD_REQUIRED ON)`. If this is not feasible, for example
131131
in a C project using GoogleTest for validation, then it can be specified by
132132
adding it to the options for cmake via the`-DCMAKE_CXX_FLAGS` option.
@@ -145,9 +145,9 @@ We list the most frequently used macros below. For a complete list, see file
145145
### Multi-threaded Tests
146146

147147
GoogleTest is thread-safe where the pthread library is available. After
148-
`#include <gtest/gtest.h>`, you can check the
149-
`GTEST_IS_THREADSAFE` macro to see whether this is the case (yes if the macro is
150-
`#defined` to 1, no if it's undefined.).
148+
`#include <gtest/gtest.h>`, you can check the `GTEST_IS_THREADSAFE` macro to see
149+
whether this is the case (yes if the macro is `#defined` to 1, no if it's
150+
undefined.).
151151

152152
If GoogleTest doesn't correctly detect whether pthread is available in your
153153
environment, you can force it with

0 commit comments

Comments
 (0)