[plt-scheme] Scribble question: how do you refer to another Scribble document?

The file in the #:doc argument should be the top-level scribble file
and then the ordinary argument to secref shoudl be a tag in that file
(look at the #:tag arguments to @section and @title). Watch out for
#:tag-prefix's in @sections and @titles, tho, you'll need to pass the
same thing along (in a list) to the secref.

It isn't magic, but the docs could certainly be improved.

hth,
Robby

On Sat, Jan 16, 2010 at 2:52 PM, Stephen Bloch <sbloch at adelphi.edu> wrote:
> I tried sending this before, but apparently from the wrong e-mail address so
> it went to the moderator.  Let's try again.
> I'm documenting a teachpack that includes almost-identical copies of
> image.ss and universe.ss, and rather than repeat or include all their
> documentation I thought it would make more sense to just hot-link to it.  As
> I read the docs,
>
> @secref[#:doc something]
>
> should do the trick.  My first few attempts being unsuccessful, I looked
> through the bundle for examples.  I found
>
> @secref[#:doc '(lib "scribblings/setup-plt/setup-plt.scrbl") "setup-info"]
>
> copied this into my own scribble file, built and installed a PLaneT package,
> and it worked.
>
> Since I wanted to refer to the whole file rather than one specific tag in
> it, I replaced "setup-info" with "top",
> built and installed the PLaneT package, and it worked.  I concluded that
> what goes in the quotation marks is a path from .../collects to a .scrbl
> file.  But when I replaced that path with
> "teachpack/htdp/scribblings/image.scrbl", setup-plt said
>
> WARNING: undefined tag
>
> and the generated HTML page has some Scheme code in red talking about
>
> (part ("(lib scribblings/image.scrbl)" "top"))
>
> I thought maybe the target had to be in some particular blessed directory,
> so I copied "image.scrbl" into the same directory that "setup-plt.scrbl" had
> been in, and linked to it there.  Same result; it's not about being
> descended from the "scribblings" directory.
>
> A little help, please?
>
>
> Stephen Bloch
> sbloch at adelphi.edu
>
>
>
> _________________________________________________
>  For list-related administrative tasks:
>  http://list.cs.brown.edu/mailman/listinfo/plt-scheme
>
>