On Wednesday, September 21, 2016 at 9:54:23 AM UTC-4, Eli Naeher wrote:
> Is there a convention to be followed for referring the parameters of a
> function in the docstring, e.g. for emacs lisp we upcase the parameter name?
> Uppercase is (or was) also pretty standard style in Common Lisp. In
> Clojure there does not seem to be a standard. Bozhidar Batsov's Clojure
> Style guide is silent on this. Core Clojure docstrings do not seem to
> identify parameters in docstrings with any special style. Some people use
> Markdown-style backticks, but I'm not sure how widespread that usage is.
I believe the Style Guide only codifies established styles, and I don't
think there is one for this.
I'd use a Pandoc-markdown definition list in your docstring. For example,
for `(defn foo [num to from] ...)`:
: the number of frobnicators
: location it's going to
: location it's coming from
I don't know if the markdown processor for codex supports this markup, but
I think it's good and it's used by a few other markdowns besides Pandoc.
You received this message because you are subscribed to the Google
Groups "Clojure" group.
To post to this group, send email to email@example.com
Note that posts from new members are moderated - please be patient with your
To unsubscribe from this group, send email to
For more options, visit this group at
You received this message because you are subscribed to the Google Groups
To unsubscribe from this group and stop receiving emails from it, send an email
For more options, visit https://groups.google.com/d/optout.