Lisp documentation strings are counted as code

[syll-dev]

This lisp code :

(defun f (x y)
"Adds two numbers."
  (+ x y))

is (roughly) equivalent to this java code :

/** Adds two numbers. */
public int f (int x, int y)
{
    return x + y ;
}

In Lisp, "Adds two numbers." is a documentation string, equivalent to javadoc in java. I think this should not be counted as code but as comment instead. Other documentation strings are more difficult to catch, but for functions, methods, macros, ... the problem is the same.

Maybe lines with only a { or a } should not be counted at all in java, but this a a problem only for langages comparisons...

[cgag]

These unfortunately seem pretty painful to work around without basically writing parsers for languages with docstrings :\ . I think I'm going to probably ignore it for now and possibly forever.

[anntzer]

FTR the same issue occurs for Python.