more minor record fixes
documentation, sort of