Add syntax highlighting for source code examples in documentation

Currently source code examples are not syntax highlighted in the
documentation.  Also, they do not get formatted properly if they include
blank lines.

Update the documentation to make the source code examples get treated
as source code, with syntax highlighting and correct handling of blank
lines.

Change-Id: I0a211a4c350805fe1adec0c1cef6d092b0da553c
2 files changed