Add documentation of server foregrounding. (rebased onto develop)


This is the same as gh-924 but rebased onto develop.

----

@mtbc was not aware of the existence of the --foreground
option. Hence it makes sense to expose it in the docs.