How to write a bug report

When Mew doesn't work well, one would say, "... doesn't work. What should I do?". This provides no information to help you. First, you should write your environment such as OS name and version, Emacs name and version, Mew's version.

Then you should write a symptom as concrete as possible. If you can reproduce it, write the steps.

Backtrace

If you hit upon an error displayed in the mini buffer, copy the *Backtrace* buffer according to the following procedure.

If you have the "root" privilege, you should remove all ".elc" files (mew.elc and mew-*.elc), then execute Emacs again. With this work, you can obtain more debug information. To check if the .elc files are certainly deleted, after executing Mew on Emacs, type C-h f mew. If you can find "an interactive Lisp function" in the *Help* buffer, it's OK. However, if you find the word "complied" like "an interactive compiled Lisp function", the .elc files still remain.

To obtain *Backtrace*, type as follows in the *scratch* buffer:

(setq debug-on-error t)

Now, type C-xC-e after the close parenthesis, ")". In this situation, if an error occurs, many kinds of information are displayed in the *Backtrace* buffer. You should save this content and terminate Emacs. Then please send a report message, including the content, destined to mew-int@mew.org using newly executed Emacs.

Debug functionality of Mew

If a message is displayed broken in Message mode, type

(setq mew-debug t)

the *scratch* buffer and type C-xC-e after the close parenthesis, ")". In this situation, if an error occurs, many kinds of information are displayed in the *Backtrace* buffer. You should save this content and terminate Emacs. Then please send a report message, including the content, destined to mew-int@mew.org using newly executed Emacs.

If communication with POP, IMAP, SMTP, NetNews, SSH, SSL and TLS deos not work well, please send log of the communication. Setting mew-debug to t by the method described above, communication is logged in the *Mew debug* buffer. Please remove privacy stuff from this buffer and save it. Then please send a report message, including the log, destined to mew-int@mew.org using newly executed Emacs.

You should set debug-on-error and mew-debug to nil except the time when you are making a bug report. If you set these variable on the *scratch* buffer, they will get back to nil on newly executed Emacs.