Revision 230837

revert back to what the documented API says; caller code can easily set to 0 if they want to avoid the performance hit, and that's what should be done, instead of messing with public APIs.  be clearer in the doco though.