extend some docstrings, add some useful comments
throw on (quote)
remove code no longer relevant