update docs due to changes in default & defaultVal