GNU Emacs 32.0.50 (9008bf64c3) のマニュアルを PLaMo 翻訳で機械翻訳したものです。誤訳を含むことがあります。原文: https://www.gnu.org/software/emacs/manual/html_node/eintr/Who-You-Are.html ・ emacs-doc.conao3.com

誰のために書かれたか

本書は、プログラマーではない方向けの入門書として執筆されています。プログラマーの方にとっては、この入門書では物足りなく感じられるかもしれません。というのも、リファレンスマニュアルを読みこなすことに習熟しており、本書の構成に違和感を覚える可能性があるからです。

この文章を校閲した熟練のプログラマーが、私にこう言った。

私はリファレンスマニュアルから学ぶ方が好きです。各段落に「飛び込み」、段落の合間に「息継ぎ」をします。

段落の最後まで読み進めると、その主題についてはこれで終わり、完結し、必要な情報はすべて揃ったのだと考えます(次の段落でより詳しく触れられる場合は別ですが)。よく書かれたリファレンスマニュアルであれば、冗長な記述は少なく、欲しい情報が載っている(唯一の)場所への的確な案内があるだろうと期待しています。

この紹介文は、この人向けに書かれていない!

まず、あらゆることを少なくとも3回は伝えるようにしています。1回目は紹介するため、2回目は文脈の中で示すため、そして3回目は別の文脈で示すか、あるいは復習するためです。

次に、ある主題に関するすべての情報を一箇所にまとめることはほとんどありませんし、ましてや一つの段落に収めることなどまずありません。私の考えでは、それでは読者に過度な負担を強いることになるからです。その代わりに、その時点で知っておくべきことだけを説明するようにしています。(時折、少し補足情報を盛り込むこともあります。そうすることで、後でその情報が正式に導入された際に、読者が驚かずに済むからです。)

この文章を読む際、一度ですべてを習得できるとは限りません。多くの場合、挙げられている項目のいくつかに、軽く目を通すだけで十分でしょう。私がこの文章を構成し、十分なヒントを提示したことで、何が重要であるかに気づき、そこに集中していただけることを願っています。

いくつかの段落はじっくり読み込む必要があります。そうする以外に読み方はありません。ただ、そうした段落の数は極力抑えるよう努めました。本書は、そびえ立つ山ではなく、親しみやすい丘となることを意図しています。

本書『An Introduction to Programming in Emacs Lisp』には、『The GNU Emacs Lisp Reference Manual』という関連ドキュメント、The GNU Emacs Lisp Reference Manualがあります。リファレンスマニュアルは、本入門書よりも詳細な内容となっています。リファレンスマニュアルでは、あるトピックに関するすべての情報が一箇所にまとめられています。前述のプログラマーのような方は、ぜひそちらを参照してください。そしてもちろん、この『Introduction』を読み終えた後には、独自のプログラムを記述する際に『Reference Manual』が役立つことでしょう。