some docstrings and a small performance improvement in the walker copy function