add comments on tricky sections while i remember them
be more tolerant of private string values