[plt-dev] Scribble errors in Dracula distribution

On Mon, Mar 9, 2009 at 8:30 AM, Matthew Flatt <mflatt at cs.utah.edu> wrote:
> At Fri, 13 Feb 2009 13:28:18 -0500, Carl Eastlund wrote:
>> The pre-built documentation I uploaded with Dracula 8.1 has some
>> broken internal links.  You can see an example in the first paragraph
>> at:
>>
>> http://planet.plt-scheme.org/package-source/cce/dracula.plt/8/1/planet-
>> docs/reference/index.html
>>
>> These links work fine in the Dracula package itself.  Does anyone know
>> why they wouldn't work in the version created for the .plt file?  I
>> didn't see any errors reported when I built the package, or I would
>> have copied them and reported this problem then.
>>
>> Have any other planet package maintainers seen problems like this?
>
> I've finally looked into this.
>
> A file like "expressions.scrbl" in the Dracula document source has a
> `for-label' import of "../../lang/dracula.ss" instead of `(planet
> cce/dracula:8:1/lang/dracula))'. The relative path overlaps with the
> Planet package after its installed, so that's why the installed docs
> work. While building for the ".plt" file, though, Scribble doesn't know
> that "../../lang/dracula.ss" in the source directory for the new
> package corresponds to a Planet package.
>
> One solution is to use
>
>  (require (for-label (planet cce/dracula:8:1/lang/dracula)))
>
> instead of relative-path `for-label' requires in the doc sources. Or
> maybe add something like to `require-this-package-for-label' to the set
> of documentation macros currently provided by `(planet
> cce/scheme:3:0)'.

If I do that, then every time I update the package, I have to search
for every such occurrence and update cce/dracula:8:1/... to say
cce/dracula:8:2/... or whatever.  Hence the relative links that stay
the same across updates.  If I make a require expander that generates
a (planet ...) spec with appropriate version number, will Scribble
"understand" that?

--Carl