index.html #26

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
  <TITLE>Tony Smith's P4Ruby - Perforce Public Depot</TITLE>
  <META content="text/html; charset=iso8859-1" http-equiv=Content-Type>
  <LINK REL="stylesheet" TYPE="text/css" HREF="../../../shared/rubystyle.css">
</HEAD>
<BODY>
  <table width="100%" border=0>
    <tr>
      <td>
	<img src="../../../images/ruby2.jpg">
      </td>
      <td>
	<H2>P4Ruby: Ruby interface to the Perforce API</H2>
      </td>
    </tr>
  </table>

  <h3>Contents</h3>

  <ol>
      <li><a href="#intro">Introduction</a></li>
      <li><a href="#lib">P4Ruby Script Library</a></li>
      <li><a href="#credits">Credits</a></li>
  </ol>

  <a name="intro"></a>
  <h3>Introduction</h3>
  <p>
  So, what's it all about? Well in a nutshell P4Ruby allows you to write 
  beautiful Ruby code that interacts with a Perforce server. The main features 
  are:
  </p>

  <ul>
    <li>Get Perforce data and forms in native Ruby classes
    <li>Edit Perforce forms by modifying objects
    <li>Exception based error handling
    <li>Distinguish between errors and warnings easily
    <li>Run many commands on a single connection 
  </ul>

  <p>
  Writing Ruby code is a joy for all programmers, and P4Ruby makes that experience
  available to Perforce users. Enjoy it!
  </p>

  <strong>
      <p>
      Note: In March 2008, P4Ruby was adopted as a supported Perforce 
      product. The version here, in the Perforce Public depot is deprecated,
      and will not be maintained further.
      </p>

      <p>
      Download P4Ruby from the <a href="ftp://ftp.perforce.com/perforce">Perforce FTP site</a>.
      </p>
  </strong>

  <a name="lib"></a>
  <h3>P4Ruby Script Library</h3>

  I've started collecting a 
  <a href="../../P4Rubylib/index.html">library</a> of triggers and scripts
  based on P4Ruby. If you've a script you'd like to see included, please
  <a href="mailto:[email protected]">contact me</a> and let me know.

  <a name="credits"></a>
  <h3>Credits</h3>

  Thanks to <a href="mailto:[email protected]">Robert Cowham</a> for
  getting me started with a Windows installer.
  <p>
  Thanks to Dave Thomas and Andy Hunt at 
  <a href="http://www.pragmaticprogrammer.com">The Pragmatic Programmers</a>
  for their superb book and kindly giving me permission to use the funky Ruby
  image at the top of this page.
  <p>
  And of course, thanks to Matz for Ruby. 

</BODY></HTML>

#	Change	User	Description
#26	6259	Tony Smith	Update P4Perl/P4Ruby html pages with deprecation notice.
#25	6005	Tony Smith	Release P4Ruby 1.5953 as latest stable release
#24	5996	Tony Smith	Fix broken link
#23	5822	Tony Smith	Fix broken links due to transposed digits in version number.
#22	5771	Tony Smith	Release P4Ruby 1.5768 as latest stable release. There are some larger changes in the pipe, so I'm releasing the existing code before they come through.
#21	5106	Tony Smith	P4Ruby installers for version 1.5105. Note that the Ruby 1.8 installer is now built with Ruby 1.8.2.
#20	4847	Tony Smith	Update stable release of P4Ruby to 1.4841 as it fixes an annoying bug in the previous stable release.
#19	4829	Tony Smith	Release build 1.4809 of P4Ruby as the latest stable release.
#18	4660	Tony Smith	Some doc tidying.
#17	4590	Tony Smith	Update link to Ruby installer
#16	4260	Tony Smith	Call P4Ruby 1.4251 the latest stable release and update web page accordingly.
#15	4254	Tony Smith	Convert P4Ruby pages to CSS style sheet instead of horrid tags.
#14	4250	Tony Smith	Simplify porting matrices and add a link to the P4Ruby library.
#13	3655	Tony Smith	Change the location of the images in the P4Ruby index page and update the porting matrix.
#12	3581	Tony Smith	Release 1.3578 source code and installers and update web page accordingly
#11	2598	Tony Smith	Update porting matrices for P4Perl and P4Ruby
#10	2580	Tony Smith	Update build matrices for P4Perl and P4Ruby as both compile and work happily with the 2002.2 API.
#9	2435	Tony Smith	HTML tidying and some corrections from Robert C.
#8	2428	Tony Smith	Just a few more minor tweaks. Add some credits and slightly expand the example code.
#7	2427	Tony Smith	A couple of minor tweaks
#6	2426	Tony Smith	Doc beautifying for P4Ruby.
#5	1917	Tony Smith	Clean up previous change.
#4	1916	Tony Smith	Update P4Ruby pages to show 1.1750 stable build
#3	1413	Tony Smith	Correct name of tarball archive.
#2	1324	Tony Smith	P4/Ruby documentation update. Changed doc layout and added in docs for newly added methods and classes.
#1	1164	Tony Smith	Reworked exception handling (hopefully for the last time) in P4/Ruby. Now exceptions are raised on completion of Perforce commands if any errors or warnings were received as part of executing the command. This change also adds documentation, and indexes the Ruby interface off my main page. Bad form to combine so many changes in one changelist, but it's getting late and I want to get them submitted!