documentation and error handling improvements

Added documentation about the features in the doc/ directory
Added improved handling of error messages when source directories
are local to the machine