Merge pull request #2357 from kuzkry:obsolete-documentation

PiperOrigin-RevId: 261343928

googlemock/include/gmock/gmock-generated-actions.h

@@ -259,11 +259,10 @@ class ActionHelper {
 //
 // CAVEAT:
 //
-// ACTION*() can only be used in a namespace scope.  The reason is
+// ACTION*() can only be used in a namespace scope as templates cannot be
-// that C++ doesn't yet allow function-local types to be used to
+// declared inside of a local class.
-// instantiate templates.  The up-coming C++0x standard will fix this.
+// Users can, however, define any local functors (e.g. a lambda) that
-// Once that's done, we'll consider supporting using ACTION*() inside
+// can be used as actions.
-// a function.
 //
 // MORE INFORMATION:
 //

googlemock/include/gmock/gmock-generated-actions.h.pump

@@ -182,11 +182,10 @@ $template
 //
 // CAVEAT:
 //
-// ACTION*() can only be used in a namespace scope.  The reason is
+// ACTION*() can only be used in a namespace scope as templates cannot be
-// that C++ doesn't yet allow function-local types to be used to
+// declared inside of a local class.
-// instantiate templates.  The up-coming C++0x standard will fix this.
+// Users can, however, define any local functors (e.g. a lambda) that
-// Once that's done, we'll consider supporting using ACTION*() inside
+// can be used as actions.
-// a function.
 //
 // MORE INFORMATION:
 //

googlemock/include/gmock/gmock-generated-matchers.h

@@ -250,11 +250,8 @@
 // overloading matchers based on parameter types (as opposed to just
 // based on the number of parameters).
 //
-// MATCHER*() can only be used in a namespace scope.  The reason is
+// MATCHER*() can only be used in a namespace scope as templates cannot be
-// that C++ doesn't yet allow function-local types to be used to
+// declared inside of a local class.
-// instantiate templates.  The up-coming C++0x standard will fix this.
-// Once that's done, we'll consider supporting using MATCHER*() inside
-// a function.
 //
 // More Information
 // ================

googlemock/include/gmock/gmock-generated-matchers.h.pump

@@ -252,11 +252,8 @@ $$ }} This line fixes auto-indentation of the following code in Emacs.
 // overloading matchers based on parameter types (as opposed to just
 // based on the number of parameters).
 //
-// MATCHER*() can only be used in a namespace scope.  The reason is
+// MATCHER*() can only be used in a namespace scope as templates cannot be
-// that C++ doesn't yet allow function-local types to be used to
+// declared inside of a local class.
-// instantiate templates.  The up-coming C++0x standard will fix this.
-// Once that's done, we'll consider supporting using MATCHER*() inside
-// a function.
 //
 // More Information
 // ================

googlemock/scripts/upload.py

@@ -631,7 +631,7 @@ class VersionControlSystem(object):
         new_content: For text files, this is empty.  For binary files, this is
           the contents of the new file, since the diff output won't contain
           information to reconstruct the current file.
-        is_binary: True if the file is binary.
+        is_binary: True iff the file is binary.
         status: The status of the file.
     """
 

googletest/scripts/gen_gtest_pred_impl.py

@@ -540,10 +540,10 @@ class Predicate%(n)sTest : public testing::Test {
     }
   }
 
-  // true if the test function is expected to run to finish.
+  // true iff the test function is expected to run to finish.
   static bool expected_to_finish_;
 
-  // true if the test function did run to finish.
+  // true iff the test function did run to finish.
   static bool finished_;
 """ % DEFS
 
@@ -572,12 +572,12 @@ typedef Predicate%(n)sTest ASSERT_PRED%(n)sTest;
     """Returns the test for a predicate assertion macro.
 
     Args:
-      use_format:     true if the assertion is a *_PRED_FORMAT*.
+      use_format:     true iff the assertion is a *_PRED_FORMAT*.
-      use_assert:     true if the assertion is a ASSERT_*.
+      use_assert:     true iff the assertion is a ASSERT_*.
-      expect_failure: true if the assertion is expected to fail.
+      expect_failure: true iff the assertion is expected to fail.
-      use_functor:    true if the first argument of the assertion is
+      use_functor:    true iff the first argument of the assertion is
                       a functor (as opposed to a function)
-      use_user_type:  true if the predicate functor/function takes
+      use_user_type:  true iff the predicate functor/function takes
                       argument(s) of a user-defined type.
 
     Example:

googletest/scripts/pump.py

@@ -161,7 +161,7 @@ class Token:
 
 
 def StartsWith(lines, pos, string):
-  """Returns True if the given position in lines starts with 'string'."""
+  """Returns True iff the given position in lines starts with 'string'."""
 
   return lines[pos.line][pos.column:].startswith(string)
 

googletest/scripts/upload.py

@@ -631,7 +631,7 @@ class VersionControlSystem(object):
         new_content: For text files, this is empty.  For binary files, this is
           the contents of the new file, since the diff output won't contain
           information to reconstruct the current file.
-        is_binary: True if the file is binary.
+        is_binary: True iff the file is binary.
         status: The status of the file.
     """