Perforce Version Copy Utility (VCP) Build Installation Instructions
THESE INSTRUCTIONS ARE FOR MICROSOFT WINDOWS 2000 AND XP
The build installation scripts and structure provide a means for creating
repeatable builds of the vcp binary.
LAST UPDATED: January 5, 2006
TODO: Extend scripts so they can also be used to install the VCP module
into an existing version of Perl, with or without PAR.
--------------------------------------------------------------------------------
Prerequisites:
--------------------------------------------------------------------------------
You must have the following software installed on your system first in
order to install and build the vcp binary:
- Some decompression/dearchive tool which works on tar, gzip and zipped
files such as http://www.winzip.com or http://www.7-zip.org.
- nmake utility, this comes with Visual Studio or can be obtained from
http://download.microsoft.com/download/vc15/Patch/1.52/W95/EN-US/
Nmake15.exe. If you use this version, put the uncompressed files into
your Windows directory or else add the installed path to your $PATH
environment variable.
- ActivePerl from: http://www.activestate.com/Products/ActivePerl
--------------------------------------------------------------------------------
Creating a clean build of VCP binary on a Windows platform:
--------------------------------------------------------------------------------
01) Create a build directory, e.g., C:\BuildVCP
02) Using your browser of choice, download the following files into this
directory:
http://search.cpan.org/CPAN/authors/id/S/SB/SBURKE/
HTML-Format-2.04.tar.gz
http://search.cpan.org/CPAN/authors/id/N/NI/NI-S/PodToHTML-0.05.tar.gz
http://search.cpan.org/CPAN/authors/id/R/RB/RBS/BFD-0.31.tar.gz
03) Using your decompression/dearchive tool, uncompress and unarchive these
files so that they are installed under C:\BuildVCP.
04) Copy the 'win-ppm-install.bat' file into C:\BuildVCP.
05) Open a 'Command Prompt' window and run the following commands:
cd C:\BuildVCP
win-ppm-install
06) Build HTML-Format module using the 'Command Prompt' window:
cd C:\BuildVCP\HTML-Format-2.04
perl Makefile.PL
nmake
nmake test
nmake install
07) Build PodToHTML module using the 'Command Prompt' window:
cd C:\BuildVCP\PodToHTML-0.05
perl Makefile.PL
nmake
nmake test
nmake install
08) Build BFD module using the 'Command Prompt' window:
cd C:\BuildVCP\BFD-0.31
perl Makefile.PL
nmake
nmake test
nmake install
09) Using your decompression/dearchive tool, uncompress and unarchive the
VCP release into the C:\BuildVCP directory.
10) Backup the original vcp file:
cd C:\BuildVCP\VCP-{version}
copy bin\vcp bin\vcp.orig
11) Edit the vcp file using your editor of choice:
Search for: my @bundled_files
Change the three lines so that it is just:
my @bundled_files;
12) Build VCP module using the 'Command Prompt' window:
cd C:\BuildVCP\VCP-{version}
perl Makefile.PL
nmake
nmake test
nmake install
13) Replace original vcp file by:
cd C:\BuildVCP\VCP-{version}
move bin\vcp.orig bin\vcp
14) Build windows binary
cd C:\BuildVCP\VCP-{version}
perl bin\build_vcp_executable.pl
The resulting 'vcp.exe' file will be in C:\BuildVCP\VCP-{version} directory.