Tidy up rST usage in comments

Change-Id: Icb9a349440f06a00c6a538ae5ef1943c6d98f87c