PerlCAD Installation
====================

To run PerlCAD you need to have a working version of PerlQt
installed on your system.  Copies can be obtained from
http://perlqt.sourceforge.net/ .  Though PerlQt is required to
run, I have not listed it as a dependency in the RPM spec file.
This will allow you to manually install it or upgrade it without
moving the PerlCAD sources.

PerlCAD can be installed in any one of three ways (I'm sure there
are more, but I've provided three):

1) Install via rpm.

   If you have downloaded this as an rpm, you can skip ahead for how
   to install it (although if you have an rpm you probably already
   know how and won't be seeing this notice anyway).

   I have included a spec file in the distribution.  You can manually
   untar a file and put the spec file in the proper place and the tar
   file in the proper place and then do rpm -bb
   /pathtospecs/perlcad.spec.

   OR

   You can simply type (as root):

   rpm -tb perlcad-0.0-1.tar.gz
 
   Of course you should replace 0.0-1 with whatever version you are
   installing.  This will build a rpm.  The rpm will be found in a
   location similar to
   /usr/src/RPM/RPMS/noarch/perlcad-0.0-1.noarch.rpm (RedHat users
   will get it at /usr/src/RedHat instead).  You may also see the
   location during the end of the rpm build on a line that says:
   "Wrote: /pathtorpm/perlcad-0.0-1.noarch.rpm".

   Once the rpm is built - or if you have downloaded it from another
   source, simply type:

   rpm -Uhv /pathtorpm/perlcad-0.0-1.noarch.rpm

   Or whatever method your distribution uses.

2) Use a standard perl module install as follows:

   perl Makefile.PL
   make
   make install

   I currently do not have any perl tests included.  The tests would
   only tell you what you would discover by running the application.
   There aren't too many standalone GUI applications on CPAN.

   Eventually I should have a working CPAN install available via "perl
   -MCPAN -e install Bundle::PerlCAD" or something.

3) Run install.sh

   I have included a simple sh that essentially runs step #2 for you.
   To use it type:

   sh install.sh

Of all of these methods - I would suggest using the rpm method as it
will allow for tracking of installed files which is usually a good
thing.

