<html> <head> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> <title>Programming Ruby: The Pragmatic Programmer's Guide</title> <link rel="StyleSheet" href="pr_style.css" type="text/css" media="screen"> </head> <body bgcolor="white"> <table bgcolor="#c09090" cellpadding="3" border="0" cellspacing="0" width="100%"> <tr> <td colspan="3"> <table bgcolor="#701a1a" cellpadding="20" width="100%"> <tr> <td width="6in"> <h1 class="header">Programming Ruby</h1> <h3 class="subheader">The Pragmatic Programmer's Guide</h3> </td> </tr> </table> </td> </tr> <tr> <td width="33%" align="left"> <a class="subheader" href="irb.html">Previous <</a> </td> <td width="33%" align="center" valign="middle"> <a class="subheader" href="index.html">Contents ^</a> <br> </td> <td width="33%" align="right"></td> </tr> </table> <!-- Copyright (c) 2001 by Addison Wesley Longman, Inc. This material may be distributed only subject to the terms and conditions set forth in the Open Publication License, v1.0 or later (the latest version is presently available at http://www.opencontent.org/openpub/). <P></P> Distribution of substantively modified versions of this document is prohibited without the explicit permission of the copyright holder. <P></P> Distribution of the work or derivative of the work in any standard (paper) book form is prohibited unless prior permission is obtained from the copyright holder. --> <h1>Support</h1> <hr> <br> <P></P> One of the major features of Open Source projects is the technical support. Articles in the mass media often criticize open source efforts for not having the same tech support that a commercial product has. And boy is that a good thing! Instead of dialing up some overworked and understaffed help desk and being treated to Music On Hold for an hour or so <em>without</em> ever getting the answer you need, we have a better solution: the Ruby community. The author of Ruby, the authors of this book, and many other Ruby users are willing and able to lend you a hand, should you need it. <P></P> The syntax of Ruby remains fairly stable, but as with all evolving software, new features are added every now and again. As a result, both printed books and the online documentation can fall behind. All software has bugs, and Ruby is no exception. There aren't many, but they do crop up. See the bug reporting section on page 527 for details. <P></P> If you experience a problem with Ruby, feel free to ask in the mailing lists or on the newsgroup (more on those in just a minute). Generally you'll get timely answers from Matz himself, the author of the language, from other gurus, and from those who've solved problems similar to your own. <P></P> There might be similar questions in the mailing lists or on the newsgroup, and it is good ``netiquette'' to read through recent postings before asking. If you can't find the answer you need, ask, and a correct answer will usually show up with remarkable speed and precision. <h2><a name="S1">Web Sites</a></h2> <P></P> The official Ruby Home Page is <a href="http://www.ruby-lang.org">http://www.ruby-lang.org</a>. <P></P> You can also find Ruby information at <a href="http://www.rubycentral.com">http://www.rubycentral.com</a>. In particular, you'll find complete online references to Ruby's built-in classes and modules at <a href="http://www.rubycentral.com/ref/">http://www.rubycentral.com/ref/</a>, and to the Ruby FAQ at <a href="http://www.rubycentral.com/faq/">http://www.rubycentral.com/faq/</a>. <P></P> While you're surfing, drop in on <a href="http://www.pragmaticprogrammer.com">http://www.pragmaticprogrammer.com</a> and see what we're up to. <h2><a name="S2">Download Sites</a></h2> <P></P> The latest version of Ruby can be downloaded from: <a href="http://www.ruby-lang.org/en/download.html">http://www.ruby-lang.org/en/download.html</a>. <P></P> Mirror sites are: <P></P> <ul> <li> <a href="ftp://ftp.TokyoNet.AD.JP/pub/misc/ruby">ftp://ftp.TokyoNet.AD.JP/pub/misc/ruby</a> </li> <li> <a href="ftp://ftp.iij.ad.jp/pub/lang/ruby">ftp://ftp.iij.ad.jp/pub/lang/ruby</a> </li> <li> <a href="ftp://blade.nagaokaut.ac.jp/pub/lang/ruby">ftp://blade.nagaokaut.ac.jp/pub/lang/ruby</a> </li> <li> <a href="ftp://ftp.krnet.ne.jp/pub/ruby">ftp://ftp.krnet.ne.jp/pub/ruby</a> </li> <li> <a href="ftp://mirror.nucba.ac.jp/mirror/ruby">ftp://mirror.nucba.ac.jp/mirror/ruby</a> </li> <li> <a href="http://mirror.nucba.ac.jp/mirror/ruby">http://mirror.nucba.ac.jp/mirror/ruby</a> </li> </ul> <P></P> Precompiled Windows binaries (using cygwin) are in the <code>pc/</code> subdirectory. <h2><a name="S3">Usenet Newsgroup</a></h2> <P></P> Ruby has its own newsgroup, <code>comp.lang.ruby</code>. Traffic on this group is archived and mirrored to the <code>ruby-talk</code> mailing list. <h2><a name="S4">Mailing Lists</a></h2> <P></P> There are five mailing lists now talking about Ruby. The first is in English, the last four in Japanese: <P></P> <table class="codebox" cellspacing="0" border="0" cellpadding="3"> <P></P> <tr> <td colspan="9" bgcolor="#ff9999" height="3"><img src="dot.gif" width="1" height="1"></td> </tr> <tr> <td valign="top"> <code>ruby-talk@netlab.co.jp</code> </td> <td valign="top">English language discussion of Ruby (mirrored to <code>comp.lang.ruby</code>).</td> </tr> <tr> <td valign="top"> <code>ruby-list@netlab.co.jp</code> </td> <td valign="top">Japanese language discussion of Ruby.</td> </tr> <tr> <td valign="top"> <code>ruby-dev@netlab.co.jp</code> </td> <td valign="top">List for Ruby developers.</td> </tr> <tr> <td valign="top"> <code>ruby-ext@netlab.co.jp</code> </td> <td valign="top">List for people writing extensions for or with Ruby.</td> </tr> <tr> <td valign="top"> <code>ruby-math@netlab.co.jp</code> </td> <td valign="top">Ruby in mathematics.</td> </tr> <tr> <td colspan="9" bgcolor="#ff9999" height="2"><img src="dot.gif" width="1" height="1"></td> </tr> </table> <P></P> See <a href="http://www.ruby-lang.org/en/ml.html">http://www.ruby-lang.org/en/ml.html</a> for details on joining a mailing list. <P></P> The mailing lists are archived, and can be searched using <a href="http://blade.nagaokaut.ac.jp/ruby/ruby-talk/index.shtml">http://blade.nagaokaut.ac.jp/ruby/ruby-talk/index.shtml</a>. <h2><a name="S5">Bug Reporting</a></h2> <P></P> If you think you've spotted a bug in Ruby, you may want to browse the bug database at <a href="http://www.ruby-lang.org/cgi-bin/ruby-bugs">http://www.ruby-lang.org/cgi-bin/ruby-bugs</a>. You may also want to check to see if a new version of Ruby is available---perhaps the bug you've found has already been fixed. <P></P> You can submit a bug report either by using the Web page mentioned above or by sending an e-mail to <code>ruby-bugs@ruby-lang.org</code>. <P></P> When reporting a suspected bug, it would be a good idea to include the output of ``<code>ruby -v</code>'' along with any problematic source code. People will also need to know the operating system you're running. If you compiled your own version of Ruby, it might be a good idea to attach your <code>rbconfig.rb</code> file as well. <P></P> If you have a problem using irb, be aware of its limitations (see the reference section beginning on page 517). See what happens using just Ruby itself. <P></P> <p></p> <hr> <table bgcolor="#a03030" cellpadding="10" border="0" cellspacing="0"> <tr> <td width="33%" align="left"> <a class="subheader" href="irb.html">Previous <</a> </td> <td width="33%" align="center" valign="middle"> <a class="subheader" href="index.html">Contents ^</a> <br> </td> <td width="33%" align="right"></td> </tr> </table> <p></p> <font size="-1">Extracted from the book "Programming Ruby - The Pragmatic Programmer's Guide"</font> <br> <font size="-3"> Copyright © 2001 by Addison Wesley Longman, Inc. This material may be distributed only subject to the terms and conditions set forth in the Open Publication License, v1.0 or later (the latest version is presently available at <a href="http://www.opencontent.org/openpub/">http://www.opencontent.org/openpub/</a>)). <p></p> Distribution of substantively modified versions of this document is prohibited without the explicit permission of the copyright holder. <p></p> Distribution of the work or derivative of the work in any standard (paper) book form is prohibited unless prior permission is obtained from the copyright holder. <br> </font> </body> </html>