Re: defmacro* and defmacro*-public in master

[Andy Wingo <wingo@pobox.com>]

Hi Tristan,

On Tue 15 Dec 2009 18:15, Tristan Colgate <tcolgate@gmail.com> writes:

>   Are defmacro* and friends supposed to work in current master?

Yes, they are. But indeed, they weren't working. Thanks for the report,
I have pushed a fix to current master.

>   Also, out of interest, is there such a thing as define*-syntax?

No, there is not; though you could build one.

>   Is it possible to have docstrings for macros?

Yes, macros can have docstrings. For defmacros, docstrings go in the
same place they would go if it were a function definition.

For syntax-case expressions, the docstring goes with the syntax
transformer:

  (define-syntax foo
    (lambda (x)
      "docs"
      (syntax-case x ....)))

Syntax-rules macros currently can't have any docs. We could change that,
but as it would be a nonstandard extension anyway, you're probably
better off using syntax-case.

> doing something like (help macroname) seems to break anyway

Ah, here you have found another bug, I think. I was going to add a
hack-around to (ice-9 documentation) to fix this, but it's probably
better to attack the root, in macros.c.

Cheers,

Andy
-- 
http://wingolog.org/