reInit() use case documentation

It would be great if reInit() function would have extended documentation. Right now it is not clear what its use case is.

For instance, is it necessary to reInit() before every change? or when should it be called?
