documented opt.py and added a callback to some Optimizers so the user can know about failed attempts to optimize