branches.pl CGI script (by Todd Short)

All I ask for is credit! :)

This script will generate a PNG file that graphically depicts the 
branching and merging relationships between files. This script is
mostly compatible with P4DB. This requires GD to be installed (I
used GD 1.8.4) and the GD.pm Perl module (I used version 1.33).

The GD library is available at:

http://www.boutell.com/gd

The GD.pm module is available at:

http://stein.cshl.org/WWW/software/GD/GD.html

The script is run twice, once for the HTML, and again to generate
the PNG. This was tested using P4/P4D 2001.1.

My Perl isn't pretty, but it works, and seems to do the job well.

Setup:
1. Edit the branches.pl script:
1a. update the location of perl
1b. update the $ENV{P4USER} and $ENV{P4PORT} lines
1c. update the location of p4 ($P4)
2. If using P4DB with P4CGI:
2a. change 'use CGI' to 'use P4CGI'
2b. Cut out the section that was borrowed from P4CGI/P4DB
2c. prepend &P4CGI:: to the bail(), p4call() and fixSpecChar() function invocations
2d. update the getting of parameters
2e. update the start and end html sections
3. If you want to link this into a P4DB-like system, to have links to changes and diffs
3a. Edit the URLS and parameters at the top of the script ($CHANGELIST_... $DIFF_...)

4. Set the script up with your web server (don't ask me how...)