Pgb api fix

minor API-doc cleanup; also clarified scope of "remote login" CLI command