make docblock more consistent with the later getters