Re: use-syntax / transformer doc bugs

[Kevin Ryde]

Andy Wingo <address@hidden> writes:
>
> It's not clear from the docs that what (use-syntax (foo bar)) actually
> does is uses the (foo bar) module, then installs the procedure bound to
> `bar' as (module-transformer (current-module)). That seems like a bit of
> a hack, but whatever. It should be noted that the user should only call
> `use-syntax' for a module that actually implements a transformer, not
> for modules that just export syntax. Also, it should cross-reference to
> the paragraph describing the idea of a syntax transformer.
>
> (And why are #:export and #:export-syntax different if they don't act
> differently?)

I find the description of use-modules versus use-syntax pretty
unclear.  I thought at one time I know what it meant, but now know
I've got no idea.