バグの報告

ときにはEmacsのバグに出合うこともあるでしょう．我々はそのバグを必ず直 せるとは限りませんし，また，それがバグであるということに同意すらしないか もしれませんが，直したいと考える場合には利用者の見つけたバグについての情 報がなくてはなりません．

我々がバグを直すためには利用者にそれを報告していただく必要があります． この報告を効果的に行なうために，利用者はいつ，どうやって報告したらよいか を知っておいてください．

どんなときがバグか

Emacsが不正命令を実行したりプログラムに問題があるというオペレーティン グ・システムのエラーメッセージ("disk full"のようなものではなく)が出て， 止まってしまった場合，それは確かにバグです．

Emacsがバッファにあるものに対応しない表示をしたら，これは確かにバグで す．コマンドが誤った実行をしているように見えても，C-lを入力したら 問題が解消されたときは，表示更新が正しくなかったケースです．

いつまでたってもコマンドが完了しない場合もバグである可能性がありますが， 本当にEmacs側のバグなのかどうか確かめてみてください．実行に長い時間のか かるコマンドもいくつかあります．C-gのあと，C-h lを入力して Emacsが受け付けた入力が利用者の意図したものであったかどうか確かめてくだ さい．すぐに実行されるはずと知っているコマンドであった場合にはバグを報告 してください．そのコマンドが長い時間を要するかどうか知らない場合は，マニュ アルを見るか誰かに助けてもらってください．

利用者のよく知っているコマンドを実行したときに，その定義が正しいもので あるのにEmacsのエラーメッセージが出た場合にはそれはおそらくバグでしょう．

コマンドが間違ったことを実行した場合にはそれはバグです．しかしその前に， コマンドが本当は何をするものなのかが分かっているかどうか自問してみてくだ さい．もし利用者がそのコマンドをあまり知らなかったり，そのコマンドがどの ような動作をするのか，はっきりとは知らない場合には，そのコマンドは正しく 動作している可能性もあります．すぐに結論に飛びつくのではなく，よく知って いる人にその問題を見てもらいましょう．

最後に，コマンドで意図された定義が編集には最適でないこともあります．こ れは大変重要な問題ですが，また判断の問題でもあります．また，ある機能を知 らないためにそういった結論に達しやすいともいえます．いつものやり方でまず 説明文書を調べ，それを理解しているという確信が持て，それでも望みの機能が 実現されていないと確信したら，そこではじめて"問題がある"と結論するのが もっともよい方法です．マニュアルをよく読んでも，そのコマンドが何をするは ずなのかがはっきりと分からない場合には，不明確な言葉を索引や用語集で調べ ましょう．それでも分からない場合はマニュアルにバグがあるといえるでしょう． マニュアルによって"すべて分からなければ"なりません．マニュアルのバグを 報告することはプログラムのバグの報告と同じくらい重要です．

ある関数や変数のオンラインでの説明文書がマニュアルと矛盾している場合に はいずれかが間違っているはずなのでバグを報告してください．

バグの報告の方法

バグであると判断したときにそれを報告すること，しかも役に立つように報告 することが重要です．最も役に立つのは利用者の入力したコマンド，つまり Emacsをスタートさせたシェルコマンドから，問題が起こるまでに入力したコマ ンドの正確な記述です．また使っているEmacsのバージョン番号も含めてください． これを得るにはM-x emacs-versionと入力します．

バグを報告するときにもっとも重要な原則は，仮説やバグの種類ではなく，" 事実"を報告することです．事実を報告する方がやさしいはずですが，人々は説 明しようと努力し，事実の代わりにそれを報告してしまうことが多いようです． Emacsのインプリメントを推測してそれに基づいて説明しても役に立ちません． 我々はどのような事実が，その考えに結び付いたのかを考え出さなくてはならな いからです．時にはこれは不可能です．いずれにしてもこれは我々にとっては不 必要な作業です．

