You could use type hints and pre/post conditions: (defn foo "Gets adjusted pixels or whatever" [^BufferedImage screen ^Number x ^Number y] {:post [(foo-map? %)]} ...)
(defn foo-map? "True if x is a map of maps with pixel colors ..." [x] ...) That said, it would be nice if clojure.repl/doc printed type hints and pre&post conditions. You can however use clojure.repl/source to see pre&post conditions. On Sunday, January 13, 2013 10:03:35 AM UTC-8, Marcel Möhring wrote: > > Hello, > > is there a better way to document a function if I want to include type > information > and parameters for in/out? > > Currently I am using this approach but it feels rather clumsy: > > "Takes a screen and a pixel coordinate and returns > a map of maps with pixel colors > and adjusted pixel coordinates around the pixel. > Directions are degree numbers from 0 to 315. > in: screen (BufferedImage), x (Number), y (Number) > out: map of maps ({direction (Number) {:color (Number) :x (Number) > :y (Number)}})" > > Are there any better ways? > > Thanks, > Marcel > > -- 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