some documentation and a start on tracing functions that read from external files
simple typo