たとえば利用者がC-x C-f /glorp/baz.ugh RETと入力し，非常に 大きなファイル(と知っている)を読み込もうとしたときに，Emacsが`I feel pretty today'と出力したとしましょう．バグの報告の最もよい方法は，こ の文のように報告することです．というのは，ここにはすべての事実が述べられ， 事実以外何も述べられていないからです．

この問題がファイルサイズによるものだと仮定して"大きなファイルを読み込 もうとしたらEmacsが`I feel pretty today'とプリントアウトした"と報 告するのはやめてください．これがいわゆる"推測に基づく説明"です．問題だっ たのは，たとえばファイル名の`z'が含まれていたということだけかもしれ ないのです．もしこのとおりであって，しかも"ファイルが大きすぎた"という 利用者の報告を受けとったら，我々は"大きなファイル"に関する問題(たぶん `z'はその名前の中にはいっていないでしょう)を考えなくてはならず，何 ら悪いところは発見できないことになります．"名前の中に`z'が含まれて いるファイルを読み込もうとした"ということを我々が推測する手段はまったく ありません．

または，ファイルがちょうど25の空白で始まるのが問題の原因だったのかもし れません．こういったことも考えると，利用者はバグを再現させるのに必要なファ イルの正確な内容を我々に知らせる必要があるでしょう．その前にC-x C-aコマンドを入力したときだけに，問題が発生するのでしょうか．これらの事 柄も考慮するため，Emacsを使い始めてから入力した文字の正確な列も報告して ください．

ファイルを読み込むコマンドがどれも同じエラーを起こすとわかるまでは C-x C-fと報告する代わりに"ファイルを読み込むときに"という報告を しないでください．また同様に"1行に3文字入力すると"よりも "RET A B C RET C-pと入力したら"と報告してください．

問題が発生したときFundamentalモードでなかった場合は，どのモードにいた のかも報告してください．

Emacsのエラーメッセージによってバグが明らかになったのなら，エラーメッ セージのテキストだけではなく，EmacsのLispプログラムが，どうやってそのエ ラーのところまできたかというバックトレースを報告することが大切です．バッ クトレースを得るにはエラーが起きる前にLisp式(setq debug-on-error t)を実行する必要があります(すなわちこの式を実行した あと，もう一度バグを発生させるわけです)．これによりLispデバッガが動作し ます(see section Emacs Lispデバッガ)．デバッガのバックトレースも，バグ報告にテキスト としてコピーすることができます．このデバッガの使い方は，そのバグを再現す る方法を知っている場合のみ可能です．最初にバグが起こったときにかならずエ ラーメッセージを記録しておいてください．バグが再現しなかったら，それだけ でも報告してください．

利用者がLisp環境にロードしたプログラム(利用者の`.emacs'ファイルも 含む)が，Emacsの機能に影響を与えるような変数の設定を行なっていないか調べ てください．また利用者の`.emacs'ファイルをロードせずに始動したEmacs でも問題が発生するかどうかを調べてください(-qスイッチを付けて Emacsをスタートすると初期化ファイルのロードをしません)．そのときに問題が 起きなければ，問題を起こすためLisp環境にロードしなくてはならないプログラ ムの具体的内容を我々が知ることが重要になります．

その問題が初期化ファイルや標準のEmacsのシステムの一部ではないような他 のLispプログラムに由来しているならば，それはメインテナンスをしている人に 相談してプログラムのバグではないということをまず確認する必要があります． Emacsが正しい動作をするような設定で使用していると確認したら，バグを報告 してください．

ファイルの読み込みをせずに問題が発生する場合が見つかったら，それも報告 してください．これでデバッグがずっとやりやすくなります．ファイルが必要な らその正確な内容を我々が見られるようにしてください．たとえばファイルの最 後の空白や，バッファの最終行の次の改行が影響することがよくあります．(最 終行が終っているかどうかは気にする必要はありませんが，バグに関係すること があります．)

Emacsへの入力を正確に記録する簡単な方法は，ドリブルファイルを作ること です．これには次のLisp式を実行します．

(open-dribble-file "~/dribble")

これにはMeta-ESCを使うかEmacsをスタートした直後の `*scratch*'バッファから呼び出します．これを実行してからは，Emacsの プロセスが終了するまではEmacsへのすべての入力は指定されたドリブルファイ ルに書き込まれます．

表示のバグである可能性があるときには端末の種類(環境変数TERMの値)， その端末に対する`/etc/termcap'のエントリの全体(このファイルはすべて のマシンに共通ではないからです)，およびEmacsが実際に端末に送った出力を報 告してください．この出力を得るには，次のLisp式を実行します．

(open-termscript "~/termscript")

これにはMeta-ESCを使うか，Emacsをスタートした直後の `*scratch*'バッファから呼び出します．これを実行してからEmacsのプロ セスが終了するまで，Emacsから端末へのすべての出力が指定された端末記録ファ イルに書き込まれます．Emacsが始動したときに問題が生じるなら，この式をあ なたの`.emacs'ファイルに入れます．これによりEmacsがはじめて画面表示 を行なうときには，すでに端末記録ファイルがオープンされているようになりま す．注意:端末に由来するバグを修正するのは，そのバグが発生する端末に直接 触れない限り，困難あるいは，ときには不可能です．

バグを報告する住所は

GNU Emacs Bugs
545 Tech Sq, rm 703
Cambridge, MA 02139

あるいはUsenetの`mit-eddie!bug-gnu-emacs'またはInternetの `bug-gnu-emacs@prep.ai.mit.edu'にメイルを送ってください．

繰り返しますが，我々は必ずそのバグを直すとはお約束できません．しかしそ のバグが重大なもの，みっともないもの，簡単に直せるもの，である場合には我々 がそれを直したいと考える可能性は高いでしょう．

Emacs Version 17 Antinews

For those of you who are downgrading from version 18 to version 17 of GNU Emacs, here is a list of the old features. You will note many simplifications; complicated features have been eliminated. The list does not include changes affecting only topics not dealt with in this manual.

General Changes

• Vi, EDT and Gosmacs emulation have been eliminated in version 17. The idea is that other editors are obsolete and nobody should want to remember they exist.
• The buffer-sorting commands of version 18 have been eliminated in version 17. See section テキストの整列.
• The M-TAB command for completion of Lisp symbol names has been eliminated.
• The M-/ command for dynamic abbrev expansion has been eliminated.
• C-M-v is no longer redefined in the minibuffer. It has its standard meaning, which is to scroll the "next" window. In the minibuffer, the "next" window is always the one at the top of the screen. See section マルチプルウィンドウ.
• The old command M-x occur-menu is now the way to ask for a list of matches for a regexp and then pick one and move point to it. Refer to its on-line documentation for full details of its use. M-x occur has been simplified and now just displays a list of matches with no fancy options. See section 他の繰り返し探索コマンド.
• Incremental searches both ordinary and regexp now share a single default search string which is the last thing searched for by either kind of incremental search. They do not wrap to the beginning or end of the buffer. See section インクリメンタル探索.
• The variables search-low-speed and search-slow-window-lines have been renamed to start with isearch instead of search.
• Undo in version 17 clears the "modified" flag more often. If the buffer contents that result from undoing are the same as at a prior instant when the "modified" flag was clear, the "modified" flag is cleared again. See section 変更の取り消し(Undo).
• C-x C-v is allowed only when the current buffer is visiting a file. See section ファイルの読み込み.
• Auto-save file names in version 17 do not have a final `#'. The auto-save file name for a file `foo.c' is therefore `#foo.c'. See section 自動セーブ:不慮の事故に対するプロテクト.
• M-x recover-file works more simply. It does not compare the dates of the specified file and its auto-save file; it does not display a directory listing for them. You must figure out on your own whether you want to recover the file from its auto-save file.
• Some of the command line switches have been eliminated (see section コマンドスイッチと引数). Switches eliminated include `-insert' and `-i', and the alternate names `-funcall', `-load', `-user' and `-no-init-file'.

Changes in Major Modes

• Fortran mode has been eliminated.
• Nroff mode no longer defines a syntax for comments (see section Nroffモード).
• The two kinds of TeX mode have been combined into one; M-x tex-mode simply turns on this mode instead of choosing among two others. A further simplification is the elimination of the commands C-c C-f, C-c C-k, C-c C-l and C-c C-q. See section TeXモード.
• All the special commands of Outline mode have been moved to new keys or eliminated (see section Outlineモード).
  • C-c C-n becomes M-}.
  • C-c C-p becomes M-{.
  • C-c C-f, C-c C-b and C-c C-u are eliminated.
  The variable outline-regexp has also been eliminated in version 17.
• In C mode, TAB always reindents the current line. The variable c-tab-always-indent has been eliminated and Emacs acts as if it were t. See section Cの字下げのカスタム化.
• Linefeed is now redefined in C mode so that it reindents (with TAB) both of the lines that result from breaking the current line.
• The special commands used in Picture mode to specify the direction of cursor motion after self-inserting characters have been given new keys (see section 絵の編集). They are now
  • M-` to request leftward motion.
  • M-' to request rightward motion.
  • M-- to request upward motion.
  • M-= to request downward motion.
  • C-c ` to request upward and leftward motion.
  • C-c ' to request upward and rightward motion.
  • C-c / to request downward and leftward motion.
  • C-c \ to request downward and rightward motion.
• The special C-c commands of Mail mode have been given new keys (see section メイルの送信).
  • C-c C-f C-s becomes C-c s
  • C-c C-f C-t becomes C-c t
  • C-c C-f C-b becomes C-c b
  • C-c C-f C-c becomes C-c c
  • C-c C-y becomes C-c y
  • C-c C-q becomes C-c q
  • C-c C-w becomes C-c w
• The g command in Dired has been removed (see section ディレクトリエディタ, Dired).

Init Files and Library Changes

• The commands load-file and load-library are replaced with one command, load. This command is logically the same as version 18 load-library, but due to changes in the order of searching it can also serve in place of load-file. See section ライブラリのロード. The search order in version 17 is:
  1. Search all the directories in the search path for the file name as given.
  2. Append the suffix `.elc' and search all the directories.
  3. Remove the final `c', resulting in a suffix `.el', and search all the directories.
  The search path in version 17 normally starts with nil, meaning the current default directory. As a result, the first file name that load tries is the one load-file would use in version 18: no suffix, and current default directory.
• The default init file is called `default-profile' instead of `default.el' or `default.elc'. Also, it is executed only if you have no init file of your own.
• The terminal-independent keypad support in the `keypad' library has been eliminated. See section 端末ごとの初期化.
• The function setq-default has been eliminated. Use set-default and quote the variable name, as in

  (set-default 'variable value)
  

  Several built-in variables now are always local to all buffers. These variables are tab-width, ctl-arrow, truncate-lines, fill-column, left-margin, mode-line-format, abbrev-mode, overwrite-mode, case-fold-search, auto-fill-hook, selective-display. set-default does not work with these variables. They do have defaults, but the defaults affect only buffers yet to be created. The only way to set the default for variable foo is to set the variable named default-foo, such as default-case-fold-search and default-fill-column.
• Some variables have been eliminated. Emacs version 17 always behaves as if they were nil.
  • backup-by-copying-when-mismatch
  • find-file-hooks
  • find-file-not-found-hooks
  • write-file-hooks
  • file-precious-flag
  • no-redraw-on-reenter