Helix SwarmHelix Swarm

index.html

  • //
  • guest/
  • rick_richardson/
  • perforce/
  • utils/
  • index.html #1
  • View
  • Commits
  • Open Download .zip Download (11 KB) 
  1. <HTML>
  2.  
  3. <HEAD>
  4.  
  5. <TITLE>
  6. Utilities Project - Perforce Public Depot
  7. </TITLE>
  8.  
  9. </HEAD>
  10.  
  11. <BODY BGCOLOR="#FFFFFF">
  12. <CENTER>
  13. <P>
  14. <A NAME="toc"></A>
  15. <h2>
  16. <sub><a href="../../index.html">Perforce Public Depot</a></sub><br>
  17. Perforce Utilities Project
  18. <br>
  19. </H2>
  20. <P>
  21.  
  22.  
  23.  
  24. <TABLE BORDER=0>
  25. <TR>
  26. <TD VALIGN=TOP>
  27. <B>
  28. <UL>
  29. <LI><A HREF="#about">About This Project
  30. </A>
  31. <LI><A HREF="#browsers">Depot Browsers
  32. </A>
  33. <LI><A HREF="#convert">Conversion Scripts
  34. </A>
  35. <LI><A HREF="#daemons">Review Daemons
  36. </A>
  37. </UL>
  38. <TD VALIGN=TOP>
  39. <B>
  40. <UL>
  41. <LI><A HREF="#triggers">Pre-Submit Triggers
  42. </A>
  43. <LI><A HREF="#diffmrg">Diffing and Merging
  44. </A>
  45. <LI><A HREF="#defect">Defect Tracking
  46. </A>
  47. <LI><A HREF="#compat">Compatibility Aids
  48. </A>
  49. </UL>
  50. </TABLE>
  51. <B>
  52. <LI><A HREF="#misc">Miscellany
  53. </A>
  54. </CENTER>
  55. <br>
  56. <br>
  57. <br>
  58.  
  59. <!------------------------------------------------------------------>
  60. <P>
  61. <TABLE CELLSPACING=0 BORDER=0 WIDTH=100%><TR><TD BGCOLOR=FFCC66>
  62.  
  63. <A NAME="about"></A>
  64. <H2>About This Project
  65. </H2>
  66.  
  67. <TD WIDTH=5% BGCOLOR=FFCC66 ALIGN=RIGHT><FONT SIZE="-2"><A HREF="#toc">
  68. Back to Table of Contents</A></TD></TR>
  69. </TABLE>
  70. <!------------------------------------------------------------------>
  71.  
  72. <TABLE CELLPADDING=5%>
  73. <TD VALIGN=TOP>
  74. <B>Content</B></TD>
  75. <TD VALIGN=TOP>
  76. The Perforce Utilities Project is a collection of 
  77. programs and scripts that integrate Perforce with a variety
  78. of software development tools and environments, and/or 
  79. provide alternative interfaces to the Perforce SCM system.
  80. </TD>
  81.  
  82. </TR><TR>
  83.  
  84. <TD VALIGN=TOP>
  85. <B>Curator</B></TD>
  86. <TD VALIGN=TOP>
  87. This project is maintained by Perforce staff, with individual
  88. curators as shown below.
  89. Eventually we'll split these utilities up into separate projects,
  90. depending on their activity and growth. If you have a particular
  91. interest in any or all of this project, and would like
  92. to volunteer as a curator, please email us.
  93. <p>
  94. If you would like to contribute to one of the categories that 
  95. does not have a curator yet,
  96. you may request to have your submitted
  97. changes integrated into this project by emailing Perforce staff at
  98. <A HREF="mailto:info@perforce.com">info@perforce.com</A>.
  99. </TD>
  100.  
  101. </TR>
  102. </TABLE>
  103.  
  104.  
  105. <!------------------------------------------------------------------>
  106. <P>
  107. <TABLE CELLSPACING=0 BORDER=0 WIDTH=100%><TR><TD BGCOLOR=FFCC66>
  108.  
  109. <A NAME="browsers"></A>
  110. <H2>Depot Browsers
  111. </H2>
  112.  
  113. <TD WIDTH=5% BGCOLOR=FFCC66 ALIGN=RIGHT><FONT SIZE="-2"><A HREF="#toc">
  114. Back to Table of Contents</A></TD></TR>
  115. </TABLE>
  116. <!------------------------------------------------------------------>
  117.  
  118. <DL>
  119.  
  120. <P><DT><B>
  121. <A HREF="http://public.perforce.com/cgi-bin/p4db/dtb.cgi?FSPC=public/perforce/utils/perfbrowse">
  122. //public/perforce/utils/perfbrowse/...
  123. </A></CODE></B><DD>
  124. <DD>
  125. <B>perfbrowse</b>.
  126. Shows depot hierarchies, changelists, filelogs, file contents, diffs, etc.
  127. There's a 
  128. <a href=perfbrowse/perfbrowse.perl@P99.1>
  129. 99.1-compatible</a> version and a
  130. <a href=perfbrowse/perfbrowse.perl@P98.2>
  131. 98.2-compatible</a> version.
  132.  
  133. <P><DT><B>
  134. <A HREF="http://public.perforce.com/cgi-bin/p4db/dtb.cgi?FSPC=public/perforce/utils/p4db">
  135. //public/perforce/utils/p4db/...
  136. </A></CODE></B><DD>
  137. <DD>
  138. <B>P4DB</b>.
  139. Based on <b>perfbrowse</b>, with added features, including
  140. labels associated with files, 
  141. file content viewer with annotated deltas, 
  142. HTML file viewer,
  143. and The Great Submit Race. 
  144.  
  145. </DL>
  146.  
  147.  
  148. <!------------------------------------------------------------------>
  149. <P>
  150. <TABLE CELLSPACING=0 BORDER=0 WIDTH=100%><TR><TD BGCOLOR=FFCC66>
  151.  
  152. <A NAME="convert"></A>
  153. <H2>Conversion Scripts
  154. </H2>
  155.  
  156. <TD WIDTH=5% BGCOLOR=FFCC66 ALIGN=RIGHT><FONT SIZE="-2"><A HREF="#toc">
  157. Back to Table of Contents</A></TD></TR>
  158. </TABLE>
  159. <!------------------------------------------------------------------>
  160.  
  161. <DL>
  162.  
  163. <P><DT><B>
  164. <A HREF="http://public.perforce.com/cgi-bin/p4db/dtb.cgi?FSPC=public/perforce/utils/cvs2p4">
  165. //public/perforce/utils/cvs2p4/...
  166. </A></CODE></B><DD>
  167. <DD>
  168. This <b>CVS to Perforce</b> converter extracts metadata from a CVS repository
  169. and generates a Perforce depot using Perforce client commands.  The
  170. converter handles Attic/ and .cvsignore, and has flexible support for
  171. branching.  
  172. Contributed by
  173. <A HREF="http://public.perforce.com/cgi-bin/p4db/lu.cgi?USER=richard_geiger">
  174. Richard Geiger</a>, who is also its curator. (See the
  175. README file for more info.)
  176.  
  177. </DL>
  178.  
  179.  
  180. <!------------------------------------------------------------------>
  181. <P>
  182. <TABLE CELLSPACING=0 BORDER=0 WIDTH=100%><TR><TD BGCOLOR=FFCC66>
  183.  
  184. <A NAME="daemons"></A>
  185. <H2>Review Daemons
  186. </H2>
  187.  
  188. <TD WIDTH=5% BGCOLOR=FFCC66 ALIGN=RIGHT><FONT SIZE="-2"><A HREF="#toc">
  189. Back to Table of Contents</A></TD></TR>
  190. </TABLE>
  191. <!------------------------------------------------------------------>
  192.  
  193.  
  194. <!------------------------------------------------------------------>
  195. <P>
  196. <TABLE CELLSPACING=0 BORDER=0 WIDTH=100%><TR><TD BGCOLOR=FFCC66>
  197.  
  198. <A NAME="triggers"></A>
  199. <H2>Pre-Submit Triggers
  200. </H2>
  201.  
  202. <TD WIDTH=5% BGCOLOR=FFCC66 ALIGN=RIGHT><FONT SIZE="-2"><A HREF="#toc">
  203. Back to Table of Contents</A></TD></TR>
  204. </TABLE>
  205. <!------------------------------------------------------------------>
  206.  
  207. <P>
  208. <DL>
  209. <DT>
  210. <B>
  211. <A HREF="http://public.perforce.com/cgi-bin/p4db/dtb.cgi?FSPC=public/perforce/utils/triggers">
  212. //public/perforce/utils/triggers/...
  213. </A></CODE></B>
  214. <DD>
  215. Perforce Release 99.1 introduced server support for pre-submit
  216. triggers.
  217. Here are some example scripts
  218. that can be used as triggers in a Perforce 99.1 (or later) server. 
  219. These scripts were written and contributed by 
  220. <a href="/guest/jeff_bowles/jab.html">
  221. Jeff Bowles</a>
  222. and <A HREF="/guest/wes_peters/pcp.html">Wes Peters</A>.
  223.  
  224. <P>
  225. <table border=1>
  226. <tr>
  227. <td><b>Script Name</b><td><b>Status<sup>*</sup></b><td><center><b>Description</b></center></tr>
  228. <tr>
  229. <td>
  230. <B><A HREF="triggers/Jobs.pl">
  231. Jobs.pl
  232. </A></B>
  233. <td><img src="triggers/smiley.gif">
  234. <td>
  235. Example trigger to enforce a rule &quot;submissions must be associated
  236. with a job.&quot;.
  237. <tr>
  238. <td>
  239. <B><A HREF="triggers/Jobs.sh">
  240. Jobs.sh
  241. </A></B>
  242. <td><img src="triggers/smiley.gif">
  243. <td>
  244. Similar to above, but contributed by <A HREF="/guest/wes_peters/pcp.html">Wes Peters</A>
  245. and written in Unix "shell". <i>Takes a different approach to the problem,
  246. running "p4 fixes" to determine whether you're fixing something with this submission.</i>
  247. <tr>
  248. <td>
  249. <B><A HREF="triggers/CheckC.pl">
  250. CheckC.pl
  251. </A></B>
  252. <td><img src="triggers/afraid.gif">
  253. <td>
  254. A script to notice when you're creating new files (or integrating to a new
  255. branch) and the directory name you're writing the [new] file to isn't the
  256. same case as an existing directory name.
  257. <p><i>(For example, if "//depot/<u>x</u>/<u>y</u>/z.c"
  258. exists, this won't allow you to create a file named "//depot/<u>X</u>/<u>Y</u>/one.c".)</i>
  259. <tr>
  260. <td>
  261. <B><A HREF="triggers/Pairs.pl">
  262. Pairs.pl
  263. </A></B>
  264. <td><img src="triggers/smiley.gif">
  265. <td>
  266. Example trigger to enforce a rule &quot;files of suffix .x/.y need to be checked
  267. in as pairs&quot;.
  268. <tr>
  269. <td>
  270. <B><A HREF="triggers/Binary.pl">
  271. Binary.pl
  272. </A></B>
  273. <td><img src="triggers/smiley.gif">
  274. <td>
  275. Example trigger to enforce a rule &quot;submissions of .gif must binary files
  276. and .sh files should be text and....&quot;
  277. <tr>
  278. <td>
  279. <B><A HREF="triggers/simple.cmd">
  280. simple.cmd
  281. </A></B>
  282. <td><img src="triggers/teaching.gif">
  283. <td>
  284. Classroom example of writing a trigger using the Windows/NT command shell,
  285. a.k.a. "a <i>.cmd</i> script". (It checks that "Bug:" is included in the change
  286. description.) Doesn't do a lot, but gets the idea across.
  287. </table>
  288. <p>
  289. <sup>*</sup>How to interpret the &quot;Status&quot; field:
  290. <ul><li>a smiley face means &quot;it's probably
  291. simple enough to use without any worries that it'll corrupt or slow down anything&quot; ;
  292. <li>a scared face means &quot;you probably want to read the comments
  293. at the top of the script - this might need localization/tailoring or might have
  294. performance implications you want to investigate before deploying on your production
  295. Perforce server&quot; ;
  296. <li>and &quot;under construction&quot; means just that - you can look, you can
  297. make copies, but it's getting reworked at the moment.
  298. </ul>
  299.  
  300. </DL>
  301.  
  302. <!------------------------------------------------------------------>
  303. <P>
  304. <TABLE CELLSPACING=0 BORDER=0 WIDTH=100%><TR><TD BGCOLOR=FFCC66>
  305.  
  306. <A NAME="diffmrg"></A>
  307. <H2>Diffing and Merging
  308. </H2>
  309.  
  310. <TD WIDTH=5% BGCOLOR=FFCC66 ALIGN=RIGHT><FONT SIZE="-2"><A HREF="#toc">
  311. Back to Table of Contents</A></TD></TR>
  312. </TABLE>
  313. <!------------------------------------------------------------------>
  314.  
  315. <DL>
  316.  
  317. <P><DT><B>
  318. <A HREF="http://public.perforce.com/cgi-bin/p4db/dtb.cgi?FSPC=public/perforce/utils/emacs_mrg">
  319. //public/perforce/utils/emacs_mrg/...
  320. </A></CODE></B><DD>
  321. <DD>
  322. Some emacs lisp code to make editing merges in p4 easier.
  323.  
  324. </DL>
  325.  
  326. <!------------------------------------------------------------------>
  327. <P>
  328. <TABLE CELLSPACING=0 BORDER=0 WIDTH=100%><TR><TD BGCOLOR=FFCC66>
  329.  
  330. <A NAME="defect"></A>
  331. <H2>Defect Tracking
  332. </H2>
  333.  
  334. <TD WIDTH=5% BGCOLOR=FFCC66 ALIGN=RIGHT><FONT SIZE="-2"><A HREF="#toc">
  335. Back to Table of Contents</A></TD></TR>
  336. </TABLE>
  337. <!------------------------------------------------------------------>
  338.  
  339.  
  340. <!------------------------------------------------------------------>
  341. <P>
  342. <TABLE CELLSPACING=0 BORDER=0 WIDTH=100%><TR><TD BGCOLOR=FFCC66>
  343.  
  344. <A NAME="compat"></A>
  345. <H2>Compatibility Aids
  346. </H2>
  347.  
  348. <TD WIDTH=5% BGCOLOR=FFCC66 ALIGN=RIGHT><FONT SIZE="-2"><A HREF="#toc">
  349. Back to Table of Contents</A></TD></TR>
  350. </TABLE>
  351. <!------------------------------------------------------------------>
  352.  
  353. <DL>
  354.  
  355. <P><DT><B>
  356. <A HREF="http://public.perforce.com/cgi-bin/p4db/dtb.cgi?FSPC=public/perforce/utils/c4">
  357. //public/perforce/utils/c4/...
  358. </A></CODE></B><DD>
  359. <DD>
  360. <B>c4</B>. A CVS-like frontend to <b>p4</b>. This package was
  361. contributed by
  362. <A HREF="http://public.perforce.com/cgi-bin/p4db/lu.cgi?USER=neil_russell">
  363. Neil Russell</a>, who is also its curator. (See the
  364. README file for more info.)
  365.  
  366.  
  367. <P><DT><B>
  368. <A HREF="http://public.perforce.com/cgi-bin/p4db/dtb.cgi?FSPC=public/perforce/utils/aegis">
  369. //public/perforce/utils/aegis/...
  370. </A></CODE></B><DD>
  371. <DD>
  372. Aegis-like wrappers to <b>p4</b>.
  373.  
  374. </DL>
  375.  
  376. <!------------------------------------------------------------------>
  377. <P>
  378. <TABLE CELLSPACING=0 BORDER=0 WIDTH=100%><TR><TD BGCOLOR=FFCC66>
  379.  
  380. <A NAME="misc"></A>
  381. <H2>Miscellany
  382. </H2>
  383.  
  384. <TD WIDTH=5% BGCOLOR=FFCC66 ALIGN=RIGHT><FONT SIZE="-2"><A HREF="#toc">
  385. Back to Table of Contents</A></TD></TR>
  386. </TABLE>
  387. <!------------------------------------------------------------------>
  388.  
  389.  
  390. <br><br><br>
  391. <!------------------------------------------------------------------>
  392. <P>
  393. <TABLE CELLSPACING=0 BORDER=0 WIDTH=100%>
  394. <TR>
  395.  
  396. <TD WIDTH=15% BGCOLOR=FFCC66 ALIGN=LEFT VALIGN=CENTER>
  397. <FONT SIZE="-2">
  398. Copyright &copy;<br>
  399. 1998, 1999<br>
  400. <a href="http://www.perforce.com">Perforce Software</a><br>
  401. </FONT>
  402. </TD>
  403.  
  404. <TD WIDTH=70% BGCOLOR=FFCC66 ALIGN=CENTER>
  405. <FONT SIZE="-2">
  406. You're browsing a file stored as<br> 
  407. <code>$Id: //guest/rick_richardson/perforce/utils/index.html#1 $</code><br> 
  408. in the 
  409. <A HREF=http://public.perforce.com/public/index.html>Perforce Public Depot</A>.
  410. </FONT>
  411. </TD>
  412.  
  413. <TD WIDTH=15% BGCOLOR=FFCC66 ALIGN=RIGHT>
  414. <FONT SIZE="-2"><A HREF="#toc">
  415. Back to<BR>Table of<BR>Contents</A></TD></TR>
  416. </FONT>
  417. </TD>
  418.  
  419. </TR>
  420. </TABLE>
  421. <!------------------------------------------------------------------>
  422.  
  423.  
  424.  
  425. </BODY>
# Change User Description Committed
#1 645 Rick Richardson Create banch for adding p4wrapper. 24 years ago