Re: On a programming manual for Lout

[Valeriy E. Ushakov]

On Fri, Jul 13, 2001 at 15:01:20 +0100, Graham Douglas wrote:

> If anyone has notes, examples, ideas for topics to be covered,
> indeed ANYTHING that could contribute to eventually producing a
> programming guide, please e-mail it to me (as text please).

Well, I think that while mailing list archive are somewhat indicative,
they are not really a good starting point for a programming manual.
They could augment it quite nicely, though.


> If anyone reading this has grasped a particular aspect of Lout (no
> matter how trivial you *think* it may be) and could spare a bit of
> time to write it up ***I beg you to do so*** and send it to me. You
> never know how the tiny pieces of this jigsaw could be completed by
> your input.  If in doubt, write it and send it.

I think this is good.  When one works with something too long, there's
a "perspective shift", so to say, or even a "tunnel vision".  I have
tutoring experience (university, workshops &c) and I observed that
sometimes there's a sort of communication break-down between me as
instructor and the audience.  Sometimes I just took some things for
granted, while audience that was only being exposed to the concepts
new to them would has a very different background and perspective than
I had .  So I think feedback in this area will be beneficial.


> If you have Lout source code, please write some notes explaining how
> it works and -- any problems you had; in particular, those aspects
> of Lout which initially confused you and the "Eureka moment" you had
> when you finally understood it (as I experienced with @Filter).  I
> will identify you, **if requested**, in a general list at the front
> of whatever I actually produce.

I've been actually contemplating (for quite some time) writing a
walk-throgh for some standard lout packages (sort of what "TCP/IP
Illustrated Vol.2" does for BSD TCP/IP stack).  If there's enough
interest in that I'll try to commit some time to actually write it.

SY, Uwe
-- 
address@hidden                         |       Zu Grunde kommen
http://www.ptc.spbu.ru/~uwe/            |       Ist zu Grunde gehen