Show 39 quoted lines
> Aditya Garg <gargaditya08@live.com> writes:
>
>> +--[no-]outlook-id-fix::
>> + Outlook servers discard the Message-ID sent via email and assign a
>> + new random Message-ID, thus breaking threads.
>> ++
>> +--
>> +- '--outlook-id-fix' will attempt to retrieve the ID from the server
>> + irrespective of the SMTP server being used. Use only if Microsoft is your
>> + email provider.
>> +- '--no-outlook-id-fix' will disable this tweak irrespective of the SMTP
>> + server being used.
>> +--
>> ++
>> +If not specified, the default behaviour will be to enable the tweak only if the
>> +SMTP server is 'smtp.office365.com' or 'smtp-mail.outlook.com'.
>
> I found "irrespective of the SMTP server being used" part a bit
> confusing, which seemed to contradict with the next sentence to tell
> you to use it only against Outlook based servers.
>
> After reading the "If not specified" part, I can sort of guess that
> you wanted to "irrespective" mean "even when we are (or are not)
> talking to outlook.com", but it is still a confusing description.
>
> Would the following work better, I wonder...?
>
> Microsoft Outlook SMTP servers ..., thus breaking threads.
>
> With `--outlook-id-fix`, "git send-email" uses a mechanism
> specific to Outlook servers to learn the Message-ID the
> server assigned to fix the threading. Use it only when you
> know that the server reports the rewritten Message-ID the
> same way as Outlook servers do.
>
> Without this option specified, the fix is done by default
> when talking to smtp.office365.com or smtp-mail.outlook.com.
> Use `--no-outlook-id-fix` to disable even when talking to
> these two servers.
Aditya Garg <gargaditya08@live.com>