Frequently Asked Questions
JabRef & Linux
Q: Does JabRef run under free Java (Classpath, Kaffee, GCJ, etc.)?
A: As far as we know, it has not yet succeeded running JabRef on these free JVMs, due of our dependencies. At the time of writing this (2006-09-13), version 0.92 of Classpath was used. However, JabRef is reported to run nicely on the IcedTea runtime, which is based on the OpenJDK built with GNU Classpath to fill in missing classes. Please let us know if newer versions give different results. If you have an idea or the expertise to make JabRef work under Classpath let us know.
Q: JabRef does not start under Linux! What can I do?
A: JabRef works fine under Linux if you use a Java Runtime Environment (JRE) from Sun version 1.5 and newer. If running JabRef fails to start nevertheless do the following for troubleshooting:
Run
java --version
from the command line. If this does not report to be a product from Sun Microsystems (for instance tells you that it is a GCJ VM) even if you have installed the Sun JVM then you need to change your setup. This is highly dependent on your distribution, so we cannot give exact advise for everybody.
Under Debian/Ubuntu it works like this (you need to have admin privileges):
sudo update-alternatives --config java
In the dialog that appears select the Sun JDK or JRE. Alternatively you can also search for the java executable and run that directly. In Ubuntu you can find Java at
/usr/lib/jvm/java-1.5.0-sun/jre/bin/java
If you do not have root-access on the machine you can install the Sun JRE in your home but need to make sure that you run the correct java executable. For instance if you installed the JRE into a folder called
java
in your home try
~/java/jre/bin/java -jar JabRef-2.1.jar
Q: I am on Debian/Ubuntu and clicking on the JabRef icon works, but I cannot start JabRef from the command line. What is wrong?
A: You have several Java Virtual Machines installed and under the command line the wrong one is chosen. Have a look at the previous question that tells you how to change the virtual machine used.
For Ubuntu you may also have a look at the Ubuntu page on Java.
JabRef & Windows
Q: My virus-scanner tells me that JabRef is a virus. Is your server compromised?
A: No. But the windows installer uses the Nullsoft Scriptable Install System (NSIS) version 2.18 (as of JabRef 2.1) which unfortunately creates installers that are thought to be viruses by some virus-scanners.
See the discussion in the NSIS forum or the list of false positives with NSIS for details.
As a work-around and if you are afraid to use the installer you can always use the platform independent jar and run it from the command line:
java -jar JabRef-X.jar
where 'X' is the JabRef version.
Since JabRef is open source, you can of course also download the source code and compile it yourself.
If you want to do anything about this issue, please report this bug with your virus scanner.
Developers
Q: How can I join the JabRef project?
A: Sign up with sourceforge and write an email to our project leader Morten O. Alver. Good ways to start with the project is to help with fixing bugs (maybe some that trouble you yourself ;-), writing FAQs, helping users in the forum and translating JabRef into another language.
Q: I have a patch that I want to contribute. Where can I do that?
A: Please send patches to the Patch-Tracker on Sourceforge and write a quick entry on the user or developer list.
General usage
Q: How do I prevent JabRef from introducing line breaks in certain fields (such as "title") when saving the .bib file?
A: Open Tools -> Preferences. In the "General" panel, you will find an option called "Do not wrap the following fields when saving". This option contains a semicolon-separated list of field names. Any field you add to this list will always be stored without introduction of line breaks.
Other
Q: My question is not answered here. What can I do?
A: After consulting the documentation and checking whether your question has been answered in the forum, check the bug-tracker if this has been discussed before (filter for Any Bugs). If you cannot find anything in an reasonable amount of time write a message in the forum, problems usually get resolved rather quickly (at least we hope so ;-).
Q: There is a mistake in this FAQ, a dead link or I have written a better/new explanation for a question!
A: Let us know as soon as possible! => JabRef User Forum