Development

jOrgan is developed in the Java programming language. The project is hosted on http://sourceforge.net/projects/jorgan.

Version Control

If you want to participate in the development you can access the program's source code from our CVS repository:

:pserver:anonymous@jorgan.cvs.sourceforge.net:/cvsroot/jorgan

For a short look you might want to browse the CVS Repository.

jOrgan is devided into the following modules:

With the following command you can get a working copy of the program's source code:

cvs -d:pserver:anonymous@jorgan.cvs.sourceforge.net:/cvsroot/jorgan co module

For module you have to substitute the module you would like to work on.

Building from Source

To build a module your system has to fulfill the following prerequisites:

  • JDK 1.6
  • Apache Ant (including optional tasks)
  • GCC (required by extensions using native code)

Now start Ant in the module's directory to build it:

ant

Bugs

No program is free of bugs, neither is jOrgan.

Garbage collector

If you experience sluginess with the program, the activity of the garbarge collector might give use some clues. Please start jOrgan with the following parameters:

java -verbose:gc -jar jorgan.jar

Thread dump

If you encounter program freezes, this might caused by threading problems. Please start jOrgan with the following parameters:

java -jar jorgan.jar

As soon as jOrgan becomes unresponsive, press CTRL-PAUSE on the command line to generate a thread dump.

Heap dump

For later memory usage analysis it might be necessary to have a heap dump available. For this start jOrgan with the hprof agent enabled:

java -agentlib:hprof=format=b -jar jorgan.jar

On program exit the file java.hprof will be generated which we'll be able to analyse later on.

development.txt · Last modified: 2009/08/06 16:53 by svenmeier
Get jOrgan at SourceForge.net. Fast, secure and Free Open Source software downloads www.chimeric.de Valid CSS Driven by DokuWiki do yourself a favour and use a real browser - get firefox!! Recent changes RSS feed Valid XHTML 1.0