fix highlighting for relnotes
fix formatting for method description
more markup fixes
fix :bb:step: reference
add space to make directive recognizable
fix parameter markup
unit tests: handle double fork on upstart system

Don't assume that when the parent process dies, the child's
ppid will become 1.

This is for example not the case when running unit tests on an
upstart based system (e.g. Ubuntu 13.10) from GUI session.

When a user loggs in into the GUI, a new 'init' process is started
by upstart. That new 'init' process will inherit any orphanded child
processes.
Merge elmirjagudin/buildbot:runprocess-upstart (PR #1173)
Merge sa2ajj/buildbot:more-docs-fixes (PR #1174)