[racket-dev] help on Help Desk

From: Robby Findler (robby at eecs.northwestern.edu)
Date: Wed Sep 21 23:00:32 EDT 2011

I guess I'm in charge of the bits that call into help/search. If f1 is
near whitespace, it calls send-main-page. If there is a word/symbol
nearby it calls perform-search with that word and some context
information. It kind of sounds like the context is being synthesized
wrong. Perhaps the next step is to figure out what that context
information is when you're running and if it looks right or not.


On Wed, Sep 21, 2011 at 9:13 PM, Stephen Bloch <sbloch at adelphi.edu> wrote:
> Bug #12115 is really throwing me.  The reported symptom is "picturing-programs documentation is not searchable in Help Desk," but that's not quite true.
> I start up DrRacket in BSL and type "(require picturing-programs)" in Definitions pane, then hit Run.
> If I do NOT have a browser running, and I explicitly invoke "Help Desk" from the DrRacket menu, then search for (say) map-image, it finds it, no problem.
> If I then invoke "Help Desk" from the menu again, I get another browser tab that also finds map-image, no problem.
> If I then search for map-image by highlighting the function name and hitting F1, I get another browser tab that does NOT find map-image.
> What's more, the previously-opened tabs have now forgotten how to find map-image, which they found without difficulty a few seconds ago.
> Invoking Help Desk from the menu doesn't help: if I've EVER used F1, the search context is irretrievably lost.
> Hitting "Run" in DrRacket doesn't help: all the tabs have now lost the context that enabled them to find "map-image".
> Closing all the tabs in the browser doesn't help; any newly created tab is still missing that context.
> Quitting the browser DOES help: any Help Desk tab opened thereafter has the right context, until I use F1, at which point they all lose it.
> In short, Help Desk can find picturing-programs-specific documentation iff (I haven't used F1 since the last time I started the browser).
> This is on a Mac with Firefox; I haven't experimented with it on Windows (where the bug was reported) yet, nor with different browsers.
> BTW, the same thing happens if picturing-programs is loaded as a teachpack rather than with "require".
> Who's in charge of the Help Desk (and, more particularly, the F1 keyboard shortcut)?
> Stephen Bloch
> sbloch at adelphi.edu
> _________________________________________________
>  For list-related administrative tasks:
>  http://lists.racket-lang.org/listinfo/dev

Posted on the dev mailing list.