code comment

explain that mthod is called a second time in case it returns
different info in list context