Dev: ra: Show parameters more clearly

[liangxin1300]

Changes for ra info output

• Show ra name in headers

# new
ocf:heartbeat:IPaddr2 - Manages virtual IPv4 and IPv6 addresses (Linux specific version)
# original
Manages virtual IPv4 and IPv6 addresses (Linux specific version) (ocf:heartbeat:IPaddr2)

• More obviously for the required parameter

# new
ip (string): *** Required *** IPv4 or IPv6 address
# original
ip* (string): IPv4 or IPv6 address

• Mark deprecated parameters (mentioned in Confusing information from crm ra info regarding fence agent parameters #1731)

# new
debug (string): *** Deprecated *** Write debug information to given file
# original
debug (string): Write debug information to given file

• Show what this parameter obsoleted (mentioned in Confusing information from crm ra info regarding fence agent parameters #1731)

# new
ip (string): *** Required; Obsoletes ipaddr *** IP address or hostname of fencing device
# original
ip* (string): IP address or hostname of fencing device

• Don't show parameter as required, which deprecated

# new
ip (string): *** Required; Obsoletes ipaddr *** IP address or hostname of fencing device
ipaddr (string): *** Deprecated *** IP address or hostname of fencing device
username (string): *** Required; Obsoletes login *** Login name
login (string): *** Deprecated *** Login name
# original
ip* (string): IP address or hostname of fencing device
ipaddr* (string): IP address or hostname of fencing device
username* (string): Login name
login* (string): Login name

• Show short description for FA

# new
stonith:fence_ifmib - Fence agent for IF MIB
# original
stonith:fence_ifmib

• Show required parameters first, then others in alphabetical order

[nicholasyang2022]

Too noisy. The original format, using * to denote required parameters is more readable.

[liangxin1300]

Too noisy. The original format, using * to denote required parameters is more readable.

I thought this could be unified with the format like *** Advanced Use Only *** and *** Automatically generated by pacemaker ***

[liangxin1300]

This PR also fix #1724

# crm_resource --show-metadata stonith:fence_virsh|grep "required=\"1\""|grep -v deprecated
    <parameter name="ip" unique="0" required="1" obsoletes="ipaddr">
    <parameter name="username" unique="0" required="1" obsoletes="login">

crm(live/alp-1)configure# primitive st_virsh fence_virsh
crm(live/alp-1)configure# commit
(unpack_config)         warning: Blind faith: not fencing unseen nodes
ERROR: st_virsh: required parameter "ip" not defined
ERROR: st_virsh: required parameter "username" not defined
Do you still want to commit  (y/n)?