Development
Contact
Public discussion about referencer takes place on mailing list. If you have a specific bug to report then please help your maintainer by filing it in launchpad
For anything which you'd prefer not to discuss in public, you can also contact the main author directly: jcspray at icculus.org
Hacking
C++
Most of Referencer is written in C++, using the gtkmm toolkit as well as a number of other libraries.
Python
Referencer may be readily extented by writing a plugin in python. The plugin API is documented in Writing plugins for Referencer (PDF).
Mercurial
To get the source code:hg clone http://hg.icculus.org/jcspray/referencer/
Web view of the repository:http://hg.icculus.org/jcspray/referencer/
Mercurial is used for referencer development. It's a distributed revision control system. If you've used git, it's a lot like that. Debian/Ubuntu users can apt-get install mercurial. There's some good documentation.
You can still send in patches the old fashioned way with hg diff (having done hg pull; hg update recently, please). Even better, if you're comfortable with hg serveing your repository for me to pull from, then so am I.
Building
The build dependencies on ubuntu are: 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 python2.5-dev
.
To work from mercurial you'll also need: mercurial gnome-common automake1.9
. Note that when building from mercurial ./autogen.sh needs to be run before ./configure.
Translation
Referencer uses launchpad.net for translation. After registering for a launchpad.net account, the web interface should allow translation without any specialist knowledge. Please report any problems to the mailing list.
Bugs
Referencer uses launchpad.net for bug tracking.