message: Add a DEPRECATION mode

By default, the message is not issued. If CMAKE_ERROR_DEPRECATED
is on, the message is fatal. If CMAKE_WARN_DEPRECATED is on, the
message is a warning.
This commit is contained in:
Stephen Kelly
2013-09-17 18:54:34 +02:00
parent 40c84683aa
commit 509c142a3f
16 changed files with 65 additions and 4 deletions

View File

@@ -60,9 +60,8 @@ public:
virtual const char* GetFullDocumentation() const
{
return
" message([STATUS|WARNING|AUTHOR_WARNING|FATAL_ERROR|SEND_ERROR]\n"
" \"message to display\" ...)\n"
"The optional keyword determines the type of message:\n"
" message([<mode>] \"message to display\" ...)\n"
"The optional <mode> keyword determines the type of message:\n"
" (none) = Important information\n"
" STATUS = Incidental information\n"
" WARNING = CMake Warning, continue processing\n"
@@ -70,6 +69,9 @@ public:
" SEND_ERROR = CMake Error, continue processing,\n"
" but skip generation\n"
" FATAL_ERROR = CMake Error, stop processing and generation\n"
" DEPRECATION = CMake Deprecation Error or Warning if variable\n"
" CMAKE_ERROR_DEPRECATED or CMAKE_WARN_DEPRECATED\n"
" is enabled, respectively, else no message.\n"
"The CMake command-line tool displays STATUS messages on stdout "
"and all other message types on stderr. "
"The CMake GUI displays all messages in its log area. "