Final fixes and documentation

* Changed vote count type to long (because the total vote count can go
up to 2^32 - 1);
* Added documentation and improved comments in code;
* Removed temporary test input files from solution.