Newsgroups: comp.lang.scheme
Path: cantaloupe.srv.cs.cmu.edu!rochester!udel!news.mathworks.com!zombie.ncsc.mil!paladin.american.edu!solace!news.ifm.liu.se!liuida!news
From: Leif Nixon <leini@ida.liu.se>
Subject: Re: history of decision against documentation
X-Nntp-Posting-Host: mir14.ida.liu.se
Content-Type: text/plain; charset=us-ascii
Message-ID: <316B7D02.5A00@ida.liu.se>
Sender: news@ida.liu.se
Content-Transfer-Encoding: 7bit
Organization: Dept. of Computer and Information Science, Linkoping University
References: <3037656203674911@arcana.naggum.no> <4k3f0v$krh@usenet2.interramp.com> <3037716228318999@arcana.naggum.no> <4k6bsd$st1@agate.berkeley.edu> <3037873965239270@arcana.naggum.no>
Mime-Version: 1.0
Date: Wed, 10 Apr 1996 09:18:58 GMT
X-Mailer: Mozilla 2.01 (X11; I; SunOS 5.4 sun4m)
Lines: 22

Erik Naggum wrote:
> 
> again, I would like to understand why interactive Scheme systems do not
> offer the programmer/user any (accurate, up-to-the-release-date) on-line
> documentation and instead ask people to read manuals that suffer the same
> problem every other language's manuals do, being incomplete, overly
> tutorial in style, imprecise, etc.
> 

I don't quite follow you here. Lack of online documentation is clearly not
a fault of Scheme itself, but of the programming environment of your
Scheme implementation. Moreover, at least one major implementation, MacGambit,
has online access to R4RS and to documentation about MacGambit's own
extensions.

Also, why would online documentation not also suffer from being, as you say,
"incomplete, overly tutorial in style, imprecise, etc?"

/Leif Nixon
leini@ida.liu.se

Department of Computer Science, Linkoping University
