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.
Why Do This?
Software can be used in many different ways and it is not possible for any one person to encounter every situation. In other words, your message may be the first time that we know about an issue, even if it seems “obvious” that we would have seen it.
It’s important to be specific, as the details are often crucial for replicating or even understanding a problem. See “Useful Things to Include in Bug Reports” below.
Please do not worry about reporting something we may have seen before. In fact, seeing many reports about the same problem can help when finding a complete solution.
You may request a quick fix, and every effort is made to solve problems immediately. Note however that the nature of a problem (or other factors) sometimes prevents issues from being solved right away.
And lastly, since MacTerm is free, the only real way to “pay” for it is by helping out. If you spend a moment to identify problems that you face, the project is better for it!
Useful Things to Include in Bug Reports
- The MacTerm version (use Get Info in the Finder, or the About MacTerm command).
- The system version (for example, "OS 10.9.1").
- 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.
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.