Warren Lynn <wrn.l...@gmail.com> writes: >> In general, all different versions of a function should somehow do >> the same thing, so with separate docstrings you'd need to repeat >> yourself. A good guideline is to write the "big picture" first, >> followed by the meaning of the different parameters. >> > I agree the design should keep all implementations to do the same > thing *conceptually*, as that is what an interface is for. However, I > can imagine it is very common that a concrete implementation needs > extra documentation for certain implementation specific things. [...] > > In summary, in my view, this is a very legitimate and basic need.
I won't object, and the alter-meta! approach allows you to do that. Of course, it cannot provide documentation for the implementations, but the interface docs may be extended with impl docs incrementally at the location where the implementation is defined. That's at least better than nothing... Bye, Tassilo -- 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
