plumatic / plumbing

Prismatic's Clojure(Script) utility belt

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

defnk-defined functions don't document their args

gfredericks opened this issue · comments

When you defnk something clojure.repl/doc can't find any info about the args the function takes.

When I started thinking about this I realized it's not obvious what the best solution is here; perhaps the :arglists metadata could be generated that would reflect a normal top-level destructuring form such as [{:keys [foo bar baz]}]? It wouldn't have complete information but feels like it'd be better than nothing.

Thanks for the suggestion. That sounds reasonable to me -- so long as the arglist is accurate (says as much about the args as it can without saying anything false) it definitely seems better than nothing. PR welcome!