misleading documentation corrected, thanks to Kai Zhang for spotting the
error