Re: Determining if a merge was produced automatically

From: Jonathan Nieder <jrnieder@gmail.com>
Date: Jul 1, 2024, 11:49 UTC
Message-ID: <ZoKXt0jPphoM5nmJ@google.com>
In-Reply-To: <CAChcVu=Kwqj7JhXqQW6Ni9+3TdSfdmHfSTJQWm1_uO2kczSm8g@mail.gmail.com>

Hi Pavel,

Pavel Rappo wrote:

Show 5 quoted lines

> However, this bit means that I shouldn't entirely trust its output:
>
>> The output emitted when this option is used is subject to change, and so is its interaction with other options (unless explicitly documented).
>
> What is my best course of action?

I'd encourage proposing a patch to make the documentation say what you wish it said. What guarantees would you like it to make? That will help with others in the project being able to decide what it should guarantee and what it shouldn't, and regardless of the outcome of discussion it would make the documentation more helpful for the next person.

See Documentation/MyFirstContribution for some more details on how proposing a patch works.

Thanks and hope that helps, Jonathan