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. -- 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
