Helix SwarmHelix Swarm
Loading...

yapc1999.html

  • //
  • guest/
  • barrie_slaymaker/
  • safari/
  • doc/
  • yapc1999.html #1
  • View
  • Commits
  • Open Download .zip Download (50 KB) 
  1. <!doctype html public "-//w3c//dtd html 4.0 transitional//en">
  2. <html>
  3. <head>
  4. <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
  5. <meta name="GENERATOR" content="Mozilla/4.51 [en] (X11; I; Linux 2.2.5-15 i686) [Netscape]">
  6. <TITLE>SAFARI: CONCEPTION, BIRTH, AND FUTURE DEVELOPMENT OF AN OPEN SOURCE CODE BROWSING SYSTEM</TITLE>
  7. </head>
  8. <body BGCOLOR="#FFFFFF">
  9. yapc Proceedings (June 1999)
  10. <br>
  11. <p><b>SAFARI: CONCEPTION, BIRTH, AND FUTURE DEVELOPMENT OF AN OPEN SOURCE CODE BROWSING SYSTEM</b>
  12. <p>R. B. SLAYMAKER, Jr.
  13. <br>
  14. <p><font size=-1>&nbsp;&nbsp;&nbsp;&nbsp; Safari is a web based application
  15. that provides access to hierarchically organized files (programs, images,
  16. documents, or other media) stored in file systems, databases or archiving
  17. systems such as revision control and software configuration management systems.
  18. Multiple versions of any file can be browsed using meta information such
  19. as revision number, revision labels, project membership, change
  20. set numbers, or other methods natural to the structure of the storage system.
  21. Relative links between documents link to the correct revisions of the
  22. target documents as determined by the meta information.
  23. <BR>&nbsp;&nbsp;&nbsp;&nbsp;Safari also provides a standard (GNU Make based) framework
  24. for integrating analysis and processing tools and making their output easily
  25. available within the context of the hierarchy the source files are stored
  26. (and thus presented) in.
  27. <br>&nbsp;&nbsp;&nbsp;&nbsp; Safari was conceived as a tool
  28. for publishing automatically extracted documentation for an in-house system,
  29. using a 3rd party documentation extraction tool (Cocoon). The original
  30. (0.0) version is a monolithic perl script that grew from the original design
  31. goals to include source code browsing, syntax highlighting, navigation
  32. of back revisions, a second documentation extractor (pod2html) and activation
  33. of #include files to be links to the appropriate file.
  34. <br>&nbsp;&nbsp;&nbsp;&nbsp; Several key design decisions
  35. in the 0.0 version were validated in practice, others invalidated. When
  36. the burden of maintaining and extending the monolithic script grew too
  37. large, Safari was rewritten and is now headed for a 1.0 version. The 0.5
  38. version is being released under an open source license in conjunction with
  39. this paper, and a demonstration web site is being made available for the
  40. conference.
  41. <br>&nbsp;&nbsp;&nbsp;&nbsp; This paper outlines the past
  42. and near future life cycle of Safari: the design decisions, the current
  43. state, and future directions are all discussed.</font>
  44.  
  45. <h2><A NAME="Introduction"></A>1. Introduction</h2>
  46.  
  47. <P>Source code browsing systems allow a developers and
  48. other interested parties to explore and research bodies of source code.
  49. To varying extents, they provide analytical information about the
  50. code base, such as indexes of identifiers, 
  51. meta information such as change logs, labels, file dates and sizes.
  52. A few are complete web based SCM (Software Configuration Management) or 
  53. RCS (Revision Control System) interfaces.
  54.  
  55. <P>There are many existing systems that provide these features.
  56. <A HREF="http://lxr.linux.no/">The Linux Cross Reference project</A>
  57. [<A HREF="#1">1</A>] provides browsing and indexing of identifiers 
  58. for source code and is used by several high profile open source
  59. projects and by in-house developers working on proprietary
  60. code.
  61.  
  62. <P>The <A HREF="http://www.perforce.com/perforce/webkeeper.html">Perforce Webkeeper</A>
  63. [<A HREF="#2">2</A>] provides for simple retrieval of files from a perforce
  64. source code repository.
  65.  
  66. <P>The <A HREF="http://public.perforce.com/cgi-bin/p4db/dtb.cgi?FSPC=public/perforce/utils/p4db">p4db Depot Browser</A> 
  67. [<A HREF="#3">3</A>] provides another front end for browsing files held in a perforce browsing system.
  68.  
  69. <P><A HREF="http://www.mks.com/">Mortice Kern Systems, Inc.</A>
  70. provides a web based interface for the <A HREF="http://www.mks.com/solution/si/">Source Integrity Pro</A> 
  71. [<A HREF="#4">4</A>] software configuration management system. In addition to
  72. these, there are probably hundreds of similar open source, closed source,
  73. and hand-rolled systems in existence.
  74.  
  75. <P>[[If you know of any such systems that are distributed
  76. free (in either sense), please let me know. Safari's an equal opportunity
  77. borrower. Several of the p4db scripts have already been borrowed (with
  78. much gratitude).]]
  79.  
  80. <P>Safari became a source code
  81. browser as a means to a different end: we needed to extract source code 
  82. documentation (using an existing open source tool)
  83. and publish it on an intranet. Source code browsing was originally
  84. intended to provided a natural
  85. navigational interface for this system, but rapidly became the most
  86. used feature.
  87. As with many open source projects, it
  88. grew out of a need to scratch a fairly small itch and is growing
  89. to be a very general tool. 
  90.  
  91. <P>The current rewrite of Safari is intended 
  92. to allow incorporation of many different tools and to
  93. be able to interface to a wide variety of file storage and archival systems.
  94.  
  95. <H2><A NAME="Conception"></A>2. Conception</H2>
  96.  
  97. <P>Safari was originally written starting in 1997 to automatically 
  98. extract and publish documentation from comments in
  99. C++ source code kept in a closed source SCM system. The extraction
  100. tool in use is
  101. <A HREF="http://www.stratasys.com/software/cocoon/">Cocoon</A>
  102. [<A HREF="#5">5</A>]. The SCM is 
  103. <A HREF="http://www.mks.com/solution/si/">MKS' Source Integrity</A> [<A HREF="#6">6</A>].
  104. The fact that both of these were pre-existing sytems meant that
  105. Safari was initially conceived as cgi-bin to glue together
  106. chains of external tools (SI -> Cocoon -> HTTP output).
  107.  
  108. <P>Over time, feeping creaturism added:
  109.  
  110. <UL>
  111. <LI>File-, project-, label- and revision-based browsing of source code,
  112. <LI>Automatic mark-up of filenames in #include statements
  113. to be links to the referred-to files,
  114. <LI>Syntax highlighting and colorizing of C++ and (in a limited fashion) perl
  115. source code,
  116. <LI>On-the-fly documentation extraction using Cocoon and pod2html (a
  117. utility distributed with perl),
  118. <LI>Change log description browsing on a per-file basis, and
  119. <LI>Simple searching for text or regular expressions within a file.
  120. </UL>
  121.  
  122. <P>As Safari was extended, it grew beyond it's original mission
  123. as a documentation extraction
  124. tool and became a tool for researching, reviewing, and discussing 
  125. code. It turns out that reading code is often easier in a browser than
  126. when using typical development environments of SCMs, file system browsers, 
  127. documentation extractors, HTML browsers, editors, and the like. 
  128.  
  129. <P>The reasons a system such as Safari is more usable than
  130. traditional development environments are:
  131.  
  132. <OL>
  133. <LI>There's no need to check out the files. Safari extracts files
  134. on-the-fly.
  135. <LI>Source code can be marked up to include links to other code.
  136. Things that can be activated in this manner include:
  137. <OL TYPE="a">
  138. <LI>References to other files / modules.
  139. <LI>Identifiers can link back to the definitions, or forward
  140. to a cross reference of their uses.
  141. <LI>URLs in comments or code
  142. <LI>Links can be added to point to external documentation
  143. of design and implementation.
  144. </OL>
  145. <LI>Documentation extractors and code analysis tools can be made
  146. almost effortless. For instance, Cocoon is complicated enough that
  147. only one or two developers at this site ever mastered it (not me). No
  148. other developer managed to get it up and running and use it for
  149. any length of time.
  150. <LI>Links to line numbers
  151. (a feature borrowed from the Linux Cross Reference tools [<A HREF="#1">1</A>])
  152. can be emailed to others. If link longevity is
  153. required, a search query that leads to a line of code can be emailed
  154. or stored, so edits that change line numbers don't cause link rot
  155. nearly as easily.
  156. </OL>
  157. All of this
  158. facilitates code reviews, documentation and research: it promotes
  159. those things that make open source so succesful today: communications and
  160. information.
  161.  
  162. <P>With Safari, checking a file in <i>is</i> publishing it. Checking
  163. in is also
  164. publishing any documentation
  165. to be extracted from it. This turned out to be a very powerful mechanism.
  166. We found ourselves storing design documentation in the project. This
  167. allowed the design documentation to be automatically associated with the 
  168. files that it referred to revision by revision, release by release.
  169.  
  170. <P>In short, we found ourselves using Safari daily as an core
  171. technology for software development. It's not the most used or
  172. most important system, but it provides significant value to the
  173. developers.
  174. We extended it several times to incorporate
  175. new features, bloating the original script beyond the point of the 
  176. maintainer's
  177. sanity (which may explain a few things about this paper). Eventually it became clear that there was an ecological niche in
  178. the broader internet community that a generalized, open source, modular 
  179. Safari-like system could fill, even given the number of other similar 
  180. systems available.
  181.  
  182. <H2><A HREF="#Gestation"></A>3. Gestation</H2>
  183.  
  184. <P>In the spring of 1998, I began to rewrite Safari in a more modular fashion
  185. while
  186. attempting to preserve the aspects that made Safari useful.
  187. Another goal was to allow for for easy integration of existing tools without
  188. requiring extensive programming knowledge. Perl's very good for controlling
  189. external programs, but there are many people with little or no Perl
  190. expertise out there.
  191.  
  192.  
  193. <P>Here's the general structure of a Safari instance:
  194.  
  195. <IMG SRC="yapc1999-dataflow.gif" ALT="Safari Dataflow Diagram">
  196.  
  197. <P>A fully functional Safari system is built with a web server,
  198. a cgi-bin (or preferably mod_perl) script <tt>cgimake</tt>, a make program,
  199. preferably GNU Make or Make.pm, a script to convert source materials into
  200. HTTP documents, and any external programs needed
  201. to fetch files and meta data from the data store and 
  202. process it in to web-ready form. These tools are the key element of
  203. Safari: they are your existing tools, not special purpose
  204. Safari tools.
  205.  
  206. <P>Several key factors that made the original single-script version of
  207. safari useful:
  208.  
  209. <OL>
  210. <LI>Coherent, simple user interface,
  211. <LI>Coherent, simple URL 'API' design, and
  212. <LI>Emphasis on minimal administration and real-time updating.
  213. </OL>
  214.  
  215. <P>Adding the goals of modularity and extensibility have rounded out
  216. Safari and made it a general purpose tool, with possible applications
  217. beyond source code browsing.
  218.  
  219. <H3><A NAME="UI"></A>3.1 User Interface Metaphors</H3>
  220.  
  221. <P>The key user interface decision that made Safari usable was basing the
  222. navigation on the hierarchical file structure present in the source code
  223. archives. This structure is already known by existing developers, and
  224. basing Safari's navigation system on it also provides a tool for learning
  225. and exploration by those who need to become familiar with it. Documentation
  226. and other analytical tools should be reachable by browsing to a file or
  227. directory, then following a link to the desired output.
  228.  
  229. <P>The disadvantage of this approach is that popular web browsers
  230. make mediocre hierarchy browsers. Javascript, Java, and custom browsers
  231. all provide possible avenues of approach for more friendly user interfaces.
  232. Safari takes a lowest common denominator approach with low graphics 
  233. intensity to make it more generally usable. The emphasis is on features,
  234. not flash (for now). That being said, a very nice tree oriented GUI would be
  235. a fantastic addition.
  236.  
  237. <P>Alternate browsing structures can easily be provided by adding reports
  238. or pages to Safari. These pages can be built automatically by an indexing
  239. tool (pod2html does this, for example), or manually. An example of the
  240. manual technique is a web page that describes each main active project
  241. and provides links to 'interesting' places in it. Interesting places might
  242. be the project root, design documents (standalone and automatically extracted),
  243. output of analysis tools, key routines, structure definitions, or
  244. files within the project, and external resources such as mailing lists,
  245. news groups, or other web sites.
  246.  
  247. <P>A search engine or permuted index generator can provide master 'random
  248. access' to the file tree. This is one of the most important features that
  249. Safari lacks support for at this time, and is the feature that the
  250. Linux Cross Reference Project was built for.
  251.  
  252. <H3><A NAME="URL"></A>3.2 URL Design</H3>
  253.  
  254. <P>The URL serves as the basic API that ties the user, the browser, and
  255. the Safari scripts together. Users often type them in manually instead
  256. of browsing to a location, so the URL should be easy to construct manually.
  257. In effect, it's a low-level alternate user interface. Browsers base
  258. relative link calculations on URLs, so placing contextual
  259. information 
  260. to the left of the destination document's path (as opposed to putting it
  261. in a '?' query specification) allows relative links between
  262. documents to lead to sensible destinations.
  263. And simple, consistent URL design makes scripting the back end much 
  264. easier.
  265.  
  266. <P>The URL design must support the hierarchical structure
  267. of the underlying archival system, must incorporate a revision identifier
  268. and also specification of which analysis or extraction tool's output
  269. is being browsed. The typical Safari URL looks like:
  270.  
  271. <PRE>
  272. http://a.b.com/checkers/_head/pretty/code/inc/checkers.h
  273. |                      |     |      |                  |
  274. +----------------------+-----+------+------------------+
  275. | Project identity     | Rev |Filter| File spec        |
  276. </PRE>
  277.  
  278. where:
  279.  
  280. <DL>
  281.    <DT>Project Identity
  282.    <DD>This is the root URL which determines what project Safari
  283.    is concerned with. In this case, the web server is configured to
  284.    map '/checkers/' to the Safari system.
  285.    <DT>Rev
  286.    <DD>The revision specifier comes next. This is usually a label
  287.    or change number, but can be a raw revision number in some cases.
  288.    The reason that it is not usually a raw revision number is that
  289.    it's rare that revision 123 of one file corresponds to revision
  290.    123 of another file. Using change set numbers or labels that
  291.    mark a release to specify revisions means that all filenames
  292.    specified to the right of the revision field refer to a
  293.    coherent, consistent set of files.
  294.    <DT>Filter
  295.    <DD>The filter specified the lens through which the file is to
  296.    be viewed. This may be a pretty-printer, a word/line counter,
  297.    a documentation extractor, a lint-like tool, etc.
  298.    <DT>File Spec
  299.    <DD>This indicates which file in the namespace of the project,
  300.    revision, and filter is being accessed. 
  301. </DL>
  302.  
  303. <P>Safari uses the query string portion of the URL (the part after
  304. a '?') to provide transient information. This transient information
  305. is information that should not affect the revision or current
  306. filter settings, and thus should not
  307. affect the document's position
  308. in the overall heirarchy.
  309.  
  310. <P>Here are some examples of Safari URLs. Sample pages generated by these
  311. are included in the appendix.
  312.  
  313. <DL>
  314. <DD>
  315. <PRE>
  316. <A HREF="#depots">http://localhost/safaridev/perforce/_head/Default/</A>
  317.    Leads to a list of files in the top level of Perforce Inc.'s public
  318.    source code archive.
  319.  
  320. <A HREF="#Default">http://localhost/safaridev/perforce/<B>_head</B>/Default/public/index.html</A>
  321.    Displays the head revision of the index.html extracted from that archive.
  322.  
  323. <A HREF="#pretty">http://localhost/safaridev/perforce/_head/<B>pretty</B>/public/index.html</A>
  324.    Displays the same page as syntax highlighted source code
  325.  
  326. <A HREF="#wc">http://localhost/safaridev/perforce/_head/pretty/public/index.html<B>?filter=wc</B></A>
  327.    Displays the output of the '<tt>wc</tt>' command when run on index.html
  328.  
  329. <A HREF="#filelog">http://localhost/safaridev/perforce/_head/pretty/public/index.html<B>?rev=_head&filter=filelog</B></A>
  330.    Displays the complete history of the file index.html.
  331.  
  332. <A HREF="#c6">http://www.slaysys.com/safaridev/perforce/<B>@6</B>/Default/public/index.html</A>
  333.    Diplays the versins of index.html associated with change set number 6.
  334.  
  335. </PRE>
  336. </DD>
  337. </DL>
  338.  
  339. <P>In essence, each combination of project and revision label or change
  340. number specifies a consistent set of files that correspond to each other.
  341. The filter determines how the source file should be processed before
  342. viewing, and the file spec leads to the file itself.
  343.  
  344. <P>Some filters generate different namespaces than the underlying
  345. archive structure. This makes linking into and out of that filter
  346. a little tricky, but relative links between files within a filter's namespace
  347. work fine.
  348.  
  349. <P>It's important to note that links between documents (both hard coded
  350. and those automatically marked up by Safari) should be relative links, for
  351. two reasons:
  352.  
  353. <UL>
  354.    <LI>Relative links will work in multiple filters and revisions
  355.    <LI>A user should be able to take a copy of the files and browse
  356.    them using a file: URL or other scheme.
  357. </UL>
  358.  
  359. <P>This is not always possible given the fact that third party tools
  360. are not always prepared to generate relative links. Workarounds do
  361. exist for some cases.
  362.  
  363. <H3><A NAME="Admin"></A>3.3 Administration and upkeep</H3>
  364.  
  365. <P>A key element in the adoption of Safari was minimal administration.
  366. Safari was born out of a need to publish sets of extracted source code
  367. documentation on the web, combined with the extreme distaste several
  368. of us had for manually generating and publishing docsets.
  369.  
  370. <P>Safari makes extensive use of file time stamps and meta information
  371. from the underlying storage system to determine when to check out a new
  372. file or (re)generate output derived from the source files.
  373.  This can be done on a timed basis (to avoid having to evaluate
  374. things every HTTP request), or it can be done on every HTTP request.
  375.  
  376. <P>In the original script, I found myself using and debugging a lot
  377. of dependency rules. This inspired the use of GNU Make as the tool
  378. to tie the cgi-bin (or mod_perl) script to the underlying tools.
  379.  
  380. <P>GNU Make provides several important features for Safari:
  381.  
  382. <OL>
  383.    <LI>a standard, well known, documented language for declaring the processes
  384.    needed to generate target files,
  385.    <LI>a program that evaluates this definition file and uses filesystem
  386.    meta information to decide what to remake,
  387.    <LI>the ability to incorporate existing tools in to Safari without
  388.    massive hacking efforts. <tt>gcc -c -Wall</tt> (ie lint) and <tt>wc</tt>
  389.    are implemented in the demonstration server as examples, but others
  390.    are available.
  391. </OL>
  392.  
  393. <P>GNU Make also poses a few challenges:
  394.  
  395. <OL>
  396.    <LI>There's no way to force a complete regeneration of output from the
  397.    source file in the event that a bug or transient condition causes
  398.    invalid output. This is especially important for Safari implementors,
  399.    but it's also a handy fly swatter for end users occasionally.
  400.    <LI>There's not an easy way to tell GNU Make to keep intermediate files
  401.    around while not ignoring errors (ie .SECONDARY's feature set is not
  402.    full enough for Safari). To work around this, Safari uses .PRECIOUS
  403.    and the scripts and Makefile shell commands that implement the 
  404.    underside of Safari delete their output files in the event of an error.
  405.    <LI>There's no natural way to use Make to check to see if a new 
  406.    revision exists in a modern client-server RCS / SCM.
  407.    <LI>GNU Make's functional programming API is very weak, and it can
  408.    be tricky to implement content-based decision making in a Makefile.
  409.    <LI>Make doesn't give a flock, so access sharing must be implemented
  410.    at a more global level that would be necessary if make could do it.
  411. </OL>
  412.  
  413. <P>Improvements that address
  414. the first two of these are now on the TODO list for the GNU Make developers.
  415. Workarounds exist for all of these, but improvements should be made that
  416. remove them.
  417.  
  418. <H3><A NAME="Design"></A>3.4 Miscellaneous Design Issues</H3>
  419.  
  420. <P>A few other key notes about the design and implementation:
  421.  
  422. <OL>
  423.    <LI>Safari is completely implemented in perl and GNU Make (although
  424.    the binaries necessary to connect to various RCSs are used).
  425.    <LI>A perl module implementing GNU Make with some powerful perlish
  426.    extensions has been developed and will be adapted to Safari use as
  427.    needed. This will run more slowly than GNU Make, but may make up
  428.    for that by reducing the forking required to do a build.
  429.    <LI>An enhanced version of the standard Unix <tt>file</tt> command
  430.    has been developed as a module File::Type. It reports mime types
  431.    and is more accurate at guessing source code languages.
  432. </OL>
  433.  
  434. <H2><A NAME="Birth"></A>4. Birth</H3>
  435.  
  436. <P>Safari's first open source release (0.50) has been developed to coincide
  437. with yapc (Yet Another Perl Conference) in June of 1999. The 0.50 release
  438. has a full basic feature set, with a lot of room to grow. A demonstration
  439. site URL should be available shortly before and for a while after the
  440. conference.
  441.  
  442. <P>Safari's source is all browse-able on the web in the perforce
  443. public depot and will be distributed via CPAN in tarball form.
  444.  
  445. <P>Mailing lists exist for Safari announcements and developer discussions.
  446. More details are available on the Safari web site. Please join and
  447. contribute.
  448.  
  449. <H2><A NAME="Growth"></a>5. Growth Plan</H3>
  450.  
  451. <P>Safari has a lot of room to grow. It is designed to be an open-ended
  452. project. Areas of significant development are:
  453.  
  454. <UL>
  455.    <LI>Indexing. Since many source code archives contain a milieu of programming
  456.    and non-programming languages, indexing is quite a challenge. It should
  457.    be a very interesting project. 
  458.    <LI>Given good indexing, automatic activation of important words in
  459.    displayed documents provides an extremely useful mechanism that makes
  460.    Safari much more useful than most editors as a code browser.
  461.    <LI>A library of back ends to different RCSs and SCMs needs to be
  462.    built. Perforce and the local filesystem are the only back ends currently
  463.    implemented. Back ends to PVCS, CVS and MKS SI are in development by
  464.    myself and others.
  465.    <LI>A library of contributed scripts and Makefiles will be collected
  466.    and published to promote cross-pollination.
  467.    <LI>Partial parsing of source languages will greatly facilitate better
  468.    indexing and syntax highlighting. This parsing can provide the 
  469.    context for each indexed word or phrase, like
  470.    whether it's a variable, macro, function, typename, or comment. This can
  471.    allow for finer grained searches and for better syntax highlighting and
  472.    automatic link generation when marking up source files.
  473.    <LI>Alternate user interfaces, like a tree view control. Safari's
  474.    intentionally lowest-common-denominator HTML GUI needs to remain,
  475.    but that should not limit it's growth.
  476.    <LI>It shouldn't be very far from a browser to a simple check-in/checkout
  477.    locking and merging interface, especially given the work on WebDAV.
  478.    <LI>Allowing a mechanism for sticky-notes to be created and attached to
  479.    source code would make Safari an incredibly powerful code review tool.
  480. </UL>
  481.  
  482. <P><B>Please join and contribute!!</B>
  483.  
  484. <H2><A NAME="Samples"></A>Appendix A. Sample Pages</H2>
  485.  
  486. <P>Several example pages are given in the order you would browse them
  487. in.
  488.  
  489. <HR>
  490. <A NAME="depots"></A><TABLE BORDER="1"><TR><TH>Location:
  491. http://localhost/safaridev/perforce/_head/Default/
  492. </TH></TR>
  493. <TR><TD>The list of depots available at public.perforce.com:1666</TD></TR>
  494. </TABLE>
  495.  
  496.  
  497. <TABLE WIDTH="100%" BORDER="0" CELLPADDING="10" CELLSPACING="0">
  498. <TR>
  499.    <TD BGCOLOR="#B0E0FF" ALIGN="CENTER" COLSPAN="2"><FONT SIZE="+3">perforce/</FONT> (Default filter)</TD>
  500. </TR>
  501. <TR>
  502. <TD BGCOLOR="#B0E0FF" VALIGN="TOP">
  503. <FONT SIZE="-1"><B>PROJECT</B></FONT><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="">top</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;up<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../_head/changes/index.html">changes</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../_head/labels/index.html">labels</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="?force=yes&">rebuild</A><BR><BR>
  504.  
  505.  
  506. <BR>
  507. </TD>
  508. <TD WIDTH="99%" VALIGN="TOP" ALIGN="LEFT">
  509.  
  510. <TABLE CELLPADDING="5" CELLSPACING="0" BORDER="0">
  511. <TR ALIGN="LEFT"><TH ALIGN="RIGHT"><BR></TH><TH ALIGN="LEFT">Depot</TH><TH ALIGN="LEFT">Description</TH></TR>
  512. <TR><TD ALIGN="RIGHT">1</TD><TD ALIGN="LEFT"><A HREF="guest/">guest/</A></TD><TD ALIGN="LEFT">Depot for guest users. </TD></TR>
  513. <TR><TD ALIGN="RIGHT">2</TD><TD ALIGN="LEFT"><A HREF="public/">public/</A></TD><TD ALIGN="LEFT">Perforce's open source depot. </TD></TR>
  514.  
  515. </TABLE>
  516.  
  517. </TD>
  518. <TR BGCOLOR="#B0E0FF">
  519.    <TD ALIGN="CENTER" COLSPAN="2">This page generated by Safari at Wed Jun 16 15:08:39 1999</TD>
  520. </TR>
  521. </TABLE>
  522.  
  523. <HR>
  524. <A NAME="public"></A><TABLE BORDER="1"><TR><TH>Location:
  525. http://localhost/safaridev/perforce/_head/Default/public/
  526. </TH></TR>
  527. <TR><TD>The list of depots files available in the public depot ( //public/* ) at public.perforce.com:1666, and their<BR>
  528. revision levels and last change number, as of the head revision.</TD></TR>
  529. </TABLE>
  530. <TABLE WIDTH="100%" BORDER="0" CELLPADDING="10" CELLSPACING="0">
  531. <TR>
  532.    <TD BGCOLOR="#B0E0FF" ALIGN="CENTER" COLSPAN="2"><FONT SIZE="+3">perforce/public/</FONT> (Default filter)</TD>
  533. </TR>
  534. <TR>
  535. <TD BGCOLOR="#B0E0FF" VALIGN="TOP">
  536. <FONT SIZE="-1"><B>PROJECT</B></FONT><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../">top</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../">up</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../../_head/changes/index.html">changes</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../../_head/labels/index.html">labels</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="?force=yes&">rebuild</A><BR><BR>
  537.  
  538.  
  539. <BR>
  540. </TD>
  541. <TD WIDTH="99%" VALIGN="TOP" ALIGN="LEFT">
  542.  
  543. <TABLE CELLPADDING="5" CELLSPACING="0" BORDER="0">
  544. <TR ALIGN="LEFT"><TH ALIGN="RIGHT"><BR></TH><TH ALIGN="LEFT">File</TH><TH ALIGN="RIGHT">Rev</TH><TH ALIGN="LEFT">Description</TH><TH ALIGN="RIGHT">Change</TH><TH ALIGN="LEFT">Type</TH></TR>
  545. <TR><TD ALIGN="RIGHT">1</TD><TD ALIGN="LEFT"><A HREF="index.html">index.html</A></TD><TD ALIGN="RIGHT"><A HREF="index.html?filter=filelog">#17</A></TD><TD ALIGN="LEFT">edit</TD><TD ALIGN="RIGHT"><A HREF="../../../_head/changes/114.html">114</A></TD><TD ALIGN="LEFT">ktext</TD></TR>
  546. <TR><TD ALIGN="RIGHT">2</TD><TD ALIGN="LEFT"><A HREF="jam/">jam/</A></TD><TD ALIGN="RIGHT"><A HREF="jam/?filter=filelog">#2</A></TD><TD ALIGN="LEFT">integrate</TD><TD ALIGN="RIGHT"><A HREF="../../../_head/changes/76.html">76</A></TD><TD ALIGN="LEFT">xtext</TD></TR>
  547. <TR><TD ALIGN="RIGHT">3</TD><TD ALIGN="LEFT"><A HREF="perforce/">perforce/</A></TD><TD ALIGN="RIGHT"><A HREF="perforce/?filter=filelog">#2</A></TD><TD ALIGN="LEFT">edit</TD><TD ALIGN="RIGHT"><A HREF="../../../_head/changes/98.html">98</A></TD><TD ALIGN="LEFT">ktext</TD></TR>
  548. <TR><TD ALIGN="RIGHT">4</TD><TD ALIGN="LEFT"><A HREF="tutorial.html">tutorial.html</A></TD><TD ALIGN="RIGHT"><A HREF="tutorial.html?filter=filelog">#9</A></TD><TD ALIGN="LEFT">edit</TD><TD ALIGN="RIGHT"><A HREF="../../../_head/changes/147.html">147</A></TD><TD ALIGN="LEFT">ktext</TD></TR>
  549.  
  550. </TABLE>
  551.  
  552. </TD>
  553. <TR BGCOLOR="#B0E0FF">
  554.    <TD ALIGN="CENTER" COLSPAN="2">This page generated by Safari at Wed Jun 16 15:42:46 1999</TD>
  555. </TR>
  556. </TABLE>
  557.  
  558. <HR>
  559. <A NAME="Default"></A><TABLE BORDER="1"><TR><TH>Location:
  560. http://localhost/safaridev/perforce/_head/Default/public/index.html
  561. </TH></TR>
  562. <TR><TD>The head revision of //public/index.html from public.perforce.com:1666</TD></TR>
  563. </TABLE>
  564.  
  565. <TABLE WIDTH="100%" BORDER="0" CELLPADDING="10" CELLSPACING="0">
  566. <TR>
  567.    <TD BGCOLOR="#B0E0FF" ALIGN="CENTER" COLSPAN="2"><FONT SIZE="+3">perforce/public/index.html</FONT> (HTML filter)</TD>
  568. </TR>
  569. <TR>
  570. <TD BGCOLOR="#B0E0FF" VALIGN="TOP">
  571. <FONT SIZE="-1"><B>PROJECT</B></FONT><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../">top</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="">up</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../../_head/changes/index.html">changes</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../../_head/labels/index.html">labels</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="index.html?force=yes&">rebuild</A><BR><BR>
  572.  
  573. <FONT SIZE="-1"><B>FILTERS</B></FONT><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../Default/public/index.html">Default</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../POD/public/index.html">POD</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../pretty/public/index.html">pretty</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../plain/public/index.html">plain</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../HTML/public/index.html">HTML</A><BR><BR>
  574.  
  575. <FONT SIZE="-1"><B>TOOLS</B></FONT><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="index.html?filter=gcclint">gcclint</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="index.html?filter=wc">wc</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="index.html?rev=_head&filter=filelog">filelog</A><BR><BR>
  576.  
  577. </TD>
  578. <TD WIDTH="99%" VALIGN="TOP" ALIGN="LEFT">
  579.  
  580. <CENTER>
  581. <P>
  582. <A NAME="toc"></A>
  583. <A HREF="http://www.perforce.com">
  584. <IMG SRC="http://www.perforce.com/images/logo.gif" alt="Perforce" border=0></A>
  585. <H1>
  586. Welcome to the Perforce Public Depot
  587. </H1>
  588. <P>
  589.  
  590. <TABLE BORDER=0><TR><TD>
  591. <B>
  592. <UL>
  593. <LI><A HREF="#aboutPerforce">About Perforce and the Public Depot
  594. </A>
  595. <LI><A HREF="#roadmap">The Depot Road Map
  596. </A>
  597. <LI><A HREF="#howtobrowse">How to Browse the Depot
  598. </A>
  599. <LI><A HREF="#howtocontrib">How to Contribute to the Depot
  600. </A>
  601. </UL>
  602. </UL>
  603. </TABLE>
  604. </CENTER>
  605. <br>
  606. <br>
  607. <br>
  608.  
  609. <!------------------------------------------------------------------>
  610. <P>
  611. <TABLE CELLSPACING=0 BORDER=0 WIDTH=100%><TR><TD BGCOLOR=FFCC66>
  612.  
  613. <A NAME="aboutPerforce"></A>
  614. <H2>About Perforce and the Public Depot
  615. </H2>
  616.  
  617.  
  618. <TD WIDTH=5% BGCOLOR=FFCC66 ALIGN=RIGHT><FONT SIZE="-2"><A HREF="#toc">
  619. Back to<BR>Table of<BR>Contents</A></TD></TR>
  620. </TABLE>
  621.  
  622. <P ALIGN="CENTER"><B> [...lots of good information snipped for brevity...] </B>
  623.  
  624. <!------------------------------------------------------------------>
  625. <P>
  626. <TABLE CELLSPACING=0 BORDER=0 WIDTH=100%>
  627. <TR>
  628.  
  629. <TD WIDTH=15% BGCOLOR=FFCC66 ALIGN=LEFT VALIGN=CENTER>
  630. <FONT SIZE="-2">
  631. Copyright &copy;<br>
  632. 1998, 1999<br>
  633. <a href="http://www.perforce.com">Perforce Software</a><br>
  634. </FONT>
  635. </TD>
  636.  
  637. <TD WIDTH=70% BGCOLOR=FFCC66 ALIGN=CENTER>
  638. <FONT SIZE="-2">
  639. You're browsing a file stored as<br> 
  640. <code>$Id: //public/index.html#17 $</code><br> 
  641. in the 
  642. <A HREF=http://public.perforce.com/public/index.html>Perforce Public Depot</A>.
  643. </FONT>
  644. </TD>
  645.  
  646. <TD WIDTH=15% BGCOLOR=FFCC66 ALIGN=RIGHT>
  647. <FONT SIZE="-2"><A HREF="#toc">
  648. Back to<BR>Table of<BR>Contents</A></TD></TR>
  649. </FONT>
  650. </TD>
  651.  
  652. </TR>
  653. </TABLE>
  654. <!------------------------------------------------------------------>
  655.  
  656.  
  657.  
  658.  
  659. </TD>
  660. <TR BGCOLOR="#B0E0FF">
  661.    <TD ALIGN="CENTER" COLSPAN="2">This page generated by Safari at Fri Jun 18 02:24:59 1999</TD>
  662. </TR>
  663. </TABLE>
  664.  
  665. <HR>
  666. <A NAME="pretty"></A><TABLE BORDER="1"><TR><TH>Location:
  667. http://localhost/safaridev/perforce/_head/pretty/public/index.html
  668. </TH></TR>
  669. <TR><TD>The syntax highlighted source code for the head revision of //public/index.html from<BR> public.perforce.com:1666</TD></TR>
  670. </TABLE>
  671.  
  672. <TABLE WIDTH="100%" BORDER="0" CELLPADDING="10" CELLSPACING="0">
  673. <TR>
  674.    <TD BGCOLOR="#B0E0FF" ALIGN="CENTER" COLSPAN="2"><FONT SIZE="+3">perforce/public/index.html</FONT> (pretty filter)</TD>
  675. </TR>
  676. <TR>
  677. <TD BGCOLOR="#B0E0FF" VALIGN="TOP">
  678. <FONT SIZE="-1"><B>PROJECT</B></FONT><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../">top</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="">up</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../../_head/changes/index.html">changes</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../../_head/labels/index.html">labels</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="index.html?force=yes&">rebuild</A><BR><BR>
  679.  
  680. <FONT SIZE="-1"><B>FILTERS</B></FONT><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../Default/public/index.html">Default</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../POD/public/index.html">POD</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../pretty/public/index.html">pretty</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../plain/public/index.html">plain</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../HTML/public/index.html">HTML</A><BR><BR>
  681.  
  682. <FONT SIZE="-1"><B>TOOLS</B></FONT><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="index.html?filter=gcclint">gcclint</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="index.html?filter=wc">wc</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="index.html?rev=_head&filter=filelog">filelog</A><BR><BR>
  683.  
  684. </TD>
  685. <TD WIDTH="99%" VALIGN="TOP" ALIGN="LEFT">
  686. <pre>
  687. <a name="line1" href="#line1">  1</a>  <font color="#993333"><font color="#0000aa"><strong>&lt;</strong></font><font color="#0000ff">H</font><font color="#0000ff">T</font><font color="#0000ff">M</font><font color="#0000ff">L</font><font color="#0000aa"><strong>&gt;</strong></font></font>
  688. <a name="line2" href="#line2">  2</a>  
  689. <a name="line3" href="#line3">  3</a>  <font color="#993333"><font color="#0000aa"><strong>&lt;</strong></font><font color="#0000ff">H</font><font color="#0000ff">E</font><font color="#0000ff">A</font><font color="#0000ff">D</font><font color="#0000aa"><strong>&gt;</strong></font></font>
  690. <a name="line4" href="#line4">  4</a>  
  691. <a name="line5" href="#line5">  5</a>  <font color="#993333"><font color="#0000aa"><strong>&lt;</strong></font><font color="#0000ff">T</font><font color="#0000ff">I</font><font color="#0000ff">T</font><font color="#0000ff">L</font><font color="#0000ff">E</font><font color="#0000aa"><strong>&gt;</strong></font></font>
  692. <a name="line6" href="#line6">  6</a>  Perforce Public Depot
  693. <a name="line7" href="#line7">  7</a>  <font color="#993333"><font color="#0000aa"><strong>&lt;</strong></font><font color="#0000ff">/</font><font color="#0000ff">T</font><font color="#0000ff">I</font><font color="#0000ff">T</font><font color="#0000ff">L</font><font color="#0000ff">E</font><font color="#0000aa"><strong>&gt;</strong></font></font>
  694. <a name="line8" href="#line8">  8</a>  
  695. <a name="line9" href="#line9">  9</a>  <font color="#993333"><font color="#0000aa"><strong>&lt;</strong></font><font color="#0000ff">/</font><font color="#0000ff">H</font><font color="#0000ff">E</font><font color="#0000ff">A</font><font color="#0000ff">D</font><font color="#0000aa"><strong>&gt;</strong></font></font>
  696. <a name="line10" href="#line10"> 10</a>  
  697. <a name="line11" href="#line11"> 11</a>  <font color="#993333"><font color="#0000aa"><strong>&lt;</strong></font><font color="#0000ff">B</font><font color="#0000ff">O</font><font color="#0000ff">D</font><font color="#0000ff">Y</font><font color="#0000ff"> </font><font color="#0000ff">B</font><font color="#0000ff">G</font><font color="#0000ff">C</font><font color="#0000ff">O</font><font color="#0000ff">L</font><font color="#0000ff">O</font><font color="#0000ff">R</font><font color="#0000ff">=</font><font color="#008000">&quot;#FFFFFF&quot;</font><font color="#0000aa"><strong>&gt;</strong></font></font>
  698. <a name="line12" href="#line12"> 12</a>  <font color="#993333"><font color="#0000aa"><strong>&lt;</strong></font><font color="#0000ff">C</font><font color="#0000ff">E</font><font color="#0000ff">N</font><font color="#0000ff">T</font><font color="#0000ff">E</font><font color="#0000ff">R</font><font color="#0000aa"><strong>&gt;</strong></font></font>
  699. <a name="line13" href="#line13"> 13</a>  <font color="#993333"><font color="#0000aa"><strong>&lt;</strong></font><font color="#0000ff">P</font><font color="#0000aa"><strong>&gt;</strong></font></font>
  700. <a name="line14" href="#line14"> 14</a>  <font color="#993333"><font color="#0000aa"><strong>&lt;</strong></font><font color="#0000ff">A</font><font color="#0000ff"> </font><font color="#0000ff">N</font><font color="#0000ff">A</font><font color="#0000ff">M</font><font color="#0000ff">E</font><font color="#0000ff">=</font><font color="#008000">&quot;toc&quot;</font><font color="#0000aa"><strong>&gt;</strong></font></font><font color="#993333"><font color="#0000aa"><strong>&lt;</strong></font><font color="#0000ff">/</font><font color="#0000ff">A</font><font color="#0000aa"><strong>&gt;</strong></font></font>
  701. <a name="line15" href="#line15"> 15</a>  <font color="#993333"><font color="#0000aa"><strong>&lt;</strong></font><font color="#0000ff">A</font><font color="#0000ff"> </font><font color="#0000ff">H</font><font color="#0000ff">R</font><font color="#0000ff">E</font><font color="#0000ff">F</font><font color="#0000ff">=</font><font color="#008000">&quot;http://www.perforce.com&quot;</font><font color="#0000aa"><strong>&gt;</strong></font></font>
  702. <a name="line16" href="#line16"> 16</a>  <font color="#993333"><font color="#0000aa"><strong>&lt;</strong></font><font color="#0000ff">I</font><font color="#0000ff">M</font><font color="#0000ff">G</font><font color="#0000ff"> </font><font color="#0000ff">S</font><font color="#0000ff">R</font><font color="#0000ff">C</font><font color="#0000ff">=</font><font color="#008000">&quot;http://www.perforce.com/images/logo.gif&quot;</font><font color="#0000ff"> </font><font color="#0000ff">a</font><font color="#0000ff">l</font><font color="#0000ff">t</font><font color="#0000ff">=</font><font color="#008000">&quot;Perforce&quot;</font><font color="#0000ff"> </font><font color="#0000ff">b</font><font color="#0000ff">o</font><font color="#0000ff">r</font><font color="#0000ff">d</font><font color="#0000ff">e</font><font color="#0000ff">r</font><font color="#0000ff">=</font><font color="#0000ff">0</font><font color="#0000aa"><strong>&gt;</strong></font></font><font color="#993333"><font color="#0000aa"><strong>&lt;</strong></font><font color="#0000ff">/</font><font color="#0000ff">A</font><font color="#0000aa"><strong>&gt;</strong></font></font>
  703. <a name="line17" href="#line17"> 17</a>  <font color="#993333"><font color="#0000aa"><strong>&lt;</strong></font><font color="#0000ff">H</font><font color="#0000ff">1</font><font color="#0000aa"><strong>&gt;</strong></font></font>
  704. <a name="line18" href="#line18"> 18</a>  Welcome to the Perforce Public Depot
  705. <a name="line19" href="#line19"> 19</a>  <font color="#993333"><font color="#0000aa"><strong>&lt;</strong></font><font color="#0000ff">/</font><font color="#0000ff">H</font><font color="#0000ff">1</font><font color="#0000aa"><strong>&gt;</strong></font></font>
  706. <a name="line20" href="#line20"> 20</a>  <font color="#993333"><font color="#0000aa"><strong>&lt;</strong></font><font color="#0000ff">P</font><font color="#0000aa"><strong>&gt;</strong></font></font>
  707. <B> [...more lines, snipped for brevity...] </B>
  708. </pre>
  709. </TD>
  710. <TR BGCOLOR="#B0E0FF">
  711.    <TD ALIGN="CENTER" COLSPAN="2">This page generated by Safari at Fri Jun 18 02:25:38 1999</TD>
  712. </TR>
  713. </TABLE>
  714.  
  715. <HR>
  716. <A NAME="wc"></A><TABLE BORDER="1"><TR><TH>Location:
  717. http://localhost/safaridev/perforce/_head/pretty/public/index.html?filter=wc
  718. </TH></TR>
  719. <TR><TD>Output of the '<TT>wc</TT>' command applied to the
  720. file //public/index.html</TD></TR>
  721. </TABLE>
  722.  
  723. <TABLE WIDTH="100%" BORDER="0" CELLPADDING="10" CELLSPACING="0">
  724. <TR>
  725.    <TD BGCOLOR="#B0E0FF" ALIGN="CENTER" COLSPAN="2"><FONT SIZE="+3">perforce/public/index.html</FONT> (wc filter)</TD>
  726. </TR>
  727. <TR>
  728. <TD BGCOLOR="#B0E0FF" VALIGN="TOP">
  729. <FONT SIZE="-1"><B>PROJECT</B></FONT><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../">top</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="">up</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../../_head/changes/index.html">changes</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../../_head/labels/index.html">labels</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="index.html?force=yes&filter=wc">rebuild</A><BR><BR>
  730.  
  731. <FONT SIZE="-1"><B>FILTERS</B></FONT><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../Default/public/index.html">Default</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../POD/public/index.html">POD</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../pretty/public/index.html">pretty</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../plain/public/index.html">plain</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../HTML/public/index.html">HTML</A><BR><BR>
  732.  
  733. <FONT SIZE="-1"><B>TOOLS</B></FONT><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="index.html?filter=gcclint">gcclint</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;wc<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="index.html?rev=_head&filter=filelog">filelog</A><BR><BR>
  734.  
  735. </TD>
  736. <TD WIDTH="99%" VALIGN="TOP" ALIGN="LEFT">
  737.  
  738. <PRE>453 lines, 1257 words, 12271 bytes in _head/public/index.html
  739. </PRE>
  740.  
  741. </TD>
  742. <TR BGCOLOR="#B0E0FF">
  743.    <TD ALIGN="CENTER" COLSPAN="2">This page generated by Safari at Fri Jun 18 02:27:13 1999</TD>
  744. </TR>
  745. </TABLE>
  746. <HR>
  747. <A NAME="filelog"></A><TABLE BORDER="1"><TR><TH>Location:
  748. http://localhost/safaridev/perforce/_head/pretty/public/index.html?rev=_head&filter=filelog
  749. </TH></TR>
  750. <TR><TD>The complete revision history of the file //public/index.html</TD></TR>
  751. </TABLE>
  752.  
  753. <TABLE WIDTH="100%" BORDER="0" CELLPADDING="10" CELLSPACING="0">
  754. <TR>
  755.    <TD BGCOLOR="#B0E0FF" ALIGN="CENTER" COLSPAN="2"><FONT SIZE="+3">perforce/public/index.html</FONT> (filelog filter)</TD>
  756. </TR>
  757. <TR>
  758. <TD BGCOLOR="#B0E0FF" VALIGN="TOP">
  759. <FONT SIZE="-1"><B>PROJECT</B></FONT><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../">top</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="">up</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../../_head/changes/index.html">changes</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../../_head/labels/index.html">labels</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="index.html?force=yes&rev=_head&filter=filelog">rebuild</A><BR><BR>
  760.  
  761. <FONT SIZE="-1"><B>FILTERS</B></FONT><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../Default/public/index.html">Default</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../POD/public/index.html">POD</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../pretty/public/index.html">pretty</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../plain/public/index.html">plain</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../HTML/public/index.html">HTML</A><BR><BR>
  762.  
  763. <FONT SIZE="-1"><B>TOOLS</B></FONT><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="index.html?filter=gcclint">gcclint</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="index.html?filter=wc">wc</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="index.html?rev=_head&filter=filelog">filelog</A><BR><BR>
  764.  
  765. </TD>
  766. <TD WIDTH="99%" VALIGN="TOP" ALIGN="LEFT">
  767.  
  768. <UL>
  769. <TABLE>
  770. <TR ALIGN="LEFT"><TH>Rev</TH><TH>Act.</TH><TH>Date</TH><TH>User</TH><TH>Change</TH><TH>Desc</TH><TH>Labels</TH><TH>Opened_by</TH><TH></TR>
  771. </TH><TR><TD VALIGN="TOP"><A HREF="../../../_17/pretty/public/index.html">17</A></TD><TD VALIGN="TOP">edit</TD><TD VALIGN="TOP">1999/03/22</TD><TD VALIGN="TOP">laura_wingerd</TD><TD VALIGN="TOP"><A HREF="../../../_head/changes/114.html">114</A></TD><TD VALIGN="TOP"><tt>Fix typos in links. </tt></TD><TD VALIGN="TOP"><b></b></TD><TD VALIGN="TOP"></TD><TD VALIGN="TOP"></TR>
  772. </TD><TR><TD VALIGN="TOP"><A HREF="../../../_16/pretty/public/index.html">16</A></TD><TD VALIGN="TOP">edit</TD><TD VALIGN="TOP">1999/03/15</TD><TD VALIGN="TOP">laura_wingerd</TD><TD VALIGN="TOP"><A HREF="../../../_head/changes/94.html">94</A></TD><TD VALIGN="TOP"><tt>Re-org "triggers" directory -- </tt></TD><TD VALIGN="TOP"><b></b></TD><TD VALIGN="TOP"></TD><TD VALIGN="TOP"></TR>
  773. </TD><TR><TD VALIGN="TOP"><A HREF="../../../_15/pretty/public/index.html">15</A></TD><TD VALIGN="TOP">edit</TD><TD VALIGN="TOP">1999/01/05</TD><TD VALIGN="TOP">laura_wingerd</TD><TD VALIGN="TOP"><A HREF="../../../_head/changes/52.html">52</A></TD><TD VALIGN="TOP"><tt>Minor web page format changes. </tt></TD><TD VALIGN="TOP"><b></b></TD><TD VALIGN="TOP"></TD><TD VALIGN="TOP"></TR>
  774. </TD><TR><TD VALIGN="TOP"><A HREF="../../../_14/pretty/public/index.html">14</A></TD><TD VALIGN="TOP">edit</TD><TD VALIGN="TOP">1999/01/05</TD><TD VALIGN="TOP">laura_wingerd</TD><TD VALIGN="TOP"><A HREF="../../../_head/changes/51.html">51</A></TD><TD VALIGN="TOP"><tt>Update copyright year. </tt></TD><TD VALIGN="TOP"><b></b></TD><TD VALIGN="TOP"></TD><TD VALIGN="TOP"></TR>
  775. </TD><TR><TD VALIGN="TOP"><A HREF="../../../_13/pretty/public/index.html">13</A></TD><TD VALIGN="TOP">edit</TD><TD VALIGN="TOP">1999/01/05</TD><TD VALIGN="TOP">laura_wingerd</TD><TD VALIGN="TOP"><A HREF="../../../_head/changes/50.html">50</A></TD><TD VALIGN="TOP"><tt>Minor PD doc changes. </tt></TD><TD VALIGN="TOP"><b></b></TD><TD VALIGN="TOP"></TD><TD VALIGN="TOP"></TR>
  776. </TD><TR><TD VALIGN="TOP"><A HREF="../../../_12/pretty/public/index.html">12</A></TD><TD VALIGN="TOP">edit</TD><TD VALIGN="TOP">1998/12/24</TD><TD VALIGN="TOP">perforce</TD><TD VALIGN="TOP"><A HREF="../../../_head/changes/46.html">46</A></TD><TD VALIGN="TOP"><tt>Add WebKeeper source. </tt></TD><TD VALIGN="TOP"><b></b></TD><TD VALIGN="TOP"></TD><TD VALIGN="TOP"></TR>
  777. </TD><TR><TD VALIGN="TOP"><A HREF="../../../_11/pretty/public/index.html">11</A></TD><TD VALIGN="TOP">edit</TD><TD VALIGN="TOP">1998/12/03</TD><TD VALIGN="TOP">laura_wingerd</TD><TD VALIGN="TOP"><A HREF="../../../_head/changes/42.html">42</A></TD><TD VALIGN="TOP"><tt>Fix links in index pages, add o</tt></TD><TD VALIGN="TOP"><b></b></TD><TD VALIGN="TOP"></TD><TD VALIGN="TOP"></TR>
  778. </TD><TR><TD VALIGN="TOP"><A HREF="../../../_10/pretty/public/index.html">10</A></TD><TD VALIGN="TOP">edit</TD><TD VALIGN="TOP">1998/11/05</TD><TD VALIGN="TOP">perforce</TD><TD VALIGN="TOP"><A HREF="../../../_head/changes/28.html">28</A></TD><TD VALIGN="TOP"><tt>Reword intro, fix typos, fix na</tt></TD><TD VALIGN="TOP"><b></b></TD><TD VALIGN="TOP"></TD><TD VALIGN="TOP"></TR>
  779. </TD><TR><TD VALIGN="TOP"><A HREF="../../../_9/pretty/public/index.html">9</A></TD><TD VALIGN="TOP">edit</TD><TD VALIGN="TOP">1998/10/26</TD><TD VALIGN="TOP">perforce</TD><TD VALIGN="TOP"><A HREF="../../../_head/changes/26.html">26</A></TD><TD VALIGN="TOP"><tt>Fleshed out "how to contribute"</tt></TD><TD VALIGN="TOP"><b></b></TD><TD VALIGN="TOP"></TD><TD VALIGN="TOP"></TR>
  780. </TD><TR><TD VALIGN="TOP"><A HREF="../../../_8/pretty/public/index.html">8</A></TD><TD VALIGN="TOP">edit</TD><TD VALIGN="TOP">1998/10/22</TD><TD VALIGN="TOP">perforce</TD><TD VALIGN="TOP"><A HREF="../../../_head/changes/22.html">22</A></TD><TD VALIGN="TOP"><tt>Added "About the depot" section</tt></TD><TD VALIGN="TOP"><b></b></TD><TD VALIGN="TOP"></TD><TD VALIGN="TOP"></TR>
  781. </TD><TR><TD VALIGN="TOP"><A HREF="../../../_7/pretty/public/index.html">7</A></TD><TD VALIGN="TOP">edit</TD><TD VALIGN="TOP">1998/10/09</TD><TD VALIGN="TOP">perforce</TD><TD VALIGN="TOP"><A HREF="../../../_head/changes/19.html">19</A></TD><TD VALIGN="TOP"><tt>Fix browser links, add lost tra</tt></TD><TD VALIGN="TOP"><b></b></TD><TD VALIGN="TOP"></TD><TD VALIGN="TOP"></TR>
  782. </TD><TR><TD VALIGN="TOP"><A HREF="../../../_6/pretty/public/index.html">6</A></TD><TD VALIGN="TOP">edit</TD><TD VALIGN="TOP">1998/10/09</TD><TD VALIGN="TOP">perforce</TD><TD VALIGN="TOP"><A HREF="../../../_head/changes/15.html">15</A></TD><TD VALIGN="TOP"><tt>Added browser links to index. </tt></TD><TD VALIGN="TOP"><b></b></TD><TD VALIGN="TOP"></TD><TD VALIGN="TOP"></TR>
  783. </TD><TR><TD VALIGN="TOP"><A HREF="../../../_5/pretty/public/index.html">5</A></TD><TD VALIGN="TOP">edit</TD><TD VALIGN="TOP">1998/10/05</TD><TD VALIGN="TOP">perforce</TD><TD VALIGN="TOP"><A HREF="../../../_head/changes/10.html">10</A></TD><TD VALIGN="TOP"><tt>Added "How to Browse". </tt></TD><TD VALIGN="TOP"><b></b></TD><TD VALIGN="TOP"></TD><TD VALIGN="TOP"></TR>
  784. </TD><TR><TD VALIGN="TOP"><A HREF="../../../_4/pretty/public/index.html">4</A></TD><TD VALIGN="TOP">edit</TD><TD VALIGN="TOP">1998/10/02</TD><TD VALIGN="TOP">perforce</TD><TD VALIGN="TOP"><A HREF="../../../_head/changes/9.html">9</A></TD><TD VALIGN="TOP"><tt>Add road map & nicer formatting</tt></TD><TD VALIGN="TOP"><b></b></TD><TD VALIGN="TOP"></TD><TD VALIGN="TOP"></TR>
  785. </TD><TR><TD VALIGN="TOP"><A HREF="../../../_3/pretty/public/index.html">3</A></TD><TD VALIGN="TOP">edit</TD><TD VALIGN="TOP">1998/10/02</TD><TD VALIGN="TOP">perforce</TD><TD VALIGN="TOP"><A HREF="../../../_head/changes/8.html">8</A></TD><TD VALIGN="TOP"><tt>Change to ktext. </tt></TD><TD VALIGN="TOP"><b></b></TD><TD VALIGN="TOP"></TD><TD VALIGN="TOP"></TR>
  786. </TD><TR><TD VALIGN="TOP"><A HREF="../../../_2/pretty/public/index.html">2</A></TD><TD VALIGN="TOP">edit</TD><TD VALIGN="TOP">1998/10/02</TD><TD VALIGN="TOP">perforce</TD><TD VALIGN="TOP"><A HREF="../../../_head/changes/7.html">7</A></TD><TD VALIGN="TOP"><tt>Test links in index page. </tt></TD><TD VALIGN="TOP"><b></b></TD><TD VALIGN="TOP"></TD><TD VALIGN="TOP"></TR>
  787. </TD><TR><TD VALIGN="TOP"><A HREF="../../../_1/pretty/public/index.html">1</A></TD><TD VALIGN="TOP">add</TD><TD VALIGN="TOP">1998/10/02</TD><TD VALIGN="TOP">perforce</TD><TD VALIGN="TOP"><A HREF="../../../_head/changes/6.html">6</A></TD><TD VALIGN="TOP"><tt>Open source depot index. </tt></TD><TD VALIGN="TOP"><b></b></TD><TD VALIGN="TOP"></TD><TD VALIGN="TOP"></TR>
  788. </TD></TABLE>
  789.  
  790. </TD>
  791. <TR BGCOLOR="#B0E0FF">
  792.    <TD ALIGN="CENTER" COLSPAN="2">This page generated by Safari at Fri Jun 18 02:27:54 1999</TD>
  793. </TR>
  794. </TABLE>
  795.  
  796. <HR>
  797. <A NAME="c6"></A><TABLE BORDER="1"><TR><TH>Location:
  798. http://www.slaysys.com/safaridev/perforce/@6/Default/public/index.html
  799. </TH></TR>
  800. <TR><TD>The file index.html as of change number 6.</TD></TR>
  801. </TABLE>
  802.  
  803.  
  804. <TABLE WIDTH="100%" BORDER="0" CELLPADDING="10" CELLSPACING="0">
  805. <TR>
  806.    <TD BGCOLOR="#B0E0FF" ALIGN="CENTER" COLSPAN="2"><FONT SIZE="+3">perforce/public/index.html</FONT> (HTML filter)</TD>
  807. </TR>
  808. <TR>
  809. <TD BGCOLOR="#B0E0FF" VALIGN="TOP">
  810. <FONT SIZE="-1"><B>PROJECT</B></FONT><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../">top</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="">up</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../../_head/changes/index.html">changes</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../../_head/labels/index.html">labels</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="index.html?force=yes&">rebuild</A><BR><BR>
  811.  
  812. <FONT SIZE="-1"><B>FILTERS</B></FONT><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../Default/public/index.html">Default</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../POD/public/index.html">POD</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../pretty/public/index.html">pretty</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../plain/public/index.html">plain</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="../../HTML/public/index.html">HTML</A><BR><BR>
  813.  
  814. <FONT SIZE="-1"><B>TOOLS</B></FONT><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="index.html?filter=gcclint">gcclint</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="index.html?filter=wc">wc</A><BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="index.html?rev=_head&filter=filelog">filelog</A><BR><BR>
  815.  
  816. </TD>
  817. <TD WIDTH="99%" VALIGN="TOP" ALIGN="LEFT">
  818.  
  819. <h3>Testing...</h3>
  820. This is a test.
  821. <p>
  822. This should be the Perforce 
  823. <a href=../index.html>home page</a>.
  824.  
  825.  
  826.  
  827. </TD>
  828. <TR BGCOLOR="#B0E0FF">
  829.    <TD ALIGN="CENTER" COLSPAN="2">This page generated by Safari at Fri Jun 18 04:59:03 1999</TD>
  830. </TR>
  831. </TABLE>
  832.  
  833. <h2><A NAME="References"></A>References</h2>
  834.  
  835. <P><A NAME="1">[1]</A> The Linux Cross Reference System 
  836. ( <A HREF="http://lxr.linux.no/">http://lxr.linux.no/</A> ).
  837.  
  838. <P><A NAME="2">[2]</A> The Perforce WebKeeper
  839. ( <A HREF="http://www.perforce.com/perforce/webkeeper.html">http://www.perforce.com/perforce/webkeeper.html</A> ).
  840.  
  841. <P><A NAME="3">[3]</A> The p4db Perforce Depot Browser
  842. ( <A HREF="http://public.perforce.com/cgi-bin/p4db/dtb.cgi?FSPC=public/perforce/utils/p4db">http://public.perforce.com/cgi-bin/p4db/dtb.cgi?FSPC=public/perforce/utils/p4db</A> ).
  843.  
  844. <P><A NAME="4">[4]</A> Mortice Kern Systems' Source Integrity Pro Software Configuration Management System
  845. ( <A HREF="http://www.mks.com/solution/si/pro/">http://www.mks.com/solution/si/pro/</A> ).
  846.  
  847. <P><A NAME="5">[5]</A> The Cocoon Utilities, Version 3.2, Jeffrey Kotula 
  848. ( <A HREF="http://www.stratasys.com/software/cocoon/">http://www.stratasys.com/software/cocoon/</A> ).
  849.  
  850. <P><A NAME="6">[6]</A> Mortice Kern Systems' Source Integrity 
  851. ( <A HREF="http://www.mks.com/solution/si/">http://www.mks.com/solution/si/</A> ).
  852. </body>
  853. </html>
# Change User Description Committed
#1 168 Barrie Slaymaker Added YAPC paper, slides 26 years ago