Skip to content

Commit

Permalink
Doc: add warning about experimental nature of 'gdal' utility
Browse files Browse the repository at this point in the history
Co-authored-by: Howard Butler <[email protected]>
  • Loading branch information
rouault and hobu committed Dec 3, 2024
1 parent 554ef14 commit 93cbcce
Showing 1 changed file with 11 additions and 0 deletions.
11 changes: 11 additions & 0 deletions doc/source/programs/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down

0 comments on commit 93cbcce

Please sign in to comment.