Polishing the documentation. Correcting some technically incorrect bits and adding info about the variables.