GNU Emacsには便利なビルトインのヘルプ機能があり、それらのほとんどは関数や変数のドキュメント文字列に付属するドキュメント文字列の情報が由来のものです。このチャプターではLispプログラムからドキュメント文字列にアクセスする方法について説明します。
ドキュメント文字列のコンテンツはある種の慣習にしたがう必要があります。特に最初の行はその関数や変数を簡単に説明する1つか2つの完全なセンテンスであるべきです。よいドキュメント文字列を記述する方法についてはDocumentation Tipsを参照してください。
Emacs向けのドキュメント文字列はEmacsマニュアルと同じものではないことに注意してください。マニュアルはTexinfo言語で記述された独自のソースファイルをもちます。それにたいしドキュメント文字列はそれが適用される関数と変数の定義内で指定されたものです。ドキュメント文字列を収集してもそれはマニュアルとしては不十分です。なぜならよいマニュアルはそのやり方でまとめられたものではなく、議論にたいするトピックという観点でまとめられたものだからです。
ドキュメント文字列を表示するコマンドについては、Help in The GNU Emacs Manualを参照してください。
• Documentation Basics | ドキュメント文字列が定義、格納される場所。 | |
• Accessing Documentation | Lispプログラムがドキュメント文字列にアクセスする方法。 | |
• Keys in Documentation | カレントキーバインディングの置き換え。 | |
• Text Quoting Style | ドキュメント文字列やメッセージの中のクォーテーションマーク。 | |
• Describing Characters | 非プリント文字やキーシーケンスをプリント可能な記述にする。 | |
• Help Functions | Emacsヘルプ機能により使用されるサブルーチン。 |