Perforce Version Copy Utility (VCP) Build Installation Instructions

THESE INSTRUCTIONS ARE FOR MS WINDOWS 2000 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:
    - Some decompression/dearchive tool which works on tar, gzip and zipped files
      such as 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
    - ActivePerl from: http://www.activestate.com/Products/ActivePerl
      You must REBOOT after installing ActivePerl


Creating a build of vcp binary on a Windows platform

    1) Create a build directory, e.g., C:\BuildVCP
    2) Using your browser of choice, download the following files into this
       directory:
         http://search.cpan.org/CPAN/authors/id/A/AU/AUTRIJUS/PAR-0.85.tar.gz
         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.04.tar.gz
         http://search.cpan.org/CPAN/authors/id/R/RB/RBS/BFD-0.31.tar.gz
    3) Using your decompression/dearchive tool, uncompress and unarchive these
       files so that they are installed under C:\BuildVPC
    4) Copy the 'win-ppm-install.bat' file into C:\BuildVCP
    5) Open a 'Command Prompt' window and run the following commands:
         cd C:\BuildVCP
         win-ppm-install
    6) Build PAR module using the 'Command Prompt' window: (Note: ignore signature failure)
         cd C:\BuildVCP\PAR-0.85
         perl Makefile.PL
         nmake
         nmake test
         nmake install
    7) Build HTML-Format module using the 'Command Prompt' window:
         cd C:\BuildVCP\HTML-Format-2.04
         perl Makefile.PL
         nmake
         nmake test
         nmake install
    7) Fix PodToHTML module's embedded bug by using Wordpad or editor of choice to
       edit the file: C:\BuildVCP\PodToHTML-0.04\lib\Pod\HTML_Elements.pm
       Search for: IO::File
       Insert the following immediately after the '{'
         use IO::File;
    8) Build HTML-Format module using the 'Command Prompt' window:
         cd C:\BuildVCP\PodToHTML-0.04
         perl Makefile.PL
         nmake
         nmake test
         nmake install
    9) Build BFD module using the 'Command Prompt' window:
         cd C:\BuildVCP\BFD-0.31
         perl Makefile.PL
         nmake
         nmake test
         nmake install
    10) Using your decompression/dearchive tool, uncompress and unarchive the VCP 
        release into the C:\BuildVCP directory
    11) Save the vcp file by:
          cd C:\BuildVCP\VCP-{version}
          copy bin\vcp bin\vcp.orig
    12) 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;
    13) Build BFD module using the 'Command Prompt' window:
          cd C:\BuildVCP\VCP-{version}
          perl Makefile.PL
          nmake
          nmake test
          nmake install
    14) Replace original vcp file by:
          cd C:\BuildVCP\VCP-{version}
          move bin\vcp.orig bin\vcp
    15) 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