add comment explaining TypedSequenceFile
fixes and cleanup from @johnynek's feedback