Merge pull request #10808 from rouault/fix_10805

Python bindings: clarify destNameOrDestDS semantics regarding updates

swig/include/python/gdal_python.i

@@ -3005,7 +3005,12 @@ def Warp(destNameOrDestDS, srcDSOrSrcDSTab, **kwargs):
     Parameters
     ----------
     destNameOrDestDS:
-        Output dataset name or object
+        Output dataset name or object.
+
+        If passed as a dataset name, a potentially existing output dataset of
+        the same name will be overwritten. To update an existing output dataset,
+        it must be passed as a dataset object.
+
     srcDSOrSrcDSTab:
         an array of Dataset objects or filenames, or a Dataset object or a filename
     kwargs:
@@ -3421,6 +3426,13 @@ def VectorTranslate(destNameOrDestDS, srcDS, **kwargs):
     ----------
     destNameOrDestDS:
         Output dataset name or object
+
+        If passed as a dataset name, a potentially existing output dataset of
+        the same name will be overwritten. To update an existing output dataset,
+        it must be passed as a dataset object. Note that the accessMode parameter
+        also controls, at the layer level, if existing layers must be overwritten
+        or updated.
+
     srcDS:
         a Dataset object or a filename
     kwargs:
@@ -3688,6 +3700,11 @@ def Nearblack(destNameOrDestDS, srcDS, **kwargs):
     ----------
     destNameOrDestDS:
         Output dataset name or object
+
+        If passed as a dataset name, a potentially existing output dataset of
+        the same name will be overwritten. To update an existing output dataset,
+        it must be passed as a dataset object.
+
     srcDS:
         a Dataset object or a filename
     kwargs:
@@ -4043,7 +4060,12 @@ def Rasterize(destNameOrDestDS, srcDS, **kwargs):
     Parameters
     ----------
     destNameOrDestDS:
-        Output dataset name or object
+        Output dataset name or object.
+
+        If passed as a dataset name, a potentially existing output dataset of
+        the same name will be overwritten. To update an existing output dataset,
+        it must be passed as a dataset object.
+
     srcDS:
         a Dataset object or a filename
     kwargs:
@@ -4212,6 +4234,11 @@ def Footprint(destNameOrDestDS, srcDS, **kwargs):
     ----------
     destNameOrDestDS:
         Output dataset name or object
+
+        If passed as a dataset name, a potentially existing output dataset of
+        the same name will be overwritten. To update an existing output dataset,
+        it must be passed as a dataset object.
+
     srcDS:
         a Dataset object or a filename
     kwargs: