Excellent pocket guide
150 pages, really fits in a pocket. Well written, great reference, could serve as a tutorial in a pinch.
Who is the Audience?
I'm always tempted by pocket references, and nearly always disappointed. The Ruby Pocket Reference is no exception.
It is not clear who the target audience is. Beginning ruby programmers would not find enough tutorial information here to get started. Experienced ruby programmers will not find anything here that isn't more easily (and more accurately) found in ri or rdoc documentation.
To make matters worse, I found a number of errors. For instance, in sec. 1.16.1.1 the examples given of the 'not' operator (!) are incorrect - the examples repeatedly are of the form !x == y where what was intended was !(x == y). Sec. 1.16.5 claims that the ruby case statement uses the semantics of == to evaluate the 'when' expressions, then goes on to show examples that illustrate that it is actually the === operator that is used.
Other parts of the book are simply not helpful. For example, sec. 1.16.6 talks about the "for var in container" construct, but the examples only show this being applied to Ranges, and the text never mentions that the construct will work on any implementer of Enumerable.
In all, I cannot recommend this book to anyone. If you need a portable ruby reference, then get the PDF of the Pickaxe book and carry it on your stick. If you need a good beginner's tutorial, there are plenty of them online (check out Why the Lucky Stiff, for example).
Not only a top pick for libraries
Michael Fitzgerald's RUBY provides an excellent quick programmer's reference to Ruby which is organized for speedy consultation. From lists of methods to predefined variables, RUBY POCKET REFERENCE is not only a top pick for libraries, but for working Ruby programmers who want a pocket at-a-glance guide.
Handy reference for the experienced Ruby programmer
You probably could learn Ruby from this handy little pocket guide, but I wouldn't advise trying it. The examples are much too short and sweet to really do a good job of it. For the experienced Ruby programmer, though, it is a great reference on all aspects of the language. It even has introductory material on how to get started running Ruby, plus some bonus material at the end on RubyGems, Rake, and a listing of additional Ruby resources - some online and some that are books. RubyGems is a package utility for Ruby that installs Ruby software packages and keeps them up to date. It is even easier to use than tools like the Unix/Linux tar utility or Java's jar utility. Rake is a build tool that helps you build, compile, or otherwise process files, sometimes large numbers of them. Rake is similar to "make" and Apache ant, but is written in Ruby. Rails operations use Rake frequently.
The only negative thing I can say is that it seems like the book was hastily edited. I haven't seen any errors in the technical directions yet, but I have caught more than a few grammar errors and odd repetitions in the regular text that might have you scratching your head and wondering what the author meant. The following is the table of contents:
Chapter 1. Ruby Pocket Reference
Section 1.1. Conventions Used in This Book
Section 1.2. Comments and Questions
Section 1.3. Acknowledgments
Section 1.4. Running Ruby
Section 1.5. Reserved Words
Section 1.6. Operators
Section 1.7. Comments
Section 1.8. Numbers
Section 1.9. Variables
Section 1.10. Symbols
Section 1.11. Predefined Variables
Section 1.12. Pseudovariables
Section 1.13. Global Constants
Section 1.14. Ranges
Section 1.15. Methods
Section 1.16. Conditional Statements
Section 1.17. Classes
Section 1.18. Files
Section 1.19. The IO Class
Section 1.20. Exception Handling
Section 1.21. Object Class
Section 1.22. Kernel Module
Section 1.23. String Class
Section 1.24. Array Class
Section 1.25. Hash Class
Section 1.26. Time Formatting Directives
Section 1.27. Interactive Ruby (irb)
Section 1.28. Ruby Debugger
Section 1.29. Ruby Documentation
Section 1.30. RDoc Options
Section 1.31. RubyGems
Section 1.32. Rake
Section 1.33. Ruby Resources
Section 1.34. Glossary
Handy Reference and Guide
This book is a handy reference and guide to the Ruby programming language. Small and lightweight, it would be at home in a laptop bag.
I program in several languages (lately: Ruby, Java, XHTML, CSS, JavaScript). A quick reference book like this is helpful when switching contexts, reminding me of the syntax or method call that has slipped my mind.
The explanations and examples concisely illustrate the language concepts. Tables list (often all of) things like pre-defined variables, global constants, etc.
An experienced programmer could learn the important basics of Ruby in a quick scan of the first 60 pages. However, I would still recommend reading one of the thorough tutorial books to get an in-depth understanding of some of the more unique Ruby techniques.
In addition to the items covered in the product description, the book includes:
* The most commonly used areas of the File and IO classes.
* A glossary of Ruby specific terms.
* RDoc, the utility for extracting documentation embedded in comments in Ruby source, and the basics of formatting your comments for RDoc.
* A thorough 20 page index including all of the special characters (punctuation) in use in Ruby. Very handy when trying to read someone else's code.
* Many links to Ruby resources on the web.
Note that the Amazon book description should read "sprintf and time formatting *directives*". That is, the special character combination for formatting strings and the output of time.
(5 reviews)
