Some googletest veteran should update outdated comments in sample code.

[chjfth]

I'm learning googletest these days, so having chance to read quite some sample code in it. I find quite some cases of outdated code comments, which no longer match current code behavior for quite many years.

For example, sample3_unittest.cc says:

googletest/googletest/samples/sample3_unittest.cc

Line 53 in 2d4f208

// The macros for indicating the success/failure of a test

// The macros for indicating the success/failure of a test
// (EXPECT_TRUE, FAIL, etc) need to know what the current test is
// (when Google Test prints the test result, it tells you which test
// each failure belongs to).  Technically, these macros invoke a
// member function of the Test class.  Therefore, you cannot use them
// in a global function.  That's why you should put test sub-routines
// in a test fixture.
//

This paragraph has been there intact since 2008-07-04(the earliest date in the git repo), and the statement "you cannot use them
(EXPECT_TRUE, FAIL, etc) in a global function" is wrong according to my experiment today. Yes, no such limitation exists. They may existed once in a very ancient version.

I think these misleading comment words should be fixed early.