intro.cgi #6

#!/usr/bin/perl -w
# -*- perl -*-
use P4CGI ;
use strict ;
#
#################################################################
#  CONFIGURATION INFORMATION 
#  All config info should be in P4CGI.pm
#
#################################################################
#
#  P4 depot browser, top
#
#################################################################



print &P4CGI::start_page("Introduction to P4DB") ;

sub pr($$) 
{
    return &P4CGI::table_row({-class=>"\"Prompt\"",
			      -text=>shift @_},
			     shift @_) ;
}

{
    my $depot = &P4CGI::DEPOT_NAME(&P4CGI::CURR_DEPOT_NO()) ;
    my $lastch = &P4CGI::CURRENT_CHANGE_LEVEL() ;
    my $server_port = &P4CGI::USER_P4PORT() ;
    my ($server_year, $server_No, $server_qual) = &P4CGI::SERVER_VERSION() ;
    my $server_version = "$server_year.$server_No$server_qual" ;
    print 
	join("\n",
	     (&P4CGI::start_framedTable("Server info"),
	      &P4CGI::start_table(),
	      pr("Depot:",$depot),
	      pr("Change level:",$lastch),
	      pr("Port:",$server_port),
	      pr("Server version:",$server_version),
	      &P4CGI::end_table(),
	      &P4CGI::end_framedTable(),
	      "<br>")) ;
}

print &P4CGI::start_table(" class=\"Text\""),
    "<tr><td>";

my $version = &P4CGI::VERSION() ;
my $changelevel = &P4CGI::CHANGELEVEL() ;
my $required = &P4CGI::REQUIRED_SERVER_VERSION() ;

while(<DATA>) {
    s/__VERSION__/$version/g ;
    s/__CHANGELEVEL__/$changelevel/g ;
    s/__REQUIRED_SERVER_VERSION__/$required/g ;
    print ;
}

print  "</td></tr>", &P4CGI::end_table() ;

print &P4CGI::end_page() ;

#
# That's all folks
#

__END__
<h1 class="Text">Welcome to P4DB version __VERSION__/__CHANGELEVEL__</h1>

<h2 class="Text">About P4DB</h2>
<p class="Text">
    P4DB is a web based depot browser for 
    <a class="normal" href="http://www.Perforce.com" title="Link to Perforce web site">
    Perforce p4</a>. The purpose of P4DB is to present data and statistics
    retrieved from a p4 depot. P4DB can not modify data in the depot or retrieve
    any information from files on clients.
    
<h2 class="Text">Quick guide to P4DB</h2>
<p class="Text">
    The top of the page there are two pull-down menus and two buttons. 
    <ul class="Text">
    <li>The left menu contains a set of predefined entry points to P4DB. 
    <li>The right menu is for your personal shortcuts (see below).
    <li>The "Add shortcuts" button let you add your own
        shortcuts that will be available in the menu mentioned above.
        It is similar to the "bookmarks" or "favourites" function in your web browser but the
        advantage with the P4DB shortcuts is that you get to set your own names
        and they do not clobber the bookmark or favorites menu.<br>
        You can remove shortcuts in the 
        <a class="normal" href="SetPreferences.cgi" title="Link to page">User Preferences</a> page.     
    <li>The last button make the current page the "default start page". This is 
        the page that will be displayed when you open "<a class="normal" href="index.cgi" 
        title="Go to index.cgi">index.cgi</a>".
    <li>The <a class="normal" href="SetPreferences.cgi" title="Link to page">User Preferences</a> page 
        will let you select depot, if there is more than one, and set up some preferences like tab size
    </ul>
    
<p class="Text">
    It you have a fairly recent browser you can let the pointer hoover over a link to get a small 
    tool-tip popup that will give you some more information about the link.<br>
    To find out if your brower supports tool-tips put the pointer over
    <a class="normal" href="intro.cgi" title="Congratulations, your browser supports tool-tip help!">this text</a>

<h2 class="Text">P4DB browser requirements</h2>
<p class="Text">
   P4DB use java-script and cookies. P4DB will not be easy to use without java-script. Without
    cookies you will not be able to modify your <a class="normal" href="SetPreferences.cgi" title="Link to page">
    user preferences</a>, add shortcuts or change default start page.

<h2 class="Text">P4DB Support and Supported Platforms</h2>

<p class="Text">
    There are no supported platforms basically because there is no support.
    P4DB is open source software and I expect the brave p4 administrator that
    installs P4DB to provide support for end users. I will of course answer
    questions if I can and I am more than willing to listen to suggestions or
    constructive criticism but please forward all this through your
    administrator.

<p class="Text">
    P4DB is developed using the Netscape 7.1 browser running on Linux.
    It is also tested with a recent version of Netscape and MS Explorer
    on Windows.
    This version of P4DB use much more cascaded style sheets (CSS) and 
    Java-Script than the earlier versions. This require more from the
    browser and P4DB __VERSION__ will probably not run well on
    Netscape browsers older than 6.2 or Explorer older than version 5.5.

<h2 class="Text">P4DB p4 server requirements</h2>
<p class="Text">
    P4DB __VERSION__ requires p4 server software 
    __REQUIRED_SERVER_VERSION__ or newer. 

<h2 class="Text">Miscellaneous Links</h2>
 
<p class="Text">
    <ul class="Text">
    <li><a class="normal" href="README.html" title="Link to page" target="_blank">Readme file for P4DB administrators</a>
    <li><a class="normal" href="http://www.perforce.com" title="Link to page" target="_blank">Perforce</a>
    <li><a class="normal" href="http://www.fredricson.nu/P4DB" title="Link to page" target="_blank">P4DB project home page</a>
    </ul>