
Referencer
==========
A document organiser and bibliography manager

For help: There is a mailing list.  Send a blank email to referencer-subscribe@icculus.org to subscribe.  To post to the list, send messages to referencer@icculus.org.

Web page: http://icculus.org/referencer/

Author: John Spray (jcspray at icculus.org)

Building
========

A simple './configure && make' should build the referencer executable, if the dependencies are present.

The build dependencies are:
	g++
	poppler-glib
	gtkmm-2.4
	libgnomeuimm-2.6 
	gnome-vfsmm-2.6
	libglademm-2.4
	gconfmm-2.6
	boost_regex
	intltool

On Ubuntu 6.10 (or 6.04 LTS), all of these may be obtained by running the following command:
	sudo apt-get install build-essential libpoppler-glib-dev libgtkmm-2.4-dev libgnomeuimm-2.6-dev libgnome-vfsmm-2.6-dev libglademm-2.4-dev libgconfmm-2.6-dev libboost-regex-dev intltool
	
(note that libboost-regex-dev is in the 'universe' repository, which is not enabled in a default Ubuntu install.  See https://help.ubuntu.com/ubuntu/desktopguide/C/extra-repositories.html)

On Fedora Core 5, you will need to do:
	yum install gtkmm24-devel libgnomeuimm26-devel gnome-vfsmm26-devel libglademm24-devel gconfmm26-devel poppler-devel gcc-c++ boost-devel



Installing
==========

Referencer may be run in-place from the build directory (type src/referencer) for convenient evaluation or testing.  Alternatively, it maybe installed systemwide: running 'make install' should install Referencer into the /usr/local prefix by default, use "--prefix /somewhere" when running ./configure to install it elsewhere.

Attributions
============

libbibutils is copied from the bibutils 3.27 package, Copyright © Chris Putnam 2005
The wvConvertUnicodeToLaTeX function is based on the function of the same name in the wv library, Copyright © Caolan McNamara, Dom Lachowicz, and others
The eel_* functions are copied from libeel, Copyright © 2000 Eazel, Inc.
The art_rgb_run_alpha function is copied from libart, Copyright © Raph Levien 1998
The thumbnail_frame.png graphic is copied from Nautilus, Copyright © 2003 Redhat, Inc
ucompose.hpp is from the string composition library, Copyright © 2003 Ole Laursen, licensed under the LGPL
The ev-tooltip class is Copyright (C) 2004 Red Hat, Inc
The sexy-icon-entry class is Copyright (C) 2004-2006 Christian Hammond

Apart from the aforementioned items, Referencer is Copyright © 2007 John Spray
Referencer is released under the terms of the GNU GPLv2 (see COPYING)
