defnk-defined functions don't document their args
gfredericks opened this issue · comments
Gary Fredericks commented
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.
Jason Wolfe commented
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!