Style improvements to README.rst

[jdufresne]

• Trim extraneous trailing whitespace
• Use double backquotes for inline fixed-space literals (Syntax described here: http://docutils.sourceforge.net/docs/user/rst/quickstart.html#text-styles)
• Always end functions with () to make clear to the reader the symbol is a function.
• Always capitalize the project's name.