Perforce Version Copy Utility (VCP) Build Installation Instructions
THESE INSTRUCTIONS ARE FOR MS WINDOWS 2000 AND XP
TODO - Revise for win2k and xp
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.