Description of problem:

The pcs commands mentioned in the upstream documentation (Clusters from Scratch - Section 2.6.3 as an example) mentions;

====
On either node, use pcs cluster auth to authenticate as the hacluster user:
-----------------------------------------------------------
| [root@pcmk-1 ~]# pcs cluster auth pcmk-1 pcmk-2         |
| Username: hacluster                                     |
| Password:                                               |
| pcmk-2: Authorized                                      |
| pcmk-1: Authorized                                      |
-----------------------------------------------------------
====

This generates the error;

====
Usage: pcs cluster auth...
    auth [-u <username>] [-p <password>]
        Authenticate pcs/pcsd to pcsd on nodes configured in the local cluster.
====

In the official Red Hat 8 High-Availability documentation, section 4.1 part 5 (https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html/configuring_and_managing_high_availability_clusters/assembly_creating-high-availability-cluster-configuring-and-managing-high-availability-clusters#proc_installing-cluster-software-creating-high-availability-cluster), it shows the proper syntax;

====
Authenticate the pcs user hacluster for each node in the cluster on the node from which you will be running pcs.

The following command authenticates user hacluster on z1.example.com for both of the nodes in the example two-node cluster, z1.example.com and z2.example.com.

------------------------------------------------------------
| [root@z1 ~]# pcs host auth z1.example.com z2.example.com |
| Username: hacluster                                      |
| Password:                                                |
| z1.example.com: Authorized                               |
| z2.example.com: Authorized                               |
------------------------------------------------------------
====

The difference (cluster -> host) is easy to miss. There are also other subtle syntax changes, like;

====
# RHEL 7 / Upstream docs;
pcs cluster setup --name mycluster pcmk-1 pcmk-2
# RHEL 8
pcs cluster setup mycluster --start pcmk-1 pcmk-2
====

The old syntax generates the error;

====
Error: Specified options '--name' are not supported in this command
====

This is a bit more helpful, but still not very obvious.

Request For Enhancement;

Given that a lot of people experienced with RHEL 7 syntax will likely hit similar issues, I think it is worth putting specific messages in the output. Something like;

====
Usage: pcs cluster auth...
    auth [-u <username>] [-p <password>]
        Authenticate pcs/pcsd to pcsd on nodes configured in the local cluster.

Hint: Syntax has changed from previous versions. See 'man pcs -> Changes'
====

And then add to the man page a section on syntax changes that occurred between RHEL 7 and 8 (or a pointer to an online / Access article covering the changes).


Version-Release number of selected component (if applicable):

pcs v. 0.10.1


How reproducible:

n/a


Steps to Reproduce:
1. n/a
2.
3.

Actual results:

n/a


Expected results:

n/a


Additional info:

RFE, not a bug.