enhanced documentation on the recursive weigh files