message

Отображение сообщения пользователю.

message([<mode>] "message to display" ...)

Необязательное ключевое слово <mode> определяет тип сообщения:

FATAL_ERROR

Ошибка CMake, остановка обработки и генерации.

SEND_ERROR

Ошибка CMake, продолжение обработки, но пропуск генерации.

WARNING

Предупреждение CMake, продолжение обработки.

AUTHOR_WARNING

Предупреждение CMake (dev), продолжение обработки.

DEPRECATION

Ошибка или предупреждение CMake о устаревании, если переменная CMAKE_ERROR_DEPRECATED или CMAKE_WARN_DEPRECATED включена соответственно, в противном случае сообщение не выводится.

(none) or NOTICE

Важное сообщение, выведенное в stderr, чтобы привлечь внимание пользователя.

STATUS

Основные интересные сообщения, которые могут заинтересовать пользователей проекта. В идеале они должны быть краткими, не более одной строки, но при этом информативными.

VERBOSE

Подробные информационные сообщения, предназначенные для пользователей проекта. Эти сообщения должны предоставлять дополнительную информацию, которая в большинстве случаев не будет интересна, но может быть полезной для разработчиков проекта, когда они хотят более глубоко понять, что происходит.

DEBUG

Подробные информационные сообщения, предназначенные для разработчиков, работающих над самим проектом, а не для пользователей, которые просто хотят его скомпилировать. Эти сообщения обычно не будут интересны другим пользователям, собирающим проект, и часто будут тесно связаны с внутренними деталями реализации.

TRACE

Мелкозернистые сообщения с очень детальной информацией низкого уровня реализации. Сообщения с этим уровнем ведения журнала обычно будут временными и, как ожидается, будут удалены перед выпуском проекта, упаковкой файлов и т. п.

Инструмент командной строки CMake отображает сообщения STATUS по TRACE на стандартный вывод, предваряя сообщение двумя дефисами и пробелом. Все остальные типы сообщений отправляются в стандартный поток ошибок и не предваряются дефисами. CMake GUI отображает все сообщения в своей области журнала. curses interface отображает сообщения STATUS по TRACE по одному на строке состояния и другие сообщения в интерактивном всплывающем окне. Опцию --loglevel командной строки для каждого из этих инструментов можно использовать для управления отображаемыми сообщениями.

Текст сообщений CMake Warning и Error отображается с использованием простого языка разметки. Текст без отступов форматируется в виде абзацев, разбитых на строки. Отступы считаются предварительно отформатированными.