documented part of the code
Merge pull request #5 from a442/master

documented part of the code