Doc: `:option:` directives link to incorrect pages

[geographika]

What is the bug?

Noticed in #14639, but is an issue elsewhere, for example at https://gdal.org/en/latest/programs/gdal_raster_info.html#cmdoption-crs-format the --output-format links to https://gdal.org/en/latest/programs/gdal_dataset_identify.html#cmdoption-f

Raw RST is:

    .. note::

        :option:`--crs-format` can only be set when :option:`--output-format`
        is set to ``text``.  The JSON text format includes both WKT2 and PROJJSON.

I guess only one link is created per unique :option:?

cc @dbaston

Steps to reproduce the issue

Click the link at https://gdal.org/en/latest/programs/gdal_raster_info.html#cmdoption-crs-format

Versions and provenance

All Sphinx docs

Additional context

No response

[dbaston]

Is the problem that docs for the new CLI are lacking a .. program:: directive on each page before the start of the options list?

[geographika]

@dbaston - adding .. program:: gdal_vector_export_schema to the page fixes the link in the PR locally. I'll add this and check again in the RTD output.

Any preference where these should be put?

Directly at the top of the page would make it the most obvious to see if it was missing.

.. _gdal_vector_export_schema:
.. program:: gdal_vector_export_schema

================================================================================
``gdal vector export-schema``
================================================================================

If this works I'll add the directive to all the new CLI programs.

[dbaston]

Directly at the top of the page would make it the most obvious to see if it was missing.

This sounds like a good idea. The older CLI programs have it at the top of the options list, but I guess those could be moved.