From mboxrd@z Thu Jan  1 00:00:00 1970
X-Msuck: nntp://news.gmane.io/gmane.comp.tex.context/2479
Path: main.gmane.org!not-for-mail
From: siepo@client44-3.kabelA.oprit.rug.nl
Newsgroups: gmane.comp.tex.context
Subject: Re: manual
Date: Sat, 12 Aug 2000 14:05:57 +0200 (CEST)
Sender: owner-ntg-context@let.uu.nl
Message-ID: <14741.15781.989852.251473@bitmuis.thuis.nl>
References: <14741.8774.386846.462340@bitmuis.thuis.nl>
	<39952723.740F14A4@pobox.com>
Reply-To: Siep Kroonenberg <siepo@cybercomm.nl>
NNTP-Posting-Host: coloc-standby.netfonds.no
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
X-Trace: main.gmane.org 1035393269 9190 80.91.224.250 (23 Oct 2002 17:14:29 GMT)
X-Complaints-To: usenet@main.gmane.org
NNTP-Posting-Date: Wed, 23 Oct 2002 17:14:29 +0000 (UTC)
Original-To: ntg-context@let.uu.nl
In-Reply-To: <39952723.740F14A4@pobox.com>
Xref: main.gmane.org gmane.comp.tex.context:2479
X-Report-Spam: http://spam.gmane.org/gmane.comp.tex.context:2479

Berend de Boer writes:
 > 
 > > Also some remarks about the manual: since it is intended as reference
 > > manual, it should facilitate quick lookup and not require close
 > > reading of an entire chapter.
 > 
 > Hmm, I find it served its purpose. But I agree that we can have more
 > manuals, one with lots of examples would be nice. Usually I test with a
 > small test file or look in the source of the manual is not clear, but
 > usually the manual is clear enough. Perhaps you need to get adjusted to
 > its style.
 > 
 > Groetjes,
 > 
 > Berend. (-:

Yes, I also write small testfiles when the meaning of the manual is
not clear. But when it is necessary to look at the source then there
is clearly something wrong. Especially since Context has pretensions
to user-friendliness that LaTeX doesn't have.

I suspect that the manual fares better for continuous reading than for
lookup. The suggested typographic changes are intended to make lookup
more efficient.

Siep