[racket-dev] accessing @deftech terms in the reference from the guide

From: Jay McCarthy (jay.mccarthy at gmail.com)
Date: Wed Oct 23 20:54:50 EDT 2013

If a @tech references something from another document, you need to use
the #:doc argument to @tech. I find this very inconvenient and a
blemish in the system. You can make it not so painful by defining the
technical term you will use many times in one place:


On Wed, Oct 23, 2013 at 6:22 PM, David T. Pierson <dtp at mindstory.com> wrote:
> Are terms defined via @deftech in the Racket reference supposed to be
> accessible via @tech from the Racket guide?
> In pkgs/racket-pkgs/racket-doc/scribblings/reference/evts.scrbl there
> exists a line that looks like:
>   ... @deftech{synchronizable event} ...
> In my pkgs/racket-pkgs/racket-doc/scribblings/guide/concurrency.scrbl I
> have:
>   ... @tech{synchronizable event}s. ...
> When I build, I get:
>   raco setup: --- building documentation ---
>   raco setup: WARNING: undefined tag in <pkgs>/racket-doc/scribblings/guide/guide.scrbl:
>   raco setup:  (tech "synchronizable event")
> I'm guessing only the @deftech terms defined in the guide are accessible?  This
> is not a big deal, I just wanted to be sure I wasn't doing something
> incorrectly.
> Thanks.
> David
> _________________________
>   Racket Developers list:
>   http://lists.racket-lang.org/dev

Jay McCarthy <jay at cs.byu.edu>
Assistant Professor / Brigham Young University

"The glory of God is Intelligence" - D&C 93

Posted on the dev mailing list.