Maybe I don't grasp all the implications of your question, and I don't know what is top-down and bottom-up documentation,<br>but from DrRacket , if you press F1 on a procedure/form/etc., you get to the web based pre-filled search box, which gives you a number of hits.<br>
Each hit gives you the module in which the name is declared, and if you click on that module name, you get the reference about the whole module, so you can indeed look at similar functions defined in that module.<br>This search box also has useful tools such as removing a given module from the current search (when right-clicking on it IIRC).<br>
<br>I, too, would sometimes prefer a "help" function that does not need to launch a web page and could also be used in a command-line only program, but I must admit the web help is very convenient and particularly well thought.<br>
<br>As for the psychological effort to temporarily escape from your current editor, maybe one day DrRacket will embed a sufficiently complete Web browser (using Webkit?) to display the Help Desk directly inside DrRacket?<br>
<br>Laurent<br><br><div class="gmail_quote">On Tue, Nov 30, 2010 at 17:55, Richard Lawrence <span dir="ltr"><<a href="mailto:richard.lawrence@berkeley.edu">richard.lawrence@berkeley.edu</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">
Dear Racketeers:<br>
<br>
Apologies in advance for what will probably be a long-winded newbie<br>
question. I'm wondering how one goes about "exploring" the Racket<br>
libraries. That is, how does one find out things like:<br>
<br>
1. which modules are likely to contain functions useful for a particular<br>
task<br>
2. what names a given module exports<br>
3. more information about the objects exported by a module: e.g.,<br>
brief descriptions, their types, what methods they respond to, ...<br>
<br>
Here's some background. Most of the programming I have done is in<br>
Python. One of my favorite features in Python is that<br>
<br>
>>> help(X)<br>
<br>
gives useful information for just about any object X. This is great for<br>
exploring modules, learning about the methods and member variables of<br>
classes, and finding out what functions do; it's an important<br>
"bottom-up" tool for exploring the language and libraries. In Python, I<br>
can often think, "I need something similar to, but not quite the same<br>
as, X; X is defined in module M; so let's do help(M) to see if M has the<br>
function I want." Often, I can tell at a glance over the docstrings that<br>
the thing I need -- or something related to it -- is there. (This kind<br>
of "bottom-up" exploration is complemented by the documentation for the<br>
Python standard library, which provides a nice "top-down" reference.)<br>
<br>
I know that REPL-based interaction is de-emphasized in Racket. Does<br>
that mean that the kind of "bottom-up" exploration of the language that<br>
I'm describing is de-emphasized as well? Should the documentation be<br>
the first (only?) place I go to learn about modules and their contents?<br>
If so, what's the best way to access and search the documentation while<br>
programming?<br>
<br>
Please understand that I'm not ragging on Racket's documentation here;<br>
the documentation is truly excellent. I guess one way of asking my<br>
question might be this. I tend to think of the documentation as<br>
something I must sit down and read for a while, partly because the<br>
examples are often extended and build on each other, and partly because<br>
of the psychology of jumping out of Emacs into a browser.[1] Is there a<br>
different way of using and thinking about them? In particular, is there<br>
a way of using them that corresponds to the uses of help() in Python?<br>
<br>
Thanks for your thoughts!<br>
<br>
Best,<br>
Richard<br>
<br>
<br>
[1] I have so far mostly stayed away from DrRacket, because I know Emacs<br>
well and haven't felt the desire or need so far to learn another<br>
environment. Is that my problem? Does DrRacket support the kind of<br>
bottom-up exploration in the documentation that I'm trying to describe?<br>
<br>
_________________________________________________<br>
For list-related administrative tasks:<br>
<a href="http://lists.racket-lang.org/listinfo/users" target="_blank">http://lists.racket-lang.org/listinfo/users</a><br>
</blockquote></div><br>