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.