show how defaults is used and make the documentation more clear. Fixes #5