<HTML>
<HEAD>
<TITLE>
Perforce Public Depot
</TITLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF">
<CENTER>
<P>
<A NAME="toc"></A>
<A HREF="http://www.perforce.com">
<IMG SRC="http://www.perforce.com/images/logo.gif" alt="Perforce" border=0></A>
<H1>
Welcome to the Perforce Public Depot
</H1>
<P>
<TABLE BORDER=0><TR><TD>
<B>
<UL>
<LI><A HREF="#aboutPerforce">About Perforce and the Public Depot
</A>
<LI><A HREF="#roadmap">The Depot Road Map
</A>
<LI><A HREF="#howtobrowse">How to Browse the Depot
</A>
<LI><A HREF="#howtocontrib">How to Contribute to the Depot
</A>
</UL>
</UL>
</TABLE>
</CENTER>
<br>
<br>
<br>
<!------------------------------------------------------------------>
<P>
<TABLE CELLSPACING=0 BORDER=0 WIDTH=100%><TR><TD BGCOLOR=FFCC66>
<A NAME="aboutPerforce"></A>
<H2>About Perforce and the Public Depot
</H2>
<TD WIDTH=5% BGCOLOR=FFCC66 ALIGN=RIGHT><FONT SIZE="-2"><A HREF="#toc">
Back to<BR>Table of<BR>Contents</A></TD></TR>
</TABLE>
<P>
<TABLE BORDER=0 ALIGN=RIGHT WIDTH=25% CELLPADDING=10 CELLSPACING=5 >
<TR>
<TD WIDTH=16> </TD>
<TD BGCOLOR="#DDDDDD" ALIGN=RIGHT><FONT SIZE=-1>
One of Perforce's many distinguishing features is that it can be used
over the internet to track shared software development.
A Perforce server stores files
in a <i>depot</i>, and developers all over the world can submit
changes to the depot. The orderly management of file changes
and merges is provided by the Perforce SCM system.
</FONT>
</TD></TR></TABLE>
If you haven't heard about
<b>Perforce, the Fast Software Configuration Management System</b>,
head over to our
<a href="http://www.perforce.com">home page</a>
and read all about it.
<P>
We've set up this Public Depot to enable software developers outside
of our company to contribute to the growing body of supporting programs
and documentation of interest to our users.
Among the first open source development projects we've initiated
into the Public Depot are
<a href="http://www.perforce.com/perforce/webkeeeper.html">
WebKeeper</a>,
an Apache Web Server module for accessing files in a Perforce depot,
and
<a href="http://public.perforce.com/public/jam/src/Jam.html">Jam/MR</a>,
a fully portable alternative to <i>make(1)</i>.
<P>
If you're interested in contributing to any of the software or
documentation in the Public Depot, read on to find out how. Or, if
you're simply interested in seeing how Perforce works, you'll find
the Public Depot to be an accessible model of
real, distributed, concurrent source management in action.
<!------------------------------------------------------------------>
<P>
<TABLE CELLSPACING=0 BORDER=0 WIDTH=100%><TR><TD BGCOLOR=FFCC66>
<A NAME="roadmap"></A>
<H2>The Depot Roadmap
</H2>
<TD WIDTH=5% BGCOLOR=FFCC66 ALIGN=RIGHT><FONT SIZE="-2"><A HREF="#toc">
Back to<BR>Table of<BR>Contents</A></TD></TR>
</TABLE>
<CENTER>
<TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0>
<TR>
<TD WIDTH=41>
<TD WIDTH=41>
<TD WIDTH=41>
<TD WIDTH=41>
<TD WIDTH=41>
<TD WIDTH=41>
<TD>
<TR>
<TD COLSPAN=2><FONT SIZE=4>
<A HREF="http://public.perforce.com/cgi-bin/p4db/dtb.cgi?FSPC=public">
public
</A>
<TD><IMG SRC=http://www.perforce.com/images/diag_bl.gif border=0>
<TD>
<TD>
<TD>
<TR>
<TD><IMG SRC=http://www.perforce.com/images/diag_tr.gif BORDER=0>
<TD><IMG SRC=http://www.perforce.com/images/diag_horiz.gif BORDER=0>
<TD COLSPAN=2><FONT SIZE=4>
<A HREF="http://public.perforce.com/cgi-bin/p4db/dtb.cgi?FSPC=public/perforce">
perforce
</A>
<TD><IMG SRC=http://www.perforce.com/images/diag_bl.gif border=0>
<TD>
<TD><B>Perforce
<TR>
<TD><IMG SRC=http://www.perforce.com/images/diag_vert.gif BORDER=0>
<TD>
<TD><IMG SRC=http://www.perforce.com/images/diag_tr.gif BORDER=0>
<TD><IMG SRC=http://www.perforce.com/images/diag_horiz.gif BORDER=0>
<TD><FONT SIZE=4>
<A HREF="perforce/utils/index.html">
utils
</A>
<TD><IMG SRC=http://www.perforce.com/images/diag_bl.gif border=0>
<TD>Conversion scripts, browsers, daemons, and other supporting
programs.
<TR>
<TD><IMG SRC=http://www.perforce.com/images/diag_vert.gif BORDER=0>
<TD>
<TD><IMG SRC=http://www.perforce.com/images/diag_tr.gif BORDER=0>
<TD><IMG SRC=http://www.perforce.com/images/diag_horiz.gif BORDER=0>
<TD><FONT SIZE=4>
<A HREF="perforce/faq/index.html">
faq
</A>
<TD><IMG SRC=http://www.perforce.com/images/diag_bl.gif border=0>
<TD>Frequently-asked questions and other user-contributed documentation.
<TR>
<TD><IMG SRC=http://www.perforce.com/images/diag_vert.gif BORDER=0>
<TD>
<TD><IMG SRC=http://www.perforce.com/images/diag_tr.gif BORDER=0>
<TD><IMG SRC=http://www.perforce.com/images/diag_horiz.gif BORDER=0>
<TD><FONT SIZE=4>
<A HREF="perforce/triggers/index.html">
triggers
</A>
<TD><IMG SRC=http://www.perforce.com/images/diag_bl.gif border=0>
<TD>Examples of pre-submit triggers, which is a feature added in release 99.1
<TR>
<TD><IMG SRC=http://www.perforce.com/images/diag_vert.gif BORDER=0>
<TD>
<TD><IMG SRC=http://www.perforce.com/images/diag_llcorner.gif BORDER=0>
<TD><IMG SRC=http://www.perforce.com/images/diag_horiz.gif BORDER=0>
<TD><FONT SIZE=4>
<A HREF="perforce/webkeeper/index.html">
webkeeper
</A>
<TD><IMG SRC=http://www.perforce.com/images/diag_bl.gif border=0>
<TD>Perforce WebKeeper module for the Apache HTTP server
<TR>
<TD><IMG SRC=http://www.perforce.com/images/diag_vert.gif BORDER=0>
<TR>
<TD><IMG SRC=http://www.perforce.com/images/diag_llcorner.gif BORDER=0>
<TD><IMG SRC=http://www.perforce.com/images/diag_horiz.gif BORDER=0>
<TD COLSPAN=2><FONT SIZE=4>
<A HREF="jam/index.html">
jam
</A>
<TD><IMG SRC=http://www.perforce.com/images/diag_bl.gif border=0>
<TD>
<TD><B>Jam/MR
<TR></TR><TD></TD>
<TR>
<TD COLSPAN=2><FONT SIZE=4>
<A HREF="http://public.perforce.com/cgi-bin/p4db/dtb.cgi?FSPC=guest">
guest
</A>
<TD><IMG SRC=http://www.perforce.com/images/diag_bl.gif border=0>
<TD>
<TD>
<TR>
<TD><IMG SRC=http://www.perforce.com/images/diag_llcorner.gif BORDER=0>
<TD><IMG SRC=http://www.perforce.com/images/diag_horiz.gif BORDER=0>
<TD COLSPAN=3><FONT SIZE=4><I>your_name_here</I>
<TD><IMG SRC=http://www.perforce.com/images/diag_bl.gif border=0>
<TD><B>Guest branches
</TABLE>
</CENTER>
<!------------------------------------------------------------------>
<P>
<TABLE CELLSPACING=0 BORDER=0 WIDTH=100%>
<TR><TD BGCOLOR=FFCC66>
<A NAME="howtobrowse"></A>
<H2>How to Browse the Public Depot
</H2>
<TD WIDTH=5% BGCOLOR=FFCC66 ALIGN=RIGHT>
<FONT SIZE="-2"><A HREF="#toc">
Back to<BR>Table of<BR>Contents</A></TD></TR>
</TABLE>
<!------------------------------------------------------------------>
<p>
If you're simply curious about our Public Depot, please browse freely.
Here's how:
<UL>
<LI>
<p>
Start
<A HREF="http://public.perforce.com/cgi-bin/p4db/index.cgi">here</A>
to browse the Public Depot using
<A HREF="http://public.perforce.com/cgi-bin/p4db/sfv.cgi?TYPE=HTML&FSPC=//public/perforce/utils/p4db/README.html&REV=head">P4DB</A>,
a suite of CGI scripts contributed by Fredric Fredricson.
<p>
<LI>
We also have
<A HREF="http://www.perforce.com/perforce/webkeeper.html">WebKeeper</A><SUP><SMALL>TM</SMALL></SUP> installed, so
if you know exactly which depot file you want to see, you can give it to your
web browser as a URL, using <B><CODE>http://public.perforce.com</CODE></B>
as the root.
For example, to look at this file:
<PRE> //public/jam/src/jam.c</PRE>
You'd use this URL:
<PRE> http://public.perforce.com/public/jam/src/jam.c</PRE>
<P>
<LI>
Finally, if you are a Perforce user, you can use any <b>p4</b>
or <b>P4Win</b> reporting commands to browse the Public Depot.
Just set your P4PORT to:
<PRE> public.perforce.com:1666</pre>
<p>
(<B>p4</B> and <B>P4Win</B> are Perforce client programs which can be
<A HREF="http://www.perforce.com/perforce/loadprog.html">downloaded</A>
for free.
<B>p4</B> is a command-line program available for all platforms,
and <B>P4Win</B> is a Windows GUI available for Windows 95 and
Windows NT.)
<P>
Note: We periodically purge client specs created by
unregistered users. You are free to recreate clients with
<b>p4</b> or <b>P4win</b>, but unless
you're a registered user, don't count on having a persistent
client spec in the depot.
See below
for instructions on
becoming a registered user.
</UL>
<!------------------------------------------------------------------>
<P>
<TABLE CELLSPACING=0 BORDER=0 WIDTH=100%>
<TR><TD BGCOLOR=FFCC66>
<A NAME="howtocontrib"></A>
<H2>How to Contribute to the Public Depot
</H2>
<TD WIDTH=5% BGCOLOR=FFCC66 ALIGN=RIGHT>
<FONT SIZE="-2"><A HREF="#toc">
Back to<BR>Table of<BR>Contents</A></TD></TR>
</TABLE>
<!------------------------------------------------------------------>
<P>
<TABLE WIDTH=100%>
<TR>
<TD VALIGN=TOP WIDTH=20%>
<h4>Registering</h4>
</TD>
<TD VALIGN=TOP>
<ul>
<P>
<li>
To contribute to the Public Depot, you'll need to become a
registered user. To apply, please send email to
<a href="mailto:info@perforce.com">info@perforce.com</a>,
describing the tools, scripts, or documents you'd like to
contribute.
You must provide your full name, which
we will use to assign your Perforce user ID.
(E.g., if your name is Sammy Davis, Jr, your user ID in the Perforce
Public Depot will be
<code><b>sammy_davis_jr</b></code>.)
</ul>
<p>
</TD></TR>
<TR><TD COLSPAN=2> </TD></TR>
<TR>
<TD VALIGN=TOP WIDTH=20%>
<h4>Client Setup</h4>
</TD>
<TD VALIGN=TOP>
<ul>
<P>
<li>
If you're not already using Perforce, you'll need a Perforce client
program for your development platform. Go to our
<A HREF="http://www.perforce.com/perforce/loadprog.html">downloads page</A>
and download the client for your platform.
<p>
<li>
Follow the instructions in the
<a href="tutorial.html">tutorial</a>
to set up a client workspace with a guest branch view for yourself.
<p>
</ul>
</TD></TR>
<TR><TD COLSPAN=2> </TD></TR>
<TR>
<TD VALIGN=TOP WIDTH=20%>
<h4>Submitting Files</h4>
</TD>
<TD VALIGN=TOP>
<ul>
<li>
You are free to submit any files or changes to your guest branch.
If you're new to Perforce, see the
<a href="tutorial.html">tutorial</a> for a
guided example of how to work on files.
<p>
<li>
When you have something in your guest branch that is completed and
ready to be integrated into the public branch, please email
the curator of the project you're targeting. Curators
are listed in the <code><b>index.html</b></code> files at the
top level of each project (see the Depot Roadmap, above).
The curator will review your files and integrate them into
the public branch.
</ul>
<p>
</TD></TR>
<TR><TD COLSPAN=2> </TD></TR>
<TR>
<TD VALIGN=TOP WIDTH=20%>
<h4>Notes on Access Permissions</h4>
</TD>
<TD VALIGN=TOP>
<ul>
<li>
There are two depots in the Public Depot:
<code><b>//public</b></code> and
<code><b>//guest</b></code>.
All users, registered or not, have read access to
all files in both depots.
<p>
<li>All users have read access to all changelist descriptions,
user specs, client specs, etc.
<p>
<li>
Only registered users have write access, and only to
the files in his/her guest branch. (That is, you can only submit
files in the
<code><b>//guest/your_name</b></code> path.)
<p>
<li>
Only Perforce staff, and "curators" designated by Perforce
staff, have write access to files in the
<code><b>//public</b></code> depot.
<P>
</ul>
</TD></TR>
<TR><TD COLSPAN=2> </TD></TR>
<TR>
<TD VALIGN=TOP WIDTH=20%>
<h4>More Information</h4>
</TD>
<TD VALIGN=TOP>
<ul>
<li>
All registered users should read the
<a href="tutorial.html">Public Depot Tutorial</a>.
<p>
<li>
Users new to Perforce should visit
our
<a href="../perforce/technical.html">Technical Documentation</A> page.
<p>
</ul>
</TD>
</TR>
</TABLE>
<br><br><br>
<!------------------------------------------------------------------>
<P>
<TABLE CELLSPACING=0 BORDER=0 WIDTH=100%>
<TR>
<TD WIDTH=15% BGCOLOR=FFCC66 ALIGN=LEFT VALIGN=CENTER>
<FONT SIZE="-2">
Copyright ©<br>
1998, 1999<br>
<a href="http://www.perforce.com">Perforce Software</a><br>
</FONT>
</TD>
<TD WIDTH=70% BGCOLOR=FFCC66 ALIGN=CENTER>
<FONT SIZE="-2">
You're browsing a file stored as<br>
<code>$Id: //guest/jeff_bowles/top-level.html#1 $</code><br>
in the
<A HREF=http://public.perforce.com/public/index.html>Perforce Public Depot</A>.
</FONT>
</TD>
<TD WIDTH=15% BGCOLOR=FFCC66 ALIGN=RIGHT>
<FONT SIZE="-2"><A HREF="#toc">
Back to<BR>Table of<BR>Contents</A></TD></TR>
</FONT>
</TD>
</TR>
</TABLE>
<!------------------------------------------------------------------>
</BODY>