Harmonia-Mode User's Guide Printer-Friendly Version

	Manual Contents Introduction Features Movement Search Filtered Views Reference Customization Commands Java Notes Crash Recovery and Bug Reporting

Crash Recovery and Bug Reporting

Automatic Crash Recovery

Harmonia-mode has been engineered to recover from crashes in order to preserve your work, and to help us with debugging. If it crashes, it will ask for permission to file a bug report:

Sending Harmonia-mode's Log in a Bug Report

In order to help us recreate the steps that led to a crash, Harmonia-mode automatically maintains a log file that contains a record of all edits that you made to your file leading up to the crash. If Harmonia crashes, this log will be saved in the same directory as your original file, with the extension .hlog. It will also be inserted into the bug-report that will be sent to us automatically.

Automatically Restarting Harmonia-mode

After sending a bug-report, Harmonia-mode will restart on your program, and allow you to edit it again. If Harmonia-mode keeps crashing and you would prefer to turn it off, change into fundamental mode by typing M-x fundamental-mode.

Manually Sending a Bug Report

You can also send us a bug report at any time by typing M-x report-harmonia-bug, or by emailing us at harmonia-bugs@sequoia.cs.berkeley.edu. This will invoke the bug-report email template shown below.

The top half of this window is the email that will be sent, and the bottom half contains instructions on how to send the report. You can now type a description of what you were doing beneath "Dear bug team!" in the provided template. Enter C-c C-c when you are done, and the report will be emailed to the Harmonia development team.

Please report the problems you find! Harmonia-mode is currently in active development, and we will be updating the CS164 installation as we fix bugs and add features.