Re: [Chicken-users] module and macro documentation

[Peter Bex]

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:
> 
> https://chicken.wiki.br/svn/chicken-eggs/chicken/branches/hygienic/manual/Modules%20and%20macros
> 
> (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 http://chicken.wiki.br/wiki-syntax-chicken
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.

Cheers,
Peter
-- 
http://sjamaan.ath.cx
--
"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

pgptUB8LgzyiS.pgp
Description: PGP signature