From: Junio C Hamano Date: Fri, 11 Sep 2026 18:52:40 GMT Subject: Re: [PATCH] range-diff: add --matched-only to skip one-sided commits Message-ID: In-Reply-To: Harald Nordgren writes: >> I wonder if the implementation actually can be more like >> >> - give "--hide-left-only" and "--hide-right-only" as synonyms to >> "--right-only" and "--left-only", and deprecate the original; >> >> - allow them to be given together, which will give the new >> behaviour you are introducing, i.e., skip steps without both >> sides from the output; >> >> - give a short-hand synonym, "--matched-only", to truly behave the >> same as giving "--hide-{left,right}-only" together. > > Seems like a big change, and deprecated options are a pain in the neck > because we can never actually remove them. > > If we decide to go this way, we might name them "--hide-{left,right}" > and just not introduce a condition that makes them incompatible. Then > "--matched-only" would be pure syntactic sugar and wouldn't even be > 100% necessary to have to achieve this. Or we can just keep the code and fix the documentation. I think that would be much less impact.