On Tue, Oct 26, 2010 at 4:44 PM, Timo Mihaljov <noid....@gmail.com> wrote: > On Tue, Oct 26, 2010 at 02:15:21PM -0400, Andrew Gwozdziewycz wrote: >> Areas likely to include gobbledegook: >> [...] >> 2. links (internal. for external links, just use fully qualified URI) > > Internal links could be easily handled by trying to resolve all `code > blocks` with ns-resolve in the namespace containing the docstring. If > the block resolves to a var, make it a link. No gobbledegook needed. > (In practice you'd need a slightly more complicated algorithm to > handle cases where e.g. a parameter shadows an existing var.) > > If you wanted to get real fancy, you could even check if the code > block is a list, and then resolve each symbol inside the list, so > that, for example, resolve's docstring would look like this at the > REPL: > > user=> (doc resolve) > ------------------------- > clojure.core/resolve > ([sym]) > same as `(ns-resolve *ns* sym)` > > But in the HTML documentation `ns-resolve` and `*ns*` would be > hyperlinks.
I like that idea. And it does make sense to do that rather than create some special syntax for those cases. So, that leaves images, and equations, and any other "rich" types we haven't thought of. Tom, does this all seem reasonable? If so, how can I help? Andrew > -- > Timo > > -- > 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 -- http://www.apgwoz.com -- 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
