added comments
refactored handling of the way table file size is expanded
godoc generated docs