[plt-scheme] Re: package documentation

From: Jose A. Ortega Ruiz (jao at gnu.org)
Date: Tue Apr 3 08:29:53 EDT 2007

"Jacob Matthews" <jacobm at cs.uchicago.edu>

> On 4/2/07, Jose A. Ortega Ruiz <jao at gnu.org> wrote:
> HTML docs are now listed as documentation on PLaneT right alongside
> doc.txt files; currently only one package:
> http://planet.plt-scheme.org/users/sweeney/sqlid-helper.plt/
> uses this feature. The way you get this to show up is by setting the
> now-misnamed "doc.txt" field in your info.ss file to point to the root
> of your documentation. (This is a new behavior; prior to yesterday
> doc.txt fields that weren't to files named doc.txt were ignored.) I

Excellent. Thanks for the tip.

> think that most people opt to use doc.txt files rather than HTML
> documentation just because it's much easier to work with (and in
> particular it's easier to generate a doc.txt file that the Help Desk
> knows how to search in a reasonable way).

I see. I had the impression that keyword search was a more or less
automated feature for users of tex2page (or plain text doc.txt), but i
see i should take a closer look at the documentation.

>> On a related note, i've tried to create a user on PLaneT, but have not
>> received the confirmation email after some 12 hours... is that normal?
> No. Every time I've had PLaneT mail me since moving to the new server
> the response has been immediate. Maybe the confirmation email got
> caught up in a spam filter somewhere?

Maybe. I haven't been able to locate it, though. Should i just try to
re-register with the same login?

Thanks again,
"Light thinks it travels faster than anything but it is wrong. No matter
 how fast light travels it finds the darkness has always got there first,
 and is waiting for it." - Terry Pratchett, Reaper Man
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 188 bytes
Desc: not available
URL: <http://lists.racket-lang.org/users/archive/attachments/20070403/aba7e5d0/attachment.sig>

Posted on the users mailing list.