Commit b861cf4a authored by Dave Cooper's avatar Dave Cooper
Browse files

added one crinkle, moved old #8 to 'thinking ahead' addendum.

parent ad5d8ad0
...@@ -38,18 +38,29 @@ ...@@ -38,18 +38,29 @@
7. Functions-in-this-form (which are not compiled into object yet) are 7. Functions-in-this-form (which are not compiled into object yet) are
not being picked up. not being picked up.
8. Things to start thinking about for future: What are some good 8. a. "(the-object foo (evaluate ... " should work identically to
places/contexts to start pulling up and presenting the "(the-object foo ..." except symbols should show up as keywords.
docstrings (i.e. the message-remarks) for
input-slots/computed-slots/functions etc? (so far we haven't done b. "(the-object foo ((evaluate ... " should work identically to
anything with message-remarks). And how about best ways to "(the-object foo (..." except symbols should show up as keywords.
specify/interrogate/present documentation for individual arguments
to GDL Functions? (currently they are documented using a tortured
convention within the doc-string, which has to be kept manually in
sync with the actual lambda list --- it would be nice to be able to Thinking ahead to v 0.3:
have the documentation embedded right there in the lambda list ========================
along with the args --- borrowing some meta-data ideas from Clojure
perhaps?) Things to start thinking about for future: What are some good
places/contexts to start pulling up and presenting the
docstrings (i.e. the message-remarks) for
input-slots/computed-slots/functions etc? (so far we haven't done
anything with message-remarks). And how about best ways to
specify/interrogate/present documentation for individual arguments to
GDL Functions? (currently they are documented using a tortured
convention within the doc-string, which has to be kept manually in
sync with the actual lambda list --- it would be nice to be able to
have the documentation embedded right there in the lambda list along
with the args --- borrowing some meta-data ideas from Clojure
perhaps?)
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment