update documentation on what constitutes a line in a source file

(closes SF bug #1167922)