[racket] scribble and require

From: Stephen Bloch (sbloch at adelphi.edu)
Date: Wed Dec 29 22:15:32 EST 2010

Having some Scribble difficulties.  I've got a collection with several source files.  Everything defined in the "main" source file shows up correctly in the help page, but things defined in the other source files (which are all require'd by the main one) show up underlined in red, not as functioning hot-links, and "raco setup" complains about them:
raco setup: WARNING: undefined tag in picturing-programs/doc.scrbl:
raco setup:  ((lib "picturing-programs/tiles.rkt") rotate-cw)
raco setup:  ((lib "picturing-programs/tiles.rkt") rotate-ccw)

main.rkt looks like 
#lang racket/base
(require 2htdp/universe
         etc. etc. etc.)
(provide (all-from-out picturing-programs/tiles)   ; includes all-from-out 2htdp/image, plus a few simple add-ons
         (all-from-out picturing-programs/io-stuff) ; includes with-{input-from,output-to}-{string,file}, with-io-strings
         (all-from-out 2htdp/universe)
         (all-from-out 2htdp/image)
	 etc. etc.)

doc.scrbl looks like
#lang scribble/doc
  (for-label racket
             etc. etc.
@; teachpack["picturing-programs"]{Picturing Programs}
@title{Picturing Programs Teachpack}
@author{Stephen Bloch}
@section{Examples to figure out Scribble issues}
This is a reference to the @racket[list] function (good link; defined in racket).
Now a reference to @racket[triangle] (good link; defined in 2htdp/image),
and @racket[show-it] (good link, defined in main.rkt),
and @racket[crop-top] (underlined in red, not a link, defined in tiles.rkt), 
and @racket[map-image] (underlined in red, not a link, defined in map-image.rkt),
and @racket[with-input-from-url] (underlined in red, not a link, defined in io-stuff.rkt).

I must be missing something very basic.

Stephen Bloch
sbloch at adelphi.edu

Posted on the users mailing list.