[racket-dev] python docstrings

2010-07-19 Thread John Clements
In the being-aware-of-your-competitors category: I was sitting in the first TSRJ lecture this morning, and Kathi was introducing the notion of the purpose statement. One teacher in the audience raised her hand, and asked whether DrRacket had a python-like feature where users could query the sys

[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. ___

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] Pre-Release Checklist for v5.0.1

2010-07-19 Thread Ryan Culpepper
Checklist items for the v5.0.1 release (using the v5.0.0.900 release candidate build) Search for your name to find relevant items, reply when you finish an item (please indicate which item/s is/are done). Also, if you have any commits that should have been picked, make sure that the changes are

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 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] Pre-Release Checklist for v5.0.1

2010-07-19 Thread Carl Eastlund
On Mon, Jul 19, 2010 at 10:47 AM, Ryan Culpepper wrote: > Checklist items for the v5.0.1 release >  (using the v5.0.0.900 release candidate build) > > * Carl Eastlund >  - Dracula Tests (confirm that Dracula runs from PLaneT) Done. --Carl _ For

[racket-dev] srfi41 for racket

2010-07-19 Thread Jos Koot
Is it a good idea to adapt PLT-Scheme implementation of srfi41 to Racket? In principle, this is trivial. However, when I adapted srfi41 for PLT-Scheme, Eli Barzilay advised me not to double the code for promises. I did not follow his advice. I now intend to follow his advice. This has consequences

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 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

[racket-dev] Windows test bundle 29M vs. 47M for other platforms?

2010-07-19 Thread John Clements
On this page http://pre.racket-lang.org/release/installers/ the reported size of the Windows installer is 29M, vs. about 47 or 48 M for other platforms. I see that this was true of the 5.0 release as well, so this is probably expected, but I'm curious: why is this? Is it just that the other p

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 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] Pre-Release Checklist for v5.0.1

2010-07-19 Thread Robby Findler
On Mon, Jul 19, 2010 at 9:47 AM, Ryan Culpepper wrote: > * Robby Findler >  - DrRacket Tests These discovered a bug. So, not yet done, I guess. >  - Framework Tests >  - Contracts Tests >  - Games Tests >  - Teachpacks Tests: image tests >  - PLaneT Tests done >  Updates: >  - DrRacket Update

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 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
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 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] Windows test bundle 29M vs. 47M for other platforms?

2010-07-19 Thread Eli Barzilay
On Jul 19, John Clements wrote: > On this page > > http://pre.racket-lang.org/release/installers/ > > the reported size of the Windows installer is 29M, vs. about 47 or > 48 M for other platforms. I see that this was true of the 5.0 > release as well, so this is probably expected, but I'm curiou

Re: [racket-dev] python docstrings

2010-07-19 Thread Eli Barzilay
On Jul 19, John Clements wrote: > [...] a python-like feature [...] I wasn't familiar with Python's > docstrings, so I checked them out. [...] On Jul 19, Shriram Krishnamurthi wrote: > Python apparently has a feature [...] (I was actually relieved when Matthias properly tied this back to Lisp d

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 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] python docstrings

2010-07-19 Thread Shriram Krishnamurthi
> (I was actually relieved when Matthias properly tied this back to Lisp > docstrings. If you had read the very next sentence of my original message, you'd have seen this line from me: (It sounds like the docstrings of Common Lisp.) Shriram _ F

Re: [racket-dev] Pre-Release Checklist for v5.0.1

2010-07-19 Thread Jay McCarthy
On Mon, Jul 19, 2010 at 8:47 AM, Ryan Culpepper wrote: > Checklist items for the v5.0.1 release >  (using the v5.0.0.900 release candidate build) > > Search for your name to find relevant items, reply when you finish an > item (please indicate which item/s is/are done).  Also, if you have any > co

Re: [racket-dev] Pre-Release Checklist for v5.0.1

2010-07-19 Thread Gregory Cooper
> * Greg Cooper >  - FrTime Tests Done. _ For list-related administrative tasks: http://lists.racket-lang.org/listinfo/dev