Re: [PATCH] branch: adjust documentation

From: Rubén Justo <rjusto@gmail.com>
Date: Mar 2, 2024, 16:18 UTC
Message-ID: <a434de37-7485-4d51-86c4-14b0f477db0c@gmail.com>
In-Reply-To: <253d3c827f6e389d533c60113b08f94f@manjaro.org>

On Thu, Feb 29, 2024 at 09:09:25PM +0100, Dragan Simic wrote:

Show 12 quoted lines

> On 2024-02-29 21:02, Rubén Justo wrote:
> > On Thu, Feb 29, 2024 at 11:33:24AM -0800, Junio C Hamano wrote:
> > 
> > > Do not forget that the objective of the larger-picture-revamping of
> > > this page is to make the description of each option self-contained.
> > > Similarity between -m's description and -c's description does not
> > > count as being uselessly repetitive.
> > 
> > OK.  I was not considering this.
> 
> I'd also like to avoid repetition, but if we want to have self-contained
> command descriptions (which is good), some repetition is unavoidable.

I don't see much of a problem with repetitions. Within the self-containmnent aspect it makes a lot of sense. And, after all, my messages have been mainly about repeating ... placeholders.

> In fact, we can see what avoiding the repetition has lead us to in the
> current state of the git-branch(1) man page.

Indeed. I agree that the lack of repetition has brought us here. But I think we're not 100% aligned in what repetition is :-), yet. We're working on it!

Thanks.