Переменные предупреждений

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

Переменная: warning-levels

Этот список определяет значение и порядок серьезности уровней предупреждений. Каждый элемент определяет один уровень серьезности, и они упорядочены по убыванию серьезности.

Каждый элемент имеет вид (level string function), где level — это уровень серьезности, который он определяет. string указывает текстовое описание этого уровня. string должен использовать ‘%s’, чтобы указать, где разместить информацию о типе предупреждения, или может опустить ‘%s’, чтобы не включать эту информацию.

Необязательная function, если она не nil, — это функция, вызываемая без аргументов, чтобы привлечь внимание пользователя.

Обычно вы не должны изменять значение этой переменной.

Переменная: warning-prefix-function

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

Функция вызывается с двумя аргументами: уровень серьезности и его запись в warning-levels. Она должна возвращать список для использования в качестве записи (это значение не обязательно должно быть фактическим членом warning-levels). Конструируя это значение, функция может изменить уровень серьезности предупреждения или указать другое обработку для данного уровня серьезности.

Если значение переменной nil, то нет функции для вызова.

Переменная: warning-series

Программы могут связать эту переменную с t, чтобы указать, что следующее предупреждение должно начать серию. Когда несколько предупреждений образуют серию, это означает, что точка останется на первом предупреждении серии, а не будет перемещаться на каждое предупреждение, чтобы отображаться на последнем. Серия завершается, когда локальная привязка разрывается, и warning-series становится nil снова.

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

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

Нормальное значение переменной — nil, что означает обработку каждого предупреждения отдельно.

Переменная: warning-fill-prefix

Когда эта переменная не nil, она указывает префикс заполнения для заполнения текста каждого предупреждения.

Переменная: warning-fill-column

Столбец, в котором следует заполнять предупреждения.

Переменная: warning-type-format

Эта переменная определяет формат отображения типа предупреждения в сообщении о предупреждении. Результат форматирования типа таким образом включается в сообщение под управлением строки в записи в warning-levels. Значение по умолчанию — " (%s)". Если вы свяжете его с "", то тип предупреждения вообще не отобразится.