expanded documentation to describe output format in more detail