9.4.2 シンボルの標準的なプロパティ

Emacsで特別な目的のために使用されるシンボルプロパティーを以下に一覧します。以下のテーブルで、“命名される関数(the named function)”と言うときは、関数名がそのシンボルであるような関数を意味します。“命名される変数(the named variable)”等の場合も同様です。

:advertised-binding

このプロパティーリストは、命名される関数のドキュメントを表示する際に優先されるキーバインディングを指定する。Keys in Documentationを参照のこと。

char-table-extra-slots

値が非nilなら、それは命名される文字テーブル型の追加スロットの数を指定する。Char-Tablesを参照のこと。

customized-face

face-defface-spec

saved-face

theme-face

これらのプロパティーはフェイスの標準のフェイス仕様(face specs)と、フォント仕様のsaved-fase、customized-face、themed-faceを記録するために使用される。これらのプロパティーを直接セットしないこと。これらのプロパティーはdeffaceと関連する関数により管理される。Defining Facesを参照のこと。

customized-value

saved-value

standard-value

theme-value

これらのプロパティーは、カスタマイズ可能な変数のstandard-value、saved-value、customized-value(しかし保存はされない)、themed-valueを記録するために使用される。これらのプロパティーを直接セットしないこと。これらはdefcustomと関連する関数により管理される。Variable Definitionsを参照のこと。

disabled

値が非nilなら命名される関数はコマンドとして無効になる。Disabling Commandsを参照のこと。

face-documentation

値には命名されるフェイスのドキュメント文字列が格納される。これはdeffaceにより自動的にセットされる。Defining Facesを参照のこと。

history-length

値が非nilなら、命名されるヒストリーリスト変数のミニバッファーヒストリーの最大長を指定する。Minibuffer Historyを参照のこと。

interactive-form

この値は命名される関数のインタラクティブ形式である。通常はこれを直接セットするべきではない。かわりにスペシャルフォームinteractiveを使用すること。Interactive Callを参照されたい。

menu-enable

この値は命名されるメニューアイテムが、メニュー内で有効であるべきか否かを決定するための式である。Simple Menu Itemsを参照のこと。

mode-class

値がspecialなら命名されるメジャーモードはspecial(特別)である。Major Mode Conventionsを参照のこと。

permanent-local

値が非nilなら命名される変数はバッファーローカル変数となり、メジャーモードの変更によって変数の値はリセットされない。Creating Buffer-Localを参照のこと。

permanent-local-hook

値が非nilなら、命名される関数はメジャーモード変更時にフック変数のローカル値から削除されない。Setting Hooksを参照のこと。

pure

値が非nilの場合には、名づけられた関数は純粋(pure)だとみなされる。定数の引数で呼び出された場合には、コンパイル時に評価することができる。これは実行時のエラーをコンパイル時へとシフトする。純粋ストレージ(pure storage)と混同しないこと(Pure Storageを参照)。

risky-local-variable

値が非nilなら、命名される変数はファイルローカル変数としては危険だとみなされる。File Local Variablesを参照のこと。

safe-function

値が非nilなら、命名される関数は評価において一般的に安全だとみなされます。Function Safetyを参照のこと。

safe-local-eval-function

値が非nilなら、命名される関数はファイルローカルの評価フォーム内で安全に呼び出すことができる。File Local Variablesを参照のこと。

safe-local-variable

値は命名される変数の、安全なファイルローカル値を決定する関数を指定する。File Local Variablesを参照のこと。

side-effect-free

非nil値は命名される関数は副作用(What Is a Functionを参照)をもたないので、バイトコンパイラーは値が使用されない呼び出しを無視する。このプロパティの値がerror-freeなら、バイトコンパイラーはそのような呼び出しの削除すら行うかもしれない。バイトコンパイラーの最適化に加えて、このプロパティは関数の安全性を判断するためにも使用される(Function Safetyを参照)。

variable-documentation

非nilなら、それは命名される変数のドキュメント文字列を指定する。ドキュメント文字列はdefvarと関連する関数により自動的にセットされる。Defining Facesを参照のこと。