From: Kevin Date: 2012-02-15T11:08:00+09:00 Subject: Re: the ruby syntax On Mon, Feb 13, 2012 at 9:01 AM, Robert Klemme wrote: > Please do not top post. > > On Mon, Feb 13, 2012 at 1:41 PM, maven apache wrote: >> I never think rubydoc is useless. > > It's just not the proper medium for documentation of the language. > JavaDoc is also not used to document the language - for that the JLS > is used. > >> In fact, I like ruby .  I just want to find some documents about this >> language. > > I recommend > http://www.amazon.com/Ruby-Programming-Language-David-Flanagan/dp/0596516177/ > http://www.amazon.com/Programming-Ruby-1-9-Pragmatic-Programmers/dp/1934356085/ > http://www.amazon.com/Well-Grounded-Rubyist-David-Black/dp/1933988657/ > > Kind regards > > robert > > -- > remember.guy do |as, often| as.you_can - without end > http://blog.rubybestpractices.com/ > I remember saying in one of these threads that documentation should be pervasive and this is a perfect example of why this should be the case. The syntax rules of any language, natural or constructed, belongs in the standard documentation of said language. The only reason this wasn't really done in the past is that a printed book couldn't contain this information in a reasonable way. Hypertext allows us to achieve this.