Fix error in documentation and examples about return value of "nearest".
Update Changes, add new example.