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
_
  For list-related administrative tasks:
  http://lists.racket-lang.org/listinfo/dev


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
docstrings.  The python-only posts were going towards making another
case of a "schwartzian transform" thing.)

-- 
  ((lambda (x) (x x)) (lambda (x) (x x)))  Eli Barzilay:
http://barzilay.org/   Maze is Life!
_
  For list-related administrative tasks:
  http://lists.racket-lang.org/listinfo/dev


[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 system for the purpose statement associated with a given user-defined 
function.  

I wasn't familiar with Python's docstrings, so I checked them out.  In their 
current form, they're largely irrelevant, but I could definitely see it being 
useful to be able to fold purpose statements into the right-click menu in 
DrRacket.  Specifically, I see that there's a "jump to definition" entry in 
that right-click menu; perhaps it would make sense to add the purpose statement 
associated with a function directly to that menu on its instantiation.

John



smime.p7s
Description: S/MIME cryptographic signature
_
  For list-related administrative tasks:
  http://lists.racket-lang.org/listinfo/dev