[racket] Scribble "seclink" breaking PLaneT and local documentation cache?

From: Robby Findler (robby at eecs.northwestern.edu)
Date: Tue Jan 18 13:08:26 EST 2011

Sorry for the long delay in getting back to this. Short story: The
link is now working again, but working in a suboptimal way (the way it
would have worked in the past, tho).

Longer story: There were a number of little things wrong (some of
which Matthew fixed, once of which I did) and now you get the
not-really-helpful web page that tells you to search in your own
installation instead of a broken link (the broken link was a result of
a change that made "doc-search.rkt" show up in the url instead of
"doc-search.ss" like it used to). Most of the delay was due to me not
having a planet server virtual machine to test out changes on (my last
one was taken over by someone who seemed to be downloading the entire
IEEE library and sending it off to China somewhere (and then who knows
where from there)). Anyways, I now have one that uses the latest
fedora and isn't actually directly accessible to the outside world, so
hopefully that won't happen again and hopefully I'll be a little bit
quicker with planet server problems, too.


On Mon, Jan 10, 2011 at 2:09 PM, Neil Van Dyke <neil at neilvandyke.org> wrote:
> A servlet for the PLaneT site seems broken, and I think that a use of
> Scribble "seclink" in a PLaneT package might be breaking both this and my
> local documentation cache.
> The documentation for a PLaneT package contains a link to a manual, like:
> @seclink["top" #:doc '(lib "scribblings/scribble/scribble.scrbl")]{Scribble}
> When clicking the "doc" link on the PLaneT site, this link becomes to:
> http://planet.racket-lang.org/servlets/doc-search.rkt?tag=KCgy[[...long
> string...]]
> but that URL results in an error: "Servlet didn't load.".
> For example, see the "Scribble" link near top of:
> http://planet.racket-lang.org/package-source/neil/scribble-emacs.plt/1/2/planet-docs/scribble-emacs/index.html
> I notice that, although my "~/.racket" PLaneT cache shows the "index.html"
> for this version of the package was correctly generated with a link to
> "file:///usr/local/racket-5.0.2/share/racket/doc/scribble/index.html", my
> "~/.racket/5.0.2/doc/index.html" contains a link to the previous version of
> the PLaneT package.  Likewise, my documentation search index seems to have
> the previous version of the package, not this one.
> --
> http://www.neilvandyke.org/
> _________________________________________________
>  For list-related administrative tasks:
>  http://lists.racket-lang.org/listinfo/users

Posted on the users mailing list.