Re: [PATCH v2] docs: note that extensions.compatobjectformat is incomplete

From: Junio C Hamano <gitster@pobox.com>
Date: Aug 25, 2025, 22:46 UTC
Message-ID: <xmqqms7nnhod.fsf@gitster.g>
In-Reply-To: <20250825221101.611876-1-sandals@crustytoothpaste.net>

"brian m. carlson" <sandals@crustytoothpaste.net> writes:

Show 12 quoted lines

> diff --git a/Documentation/config/extensions.adoc b/Documentation/config/extensions.adoc
> index 9e2f321a6d..df448da813 100644
> --- a/Documentation/config/extensions.adoc
> +++ b/Documentation/config/extensions.adoc
> @@ -14,6 +14,10 @@ compatObjectFormat::
>  	compatObjectFormat.  As well as being able to use oids encoded in
>  	compatObjectFormat in addition to oids encoded with objectFormat to
>  	locally specify objects.
> ++
> +Note that the functionality enabled by this option is incomplete and subject to
> +change.  This option currently exists only to allow development and testing of
> +the underlying feature and is not designed to be enabled by end users.

Much better. Let's further do "This option" -> "This extension", as all the others described in this document call themselves as such.

Thanks.