----------------------------------
--- COMPILATION & INSTALLATION ---
----------------------------------

If you wish to generate a rpm file for pal instead of installing the
traditional way, see the RPM-BASED DISTRIBUTION section below.

=== DIRECTLY FROM SOURCE ===

1) Untar/unzip the pal-x.x.x.tgz package:
	tar -xzf pal-x.x.x.tgz
	cd pal-x.x.x/src

2) (Optional) By default, pal is installed into directories under
   /usr.  Some distributions usually install things to /usr/local.  To
   change where pal will be installed to, change the "prefix" line at
   the top of Makefile.defs.

3) Compile pal
	make

4) Install pal (must be root).  This will install several files
   including the binary, global calendar files and man page.
	make install

   (Special note to developers: Use "make install-no-rm" if you don't
   want the install process to attempt to remove old pal files.  This
   is useful for when creating a package file for package managers
   such as portage or rpm.)

5) (Optional) Delete pal-x.x.x.tgz and the pal-x.x.x directory.

6) Run pal by typing "pal" at the commandline.  This will create
   ~/.pal and ~/.pal/pal.conf if they do not already exist.

7) Customize
	- Explore settings in ~/.pal/pal.conf
	- You can create your own calendar file in ~/.pal and tell pal
          to load them by making changes to ~/.pal/pal.conf.  For more
          information see pal's man page.


TO UNINSTALL, run "make uninstall" in src while root.


=== RPM-BASED DISTRIBUTION (SUCH AS REDHAT) ===
        (.tgz -> .src.rpm -> .rpm)

1) Generate the .src.rpm file.  As root, run:
	rpmbuild -ts pal-x.x.x.tgz

2) Compile the .src.rpm file to a .rpm file.  As root, run (where
   SRCRPMFILE is the filename that was displayed in while running the
   command in step 1):
	rpmbuild --rebuild SRCRPMFILE

3) Install as root.  Where RPMFILE is the filename displayed at the
   end of the output of the step 2.

   If installing for the first time:
	rpm -ivh RPMFILE

   If upgrading a previous installation:
	rpm -Uvh RPMFILE

4) (Optional) Remove unneeded files: pal-x.x.x.tgz, RPMFILE and
   SRCRPMFILE

5) Follow steps 6 and 7 in the section above (Installing DIRECTLY FROM
   SOURCE).


TO UNINSTALL, run the following command as root:
	rpm -e pal

