CMP0053

Упрощение обработки ссылок на переменные и последовательностей эскейпов.

CMake 3.1 представил значительно более быструю реализацию оценки ссылок на переменные и последовательностей эскейпов, описанных в руководстве cmake-language(7). Хотя поведение идентично реализации предыдущих версий в большинстве случаев, некоторые частные случаи были устранены для упрощения работы. В частности:

• Расширение синтаксиса ссылок @VAR@, определенного командами configure_file() и string(CONFIGURE), больше не выполняется в других контекстах.

• Литеральный синтаксис ссылок ${VAR} может содержать только буквенно-цифровые символы (A-Z, a-z, 0-9) и символы _, ., /, -, и +. Обратите внимание, что $ технически разрешен в поведении NEW, но является недопустимым для поведения OLD. Это связано с упущением при реализации CMP0053, и по этой причине использование его в качестве литеральной ссылки на переменную не рекомендуется. Переменные с другими символами в имени всё ещё могут быть обработаны косвенно, например:

  set(varname "otherwise & disallowed $ characters")
  message("${${varname}}")
  

• Настройка политики CMP0010 не учитывается, поэтому неверный синтаксис ссылки на переменную всегда является ошибкой.
• Разрешается больше символов для экранирования в именах переменных. Ранее только ()#" \@^ были допустимыми символами для экранирования. Теперь любой не буквенно-цифровой, не двоеточие, не символ NUL может быть экранирован в соответствии с производством escape_identity в разделе последовательности эскейпов руководства cmake-language(7).

Поведение OLD для этой политики заключается в соблюдении поведения предыдущих версий для ссылок на переменные и последовательностей эскейпов. Поведение NEW заключается в использовании более простых правил расширения переменных и оценки последовательностей эскейпов.

Эта политика была введена в CMake версии 3.1. CMake версии 3.20.0-rc3 предупреждает, если политика не установлена, и использует OLD поведение. Используйте команду cmake_policy(), чтобы явно установить её в OLD или NEW.