Troubleshooting: Difference between revisions

From FreeMind
Jump to navigationJump to search
(+section on java)
 
(9 intermediate revisions by 3 users not shown)
Line 1: Line 1:
==Linux==
==Linux==
See [[FreeMind on Linux]].
For troubleshooting on Linux, see [[FreeMind on Linux]].


==Windows==
==Windows==
When encountering a problem with the 0.8.0 version, please run FreeMind from <tt>freemind.bat</tt> to see all the logged errors.


When encountering a problem with a 0.9.0 beta version, please first see whether any errors have been logged by FreeMind into the error log. ''TODO: The location of error log.''
Not all issues that you encounter are a result of a bug in FreeMind. There may be a problem with your Java installation.


Please report the bugs into the bug tracker or into Open Discussion forum. The information helpful for the diagnosis includes:
Java installation: You may need to check you Java installation, by entering a DOS console, and typing "java -version" to see whether Java is correctly installed and in what Java version.
* Your Java version
* The content of the error log


''TODO: Add links to the bug tracker and to the forum.''
Looking at error log: The first place to look at when you suspect a FreeMind bug is the ''error log''. With FreeMind 0.8.0, run FreeMind from <tt>freemind.bat</tt> to see all the logged errors in the DOS console. With FreeMind 0.9.0 beta, the error log is a text file located at ".freemind" subfolder of your home folder; the name of the error log file is one of "log.0", "log.1", etc.


See also [[Getting started as a tester]].
Java problems: To find out whether your problem is caused by Java virtual machine, you may try another Java Swing application, such as JEdit. If your problem is also shown by JEdit, it is more likely to be a Java one. Trying out the Eclipse development environment does not help, as Eclipse, although a Java application, is not a Swing application.
 
Please report bugs to [http://sourceforge.net/tracker/?atid=107118&group_id=7118&func=browse SourceForge's Bug Tracker]; see also [[Reporting bugs]].
 
==Java==
FreeMind is written in Java, a programming language whose executables need a virtual machine to run.
 
The official Java virtual machine is the one from Oracle, yet there are some other Java virtual machines. When FreeMind is run using another vitual machine than the one from Oracle, it may shows various glitches. One of the virtual machines that sometimes makes trouble is OpenJDK: see [[OpenJDK]].
 
To check which Java virtual machine is installed on your computer, type "java -version" into a console of your operating system (MS DOS console in Windows, Bash terminal in Linux, and the like).
 
==See also==
* [[Reporting bugs]]
* [[Asked questions#Installation]]
 
[[Category:Documentation]]

Latest revision as of 15:07, 25 May 2011

Linux

For troubleshooting on Linux, see FreeMind on Linux.

Windows

Not all issues that you encounter are a result of a bug in FreeMind. There may be a problem with your Java installation.

Java installation: You may need to check you Java installation, by entering a DOS console, and typing "java -version" to see whether Java is correctly installed and in what Java version.

Looking at error log: The first place to look at when you suspect a FreeMind bug is the error log. With FreeMind 0.8.0, run FreeMind from freemind.bat to see all the logged errors in the DOS console. With FreeMind 0.9.0 beta, the error log is a text file located at ".freemind" subfolder of your home folder; the name of the error log file is one of "log.0", "log.1", etc.

Java problems: To find out whether your problem is caused by Java virtual machine, you may try another Java Swing application, such as JEdit. If your problem is also shown by JEdit, it is more likely to be a Java one. Trying out the Eclipse development environment does not help, as Eclipse, although a Java application, is not a Swing application.

Please report bugs to SourceForge's Bug Tracker; see also Reporting bugs.

Java

FreeMind is written in Java, a programming language whose executables need a virtual machine to run.

The official Java virtual machine is the one from Oracle, yet there are some other Java virtual machines. When FreeMind is run using another vitual machine than the one from Oracle, it may shows various glitches. One of the virtual machines that sometimes makes trouble is OpenJDK: see OpenJDK.

To check which Java virtual machine is installed on your computer, type "java -version" into a console of your operating system (MS DOS console in Windows, Bash terminal in Linux, and the like).

See also