Thank you for contributing!
- Use the “Provide MacTerm Feedback” command in the MacTerm application menu. (This is convenient because it adds version information to your new E-mail message automatically.)
- You can E-Mail a Bug Report for MacTerm [email@example.com] from this page instead.
- If you plan to donate to the project anyway, you have the option of listing quick feature requests at the same time.
Yes! Please submit reports, they help more than you may expect:
- The issue might be easy to fix (even if it doesn’t seem that way).
- It may be the only way we know about your particular problem. Even if you think you are seeing an “obvious” problem, not all computers are the same; you may be seeing something that others do not.
- It is an easy way to chip in to the project. It takes just a few minutes to send a note (whereas, did you know that MacTerm has been developed for over two decades)?
What About “Send Bugs to Apple”?
Believe it or not, this isn’t that helpful; Apple does not share bug reports sent this way (although they may fix the OS in a way that eventually affects MacTerm). It is still better to submit bugs directly for MacTerm.
Useful Things to Include in Bug Reports
While any report is useful, here are some guidelines for what makes a good report:
- The MacTerm version (use Get Info in the Finder, or the About MacTerm command).
- The system version (for example, "OS 10.9.1"), which can be found through the “About This Mac” command in the Apple menu.
- If MacTerm quits, a Console crash log (see below).
- Information on what you were doing when a problem was found, such as: running a particular command, or opening or closing a window.
- If you have tried different scenarios, mention what did or did not see the issue.
- If the problem seems related to preferences, it can help to “Export” those settings to a file (this can be done from the Preferences window, while looking at a particular collection of settings: use the gear icon in the bottom corner).
Finding Crash Logs
Once enabled, logs appear in Home ➞ Library ➞ Logs ➞ DiagnosticReports. Look for files that begin with “MacTerm” and include the most recent one when reporting a crashing bug.
The Finder does not show the Library folder by default. To see it, hold down the Option key while opening the Go menu in the Finder.