I am trying to find  comprehensive documentation on the shell standard 
library (but I would take any documentation).  I am aware of the 
discussion of shell in The Ruby Way (which is a great book).  
Unfortunately, shell has changed a lot since the book was published 
(running the examples with ruby -w generates numerous warnings). I am 
also aware of RDoc generated documentation of shell; but my level of 
non-expertise does not permit to understand how to use shell from that 
documentation (I know that's lame of me, but it's the truth right now). 
If anyone can point me to some English language resources (or even to a 
Japanese language page that I can try to machine translate), I would 
appreciate it.  Instructive examples of using shell would also be nice.