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

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

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