Fix minor documentation formatting issues.

This should avoid exceptions caused by existing
files with different contents.

I also removed some unused code.

PythonPartitioner did not take the Python-side partitioning function
into account when checking for equality, which might cause problems
in the future.

This is a temporary change until we port takeSample().

Expand the PySpark programming guide.