Helix SwarmHelix Swarm
Loading...

README.html

  • //
  • guest/
  • hari_krishna_dara/
  • perforce/
  • utils/
  • p4db/
  • P4DB_0/
  • README.html #1
  • View
  • Commits
  • Open Download .zip Download (7 KB) 
  1. <HTML>
  2. <HEAD>
  3.    <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
  4.    <META NAME="GENERATOR" CONTENT="Mozilla/4.03 [en] (X11; I; Linux 2.0.30 i586) [Netscape]">
  5.    <META NAME="Author" CONTENT="fredric@mydata.se">
  6.    <META NAME="Description" CONTENT="Information on how to install andmaintain P4DB">
  7.    <TITLE>Developers README file for P4DB</TITLE>
  8. </HEAD>
  9. <BODY>
  10.  
  11. <CENTER>
  12. <H1>
  13. A developers README for P4DB</H1></CENTER>
  14.  
  15. <H2>
  16. Introduction</H2>
  17.  
  18. <H3>
  19. Abstract</H3>
  20. This is a README for P4DB, a CGI based p4 depot browser written by Fredric
  21. Fredricson (<A HREF="mailto:fredric@mydata.se">fredric@mydata.se</A>) 
  22. (One part is written by Bob Sidebotham, no email available).
  23. The README is intended for administrators and others that want to install,
  24. maintain, and possibly contribute to, this sw package. You can read it
  25. anyway if You like but You will probably do quite well without.
  26. <H3>
  27. More introduction</H3>
  28. P4DB (P4 Depot Browser) was created to present information about the contents
  29. in the p4 depot in a nice way. Some CGI's also combine output from two
  30. or more p4 commands. The driving force behind the development has been
  31. my needs as a manager for a software team and the needs for our project
  32. leaders.
  33.  
  34. <P>The browser was developed for and runs on a Linux/Apache system and
  35. has been tested mainly with Netscape 4 although some of our users use MS
  36. Explorer and no problems has been reported.
  37. <H3>
  38. History</H3>
  39. The application was developed from a depot browser, perfbrowse.perl, made
  40. available by <A HREF="http://www.perforce.com">Perforce</A> at <A HREF="http://www.perforce.com/perforce/loadsupp.html#browse">http://www.perforce.com/perforce/loadsupp.html#browse</A>
  41.  
  42. <P>Perfbrowse.perl is written in perl and the author is unknown to
  43. me. Some code from perlbrowse.perl remains in P4DB but most parts are completely
  44. changed. The parts left untouched are the ones that were so good that I
  45. did not understand them.
  46.  
  47. <P>The idea is also stolen so I can't claim that one.
  48.  
  49. <P>To view file a script by Bob Sidebotham called 
  50. <A HREF="p4pr.perl"><tt>p4pr.perl</tt></A> is used. This script is also made
  51. available by Perforce at
  52. <A HREF="http://www.perforce.com/perforce/loadsupp.html#util">http://www.perforce.com/perforce/loadsupp.html#util</A> (only I made some minor changes and one bug fix).
  53.  
  54. <P>The reason I started to do this was that I liked perfbrowse.perl
  55. very much but wanted just a little more functionality. I started to add
  56. functionality and it quickly got out of hand. Soon I had a huuuge perl
  57. script that I could no longer maintain. Once I realized that I can write
  58. a perl script that is about 2-4 times the size of the script that I can
  59. maintain I decided to rewrite it all from the start as a set of small,
  60. maintainable, perl scripts. I leave to others to judge if I succeeded in
  61. my mission.
  62. <BR><I>(Maybe I should mention that it took much more time than I anticipated).</I>
  63. <H2>
  64. Installation</H2>
  65.  
  66. <H3>
  67. First: Where to install</H3>
  68. Other than the obvious, that is somewhere in a http servers CGI path, I
  69. recommend You to set up a http server on Your p4 server and run P4DB
  70. on the server. The main reasons are that it improves response time and
  71. reduces load on network.
  72. <P>
  73. One argument against this may be that You want to keep Your server clear
  74. from other apps that might create problems. Personally I don't think this
  75. is a very good one but this is up to You.
  76. <H3>
  77. How to install</H3>
  78. You obviously got to this README. Together with README.html file You got
  79. a file "install.pl".
  80. <BR>Type "<TT>perl install.pl</TT>" To install all scripts. This is the
  81. theory, at least. I have not tested it on many systems
  82.  
  83. <P>Install will first find out if You have CGI.pm installed and if not
  84. a copy will be unpacked. Second it will find out the path to perl, unpack
  85. all cgi scripts and modify the first line to contain the local path to
  86. perl.
  87.  
  88. <P>For more details, see the comments inside the <A HREF="install.pl">install.pl</A>
  89. scripts.
  90. <H3>
  91. How to configure</H3>
  92. You will need to configure the scripts. The basic configuration file is
  93. called <TT>config</TT>. To create a configuration file copy the file <TT><A HREF="config.org">config.org</A></TT>
  94. to <TT>config</TT> and modify it.
  95. <BR>The configuration file is a perl script but very little knowledge of
  96. perl should be required to configure it.
  97.  
  98. <P>To make some handy shortcuts available for the users there is a file
  99. called <TT>CODELINES</TT>. See the sample file <TT><A HREF="CODELINES.sample">CODELINES.sample</A></TT>.
  100. <H4>Before You start</H4>
  101. To make sure everything works smoothly You will probably need to manually
  102. run the <A HREF="dtb_update.pl ">dtb_update.pl </A>perl script once. This
  103. script creates some data files used to accelerate the "Browse Depot Tree"
  104. function.
  105. <H2>
  106. Warranty</H2>
  107. If You get any problems because of these scripts I promise to feel sorry
  108. for You. Other than that you are on Your own.
  109. <H2>
  110. Known Bugs</H2>
  111.  
  112. <LI>
  113. Deleted files can't be viewed</LI>
  114.  
  115. <LI>
  116. A serious case of feature-bloat</LI>
  117.  
  118. <LI>
  119. Should probably be written in Java or some other language</LI>
  120.  
  121. <LI>
  122. Sometimes slow.....</LI>
  123.  
  124. <H2>
  125. Would You like to contribute?</H2>
  126. If You would like to contribute changes/improvements/new functions feel
  127. free to do so and mail them to me and I will add them to the next "release"
  128. (flames and flattery are also welcome).
  129.  
  130. <P><B>Disclaimer</B>: I may grow tired of this project or change job or
  131. die or something in which case my promise above probably expires.
  132. <H3>
  133. What would be a contribution?</H3>
  134. I will be glad for any kind of contributions ranging from corrections of
  135. my bad English to new interesting functionality. Nice letters are also
  136. welcome.
  137.  
  138. <H2>
  139. Design documentation</H2>
  140. The most important documentation is in the P4CGI.pm module. This modules
  141. is used by all scripts and contains a set of common functions that are
  142. a) useful or b) defines some common "look and feel" or c) both.
  143.  
  144. <P>The P4CGI.pm module is documented using perlpod (see perlpod man page).
  145. To get a HTML page containing documentation type:
  146. <BR><TT>pod2html P4CGI.pm ><A HREF="P4CGI.html">P4CGI.html</A></TT>&nbsp;
  147. (There is one distributed with P4DB, for convenience)
  148.  
  149. <P>For other files: more often than not the code is commented.
  150.  
  151. <P>There are five different files 'types' in the design:
  152. <DL COMPACT>
  153. <DT>
  154. P4CGI.pm</DT>
  155.  
  156. <DD>
  157. - A perl module containing functions that I
  158. find useful and all other scripts use</DD>
  159.  
  160. <DT>
  161. *.cgi</DT>
  162.  
  163. <DD>
  164. - A set of cgi scripts that are used as ...eh.. cgi-scripts.</DD>
  165.  
  166. <DT>
  167. *.pl</DT>
  168.  
  169. <DD>
  170. - Perl scripts that usually updates temporary data files. These scripts
  171. does not generate HTML output. (so far there is only one such script)</DD>
  172.  
  173. <DT>
  174. /tmp/...</DT>
  175.  
  176. <DD>
  177. - A set of temporary files that contain preformatted data to make access
  178. times acceptable.</DD>
  179. <DT>
  180. p4pr.perl
  181. <DD>
  182. - The script by Bob Sidebotham I mentioner earlier 
  183. </DL>
  184. NOTE! The P4CGI.pm module "knows" if it is used in a cgi script or a regular
  185. perl script by checking for .cgi extension.
  186.  
  187. <P>The code also uses the CGI.pm perl module. This module should be part
  188. of the "standard distribution" of perl (if there is such a thing). On my
  189. target system it was not available so I included a copy with the rest of
  190. the script.
  191.  
  192. <P>As a part of my personal religion the -w flag is always turned on and
  193. 'use strict' flag is also set. I have never had any reason to regret this
  194. particular peculiarity of mine.
  195.  
  196. <P>Performance has not been a great issue. I assume that these cgi's will
  197. not have thousands of hits each day and the design has focused on ease
  198. of development rather than speed.
  199. </BODY>
  200. </HTML>
# Change User Description Committed
#1 5093 Hari Krishna Dara Populating perforce branch.
I will be adding p4admin files to it. 		20 years ago
//guest/perforce_software/utils/p4db/P4DB_0/README.html
#1 1885 rmg For posterity:
Make the old version appear in a "P4DB_0" subdirectory.
(I'd have called i...t 0.99, but I'm not sure it really *is*
0.99!) «		 23 years ago
//guest/perforce_software/utils/p4db/README.html
#1 11 Perforce maintenance Add Fredric Fredricson's depot browser, P4DB. 26 years ago