Help for References

This file contains basic information on program References.

Contents:

What does References do?
How do I run the program?
How do I use the program
Inicialization files(customization)


What does References do?

References is a program for keeping track of articles, books, reports, etc.... References uses BibTeX stardards to write descriptions of articles, books,..., to an ASCII file. This file has a *.BIB extension and is interpreted by LateX when creating bibliographic databases for a LateX document. Not all BibTeX commands are jet supported, but the program works satisfactory. One thing to be carefull about:

@STRING      command is interpreted and than the abbreviation is replaced with the FULL text! This is because the data is stored in a graphical interface.


How do I run the program?

References is written in Java. That means that you have to have an intepreter for Java programs to be able tu run Java programs. Usefull link is:

http://www.java.sun.com/

If you use MS Windows operating system, you can either download Java intepreter for MS Windows from the

http://www.java.sun.com/ or you can run the References using MS build in interpreter “jview”. Jview has to be at

least version 5.00.3194 or later!!! Older versions do not run the Java programs correctly.

To start References, go to DOS-prompt and change the directory to in which *.jar files are stored. Then in DOS-prompt type:

jview /cp:a C:\Progra~1\References\References.jar /cp:a C:\Progra~1\References\swing1.1.jar References.Application

where the C:\Progra~1\References is the directory where you unpacked the downloaded references.zip file. If you this directory to for example:

D:\Temp

Then you have to change the command to reflect your directory:

jview /cp:a D:\Temp\References.jar /cp:a D:\Temp\swing1.1.jar References.Application

If at command prompt you get the following error

java.lang.NoClassDefFoundError: javax/swing/UIManager at
References/Application.main

Error: java.lang.NoClassDefFoundError: javax/swing/UIManager

then you are must probably using Windows NT4.0, Windows 95 or Windows 98 platform. In these platforms the program jview that is used to run the java programs in Windows does not work very well. So you have to update the jview to the version of at least 5.00.3194 or later. Go to the http://www.microsoft.com and look for the java engine update (jview). Install it and you should be able to run the References.


How do I use the program?

Start the program References. Then go to the File menu and press "New". This will create a new document for keeping bibliography items. On the tree select the leaf that corresponds to the bibliography you intend to input. On the right part of the screen the input fields become visible. Some of them are labeled in red. This fields are mandatory!!! When you have inputed all the data press "ADD" or "APPLY" (if the data has only been changed). If you change the data and do not press the "APPLY" button changes will be lost!!! At the end you have to save the file. Go to the File-->Save and save the file with the *.bib extension. For searching through the data press Ctrl+F and input the keyword to be found in the data.


Inicialization files(customization)

You can customize some things. The customizable things are written in the INI directory and are separate for each user. For example the user settings for user Administrator are in the file Administrator.ini. If you want to change the directory where Open dialog looks for the *.bib files, you change the Data_dir value. For example:

Data_dir=C:\Temp

will always change directory to the C:\Temp before opening Open file dialog.