code comment

explain that mthod is called a second time in case it returns
different info in list context
Merge pull request #225 from dkj/devel

code comment