add some docs, make 'set' not touch the reserved space