Re: [Chicken-users] egg documentation

[Alejandro Forero Cuervo]

> The only piece I see missing right now is that documentation can't be
> posted to the wiki in a semanticly rich way from which other tools can
> easily extract meaning.  I will probably work on that.

Seeing that this has been just around the corner for months, I decided
to cross said corner today and start doing something about it.  I have
the following in wiki/stream-ext:

> === stream-xcons
> 
> <procedure name="stream-xcons" args="a b" returns="stream">
> Of utility only as a value to be conveniently passed to higher-order
> procedures.
> 
> <examples>
> <expr>(stream-xcons (stream 'b 'c) 'a)</expr>
> <result>#<stream (a b c)></result>
> <expr>(stream-xcons (stream 2 3 4) 1)</expr>
> <result>#<stream 1 2 3 4></result>
> </examples>
> 
> The name stands for "eXchanged CONS."
> </procedure>

The output can be seen, obviously, in:

  http://galinha.ucpel.tche.br:8080/stream-ext#stream-xcons

You can see the code that supports this in
stream-wiki/trunk/extensions/chicken.scm.  I would invite others to
define new syntactic constructions by extending that file and sending
patches (please do not commit directly to it) as a reply sent to the
list to this mail so that we can all comment on the new proposals.

Thanks.

Alejo.
http://azul.freaks-unidos.net/