[ruby-talk:01291] Draft of the updated Ruby FAQ

Hello Dave,

after picking a little bit here and there in the FAQ, I have found two
things for which I would like to draw your attention to.

2.11 How do I pass arguments to a block? 
   The formal parameters of a block appear between vertical bars at
   the start of the block:

      proc { |a, b| a <=> b }

Here you have not only shown a block, but a closure! I think you
should delete 'proc' because a newbie could feel that there has to be
a 'proc' before every block.

   ... Typically, arguments are passed to a block using yield (or an
   iterator that calls yield), or by using the Proc.call method.

Here you probably should use matz' way of method naming. As you have
written it, it could also mean call of singleton method 'call' of
class 'Proc'. Matz has often written like Proc#call. I found this
construct more apropiate. IMHO, there is a difference between
'Proc.new' and 'Proc#new'. First means method call, second means name
of method. What do you think?

8.1 How can I use Ruby interactively? 
   ...
   There is also a simple script, eval, in the samples/ directory of
   the Ruby distribution. It lets you enter expressions and view their
   values.

You could mention a hint to copy that script to the site_ruby
directory of the current installation. After doing so one easily could
get a command line by typing
  
   ruby -reval<Enter>
   <Ctrl-D><Ctrl-D>
   ruby>

But also the debugger could be 'misused' as command-line tool. Simply
write
   
   ruby -rdebug -e1<Enter>
   (rdb:-) 

Regards,
\cle