Issue #6: Added more documentation to API.
Also changed some of the API code to return number of added shims, rather than just
returning true/false.