GITK -
Generalized Interface Toolkit

GITK -
Generalized Interface Toolkit

GITK -
Generalized Interface Toolkit

Sourceforge Page

Development takes place at http://sourceforge.net/projects/gitk/.

CVS

To login, do: When you are asked for a password, just hit return.
To check out the source, do from the source directory (co is short for commit): To updated the source, do from within each directory (up is short for update):

Dependencies

Although GITK strives to be portable, a few dependencies exists.

• glib-2.X (www.gtk.org)
• libxml2-2.4.X (www.libxml.org)
• libxslt-1.0.X (www.libxml.org)
• libiconv 1.9.1 (ftp.gnu.org)

When you are using a linux distribution, make sure you have the *-devel packages installed as well.

Building

Building the GITK packages requires fairly up-to-date version of certain development tools (packages in [ ] are not required, but suggested). I use :

• autoconf 2.54 (ftp.gnu.org)
• automake 1.7 (ftp.gnu.org)
• [check 0.8.0 (check.sourceforge.net) - only for unit tests]
• gettext 0.12.1 (ftp.gnu.org)
• intltool 0.27 (ftp.gnome.org)
• libtool 1.4 (ftp.gnu.org)
• pkgconfig-X.X (www.gnome.org)

To build the cvs version of gitk-core, do (from within the directory): This runs all the tools like autoconf, automake, gettextize and more in the right order with the right settings for you.
Then type make and make install (depending on the choosen --prefix you might need root-privileges to do that) to build and install the package. Now make sure that $prefix/lib/pkgconfig is part of the environment variable $PKG_CONFIG_PATH.

To build the cvs version of gitk-renderers and the example, do (from within each directory): After that proceed with the steps described for the core package.

When building .tar.gz releases exchange the ./autogen.sh with ./configure.

Testing

To see if it works, you can do in gitk-core and if that runs through can try : Incase nothing happens, have a look at the file /tmp/gitk.log - all debug output goes there. During testing, it is convinient to use tail -f /tmp/gitk.log so that you can follow the output. The output is only there when not disabled via configure (which is enabled by default) and it uses ansi color.

Problems

One known problem is installing gitk locally (to /home/user). If the make install step is not carried out as root, the giml.dtd file can not be registered in the systemwide catalog. In this case one needs to execute this line as root:

Platforms

We currently build GITK on sparc/solaris2.6, on i586/linux (suse9.0) and i568/cygwin (windows). To compile we are using gcc versions 2.95.X and 3.3. GITK should build and work on most linux/unix platforms though.

Documentation

You can access the current api-docs online or download them as a .tar.gz-archive. The documentation is created using doxygen.
If you want to build it by yourself, change to the directory where all modules have been checked out and initialy create a dir called docs. Then run: The created documentation can be found in docs/html subfolder.