Changed 'update_results' to 'return_results' everywhere, included tests, docstrings and examples.