auth method doc is misleading

[lkppo]

Problem description

The docstring say in PHPMAILER.php:

    /**
     * SMTP auth type.
     * Options are CRAM-MD5, LOGIN, PLAIN, XOAUTH2, attempted in that order if not specified.
     *
     * @var string
     */
    public $AuthType = '';

This is ambiguous. I had previously understood that each authentication method is tried, in the order indicated, until one of them works. But after reading the code of SMTP->authenticate(), it is clear that among the methods announced by the server, the best one also supported by PHPMailer is chosen and tried only once.

I was tricked by a lying server which claims to support CRAM-MD5 but refuses authentication with this method.

Solution?

Can you correct the documentation to disambiguate it please?

[Synchro]

How about "If not specified, the first one from that list that the server supports will be selected."?

[lkppo]

I like it. Like that?

Options are CRAM-MD5, LOGIN, PLAIN, XOAUTH2. If not specified, the first one from that list that the server supports will be selected.

[Synchro]

Done!

[lkppo]

All right!