Improved function comments

git-svn-id: svn+ssh://svn.pricetx.org/home/svn/numberguesser@32 d9013ba4-f9c6-e311-acb0-001cc0fd6b5d