Rework documentation of pg_promote
This clarifies the behavior of how the "wait" flag works, which is
something that the previous version of the documentation failed to do.
Author: Ian Barwick
Discussion: https://postgr.es/m/
cbd38450-2295-10a1-1f73-
591a692ae0b0@2ndquadrant.com