docs and warning in anneal.py