I don't think examples should be integrated in the
function-definition. It's *way* to much bloat.

I like the way http://clojure-examples.appspot.com/clojure.core goes.
A wiki-like documentation for examples, linked to every
clojure-namespace. These examples could be serialized into some data
structure and integrated in clojure.jar. This would result in no bloat
for core.clj etc. and nice, accessible examples for our
development-tools.

On Wed, Jul 7, 2010 at 9:05 PM, John Cromartie <jcromar...@gmail.com> wrote:
> I've whipped up a proof-of-concept of how to implement built-in
> examples for functions and macros. The general idea is to add an
> attribute to the var that contains a list of docstrings and arg lists
> or code that illustrate common usage.
>
> Let me know what you think: http://gist.github.com/466743
>
> It could also be useful for generating documentation.
>
> --
> You received this message because you are subscribed to the Google
> Groups "Clojure" group.
> To post to this group, send email to clojure@googlegroups.com
> Note that posts from new members are moderated - please be patient with your 
> first post.
> To unsubscribe from this group, send email to
> clojure+unsubscr...@googlegroups.com
> For more options, visit this group at
> http://groups.google.com/group/clojure?hl=en



-- 
Moritz Ulrich
Programmer, Student, Almost normal Guy

http://www.google.com/profiles/ulrich.moritz

-- 
You received this message because you are subscribed to the Google
Groups "Clojure" group.
To post to this group, send email to clojure@googlegroups.com
Note that posts from new members are moderated - please be patient with your 
first post.
To unsubscribe from this group, send email to
clojure+unsubscr...@googlegroups.com
For more options, visit this group at
http://groups.google.com/group/clojure?hl=en

Reply via email to