properly format user guide in RST

The user guide isn't formatted properly for RST. Cosmetically,
the lines are too long and some have extra non-printing characters.
Lists aren't formatted for RST.

This fixes the file so that the lines are no more than 80 characters
wide, removes the non-printing characters, and makes use of
RST-formatting for the lists.

The text itself is not modified.

Change-Id: I8d2f3e4723e619014c056946e4f226d9c0e8f48a
Partial-Bug: #1353688
Merge "properly format user guide in RST"