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 на стандартном выходе, предваряя сообщение двумя дефисами и пробелом. Все остальные типы сообщений отправляются в stderr и не имеют префикса дефисами. CMake GUI отображает все сообщения в своей области журнала. curses interface отображает сообщения STATUS по TRACE по одному на строке состояния и другие сообщения в интерактивном всплывающем окне. Опция --log-level командной строки для каждого из этих инструментов может использоваться для управления отображаемыми сообщениями.

Сообщения с уровнями журналов NOTICE и ниже также будут иметь каждую строку, предваряемую содержимым переменной CMAKE_MESSAGE_INDENT (преобразованное в одну строку путем конкатенации элементов списка). Для сообщений от STATUS до TRACE это отступы будут вставлены после дефисов.

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