view release on metacpan or  search on metacpan

lib/App/installguide.pod  view on Meta::CPAN

are in your environment.

=head2 Set Up a Development Environment (Windows)

See L<App::installguide::win32>.

=head1 INSTALL DEPENDENT SOFTWARE

=head2 Install Dependent Modules from CPAN

  perl -MCPAN -e shell
  cpan> install Date::Parse
  cpan> install Date::Format
  cpan> install Data::Dumper
  cpan> install Compress::Zlib
  cpan> install MIME::Base64
  cpan> install Storable
  cpan> install Exception::Class
  cpan> install Class::MethodMaker
  cpan> install Hook::LexWrap
  cpan> install Aspect
  cpan> exit

If anyone finds other dependent modules, please let me know.

=head1 GET App SOFTWARE

=head2 Get App From CPAN

The App is not yet on CPAN.
Try one of the other methods.

=head2 Get App from CVS (to develop App)

You should use this method if you *do* have commit access
on the App CVS repository.  (Note, substitute your CVS
user id for "LOGIN" below.)

  cd $PREFIX/src
  cvs -d :pserver:LOGIN@cvs.perl.org:/cvs/public login
  [enter your perl.org password]
  cvs -d :pserver:LOGIN@cvs.perl.org:/cvs/public co p5ee

Later, when you want to refresh your directory with the latest software
from CVS, you can repeat the same commands or you can do the following.

  cd $PREFIX/src/p5ee
  cvs update -dP

See a CVS document to find out how to create, delete, and modify files
and then submit changes.

=head2 Get App from CVS (anonymous, read-only access to latest App)

You should use this method if you do *not* have commit access
on the App CVS repository but you do want to stay up to date with the
latest App software (recommended, because there are no releases yet).

  cd $PREFIX/src
  cvs -d :pserver:anonymous@cvs.perl.org:/cvs/public login
  [press enter at the password prompt]
  cvs -d :pserver:anonymous@cvs.perl.org:/cvs/public co p5ee

Later, when you want to refresh your directory with the latest software
from CVS, you can repeat the same commands or you can do the following.

  cd $PREFIX/src/p5ee
  cvs update -dP

The "cvs update" method is the preferred way to get updates.

=head2 Get App from a Snapshot

If you do not have CVS on your system, you can still get reasonably 
recent sources from http://cvs.perl.org/snapshots/p5ee/.

  cd $PREFIX/src
  wget -O tar/p5ee-latest.tar.gz http://cvs.perl.org/snapshots/p5ee/p5ee-latest.tar.gz
  gunzip < tar/p5ee-latest.tar.gz | tar xvf -

If you don't have "wget" (http://www.gnu.org/software/wget/wget.html),
you can use Perl's own LWP.

  cd $PREFIX/src
  perl -MLWP::Simple -e 'getstore("http://cvs.perl.org/snapshots/p5ee/p5ee-latest.tar.gz", "tar/p5ee-latest.tar.gz")'
  gunzip < tar/p5ee-latest.tar.gz | tar xvf -

=head1 INSTALL App SOFTWARE

=head2 Install Perl Modules, Man Pages, HTML Pages

  cd $PREFIX/src/p5ee/App
  make
  make test    (these may or may not work. the tests themselves are under development.)
  make install

=head2 Edit Main Config File

You will need to do this one time.

  cd $PREFIX/src/p5ee/App-/cgi-bin
  cp demo.conf p5ee.conf
  vi p5ee.conf
  # edit the following lines:
  #   * perlinc       = list of perl include paths
  #   * scriptDir     = absolute path for directory which the "p5x" script will be in
  #   * scriptUrlDir  = path from http://localhost to the scriptDir
  #   * htmlDir       = absolute path for the "htdocs" directory
  #   * htmlUrlDir    = path from http://localhost to the htmlDir
  #   * ttTemplateDir = apsolute path for the "templates" directory

=head2 Make HTML Pages Visible on the Webserver

=head2 Make CGI Programs Visible on the Webserver

=cut