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.
