[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [表紙] | [目次] | [索引] | [検索] [上端 / 下端] |
本章では、Emacs Lispの機能についてさらに述べることはしません。 かわりに、前章までに述べてきた機能を効率よく使うための助言や Emacs Lispプログラマが従うべき慣習について述べます。
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [表紙] | [目次] | [索引] | [検索] [上端 / 下端] |
ここでは、読者が広く使われることを意図した Emacs Lispコードを書く場合に従うべき慣習について述べます。
Emacs Lispでは基本関数ではないがLispの伝統的な基本関数の名前にさえも この勧告は適用される。 たとえcopy-list
にさえもである。 信じるかどうかは別にして、 copy-list
のもっともらしい定義方法は複数ある。 安全であるためには、読者の接頭辞を付けて foo-copy-list
やmylib-copy-list
のような名前にする。
読者が、twiddle-files
のような特定の名前でEmacsに 追加すべき関数を書いた場合には、読者のプログラムでは その名前で呼ばないようにする。 読者のプログラムではmylib-twiddle-files
としておき、 Emacsに名前を追加するように提案するメイルを `[email protected]'へ送る。 われわれがそのようにすることを決定したときには、 名前をとても簡単に変更できる。
1つの接頭辞では不十分な場合には、 意味がある限りは、 2つか3つの共通する別の接頭辞を読者のパッケージで使ってもよい。
接頭辞とシンボル名の残りの部分とはハイフン`-'で分ける。 これはEmacs自身やほとんどのEmacs Lispプログラムと一貫性がある。
provide
の呼び出しがあるとしばしば有用である。
require
を使う。
(eval-when-compile (require 'bar)) |
(さらに、require
が働くように、 ライブラリbarには(provide 'bar)
があること。) この式により、fooをバイトコンパイルするときに barをロードすることになる。 さもないと、必要なマクロをロードせずにfooをコンパイルする危険を侵し、 正しく動作しないコンパイル済みコードを生成することになる。 see 節 12.3 マクロとバイトコンパイル。
eval-when-compile
を使うことで、 fooのコンパイル済みの版を使うときには barをロードしない。
framep
やframe-live-p
である。
かわりに、C-cのあとにコントロール文字か数字文字か特定の句読点文字が続く キー列を定義する。 これらのキー列は、メジャーモード用に予約してある。
Emacsのすべてのモードをこの慣習に従うように変換するのは たいへんな作業量であった。 この慣習を捨てさるとその作業をむだにしてしまい、ユーザーにも不便である。
この規則の理由は、任意の文脈において ESCに対するプレフィックスでないバインディングがあることで、 エスケープシーケンスをその文脈におけるファンクションキーと 認識することを防げる。
Emacsの普通のコマンドを受け付ける状態、、あるいは、 より一般的にはESCに続けてファンクションキーや矢印キーが 意味を持つ可能性がある任意の状態では、 ESCに続くエスケープシーケンスの認識を妨げる ESC ESCを定義するべきではない。 そのような状態では、脱出手段としてESC ESC ESCを 定義する。 さもなければ脱出手段としてESC ESCを定義する。
whatever-mode
という 名前のコマンドを用意し、自動ロード(see 節 14.4 自動ロード)するようにする。 パッケージをロードしただけでは見ためには効果がない、 つまり、その機能をオンにしないようにパッケージを設計すること。 ユーザーはコマンドを起動してその機能をオンにする。
next-line
やprevious-line
を使わないこと。 ほとんどの場合、forward-line
のほうがより便利であり、 予測可能で堅牢でもある。 see 節 29.2.4 テキスト行単位の移動。
特に、以下のいずれの関数も使わないこと。
beginning-of-buffer
, end-of-buffer
replace-string
, replace-regexp
対話的なユーザー向けの他の機能を必要とせずに 単にポイントを移動したり特定の文字列を置換するには、 これらの関数は1行か2行の単純なLispコードで置き換えられる。
(リストだけが許す)要素を挿入したり削除する必要がないのであれば、 ある程度のサイズがあり (先頭から末尾に向けての探索ではなく)ランダムに参照する表には ベクトルのほうが適している。
princ
ではなく関数message
を使うことである。 see 節 37.3 エコー領域。
error
(あるいはsignal
)を呼び出す。 関数error
は戻ってこない。 see 節 9.5.3.1 エラーの通知方法。
エラーを報告するために、 message
、throw
、sleep-for
、beep
は使わないこと。
...
の周りに空白はなく、末尾にピリオドもない。
edit-options
のようにする。 別のバッファに切り替え、戻るのはユーザーに任せる。 see 節 20.11 再帰編集。
defvar
の定義を追加して、 コンパイル時の未定義な自由変数に対する警告を避けるように努めること。
ある関数で変数を束縛しその変数を別の関数で使ったり設定すると、 その変数を定義しない限りコンパイラは後者の関数について警告を出す。 しかし、しばしばこれらの変数は短い名前で、 Lispパッケージでそのような変数名を定義すべきかどうか明らかでない。 したがって、そのような変数の名前は、 読者のパッケージの他の関数や変数に使っている接頭辞で 始まる名前に改名すべきである。
indent-sexp
)で字下げすること。
;; Copyright (C) year name ;; This program is free software; you can redistribute it and/or ;; modify it under the terms of the GNU General Public License as ;; published by the Free Software Foundation; either version 2 of ;; the License, or (at your option) any later version. ;; This program is distributed in the hope that it will be ;; useful, but WITHOUT ANY WARRANTY; without even the implied ;; warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR ;; PURPOSE. See the GNU General Public License for more details. ;; You should have received a copy of the GNU General Public ;; License along with this program; if not, write to the Free ;; Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, ;; MA 02111-1307 USA |
読者がフリーソフトウェアファウンデーションに著作権を委譲する契約を 結んでいるときには、 nameとして`Free Software Foundation, Inc.'を使う。 さもなければ読者自身の名前を使う。
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [表紙] | [目次] | [索引] | [検索] [上端 / 下端] |
バイトコンパイルしたLispプログラムの実行速度を改良する方法を示します。
memq
、member
、assq
、assoc
のリスト探索基本関数を 使うほうが明示的な繰り返しよりも速い。 これらの探索基本関数の1つを使えるようにデータ構造を変更する価値はある。
byte-compile
を調べる。 属性がnil
以外であれば、その関数は特別に扱われる。
たとえば、つぎの入力は、aref
が特別にコンパイルされることを示す (see 節 6.3 配列操作関数)。
(get 'aref 'byte-compile) => byte-compile-two-args |
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [表紙] | [目次] | [索引] | [検索] [上端 / 下端] |
説明文字列を書くうえでのヒントや慣習を述べます。 コマンドM-x checkdoc-minor-modeを実行して、 これらの慣習の多くを確認できます。
説明文字列には、関数や変数の使い方の詳細を述べる追加の行があってよい。 それらの行も完全な文から成るべきであるが、見ためをよくするために 適当に詰めてよい。
しかし、説明文字列全体を単純に整形するよりは、 注意深く行分けすると読みやすくなる。 説明文字列が長い場合には、話題ごとに空行で区切る。
nil
以外の値はすべて同値であることを明らかにし、 nil
とnil
以外の意味を明確に示すこと。
/
の説明文字列では、 その第2引数の名前はdivisor
なので、`DIVISOR'と表す。
また、リストやベクトルを(その一部が変化するかもしれない)構成部分に 分解したものを示すときなどのメタ変数には、すべて大文字を使う。
ヘルプモードでは、説明文字列でシングルクォートで囲ったシンボルを使うと、 そのシンボルに関数定義や変数定義があるときには自動的に ハイパーリンクを作成する。 この機能を利用するために特別なことをする必要はない。 しかし、シンボルに関数定義と変数定義の両方があり、 どちらか一方のみを参照したい場合には、 シンボルの名前のまえに `variable'、`option'、`function'、`command'の いずれかの単語を書くだけでどちらであるかを指定できる。 (これらの単語を認識するときには大文字小文字は区別しない。) たとえばつぎのように書くと、
This function sets the variable `buffer-file-name'. |
ハイパーリンクは、変数buffer-file-name
の説明文字列を指し、 その関数の説明文字列は指さない。
シンボルに関数定義や変数定義があっても、 説明文字列でのシンボルの使い方には無関係な場合には、 シンボルの名前のまえに単語`symbol'を書けば、 ハイパーリンクを作らないようにできる。 たとえば、つぎのようにすると、
If the argument KIND-OF-RESULT is the symbol `list', this function returns a list of all the objects that satisfy the criterion. |
ここではlist
の関数/変数定義は無関係なので、 関数list
の説明文字列を指すハイパーリンクは作られない。
forward-char
に現在バインドされているキーにEmacsが置き換える。 (普通は`C-f'であるが、ユーザーがキーバインディングを変更していれば、 別の文字になる。) see 節 23.3 説明文内のキーバインディングの置換。
説明文字列の表示を遅くしてしまうので、 `\\[...]'を何回も使うのは実用的ではない。 したがって、読者のメジャーモードのもっとも重要なコマンドの記述にこれを使い、 モードのキーマップの残りを表示するには`\\{...}'を使う。
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [表紙] | [目次] | [索引] | [検索] [上端 / 下端] |
コメントを置く場所とそれらの字下げ方法については以下のような慣習を推奨します。
indent-for-comment
)で 自動的に右側の正しい位置に`;'を挿入したり、 そのようなコメントが既存ならば整列できる。
つぎとその下の例は、Emacsのソースから持ってきたものである。
(setq base-version-list ; there was a base (assoc (substring fn 0 start-vn) ; version to which file-version-assoc-list)) ; this looks like ; a subversion |
(prog1 (setq auto-fill-function ... ... ;; update mode line (force-mode-line-update))) |
説明文字列を持たない各関数 (所属するパッケージで内部向けにのみ使用される関数)では、 関数が行うことと正しい呼び出し方を記述した 2つのセミコロンで始まるコメントを関数のまえに書くこと。 各引数の意味とその可能な値を関数がどのように解釈するかを正確に説明すること。
;;; This Lisp code is run in Emacs ;;; when it is to operate as a server ;;; for other processes. |
3つのセミコロンで始まるコメントの別の使い方は、 関数内の行をコメントにする場合である。 そのような行が左端に留まるように3つのセミコロンを使うのである。
(defun foo (a) ;;; This is no longer necessary. ;;; (force-mode-line-update) (message "Finished with %s" a)) |
;;;; The kill ring |
M-;(indent-for-comment
)や TAB(lisp-indent-line
)などの Emacsのlispモードの字下げコマンドは、 これらの慣習にしたがって自動的にコメントを字下げします。 See GNU Emacs マニュアル。
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [表紙] | [目次] | [索引] | [検索] [上端 / 下端] |
Emacsには、コメントをいくつかの部分に分けて作者などの情報を与えるために、 Lispライブラリの特別なコメントに対する慣習があります。 本節ではそれらの慣習について述べます。 まず、例を示します。
;;; lisp-mnt.el --- minor mode for Emacs Lisp maintainers ;; Copyright (C) 1992 Free Software Foundation, Inc. ;; Author: Eric S. Raymond |
最初の行はつぎの形式であるべきです。
;;; filename --- description |
この記述は1行で完全になるようにします。
著作権表示のあとには、`;; header-name:'で始まる いくつかのヘッダコメント(header comment)行が続きます。 header-nameに使う可能性のある慣習の一覧を以下に示します。
複数の作者がいる場合には、以下のように、 ;;
とタブ文字で始めた継続行に その人達を列挙する。
;; Author: Ashwin Ram |
作者行(`Author')と保守者行(`Maintainer')の考えは、 手作業で名前を探さずに『保守者にメイルを送る』ようなLisp関数を 作れるようにするためである。
ネットワークアドレスに加えて人の氏名も書く場合には、 ネットワークアドレスを`<...>'で必ず囲むこと。
finder-by-keyword
向けの キーワードを書く。 意味のあるキーワードを理解するためにこのコマンドを試してほしい。
この部分は重要である。 人々が特定の話題で探して読者のパッケージをみつけるであろう。 キーワードは空白やカンマで区切る。
ほとんどのLispライブラリには、 `Author'と`Keywords'のヘッダコメント行が必要です。 残りのものは必要に応じて使います。 別の名前のヘッダ行があってもかまいません。 それらには標準的な意味はありませんが、害になることもありません。
ライブラリファイルの内容を分割するために形式を定めたコメントも使います。 それらを以下に示します。
[ << ] | [ >> ] | [表紙] | [目次] | [索引] | [検索] [上端 / 下端] |