I.	Dependencies
		A. Base Package
		B. Optional Viewing Widgets
		C. Optional Sound Support
		D. Global Password Encryption
II.	OS Specific Problems
		A. HPUX
III.	General Compiling FAQ
IV.	Enabling Features
		A. Global Password Encryption
V.	Distribution FAQ
		A. RedHat and other RPM based
		B. Debian
		C. Tar/?zip?


I.	Dependencies

		Alot of confusion over what other packages you need to compile 
	Archimedes has given people a rough time.  To help clarify that, here 
	is a list of dependencies that you will need to compile Archimedes.

	To see if you have a particular package installed, you can optionally
	query your package management system.  

	In RedHat and other RPM based systems, rpm -q PACKAGE
	In Debian, dpkg -l PACKAGE
	Other systems can try variations of the Unix where, locate, or find 
		commands. Please see your local man pages for information on
		how to use these commands.

	A.	Base Package
			ANSI C Compiler and associated devel packages and libraries
			ANSI C++ Compiler and associated devel packages and libraries
			DBM (gdbm or ndbm will work, you will also need the associated
						devel package)
			gtk+
			gtk+-devel
			glib
			glib-devel
			libxml
			libglade
			libglade-devel
			glade
			automake
			autoconf
			libtool

	B.	Optional Viewing Widgets (Optional)
			gtkxmhtml (Typically a part of the gnome-libs package)
			gtkxmhtml-devel (Typically a part of the gnome-libs-devel package)
		
			mozilla
			mozilla-devel
		
			gtkhtml
			gtkhtml-devel

	C.	Sound Support (Optional)
			ESound, ESound-devel
			NAS, NAS-devel (NAS: Network Audio Support)

	D.	Global Password Encryption (Optional)
			libmcrypt, libmcrypt-devel (Only version 2.4.x supported)


II.	OS Specific Problems

	A. HPUX - This OS has had problems with the X11 headers not being
		suitable for use with a C++ compiler.  We do a check in the configure
		script to try to catch this problem.  Most systems, including other
		OS that HPUX, can solve this problem by adding -pendantic to the
		CFLAGS and CXXFLAGS lines in the mail/Makefile and ui/Makefile
		if configure fails to do so.

III.	General Compiling FAQ

		This section provides some answers to some common problems and
	questions.  Please feel free to send me mail with any additions to this
	list - either problems you are still having or tips that you would like
	to pass on.

	1. Q) When I run ./autogen.sh or ./configure it seems like I have
		an infinite loop that the configure script never seems to exit
		from. 
	   A) Most likely you have a clock skew. To fix this use the "rdate"
		utility (rdate -s somehost.com), followed by the "clock" 
		(clock -w).  You might find it necessary to checkout a new
		source tree or use "touch" to totally take care of the problem.
		Man pages are available for each package on most operating 
		systems.

	2. Q) I have errors when running Bourne or Bash scripts, most noteablely
		libglade-gen.sh.

	   A) This is a wierd problem that we don't have a real answer for, but
		we do have a solution. Edit the file giving problems by adding
		the double quotation mark around each varaible in a file test. 
		An Example is as follows:
			Original 
				if [ ! -f $GLADE_FILE ] ; then
			Modified
				if [ ! -f "$GLADE_FILE" ] ; then
	3. Q) When compiling the gtkhtml module I get errors stating that
		gdk-pixbuf/gdk-pixbuf.h does not exist.

	   A) GtkHTML-devel has a bad dependancy list, it doesn't force
		you to install gdk-pixbuf-devel.  Download gdk-pixbuf-devel
		and install it.

	4. Q) When compiling the gtkhtml module I get errors stating that
		libgnomeprint/gnome-print.h does not exist.

	   A) GtkHTML-devel has a bad dependancy list, it doesn't force
		you to install gnome-print-devel.  Download gnome-print-devel
		and install it.

	5. Q) When I try to compile I get errors about not being able to
		find libglade_support.h.

	   A) You have to run the runme script or autogen.sh.  These scripts
		will automatically call make libglade_support.h that will
		generate the header file.

	6. Q) When I try to run ./configure I get warnings about install-sh
		mkinstalldirs or missing not being found.

	   A) These warnings can be ignored as automake and autoconf will
		automatically make these files for you.

	7. Q) When trying to run libglade-gen.sh I get errors like:
		../../src/glade/libglade-gen.sh: test: argument expected

	   A) This error can be fixed by adding double quotes (") around each
		test variable.  As an example

			if [ -f $whatever ] ; then

		has to be changed to.

			if [ -f "$whatever" ] ; then

	8. Q) When trying to run ./runme on SuSe-Linux I get errors:
		AM_PATH_LIBGLADE does not exists.
		
	     A) Copy the files /opt/gnome/share/aclocal/ to /usr/share/aclocal
	            and make a directory-link from to it.   	

	8. Q) When trying to run ./runme on SuSe-Linux I get errors:
		AM_PATH_LIBGLADE does not exists.
		
	     A) Copy the files /opt/gnome/share/aclocal/ to /usr/share/aclocal
	            and make a directory-link from to it.   	

IV.	Enabling Features
		A. Global Password Encryption
			To build a Global Password Encryption capable executable, you will
				need to download and install libmcrypt.  

			libmcrypt Information:
				URL - http://mcrypt.hellug.gr/
				RPMS - ftp://ftp.fazekas.hu/pub/linux/rpms/mcrypt
				     -(or search at http://www.rpmfind.net)
			
			It is important to note, that we no longer support libmcrypt version 
				< 2.4.  You must now use a 2.4.x version.	Please
				see the libmcrypt documentation on building and installing
				this library and needed development files.

			Once libmcrypt is installed you can then run the configure script with
				the --enable-gpasswd option.  When configure is finished build
				and install Archimedes.

				% cd archimedes
				% ./configure --enable-gpasswd
				% make
				% make install

V.	Distribution FAQ
	A. RedHat and other RPM based
		i) How do I make an RPM?
			The following steps can be taken after a CVS checkout
				(see http://archimedes.sourceforge.net/cvs.html
				for more information).
			% cd archimedes
			% ./autogen.sh
			% ./configure
			% make dist
			% gunzip -d archimedes-?.?.?.tar.gz | bzip2 > archimedes-0.0.0.tar.bz2
			% rpm -ta archimedes-0.0.0.tar.bz2

	B. Debian
	C. Tar/?zip?
