Re: [PATCH v3 1/1] docs: highlight that .gitmodules does not support !command

From: Junio C Hamano <gitster@pobox.com>
Date: Jul 13, 2023, 20:55 UTC
Message-ID: <xmqqa5vzo7jy.fsf@gitster.g>
In-Reply-To: <9de918bc-6913-0486-02dd-5b4028a7fe1b@imap.cc>

Petar Vutov <pvutov@imap.cc> writes:

> I prefer the original description as it uses shorter sentences. I
> can't hold that 5-liner in my head :)

But you are comparing oranges and apples, aren't you? You are not counting "oh by the way this cannot be in .gitmodules" as part of 5.

> But now I really am bikeshedding, and I've taken enough of your
> time. I will send a v4 with just the .gitmodules disclaimer, no
> rewrite, in case you end up agreeing.

After reading the original again and again, I hate more and more the way the original wasted too many words to refer to one thing twice (e.g. "arbitrary command" and then "is the custom command", "a single argument" and then the parenthesized explanation of it) without adding any clarity.