readval return type and docs updated