body of a fn is being reproduced as verbatium code in docs

[brehaut]

The function 'parse-bool' at https://github.com/brehaut/necessary-evil/blob/master/src/necessary_evil/value.clj#L38-41

(defn parse-bool [v] (condp = (.trim (text v))
                         "0" false
                         "1" true
                         "throw exception here"))

is being output in the uberdoc.html with the following as a verbatim code block in the doc column beside an abbreviated piece code:

"0" false "1" true "throw exception here"))

(defn parse-bool [v] (condp = (.trim (text v))

[zk]

Yeah, the code that parses docstrings is pretty brittle, it looks at the next line after a defn and if it sees a quote as the first non-whitespace character it assumes it's a docstring.

Work's in progress to find a more robust solution, keep an eye on https://github.com/fogus/marginalia/issues#issue/3 to follow the progress.

[fogus]

Until we work out a better parser a fix for your particular problem is to change your code to:

(defn parse-bool [v]
  (condp = (.trim (text v))
      "0" false
      "1" true
      "throw exception here"))

[zk]

I ended up going down the rabbit hole on trying to use the c.l.LispParser, so here's a temporary fix.

c7aa687
80e4be8

See the problem-cases.general namespace for the working example.