Re: [racket-dev] self-documenting feature

2010-07-19 Thread Robby Findler
You probably already know about this, but proc-doc is the closest we have at the moment. Robby On Mon, Jul 19, 2010 at 7:04 PM, Neil Van Dyke wrote: > Robby Findler wrote at 07/19/2010 12:31 PM: >> >> Sure, but if we have the manpower/energy for this, then it would be nice >> to have, no? >> > >

Re: [racket-dev] self-documenting feature

2010-07-19 Thread Neil Van Dyke
Robby Findler wrote at 07/19/2010 12:31 PM: Sure, but if we have the manpower/energy for this, then it would be nice to have, no? I've been wanting something docstring- or javadoc-like for Scheme and Racket since forever. I have had my own kludges for this since forever, but neither myse

Re: [racket-dev] self-documenting feature

2010-07-19 Thread Shriram Krishnamurthi
This is a pointless exchange that misses the reason for its initiation. Attendee: "Here's a nice feature that I find awfully useful. How do I get it in DrRacket?" Us: "Oh yeah? And can your beloved language do X?" Shriram On Mon, Jul 19, 2010 at 4:58 PM, Matthias Felleisen wrote: > > That's

Re: [racket-dev] self-documenting feature

2010-07-19 Thread Nadeem Abdul Hamid
Yes, but Racket docstrings aren't even there at all (yet :))... On Jul 19, 2010, at 4:58 PM, Matthias Felleisen wrote: > > That's the question. Packaged for beginners; always there, never to ask for. > > > On Jul 19, 2010, at 4:55 PM, Nadeem Abdul Hamid wrote: > Do ask the person who as

Re: [racket-dev] self-documenting feature

2010-07-19 Thread Matthias Felleisen
That's the question. Packaged for beginners; always there, never to ask for. On Jul 19, 2010, at 4:55 PM, Nadeem Abdul Hamid wrote: >>> Do ask the person who asked whether Python has coverage now. -- Matthias > > Maybe not packaged for beginners, but it is doable... > http://pypi.python.org/

Re: [racket-dev] self-documenting feature

2010-07-19 Thread Nadeem Abdul Hamid
>> Do ask the person who asked whether Python has coverage now. -- Matthias Maybe not packaged for beginners, but it is doable... http://pypi.python.org/pypi/coverage/2.85 http://nedbatchelder.com/code/coverage/ _ For list-related adminis

Re: [racket-dev] self-documenting feature

2010-07-19 Thread Matthias Felleisen
That's totally different from what Shriram described. On Jul 19, 2010, at 1:53 PM, Guillaume Marceau wrote: > During > There is good support from the interviews for having dynamic > documentation in DrRacket would help quite a bit. Two out of the four > students I interview requested the featu

Re: [racket-dev] self-documenting feature

2010-07-19 Thread Matthias Felleisen
And which is which :-) On Jul 19, 2010, at 1:24 PM, Shriram Krishnamurthi wrote: >> Do ask the person who asked whether Python has coverage now. -- Matthias > > Aspirin vs vitamins. > > Shriram _ For list-related administrative tasks: http:

Re: [racket-dev] self-documenting feature

2010-07-19 Thread Guillaume Marceau
During There is good support from the interviews for having dynamic documentation in DrRacket would help quite a bit. Two out of the four students I interview requested the feature. Here are some relevant inteview excepts. Student #1: " Maybe a tiny example, or something, that follows the contra

Re: [racket-dev] self-documenting feature

2010-07-19 Thread Shriram Krishnamurthi
> Do ask the person who asked whether Python has coverage now. -- Matthias Aspirin vs vitamins. Shriram _ For list-related administrative tasks: http://lists.racket-lang.org/listinfo/dev

Re: [racket-dev] self-documenting feature

2010-07-19 Thread Robby Findler
Sure, but if we have the manpower/energy for this, then it would be nice to have, no? (We'd probably do something syntactically and not via runtime values, but the essential idea seems like it would carry over.) Robby On Mon, Jul 19, 2010 at 11:05 AM, Matthias Felleisen wrote: > > While I have a

Re: [racket-dev] self-documenting feature

2010-07-19 Thread Matthias Felleisen
While I have always liked doc strings in Lisps -- and koodos to Python for copying another feature from Lisp -- is it as critical to HtDP programming as built-in check-expect with coverage? (No but I think having it would be nice.) Do ask the person who asked whether Python has coverage now. --

Re: [racket-dev] self-documenting feature

2010-07-19 Thread Nadeem Abdul Hamid
Yes, when I taught "HtDP" in Python two years ago, this feature was handy. It provide a more convenient way for recalling/looking up contract/purpose statements right in the REPL than opening a search in a browser. If I remember correctly, I think the IDE might have also done something smart wit

[racket-dev] self-documenting feature

2010-07-19 Thread Shriram Krishnamurthi
Python apparently has a feature where you essentially put the contract/purpose in the text of a function, and when you type the function's name, it prints out that documentation. (It sounds like the docstrings of Common Lisp.) This came up on day 1, minute 15 of the TSRJ workshop. ___