Стиль оформления кавычек в тексте

Обычно грависы и апострофы в строках документации и диагностических сообщениях обрабатываются особым образом и заменяются соответствующими типографскими одинарными кавычками (также называемыми «изогнутыми кавычками»). Например, строка документации "Alias for `foo'." и вызов функции (message "Alias for `foo'.") преобразуются в "Alias for ‘foo’.". Реже Emacs отображает грависы и апострофы как есть либо только апострофы (например, "Alias for 'foo'."). Строки документации и форматы сообщений следует писать так, чтобы они хорошо отображались при любом из этих стилей. Например, строка документации "Alias for 'foo'.", вероятно, не подходит для вашей задачи, поскольку она может отображаться как "Alias for ’foo’." — необычный стиль для английского языка.

Иногда необходимо отобразить гравис или апостроф без преобразования, независимо от стиля оформления кавычек в тексте. В строке документации это можно сделать с помощью экранирования. Например, в строке документации "\\=`(a ,(sin 0)) ==> (a 0.0)" гравис обозначает код Lisp, поэтому он экранирован и отображается как есть независимо от стиля оформления кавычек. В вызове message или error можно избежать преобразования, используя формат "%s" с аргументом, представляющим собой вызов format. Например, (message "%s" (format "`(a ,(sin %S)) ==> (a %S)" x (sin x))) отображает сообщение, начинающееся с грависа, независимо от стиля оформления кавычек в тексте.

Пользовательская опция: text-quoting-style

Значение этой пользовательской опции — символ, задающий стиль одинарных кавычек, который Emacs должен использовать в формулировках справки и сообщений. Если значение опции — curve, используется стиль ‘like this’ с типографскими одинарными кавычками. Если значение — straight, используется стиль 'like this' с прямыми апострофами. Если значение — grave, кавычки не преобразуются, и используется стиль `like this' с грависом и апострофом — стандартный стиль до версии 25 Emacs. Значение по умолчанию nil действует как curve, если типографские одинарные кавычки, по-видимому, можно отобразить, и как grave в противном случае.

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

Функция: text-quoting-style

Не следует напрямую считывать значение переменной text-quoting-style. Вместо этого используйте одноимённую функцию, чтобы динамически вычислить правильный стиль оформления кавычек для текущего терминала в описанном выше случае nil.