backport GH-1223 to eight: Support specifying an identity file with GerritStatusPush
update the documentation

* the update is not exactly the same as in master
* a few things were added beside the actual backport
Merge pull request #1303 from sa2ajj/backport-gh-1223

Backport of GH-1223 to eight