If the docstrings are written in markdown, this would conflict as something in backticks isn't necessarily a var name.
In Codox, I used the wiki-link style: [[clojure.core/map]]. - James On 15 May 2016 at 18:40, cskksc <ckopar...@gmail.com> wrote: > Hello, > We are working on a new feature in CIDER which would parse a docstring and > create hyperlinks that follow the functions/vars/interop-forms mentioned > there. > It is very similar to the "See Also" links shown by ClojureDocs > <http://clojuredocs.org/>. Right now, we are using backticks to identify > the reference forms and create links. > > So a function like; > > (defn test-mde > "Does something with `user-ns/user-fn`. > Also see: `clojure.core/map`, `clojure.core/reduce`, `defn`" > [] > (+ 1 1)) > > would create hyperlinks for map, reduce, defn and user-ns/user-fn forms. > > What style do you tend to use in such docstrings ? > It would help us figure out whether to continue with the backticks or do > something else, like adding a configuration variable for this. > > Thanks, > Chaitanya > > -- > 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.
