pg_basebackup: Add more information about --max-rate option to help output

It was previously not clear what unit the option argument should have.
pg_upgrade: Fix spacing in help output
doc: Put new options in right order on reference pages