I'm porting the PLaneT package 'packrat' to the new package catalog and I'm
having trouble documenting a syntax form.
Here is the relevant snippet from the scribble documentation:
@defform/subs[#:literals (! / := |@| quote)
(parse id (nonterminal-id (sequence body body0 ...) ...) ...)
([sequence (part ...)]
[part (! part ...)
(/ sequence ...)
(? expr)
(code:line id := (quote kind))
(code:line id := |@|)
(code:line id := nonterminal-id)
(code:line id := (? expr))
(code:line nonterminal-id)])]{
Documentation here...
}
When compiling the documentation, 'raco setup packrat' complains with:
raco setup: WARNING: undefined tag in
<pkgs>/packrat/scribblings/packrat.scrbl:
raco setup: ((lib "packrat/main.rkt") parse)
The form is rendered with a red underline and is not correctly linked. It
is correctly provided by 'main.rkt' and later in the documentation, an
example containing the syntax runs OK. I've ensured the syntax is available
through the REPL, and have required the module with 'for-label' in the
scribble file as well. All other exports are linked OK. The previous
documentation had this issue as well, see here
<https://planet.racket-lang.org/package-source/dvanhorn/packrat.plt/2/3/planet-docs/packrat/index.html>
.
I think this is a simple mistake I have made, but I can't spot it and have
run out of ideas. Many thanks.
Simon.
--
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 racket-users+unsubscr...@googlegroups.com.
To view this discussion on the web visit
https://groups.google.com/d/msgid/racket-users/dbb6810b-5ae9-4b41-8c32-5b7dbe914744%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.
