rST markup fixes for pyop2.ir docstrings
Add IR user documentation
Rework kernel API section

Now that there's a separate section in the manual for the API, just
refer to it briefly.
Merge pull request #296 from OP2/pyop2-ir-doc

Add documentation on the PyOP2 intermediate representation.