On Nov 13, 9:42 am, Sean Devlin <francoisdev...@gmail.com> wrote:
> In this case, you provide the docs for each method after parameters.
> Would the following be possible:
>
> (defprotocol AProtocol :on AnInterface
>   "A doc string for AProtocol abstraction"
>   (bar "bar docs" [a b] :on barMethod)
>   (baz "baz docs" ([a] [a b] [a b &amp; c])))
>
> This matches the rhythm of the rest of the language.
>
> Sean


+1 for docstring position that matches the rest of the language.  I
actually think this is a big deal.

Other issue regarding docstrings:

user=> (doc AProtocol)
-------------------------
user/AProtocol
nil
  protocol doc
nil
user=> (doc bar)
-------------------------
user/bar
([a b])
  bar doc
nil


doc gives no indication of any relationship between bar and AProtocol,
other than the shared namespace.  Is the idea to use a convention of
max 1 protocol per namespace?

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