Is there an easy way to refer to two different identifiers with the same
name when writing scribble documentation?
For example, let's say I have a language with a `let` binding that operates
more or less the same as racket's `let`. I wanted to write something like
this:
```
@(require (prefix-in racket: (for-label racket/base)))
@defform[(let ([id expr] ...) body ...){
The same behavior as @racket[racket:let].
}
```
This doesn't seem to work; the reference to racket's `let` ends up
including the `racket:` prefix and doesn't seem to resolve to the
appropriate link.
I looked at Typed Racket's docs to see how it manages this problem, and
found the following pattern:
```
@(module def-racket racket/base
(require (for-label racket/base) scribble/manual)
(define let-id (racket let))
(provide let-id))
@(require 'def-racket)
@defform[(let ([id expr] ...) body ...){
The same behavior as @|let-id|.
}
```
source:
https://github.com/racket/typed-racket/blob/master/typed-racket-doc/typed-racket/scribblings/reference/special-forms.scrbl
So my question is, is there an easier/more direct way to accomplish this
(perhaps since these typed racket docs were written)?
It also looks like this pattern could be captured by a macro---has someone
written that already?
Thanks,
Sam Caldwell
--
You received this message because you are subscribed to the Google Groups
"Racket Users" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To view this discussion on the web visit
https://groups.google.com/d/msgid/racket-users/CALuKBHsXBQAB_Thyp9Y8PLSosXSiLWN5fUHrLBBuDF333vXfxw%40mail.gmail.com.
