From 93cbcce042faae839d76a729784c8c59affd8c7d Mon Sep 17 00:00:00 2001 From: Even Rouault Date: Tue, 3 Dec 2024 15:40:17 +0100 Subject: [PATCH] Doc: add warning about experimental nature of 'gdal' utility Co-authored-by: Howard Butler --- doc/source/programs/index.rst | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/doc/source/programs/index.rst b/doc/source/programs/index.rst index 17e3a0c57554..c5ded0399aca 100644 --- a/doc/source/programs/index.rst +++ b/doc/source/programs/index.rst @@ -10,6 +10,17 @@ Programs Starting with GDAL 3.11, parts of the GDAL utilities are available from a new single :program:`gdal` program that accepts commands and subcommands. +.. warning:: + + The :program:`gdal` command is provisionally provided as an alternative + interface to GDAL and OGR command line utilities. The project reserves the + right to modify, rename, reorganize, and change the behavior of the utility + until it is officially frozen via PSC vote in a future major GDAL release. + The utility needs time to mature, benefit from incremental feedback, and + explore enhancements without carrying the burden of full backward compatibility. + Your usage of it should have no expectation of compatibility until that time. + + .. toctree:: :maxdepth: 1 :hidden: