added rdoc comments and factered out creation of change records