Move instructions into custom/README files

googlemock/include/gmock/internal/custom/README.md

@@ -0,0 +1,16 @@
+# Customization Points
+
+The custom directory is an injection point for custom user configurations.
+
+## Header gmock-port.h
+
+The following macros can be defined:
+
+### Flag related macros:
+
+*   GMOCK_DECLARE_bool_(name)
+*   GMOCK_DECLARE_int32_(name)
+*   GMOCK_DECLARE_string_(name)
+*   GMOCK_DEFINE_bool_(name, default_val, doc)
+*   GMOCK_DEFINE_int32_(name, default_val, doc)
+*   GMOCK_DEFINE_string_(name, default_val, doc)

googlemock/include/gmock/internal/custom/gmock-matchers.h

@@ -27,9 +27,7 @@
 // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 //
-// ============================================================
-// An installation-specific extension point for gmock-matchers.h.
-// ============================================================
+// Injection point for custom user configurations. See README for details
 //
 // GOOGLETEST_CM0002 DO NOT DELETE
 

googlemock/include/gmock/internal/custom/gmock-port.h

@@ -27,16 +27,7 @@
 // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 //
-// Injection point for custom user configurations.
-// The following macros can be defined:
-//
-//   Flag related macros:
-//     GMOCK_DECLARE_bool_(name)
-//     GMOCK_DECLARE_int32_(name)
-//     GMOCK_DECLARE_string_(name)
-//     GMOCK_DEFINE_bool_(name, default_val, doc)
-//     GMOCK_DEFINE_int32_(name, default_val, doc)
-//     GMOCK_DEFINE_string_(name, default_val, doc)
+// Injection point for custom user configurations. See README for details
 //
 // ** Custom implementation starts here **
 

googletest/include/gtest/internal/custom/README.md

@@ -0,0 +1,56 @@
+# Customization Points
+
+The custom directory is an injection point for custom user configurations.
+
+## Header gtest.h
+
+### The following macros can be defined:
+
+*   GTEST_OS_STACK_TRACE_GETTER_ - The name of an implementation of
+    OsStackTraceGetterInterface.
+*   GTEST_CUSTOM_TEMPDIR_FUNCTION_ - An override for testing::TempDir(). See
+    testing::TempDir for semantics and signature.
+
+## Header gtest-port.h
+
+The following macros can be defined:
+
+### Flag related macros:
+
+*   GTEST_FLAG(flag_name)
+*   GTEST_USE_OWN_FLAGFILE_FLAG_ - Define to 0 when the system provides its own
+    flagfile flag parsing.
+*   GTEST_DECLARE_bool_(name)
+*   GTEST_DECLARE_int32_(name)
+*   GTEST_DECLARE_string_(name) *
+*   GTEST_DEFINE_bool_(name, default_val, doc)
+*   GTEST_DEFINE_int32_(name, default_val, doc)
+*   GTEST_DEFINE_string_(name, default_val, doc)
+
+### Logging:
+
+*   GTEST_LOG_(severity)
+*   GTEST_CHECK_(condition)
+*   Functions LogToStderr() and FlushInfoLog() have to be provided too.
+
+### Threading:
+
+*   GTEST_HAS_NOTIFICATION_ - Enabled if Notification is already provided.
+*   GTEST_HAS_MUTEX_AND_THREAD_LOCAL_ - Enabled if Mutex and ThreadLocal are
+    already provided. Must also provide GTEST_DECLARE_STATIC_MUTEX_(mutex) and
+    GTEST_DEFINE_STATIC_MUTEX_(mutex)
+*   GTEST_EXCLUSIVE_LOCK_REQUIRED_(locks)
+*   GTEST_LOCK_EXCLUDED_(locks)
+
+### Underlying library support features
+
+*   GTEST_HAS_CXXABI_H_
+
+### Exporting API symbols:
+
+*   GTEST_API_ - Specifier for exported symbols.
+
+## Header gtest-printers.h
+
+*   See documentation at gtest/gtest-printers.h for details on how to define a
+    custom printer.

googletest/include/gtest/internal/custom/gtest-port.h

@@ -27,40 +27,7 @@
 // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 //
-// Injection point for custom user configurations.
-// The following macros can be defined:
-//
-//   Flag related macros:
-//     GTEST_FLAG(flag_name)
-//     GTEST_USE_OWN_FLAGFILE_FLAG_  - Define to 0 when the system provides its
-//                                     own flagfile flag parsing.
-//     GTEST_DECLARE_bool_(name)
-//     GTEST_DECLARE_int32_(name)
-//     GTEST_DECLARE_string_(name)
-//     GTEST_DEFINE_bool_(name, default_val, doc)
-//     GTEST_DEFINE_int32_(name, default_val, doc)
-//     GTEST_DEFINE_string_(name, default_val, doc)
-//
-//   Logging:
-//     GTEST_LOG_(severity)
-//     GTEST_CHECK_(condition)
-//     Functions LogToStderr() and FlushInfoLog() have to be provided too.
-//
-//   Threading:
-//     GTEST_HAS_NOTIFICATION_ - Enabled if Notification is already provided.
-//     GTEST_HAS_MUTEX_AND_THREAD_LOCAL_ - Enabled if Mutex and ThreadLocal are
-//                                         already provided.
-//     Must also provide GTEST_DECLARE_STATIC_MUTEX_(mutex) and
-//     GTEST_DEFINE_STATIC_MUTEX_(mutex)
-//
-//     GTEST_EXCLUSIVE_LOCK_REQUIRED_(locks)
-//     GTEST_LOCK_EXCLUDED_(locks)
-//
-//   Underlying library support features:
-//     GTEST_HAS_CXXABI_H_
-//
-//   Exporting API symbols:
-//     GTEST_API_ - Specifier for exported symbols.
+// Injection point for custom user configurations. See README for details
 //
 // ** Custom implementation starts here **
 

googletest/include/gtest/internal/custom/gtest-printers.h

@@ -31,8 +31,8 @@
 // installation of gTest.
 // It will be included from gtest-printers.h and the overrides in this file
 // will be visible to everyone.
-// See documentation at gtest/gtest-printers.h for details on how to define a
-// custom printer.
+//
+// Injection point for custom user configurations. See README for details
 //
 // ** Custom implementation starts here **
 

googletest/include/gtest/internal/custom/gtest.h

@@ -27,15 +27,7 @@
 // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 //
-// Injection point for custom user configurations.
-// The following macros can be defined:
-//
-// GTEST_OS_STACK_TRACE_GETTER_  - The name of an implementation of
-//                                 OsStackTraceGetterInterface.
-//
-// GTEST_CUSTOM_TEMPDIR_FUNCTION_ - An override for testing::TempDir().
-//                                  See testing::TempDir for semantics and
-//                                  signature.
+// Injection point for custom user configurations. See README for details
 //
 // ** Custom implementation starts here **