Perforce Version Copy Utility (VCP) Build Installation Instructions

THESE INSTRUCTIONS ARE FOR SOLARIS x86 and sparc

The build installation scripts and structure provide a means for creating
repeatable builds of the vcp binaries. 

TODO: Extend scripts so they can also be used to install the VCP module 
into an existing version of Perl, with or without PAR.

System Requirments
    You must have the following software installed on your system in
    order to install and build the vcp binary:
    - GNU wget, expat, gcc, libgcc, libiconv

  If you don't have wget on the solaris platform, the use anonymous
  ftp to get it:
    ftp ftp.sunfreeware.com
    Username: anonymous
    Password: <hit return>
    cd pub/freeware/{intel|sparc}/{8|9}  // Platform and OS version
    bin
    get wget-1.9.1-sol{8|9}-{intel|sparc}-local.gz // Platform and OS version
    quit
    gunzip wget*.gz
    pkgadd -d wget*

  Make sure /usr/local/bin is in your path:
    PATH=/usr/local/bin:$PATH
    export PATH

  Retrieve and install the required packages as root using:
    mkdir packages
    cd packages
    sh build-solaris.sh

Creating a clean build of vcp binary on a Solaris platform

      % cd BUILD
      % sh retrieve.sh         # Retrieves about 17M bytes of files
      % sh build-modules.sh
      % # Copy the VCP release into the Tars directory
      % # e.g.: cp ../../dist/VCP-0.9.tar.gz Tars
      % sh build-vcp.sh

      You do not have to build perl since you're installing it from
      a prebuilt package. (Windows is similar in that it uses Active Perl
      as the base perl upon which the rest is built)

      At this point you will have a fresh Perl installed with only the 
      modules requires for PAR and VCP, VCP will be installed, and
      the new binary and html files installed into the dist directory

File List:
    Policy.sh - This file is configuration file for building Perl
    build-modules.sh - This script builds, tests, and installs required modules
    build-perl.sh - This script builds, tests, and installs Perl
    build-vcp.sh - This script builds, tests, and installs VCP
    gen-list.sh - This script generates the list of required modules for retrieval
    retrieve.sh - This script retrieves the requires modules from CPAN
    PodToHTML.Pod.HTML_Elements.pm.patch - Patch file for HTM_Elements.pm
    vcp.bin.build_vcp_executable.pl.patch - Patch file for build_vcp_executable.pl
    vcp.bin.vcp.patch - Patch file for vcp
    Tars/modules.list - List of required modules
    par-deps.list - Ordered list of required modules for PAR
    vcp-deps.list - Ordered list of required modules for VCP
    VCP-0.90.0.tar.gz - VCP 0.90 release

Directory Structure:
    Tars/  - Contains the modules.list file and all retrieved module tar bundles
  
    PerlModules/ - Installation directory for Perl module extensions

    tmp/ - Temporary working directory

    dist/ - Distribution location, will contain built binary and html pages
	html/				-- Directory of VCP documentation
	vcp-VER-kernelinfo.exe.gz	-- Binary for specified platform

Creating a new module.lists file

      % sh gen-lists.sh

      This script will check for the latest releases for all of the required
      modules and add in the reference URI into the modules.list file for retrieval.