Add explanatory comments at top of file.

Also massage the exposed interface a bit.
Merge branch 'master' of github.com:mstewart/reversi