[#3529289] Deprecate usage of "whitelist".

The word cannot immediately be removed as it is used in the name of a public class method. Deprecate the function and flag for removal in 3.0.x branch.