updating each_line api to better reflect returned data, added some comment headers