Fix pubkey-macro args

[CriesofCarrots]

Problem

In #34288, we discovered there are a bunch of uses of the solana_cli::pubkey macro that add unnecessary punctuation, which ends up goofy. Eg:

$ solana inflation rewards -h
...
ARGS:
    <ADDRESS>...    Address of account to query for rewards. , one of:
                      * a base58-encoded public key
                      * a path to a keypair file
                      * a hyphen; signals a JSON-encoded keypair on stdin
                      * the 'ASK' keyword; to recover a keypair via its seed phrase
                      * a hardware wallet keypair URL (i.e. usb://ledger)

Summary of Changes

Remove periods and spaces. In a couple cases, we include extra information about the address -- I made these into parentheticals, so the punctuation still works. Open to other suggestions, though, as I don't love how it demotes the information.
Update macro to be a complete sentence and adjust args accordingly.
I also fixed one argument definition that was confusing

(edit) Updated example below to match new approach
Fixed pubkeys look like:

$ cargo run -- inflation rewards -h
...
ARGS:
    <ADDRESS>...    Account to query for rewards. Address is one of:
                      * a base58-encoded public key
                      * a path to a keypair file
                      * a hyphen; signals a JSON-encoded keypair on stdin
                      * the 'ASK' keyword; to recover a keypair via its seed phrase
                      * a hardware wallet keypair URL (i.e. usb://ledger)

[codecov]

Codecov Report

Merging #34410 (9b78149) into master (07f3883) will increase coverage by 0.0%.
Report is 1 commits behind head on master.
The diff coverage is n/a.

Additional details and impacted files

@@           Coverage Diff           @@
##           master   #34410   +/-   ##
=======================================
  Coverage    81.8%    81.9%           
=======================================
  Files         819      819           
  Lines      221019   221019           
=======================================
+ Hits       180975   181033   +58     
+ Misses      40044    39986   -58     

[steviez]

I threw in a couple of ideas, but I'm also happy with what you have as well. While putting it inside parenthesis kind of "demotes" the information, the information is still present for readers

[steviez]

Just a few more nits

[CriesofCarrots]

Thanks for the quick reviews!