That's true. I'm just saying I've accidentally done that before in single arity functions with no penalty. But if you count on cider or similar picking up docstrings from your own functions you'll want to do it the official way.
--Ashton Sent from my iPhone > On Dec 20, 2014, at 10:53 AM, J Irving <j...@lollyshouse.ca> wrote: > > It's not a docstring then, just the first expression in the body. > >> On Sat, Dec 20, 2014 at 12:05 PM, Ashton Kemerling >> <ashtonkemerl...@gmail.com> wrote: >> You can put the docstring after the args, but the tooling won't pick it up. >> >> --Ashton >> >> Sent from my iPhone >> >>> On Dec 20, 2014, at 10:01 AM, Eli Naeher <enae...@gmail.com> wrote: >>> >>>> On Sat, Dec 20, 2014 at 8:30 AM, Timothy Baldridge <tbaldri...@gmail.com> >>>> wrote: >>>> >>>> And on a client project recently, it was decided (when I wasn't around) >>>> that the arguments to a function should always be on a newline: >>>> >>>> (defn foo >>>> [x] >>>> (+ x x)) >>>> >>>> Instead of: >>>> >>>> (defn foo [x] >>>> (+ x x)) >>> >>> Like you I prefer the arguments on the same line as the defn. >>> >>> Of course, when a docstring is present (and IMO there should nearly always >>> be a docstring), this is not possible. Does anyone here know why in Clojure >>> it was decided to move the docstring from its traditional-in-Lisp location >>> after the argument list? Perhaps it's just a question of what I'm used to, >>> but it feels very awkward to me. I like to be able to see the arglist while >>> I'm reading the docstring so that I can understand to which arguments it's >>> referring, but in Clojure with a long docstring often times the arglist is >>> not even visible on the screen. >>> >>> -Eli >>> -- >>> 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 >>> --- >>> You received this message because you are subscribed to the Google Groups >>> "Clojure" group. >>> To unsubscribe from this group and stop receiving emails from it, send an >>> email to clojure+unsubscr...@googlegroups.com. >>> For more options, visit https://groups.google.com/d/optout. >> >> -- >> 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 >> --- >> You received this message because you are subscribed to the Google Groups >> "Clojure" group. >> To unsubscribe from this group and stop receiving emails from it, send an >> email to clojure+unsubscr...@googlegroups.com. >> For more options, visit https://groups.google.com/d/optout. > > -- > 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 > --- > You received this message because you are subscribed to the Google Groups > "Clojure" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to clojure+unsubscr...@googlegroups.com. > For more options, visit https://groups.google.com/d/optout. -- 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 --- You received this message because you are subscribed to the Google Groups "Clojure" group. To unsubscribe from this group and stop receiving emails from it, send an email to clojure+unsubscr...@googlegroups.com. For more options, visit https://groups.google.com/d/optout.
