
INSTALL GUIDE

  This is a quickly made installation manuel...
  There are a couple of things you must do before you
  can use this software.

1. Software Dependencies

  First thing is to check wether you have all software needed.

  You need: 
    a) a working MySQL installation
    b) Java 1.2 installed

  And optionally:
    c) KMySql 1.2.1 (or beter) + mysql plugin 
       (or any other similar interface, though field attributes
        below are taken from KMySQL, but should be similar)

2. Setup

  These things are to adjust paths and MySQL login:

  a) adapt jrefs_prefs.txt to reflect Java1.2 location
  b) adapt jrefs_prefs.txt to your MySQL login

  c) adapt Makefile to reflect the file you want to use as input
  
  d) IMPORTANT !!!! adapt your MySQL database to be able to store 
     the references! You need this setup (all names are case 
     sensitive):

     DATABASE: references
     TABLES: references -> articles
             references -> authors
             references -> journals

     These tables can be created by running 'make create' with the Makefile
     in this directory.

     The articles table has these fields:

       name            type   null key   default   extra
       
       id              int         pri   0         auto_increment
       title           text   yes
       volumenumber    text   yes
       issuenumber     text   yes
       pagenumbers     text   yes
       DOI             text   yes
       publicationdate text   yes
       journalecode    text   yes

     The authors table has these fields:

       name            type   null key   default   extra

       id              int         pri   0         auto_increment
       articleID       int               0
       firstname       text   yes
       surname         text   yes

     The journals table has these fields:

       name            type   null key   default   extra

       id              int         pri   0         auto_increment
       ISSN            text   yes
       title           text   yes
       abbreviation    text   yes
       code            text   yes

3. Running

  Software can at this moment be run with the commands:

  - make set              to put articles in the SQL database
  - make get              to get articles from the SQL database
  - make clear            to clear the SQL databases content
  - make number           to autonumber a JRefenrences extended
                          DocBook document
