makes the -s --size option documentation clearer #8950

@Bertg @shykes - these changes should also have been made as part of #8950 

@fredlf @jamtur01