From: Robert Klemme <shortcutter@...>
Date: 2012-02-15T19:29:05+09:00
Subject: Re: the ruby syntax

On Wed, Feb 15, 2012 at 3:08 AM, Kevin <darkintent@gmail.com> wrote:

> 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.

What exactly is your definition of "reasonable"?  According to my
definition a book is perfectly capable of providing documentation of
syntax in a reasonable way - and actually there are tons of books
around which present syntax of languages in a way useful for the
reader.

> Hypertext allows us to achieve this.

Of course you can also document formal language syntax in a hypertext
document, and maybe even better than in a printed book.  It is not
necessary though.

Kind regards

robert


-- 
remember.guy do |as, often| as.you_can - without end
http://blog.rubybestpractices.com/