[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [Chicken-users] module and macro documentation

From: Peter Bex
Subject: Re: [Chicken-users] module and macro documentation
Date: Fri, 23 May 2008 20:53:10 +0200
User-agent: Mutt/

On Fri, May 23, 2008 at 04:51:09PM +0200, felix winkelmann wrote:
> Hi, folks!
> Please find some initial documentation about the new module
> system and explicit renaming macros here:
> (user anonymous, password empty, as usual)

Thanks for writing this up! It's a very clear document in most points,
especially the examples on explicit renaming are excellent. The
documentation on 'syntax' could use some example code, the current
description is a little terse.

Small aside: There's now wiki syntax for procedure and syntax
definitions at
Using this will make the wiki more easily scannable by automatic
tools in the future. At least, we hope it will :)

> Feedback is welcome. I'm not sure on the module syntax, but found
> this one (taken from psyntax) to be relatively natural and simple.

Yeah, I mostly agree. It is slightly annoying that all code inside the
module always ends up indented with such a system, though.  (minor
advantage: it allows you to let one file define more than one module)

> Different naming and syntax are still possible, of course.

I always liked the external definitions from the old scheme 48 system,
but they're not as simple.

"The process of preparing programs for a digital computer
 is especially attractive, not only because it can be economically
 and scientifically rewarding, but also because it can be an aesthetic
 experience much like composing poetry or music."
                                                        -- Donald Knuth

Attachment: pgptUB8LgzyiS.pgp
Description: PGP signature

reply via email to

[Prev in Thread] Current Thread [Next in Thread]