Loading...
Helix SwarmHelix Swarm
Loading...

index.html

  • //
  • guest/
  • michael/
  • utils/
  • index.html #1
  • View
  • Commits
  • Open Download .zip Download (13 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. </B>
  39. <TD VALIGN=TOP>
  40. <B>
  41. <UL>
  42. <LI><A HREF="#triggers">Pre-Submit Triggers
  43. </A>
  44. <LI><A HREF="#diffmrg">Diffing and Merging
  45. </A>
  46. <LI><A HREF="#defect">Defect Tracking
  47. </A>
  48. <LI><A HREF="#compat">Compatibility Aids
  49. </A>
  50. </UL>
  51. </B>
  52. </TABLE>
  53. <B>
  54. <LI><A HREF="#misc">Miscellany
  55. </B>
  56. </A>
  57. </CENTER>
  58. <br>
  59. <br>
  60. <br>
  61.  
  62. <!------------------------------------------------------------------>
  63. <P>
  64. <TABLE CELLSPACING=0 BORDER=0 WIDTH=100%><TR><TD BGCOLOR=FFCC66>
  65.  
  66. <A NAME="about"></A>
  67. <H2>About This Project
  68. </H2>
  69.  
  70. <TD WIDTH=5% BGCOLOR=FFCC66 ALIGN=RIGHT><FONT SIZE="-2"><A HREF="#toc">
  71. Back to Table of Contents</A></TD></TR>
  72. </TABLE>
  73. <!------------------------------------------------------------------>
  74.  
  75. <TABLE CELLPADDING=5%>
  76. <TD VALIGN=TOP>
  77. <B>Content</B></TD>
  78. <TD VALIGN=TOP>
  79. The Perforce Utilities Project is a collection of
  80. programs and scripts that integrate Perforce with a variety
  81. of software development tools and environments, and/or
  82. provide alternative interfaces to the Perforce SCM system.
  83. </TD>
  84.  
  85. </TR><TR>
  86.  
  87. <TD VALIGN=TOP>
  88. <B>Curator</B></TD>
  89. <TD VALIGN=TOP>
  90. This project is maintained by Perforce staff, with individual
  91. curators as shown below.
  92. Eventually we'll split these utilities up into separate projects,
  93. depending on their activity and growth. If you have a particular
  94. interest in any or all of this project, and would like
  95. to volunteer as a curator, please email us.
  96. <p>
  97. If you would like to contribute to one of the categories that
  98. does not have a curator yet,
  99. you may request to have your submitted
  100. changes integrated into this project by emailing Perforce staff at
  101. <A HREF="mailto:opensource@perforce.com">opensource@perforce.com</A>.
  102. </TD>
  103.  
  104. </TR>
  105. </TABLE>
  106.  
  107.  
  108. <!------------------------------------------------------------------>
  109. <P>
  110. <TABLE CELLSPACING=0 BORDER=0 WIDTH=100%><TR><TD BGCOLOR=FFCC66>
  111.  
  112. <A NAME="browsers"></A>
  113. <H2>Depot Browsers
  114. </H2>
  115.  
  116. <TD WIDTH=5% BGCOLOR=FFCC66 ALIGN=RIGHT><FONT SIZE="-2"><A HREF="#toc">
  117. Back to Table of Contents</A></TD></TR>
  118. </TABLE>
  119. <!------------------------------------------------------------------>
  120.  
  121. <DL>
  122.  
  123. <P><DT><B>
  124. <A HREF="http://public.perforce.com:8080/@ra=s@/public/perforce/utils/perfbrowse/">
  125. //public/perforce/utils/perfbrowse/...
  126. </A></CODE></B><DD>
  127. <DD>
  128. <B>perfbrowse</b>.
  129. Shows depot hierarchies, changelists, filelogs, file contents, diffs, etc.
  130. There's a
  131. <a href=perfbrowse/perfbrowse.perl@P99.1>
  132. 99.1-compatible</a> version and a
  133. <a href=perfbrowse/perfbrowse.perl@P98.2>
  134. 98.2-compatible</a> version.
  135.  
  136. <P><DT><B>
  137. <A HREF="http://public.perforce.com:8080/@ra=s@/public/perforce/utils/p4db/">
  138. //public/perforce/utils/p4db/...
  139. </A></CODE></B><DD>
  140. <DD>
  141. <B>P4DB</b>.
  142. Based on <b>perfbrowse</b>, with added features, including
  143. labels associated with files,
  144. file content viewer with annotated deltas,
  145. HTML file viewer,
  146. and The Great Submit Race.
  147.  
  148. </DL>
  149.  
  150.  
  151. <!------------------------------------------------------------------>
  152. <P>
  153. <TABLE CELLSPACING=0 BORDER=0 WIDTH=100%><TR><TD BGCOLOR=FFCC66>
  154.  
  155. <A NAME="convert"></A>
  156. <H2>Conversion Scripts
  157. </H2>
  158.  
  159. <TD WIDTH=5% BGCOLOR=FFCC66 ALIGN=RIGHT><FONT SIZE="-2"><A HREF="#toc">
  160. Back to Table of Contents</A></TD></TR>
  161. </TABLE>
  162. <!------------------------------------------------------------------>
  163.  
  164. <DL>
  165.  
  166. <P><DT><B>
  167. <A HREF="ftp://public.perforce.com/public/perforce/utils/cvs2p4/">
  168. //public/perforce/utils/cvs2p4/...
  169. </A></CODE></B><DD>
  170. <DD>
  171. This <b>CVS to Perforce</b> converter extracts metadata from a CVS repository
  172. and generates a Perforce depot using Perforce client commands.  The
  173. converter handles Attic/ and .cvsignore, and has flexible support for
  174. branching.
  175. Contributed by
  176. <A HREF="http://public.perforce.com:8080/@md=d&ra=s@//richard_geiger?ac=17">
  177. Richard Geiger</a>, who is also its curator. (See the
  178. <a href=ftp://public.perforce.com/public/perforce/utils/cvs2p4/README>README</a> file for more info.)
  179.  
  180. <P><DT><B>
  181. <A HREF=vsstop4/index.html>
  182. //public/perforce/utils/vsstop4/...
  183. </A></CODE></B><DD>
  184. <DD>
  185. Converts Visual Source Safe archives to Perforce,
  186. preserving the original times and authors.  Branches are translated
  187. verbatim, individual file revisions are grouped as much
  188. as possible into Perforce's notion of atomic changes.
  189.  
  190. <p>
  191. Requires <a href="http://www.perl.com/">Perl 5</a>, VSS 5.0 or later
  192. and Perforce 97.3 or later.  
  193. Perforce makes this conversion tool available
  194. for the convenience of our customers, these scripts are not fully
  195. supported. 
  196.  
  197. <p>
  198. Curated by <a href=http://public.perforce.com/guest/robert_cowham/pcp.html>Robert Cowham</a>.
  199.  
  200.  
  201. </DL>
  202.  
  203.  
  204. <!------------------------------------------------------------------>
  205. <P>
  206. <TABLE CELLSPACING=0 BORDER=0 WIDTH=100%><TR><TD BGCOLOR=FFCC66>
  207.  
  208. <A NAME="daemons"></A>
  209. <H2>Review Daemons
  210. </H2>
  211.  
  212. <TD WIDTH=5% BGCOLOR=FFCC66 ALIGN=RIGHT><FONT SIZE="-2"><A HREF="#toc">
  213. Back to Table of Contents</A></TD></TR>
  214. </TABLE>
  215. <!------------------------------------------------------------------>
  216.  
  217. <DL>
  218.  
  219. <P><DT><B>
  220. <A HREF="reviewd/p4review.py">
  221. //public/perforce/utils/reviewd/p4review.py
  222. </A></CODE></B>
  223. <DD>
  224.  
  225. A Perforce notification review daemon written in Python, for use on
  226. Windows or Unix;
  227. can run in the background or via cron;
  228. allows users to subscribe to notifications about jobs (as well as changes);
  229. can notify admin about bad email addresses.
  230.  
  231. <P><DT><B>
  232. <A HREF="reviewd/p4notifyd.pl">
  233. //public/perforce/utils/reviewd/p4notifyd.pl</A>
  234. </A></CODE></B>
  235. <DD>
  236.  
  237. A Perforce notification review daemon for Unix, written in Perl.
  238. This is the review daemon used for the Public Depot.
  239. Runs on Unix; written in perl; can run in the background or via cron;
  240. supports "cc:" in the description or client spec; can do logging;
  241. can add a hyperlinks to p4web (or some other web-based Perforce browser)
  242. to display full change information.
  243.  
  244. <P><DT><B>
  245. <A HREF="reviewd/reviewer/index.html">
  246. //public/perforce/utils/reviewd/reviewer/...</A>
  247. </A></CODE></B>
  248. <DD>
  249.  
  250. A Perforce notification review daemon in Java.
  251. Contributed by David Markley.
  252.  
  253. </DL>
  254.  
  255.  
  256.  
  257. <!------------------------------------------------------------------>
  258. <P>
  259. <TABLE CELLSPACING=0 BORDER=0 WIDTH=100%><TR><TD BGCOLOR=FFCC66>
  260.  
  261. <A NAME="triggers"></A>
  262. <H2>Pre-Submit Triggers
  263. </H2>
  264.  
  265. <TD WIDTH=5% BGCOLOR=FFCC66 ALIGN=RIGHT><FONT SIZE="-2"><A HREF="#toc">
  266. Back to Table of Contents</A></TD></TR>
  267. </TABLE>
  268. <!------------------------------------------------------------------>
  269.  
  270. <P>
  271. <DL>
  272. <DT>
  273. <B>
  274. <A HREF="http://public.perforce.com:8080/@ra=s@/public/perforce/utils/triggers/">
  275. //public/perforce/utils/triggers/...
  276. </A></CODE></B>
  277. <DD>
  278. Perforce Release 99.1 introduced server support for pre-submit
  279. triggers.
  280. Here are some example scripts
  281. that can be used as triggers in a Perforce 99.1 (or later) server.
  282. These scripts were written and contributed by
  283. <a href="/guest/jeff_bowles/jab.html">
  284. Jeff Bowles</a>
  285. and <A HREF="/guest/wes_peters/pcp.html">Wes Peters</A>.
  286.  
  287. <P>
  288. <table border=1>
  289. <tr>
  290. <td><b>Script Name</b><td><b>Status<sup>*</sup></b><td><center><b>Description</b></center></tr>
  291. <tr>
  292. <td>
  293. <B><A HREF="triggers/Jobs.pl">
  294. Jobs.pl
  295. </A></B>
  296. <td><img src="triggers/smiley.gif">
  297. <td>
  298. Example trigger to enforce a rule &quot;submissions must be associated
  299. with a job.&quot;.
  300. <tr>
  301. <td>
  302. <B><A HREF="triggers/Jobs.sh">
  303. Jobs.sh
  304. </A></B>
  305. <td><img src="triggers/smiley.gif">
  306. <td>
  307. Similar to above, but contributed by <A HREF="/guest/wes_peters/pcp.html">Wes Peters</A>
  308. and written in Unix "shell". <i>Takes a different approach to the problem,
  309. running "p4 fixes" to determine whether you're fixing something with this submission.</i>
  310. <tr>
  311. <td>
  312. <B><A HREF="triggers/CheckC.pl">
  313. CheckC.pl
  314. </A></B>
  315. <td><img src="triggers/afraid.gif">
  316. <td>
  317. A script to notice when you're creating new files (or integrating to a new
  318. branch) and the directory name you're writing the [new] file to isn't the
  319. same case as an existing directory name.
  320. <p><i>(For example, if "//depot/<u>x</u>/<u>y</u>/z.c"
  321. exists, this won't allow you to create a file named "//depot/<u>X</u>/<u>Y</u>/one.c".)</i>
  322. <tr>
  323. <td>
  324. <B><A HREF="triggers/Pairs.pl">
  325. Pairs.pl
  326. </A></B>
  327. <td><img src="triggers/smiley.gif">
  328. <td>
  329. Example trigger to enforce a rule &quot;files of suffix .x/.y need to be checked
  330. in as pairs&quot;.
  331. <tr>
  332. <td>
  333. <B><A HREF="triggers/Binary.pl">
  334. Binary.pl
  335. </A></B>
  336. <td><img src="triggers/smiley.gif">
  337. <td>
  338. Example trigger to enforce a rule &quot;submissions of .gif must binary files
  339. and .sh files should be text and....&quot;
  340. <tr>
  341. <td>
  342. <B><A HREF="triggers/simple.cmd">
  343. simple.cmd
  344. </A></B>
  345. <td><img src="triggers/teaching.gif">
  346. <td>
  347. Classroom example of writing a trigger using the Windows/NT command shell,
  348. a.k.a. "a <i>.cmd</i> script". (It checks that "Bug:" is included in the change
  349. description.) Doesn't do a lot, but gets the idea across.
  350. </table>
  351. <p>
  352. <sup>*</sup>How to interpret the &quot;Status&quot; field:
  353. <ul><li>a smiley face means &quot;it's probably
  354. simple enough to use without any worries that it'll corrupt or slow down anything&quot; ;
  355. <li>a scared face means &quot;you probably want to read the comments
  356. at the top of the script - this might need localization/tailoring or might have
  357. performance implications you want to investigate before deploying on your production
  358. Perforce server&quot; ;
  359. <li>and &quot;under construction&quot; means just that - you can look, you can
  360. make copies, but it's getting reworked at the moment.
  361. </ul>
  362.  
  363. </DL>
  364.  
  365. <!------------------------------------------------------------------>
  366. <P>
  367. <TABLE CELLSPACING=0 BORDER=0 WIDTH=100%><TR><TD BGCOLOR=FFCC66>
  368.  
  369. <A NAME="diffmrg"></A>
  370. <H2>Diffing and Merging
  371. </H2>
  372.  
  373. <TD WIDTH=5% BGCOLOR=FFCC66 ALIGN=RIGHT><FONT SIZE="-2"><A HREF="#toc">
  374. Back to Table of Contents</A></TD></TR>
  375. </TABLE>
  376. <!------------------------------------------------------------------>
  377.  
  378. <DL>
  379.  
  380. <P><DT><B>
  381. <A HREF="http://public.perforce.com:8080/@ra=s@/public/perforce/utils/emacs_mrg/">
  382. //public/perforce/utils/emacs_mrg/...
  383. </A></CODE></B><DD>
  384. <DD>
  385. Some emacs lisp code to make editing merges in p4 easier.
  386.  
  387. </DL>
  388.  
  389. <!------------------------------------------------------------------>
  390. <P>
  391. <TABLE CELLSPACING=0 BORDER=0 WIDTH=100%><TR><TD BGCOLOR=FFCC66>
  392.  
  393. <A NAME="defect"></A>
  394. <H2>Defect Tracking
  395. </H2>
  396.  
  397. <TD WIDTH=5% BGCOLOR=FFCC66 ALIGN=RIGHT><FONT SIZE="-2"><A HREF="#toc">
  398. Back to Table of Contents</A></TD></TR>
  399. </TABLE>
  400. <!------------------------------------------------------------------>
  401.  
  402.  
  403. <!------------------------------------------------------------------>
  404. <P>
  405. <TABLE CELLSPACING=0 BORDER=0 WIDTH=100%><TR><TD BGCOLOR=FFCC66>
  406.  
  407. <A NAME="compat"></A>
  408. <H2>Compatibility Aids
  409. </H2>
  410.  
  411. <TD WIDTH=5% BGCOLOR=FFCC66 ALIGN=RIGHT><FONT SIZE="-2"><A HREF="#toc">
  412. Back to Table of Contents</A></TD></TR>
  413. </TABLE>
  414. <!------------------------------------------------------------------>
  415.  
  416. <DL>
  417.  
  418. <P><DT><B>
  419. <A HREF="http://public.perforce.com:8080/@ra=s@/public/perforce/utils/c4/">
  420. //public/perforce/utils/c4/...
  421. </A></CODE></B><DD>
  422. <DD>
  423. <B>c4</B>. A CVS-like frontend to <b>p4</b>. This package was
  424. contributed by
  425. <A HREF="http://public.perforce.com:8080/@md=d&ra=s@//neil_russell?ac=17">
  426. Neil Russell</a>, who is also its curator. (See the
  427. README file for more info.)
  428.  
  429.  
  430. <P><DT><B>
  431. <A HREF="http://public.perforce.com:8080/@ra=s@/public/perforce/utils/aegis/">
  432. //public/perforce/utils/aegis/...
  433. </A></CODE></B><DD>
  434. <DD>
  435. Aegis-like wrappers to <b>p4</b>.
  436.  
  437. </DL>
  438.  
  439. <!------------------------------------------------------------------>
  440. <P>
  441. <TABLE CELLSPACING=0 BORDER=0 WIDTH=100%><TR><TD BGCOLOR=FFCC66>
  442.  
  443. <A NAME="misc"></A>
  444. <H2>Miscellany
  445. </H2>
  446.  
  447. <TD WIDTH=5% BGCOLOR=FFCC66 ALIGN=RIGHT><FONT SIZE="-2"><A HREF="#toc">
  448. Back to Table of Contents</A></TD></TR>
  449. </TABLE>
  450. <!------------------------------------------------------------------>
  451.  
  452. <DL>
  453.  
  454. <P><DT><B>
  455. <A HREF="http://public.perforce.com:8080/@ra=s@/public/perforce/utils/p4wrapper/">
  456. //public/perforce/utils/p4wrapper/...
  457. </A></CODE></B><DD>
  458. <DD>
  459. <B>p4wrapper</B>. A set of useful commands wrapped around <b>p4</b>, some (but not
  460. all) with a CVS bent. Contributed and curated by
  461. <A HREF="http://public.perforce.com:8080/@md=d&ra=s@//rick_richardson?ac=17">
  462. Rick Richardson</a>. (See the
  463. README file for more info.)
  464.  
  465.  
  466. </DL>
  467.  
  468. <!------------------------------------------------------------------>
  469. <P>
  470. <TABLE CELLSPACING=0 BORDER=0 WIDTH=100%>
  471. <TR>
  472.  
  473. <TD WIDTH=15% BGCOLOR=FFCC66 ALIGN=LEFT VALIGN=CENTER>
  474. <FONT SIZE="-2">
  475. Copyright &copy;<br>
  476. 1998, 1999<br>
  477. <a href="http://www.perforce.com">Perforce Software</a><br>
  478. </FONT>
  479. </TD>
  480.  
  481. <TD WIDTH=70% BGCOLOR=FFCC66 ALIGN=CENTER>
  482. <FONT SIZE="-2">
  483. You're browsing a file stored as<br>
  484. <code>$Id: //guest/michael/utils/index.html#1 $</code><br>
  485. in the
  486. <A HREF=http://public.perforce.com/public/index.html>Perforce Public Depot</A>.
  487. </FONT>
  488. </TD>
  489.  
  490. <TD WIDTH=15% BGCOLOR=FFCC66 ALIGN=RIGHT>
  491. <FONT SIZE="-2"><A HREF="#toc">
  492. Back to<BR>Table of<BR>Contents</A></TD></TR>
  493. </FONT>
  494. </TD>
  495.  
  496. </TR>
  497. </TABLE>
  498. <!------------------------------------------------------------------>
  499.  
  500.  
  501.  
  502. </BODY>
# Change User Description Committed
#1 4282 michael Branch index and curator pages for facelift. 21 years ago
//guest/perforce_software/utils/index.html
#24 2179 rmg Fix vsstop4 link. 22 years ago
#23 2178 rmg Link in Robert's new vsstop4 index page. 22 years ago
#22 1683 rmg Add a link to David Markley's Java review daemon. 23 years ago
#21 1155 rmg The change to utils/index.html was required to get the page
       to... render better with Netscape 6.2. (Without the closing </B>
       tags, the whole page from the Depot Browsers section on down
       rendered bold...!)

       I made the same logical change to the other four for consistency,
       though they didn't seem to suffer from the same problem.

       p4dti/index.html still doesn't render right under Netscape 6.2,
       but it's from a different patterns and I couldn't see a quick
       clean fix... so I didn't mess with it for now. «		 23 years ago
#20 1017 rmg Make the download behavior and naming (for p4notifyd -> p4notifyd.pl)
more consistent... with other things in the Public Depot. «		 23 years ago
#19 1016 rmg Add two review daemons. 23 years ago
#18 968 rmg Change mail addresses from "info@perforce.com" to "opensource@perforce.com"
(now that the... "opensource" address exists). «		 23 years ago
#17 780 rmg Take 2 for the p4db -> p4web conversion.
(change 788 redux) 		24 years ago
#16 779 rmg Back out change 778. 24 years ago
#15 778 rmg Covert all p4db links into p4web links. 24 years ago
#14 691 rlo Typo fix 24 years ago
#13 690 rlo Rick Richardson's "p4wrapper" becomes a public depot utility. 24 years ago
#12 245 Laura Wingerd Add emacs p4merge files, belatedly, and removed link to
missing emacs integration, since... the version we have is
really old. «		 25 years ago
#11 152 Laura Wingerd cvs2p4 goes public. 26 years ago
#10 149 Laura Wingerd Annoint Neil Russell curator of utils/c4. 26 years ago
#9 145 Laura Wingerd A 99.1-compatible perfbrowse.
(Integrated from change 142, change 143.) 		26 years ago
#8 113 Laura Wingerd Pull in updates to sample triggers
(change 110, change 109) 		26 years ago
#7 108 Laura Wingerd Update trigger descriptions
(see change 107, change 106, change 105) 		26 years ago
#6 96 Laura Wingerd oops, typo. 26 years ago
#5 94 Laura Wingerd Re-org "triggers" directory -- it's now part of the
"Perforce Utilities" project. 		26 years ago
#4 52 Laura Wingerd Minor web page format changes. 26 years ago
#3 51 Laura Wingerd Update copyright year. 26 years ago
#2 42 Laura Wingerd Fix links in index pages, add one for jam. 26 years ago
#1 39 Perforce maintenance Publish new Perforce Utilities Project index page. 26 years ago
//guest/laura_wingerd/perforce/utils/index.html
#1 37 Laura Wingerd Prototype project index pages. 26 years ago