From 757d39a79bcb3194a42ad9279dba5f56e84dda66 Mon Sep 17 00:00:00 2001 From: Abseil Team Date: Mon, 28 Oct 2019 12:31:27 -0400 Subject: Googletest export Make it clearer that users should _not_ write their own main functions. PiperOrigin-RevId: 277079721 --- googletest/docs/primer.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) (limited to 'googletest/docs') diff --git a/googletest/docs/primer.md b/googletest/docs/primer.md index 0317692b..51394024 100644 --- a/googletest/docs/primer.md +++ b/googletest/docs/primer.md @@ -478,7 +478,13 @@ If a fatal failure happens the subsequent steps will be skipped. ## Writing the main() Function -Write your own main() function, which should return the value of +Most users should _not_ need to write their own `main` function and instead link +with `gtest_main` (as opposed to with `gtest`), which defines a suitable entry +point. See the end of this section for details. The remainder of this section +should only apply when you need to do something custom before the tests run that +cannot be expressed within the framework of fixtures and test suites. + +If you write your own `main` function, it should return the value of `RUN_ALL_TESTS()`. You can start from this boilerplate: -- cgit v1.2.3