Perforce Version Copy Utility (VCP) Build Installation Instructions

THESE INSTRUCTIONS ARE FOR LINUX AND BSD

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:  http://www.gnu.org/software/wget/wget.html
    - Expat XML Parser: http://sourceforge.net/projects/expat/

    For Win2k/WinXP, you will need to also have the cygwin utility
    available from: http://cygwin.com/

Creating a clean build of vcp binary on an Unix platform

      % cd BUILD
      % sh retrieve.sh         # Retrieves about 17M bytes of files
      % sh build-perl.sh       # You will need to hit return at one point
      % 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

      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
  
    PerlSrc/ - Created by build-perl.sh for a building, testing, and installing a local Perl
      perl/ - Installation directory for local Perl
        bin/ - perl, vcp, and pp will all end up installed into this directory
              This will need to be added to the front of your PATH environment variable
      perl-addons/ - Installation directory for local Perl extensions
      perl-5.../ - Build and test directory for local Perl

    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.