Prerequisites:
==============

Almara requires the following packages:

- The Gtk2 (>2.4), GLib2, Pango, and Atk devel packages.

- The ImageMagick (preferably >6.0) , libexif, libjpeg6b, TIFF, 
  and PNG image loading devel packages. 
  You most likely have these installed on your system already. 
  If not, these libraries are available from:

    http://www.imagemagick.org/
    http://www.gtk.org/
    http://www.libtiff.org/
    http://www.libpng.org/
    http://www.ijg.org/


Getting almara sources:
=======================

Current release:

 - The sources can be downloaded from http://sourceforge.net/projects/almara/ .

Current development version is accessible from the Almara Arch repository:

 - You will need tla (Arch Revision Control System, a modern 
   replacement of CVS), available from http://www.gnuarch.org/ ).

   % tla register-archive almara-devel@nongnu.org--almara \
         http://almara.sourceforge.net/arch/
   % tla get -A almara-devel@nongnu.org--almara \
         almara--project--0.1 almara
   % cd almara


Simple installation procedure:
==============================

  % gzip -cd almara-*.tar.gz | tar xvf -   # unpack the sources
  % cd almara-*                            # change to the toplevel directory

[ root can simply run the following ]
  % ./configure                            # run the `configure' script
  % make                                   # build almara
  % make install                           # root install of almara 

[ non root users will have to run the following ]
  % ./configure --prefix=abs_install_dir   # run the `configure' script
  % make                                   # build almara
  % make install                           # user install almara
  % cd abs_install_dir
  % PATH=./bin:$PATH
  % export PATH 

  % almara


Doxygen developer documentation:
================================

  % cd almara*/docs
  % make doxy
  % cd html
  % lynx index.html
  
Building SUSE rpms:
===================

- Requires at least SUSE Linux 9.1 (check /etc/SuSE-release) with 
  the `build' package installed. It is available from: 

    ftp://ftp.suse.com/pub/suse/

[ you have to be root ]
  % cd almara*/
  % ./configure				# run the `configure' script
  % make dist-bzip2			# make distribution sources
  % mv almara-*.tar.bz2 contrib/suse/   # move distribution sources to 
                                        # the suse directory
  % cd contrib/suse/			# change to the suse directory
  % BUILD_ROOT=/var/tmp/mybuildroot	    # set the directory where the 
                                        # chroot system will be installed
  % build				        # build SUSE rpms in the chroot environment.
  % ls /var/tmp/mybuildroot/usr/src/packages/RPMS/*.rpm
					# list of built rpms

Building Debian debs:
=====================

- Refer to contrib/debian/README


Building under Cygwin:
======================

- Requires Cygwin to be installed with the following configuration:

  Base    complete
  Devel   complete
  Graphics
    - ImageMagick
    - gtk-2-x11, jasper, libjpeg (by default)
  Interpreters
    - python
  Libs
    - glib
    - gtk+: gimp toolkit lib
    - libexif
    - libgnomeprint (+ libgnomeprintui)
    - regex
  X11

  Cygwin is available from: 

    http://www.cygwin.com

[ goto the cygwin shell ]
[ follow the `Simple installation procedure:' above ]

  % export DISPLAY=localhost:0.0
  % X&
  % almara