add javadoc comments to clarify what the fill methods do