CommonTater, I've seen several projects with API documentation kept in the .h file (not 700 lines at once though). For example there is 200-line (10KB) comment in sqlite3.h.
But the problem is not in comment:
_T("test)";
Here the closing parenthesis is put inside the string literal, so the rest of the file is treated as the macro argument.