document behavior of ->all in scalar context

This just documents that ->all in scalar context will continue to return a count.  At the moment, it's just an implementation detail.