Welcome to the eXpanda Install Guide. This page will give you some explanation about the installation of eXpanda.
eXpanda is a perl library, so that you can run eXpanda in your perl script. Before using this software, you need to install some dependent libraries and perl modules by CPAN.

First you need to install "expat" which is the xml parser.
If you already have "expat" in your system, skip and go on to the next section._ You can download expat from:

	http://sourceforge.net/projects/expat/

Decompress archive and move to the expat directory after downloading from the site. First of all, run the configration script to build "expat" from a source by typing :

	./configure

After you succeed the configuration, you can build and install by running "make" and "make install" command.

	make

	make install   #or "sudo make install"

Note that you need to have write permission into the directories into which things will be installed.

Following Expat installation, go to next step.

To configure this module, move to the directory that contains the README file, and type the following:

NOTE: Users of Mac OS X please take care; Please see Following instruction

	perl Makefile.PL

Alternatively, if you are not a root user or planning to install eXpanda somewhere other than your system's perl library directory, type the following:

	perl Makefile.PL PREFIX=/home/you/perl INSTALLDIRS=perl

	                               # or simply type "perl Makefile.PL"

While configuration, you may see this warnings:

	- LWP::UserAgent             ...missing.
	==> Auto-install the 1 mandatory module(s) from CPAN? [y] 

This warnings of dependency is settled by installing the modules manually or automatically. If you press [y], the installer will try to install modules automatically through your CPAN module in the next 'make' step. if you press [n], you have to manually install the modules from CPAN(http://cpan.org/).
To install dependency modules (if you selected) and install eXpanda, type:

	sudo make

If you are a super user, just type:

	make

You can also install only the dependant modules by typing:

	sudo make installdeps       # install dependencies only

When you type and start the make process, run CPAN module and try to download and install dependencies. Dependency module installation process does not complete always. If the make stops by some dependant error, you can check the installed/not installed dependencies by "checkdeps" option of make by typing:

	make checkdeps

After you finish all the dependencies installation, you should test this module before 'make install' by typing:

	make test

If you have write access to the installation directories, you may finally install eXpanda by typing:

	sudo make install		

First you need to download Graph::Layout::Aesthetic which is the dependent module of eXpanda.

    http://search.cpan.org/CPAN/authors/id/T/TH/THOSPEL/Graph-Layout-Aesthetic-0.12.tar.gz
  

Deflate tarball and change directory to Graph-Layout-Aesthetic, Open Graph-Layout-Aesthetic/include/aglo.h with your favorite editor.

    % cd Graph-Layout-Aethetic

    % emacs include/aglo.h

  

Edit line 17 of aglo.h , rewrite 'true' to 'True', 'false' to 'False'. Or Apply patch to aglo.h

   # Before
   L17: typedef enum aglo_boolean {
   L18: false=0,                      # <= This line cause Error in gcc version 4.0.1 (Apple Inc. build 5465)
   L19: true=!false                   # <= This line cause Error in gcc version 4.0.1 (Apple Inc. build 5465)
   L20: } aglo_boolean;

   # After
   L17: typedef enum aglo_boolean {
   L18: False=0,                      # <= 'false' to 'False'
   L19: True=!false                   # <= 'true' to 'True'
   L20: } aglo_boolean;
  

Build and Install Graph::Layout::Aethetic, continue installing eXpanda

    # in Graph-Layout-Aethetic Directory.

    % perl Makefile.PL                   # Set PREFIX if you don't have root permission.

    % make             

    % sudo make install                  # 'make install' if you don't have root permission.
  

1. Make directory in home directory for libraries installation

eg.

%mkdir /path/to/directory

2. Add the directory to $PERL5LIB by writing in your shell configuration file. If you are using bash shell, please write in ".bashrc" file as follows:

in .bashrc
$PERL5LIB="path/to/directory":$PERL5LIB;

[NOTICE]

This configure may be not recursive , so if you had some trouble with "@INC", you can solve this by add all directory in directory what you made at first time.

in .bahsrc
$PERL5LIB="path/to/directory":$PERL5LIB;
$PERL5LIB="path/to/directory/lib":$PERL5LIB;
$PERL5LIB="path/to/directory/lib/":$PERL5LIB;
....

3 Then, download and decompress tarball, change directory to eXpanda-1.0.x

4. running Makefile.PL with PREFIX to the directory.

eg.

%perl Makefile.pl PREFIX=~/path/to/directory 

5. Running make, if installer find missing perl module, automatically install in PREFIX directory, so you have to have permission of PREFIX directory

6 make install

eXpanda requires the following perl modules.

• Class::Struct
• LWP::UserAgent
• SOAP::Lite
• XML::Twig
• SVG
• Graph::Layout::Aesthetic