Moved test rationale to test code file

[SVN r11878]

test/preprocessor_test.cpp

@@ -1,5 +1,5 @@
 // Copyright (C) 2001
-//  Housemarque, Inc.
+// Housemarque Oy
 // http://www.housemarque.com
 //
 // Permission to copy, use, modify, sell and distribute this software is
@@ -91,6 +91,20 @@ TEST_ENUM_PARAMS(ENUM_PARAMS_TEST_MAX)
 
 // ***
 
+//  RATIONALE:
+// - BOOST_PREPROCESSOR_REPEAT, BOOST_PREPROCESSOR_REPEAT_2ND, ... must work
+// together.
+// - BOOST_PREPROCESSOR_REPEAT is already tested with
+// BOOST_PREPROCESSOR_ENUM_PARAMS.
+// - The tested repeat count should exceed imaginable usage.
+// - Testing the generation of is_function_helper()s upto 40 arguments should
+// be sufficient in this case. Many compilers may fail the repetition tests
+// (at least with higher counts). However, the primary purpose of the
+// repetition primitives is to enable configurability with reasonable
+// defaults, and not necessarily "the most impressive repetition".
+// - ENUM_SHIFTED_PARAMS must be tested so that the shifted range is shown to
+// be correct.
+
 #ifndef IS_FUNCTION_HELPER_TEST_MAX
 #define IS_FUNCTION_HELPER_TEST_MAX 40
 #endif