pgsql: Reorder pg_ctl promote after pg_ctl status

Reorder pg_ctl promote after pg_ctl status

Since start/stop/restart/reload/status is a kind of standard command
set, it seems odd to insert the special-purpose "promote" in between
the closely related "restart" and "reload". So put it after "status"
in code and documentation.

Put the documentation of the -U option in some sensible place.

Rewrite the synopsis sentence in help and documentation to make it
less of a growing mouthful.

Branch
------
master

Details
-------
http://git.postgresql.org/pg/commitdiff/1bcdd66315fa1239793134e8284afc272f5975c3

Modified Files
--------------
doc/src/sgml/ref/pg_ctl-ref.sgml | 42 +++++++++---------
src/bin/pg_ctl/pg_ctl.c | 90 ++++++++++++++++++++------------------
2 files changed, 68 insertions(+), 64 deletions(-)