Next: , Previous: , Up: ドキュメント   [Contents][Index]


25.4 テキストのクォートスタイル

ドキュメント文字列や診断メッセージの中では、グレイブアクセント(grave accent)とアポストロフィ(apostrophe)は通常は特別に扱われてマッチするシングルクォーテーションマーク(“curved quotes”とも呼ばれる)に変換されます。たとえばドキュメント文字列"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コードの表現を意図しているので、グレイブアクセントエスケープしてクォートスタイルとは無関係にそれ自身を表示します。messageerrorの呼び出しでは、フォーマット"%s"format呼び出しを引数として変換を回避できます。たとえば(message "%s" (format "`(a ,(sin %S)) ==> (a %S)" x (sin x)))はテキストのクォートスタイルに関わらず、グレイブアクセントで始まるメッセージを表示します。

User Option: text-quoting-style

このユーザーオプションの値はヘルプやメッセージの文言中のシングルクォートにたいして、Emacsが使用するべきスタイルを指定するシンボル。このオプションの値がcurveなら‘like this’のようなcurved single quotesスタイル。値がstraightなら'like this'のような素のアポストロフィスタイル。値がgraveならクォートは変換せずに、`like this'のようなEmacsバージョン25以前の標準スタイルであるグレイブアクセントとアポストロフィのスタイル。デフォルト値のnilはcurved single quotesが表示可能なようならcurve、それ以外ならgraveのように機能する。

このオプションはcurved quotesに問題があるプラットフォームで有用。個人の好みに応じてこれを自由にカスタマイズできる。

Function: text-quoting-style

変数text-quoting-styleの値を直接読み取るべきではない。カレント端末においてこの変数にnilがセットされている際の正しいクォートスタイルを動的に算出するために、この同名の関数を使用すること。