Fixes docstring typo.
Fixes iterator proc workaround not returning control.

This changes the behaviour of the tests, since now it is not guaranteed
all deletable files will be removed if a non deletable file is found
earlier while iterating the subdirectory.
Adds basic documentation.