From e2f25d202ec80895693d66de83170c1140d9f049 Mon Sep 17 00:00:00 2001 From: "brian m. carlson" Date: Thu, 2 Apr 2026 22:42:41 +0000 Subject: [PATCH] docs: correct information about reftable Our description of the reftable format is that it is experimental and subject to change, but that is no longer true. Remove this statement so as not to mislead users. In addition, the documentation says that the files format is the default, but that is not true if breaking changes mode is on. Correct this information with a conditional. Signed-off-by: brian m. carlson Signed-off-by: Junio C Hamano --- Documentation/ref-storage-format.adoc | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/Documentation/ref-storage-format.adoc b/Documentation/ref-storage-format.adoc index 6a8db4712b..c5e29ec831 100644 --- a/Documentation/ref-storage-format.adoc +++ b/Documentation/ref-storage-format.adoc @@ -1,3 +1,8 @@ -`files`;; for loose files with packed-refs. This is the default. -`reftable`;; for the reftable format. This format is experimental and its - internals are subject to change. +`files`;; for loose files with packed-refs. +ifndef::with-breaking-changes[] + This is the default. +endif::with-breaking-changes[] +`reftable`;; for the reftable format. +ifdef::with-breaking-changes[] + This is the default. +endif::with-breaking-changes[]