diff --git a/python/core/auto_generated/qgsmapsettings.sip.in b/python/core/auto_generated/qgsmapsettings.sip.in
index ed9ed631956..d19603f40cf 100644
--- a/python/core/auto_generated/qgsmapsettings.sip.in
+++ b/python/core/auto_generated/qgsmapsettings.sip.in
@@ -78,17 +78,19 @@ of output size. Use visibleExtent() to get the resulting extent.
 
     double extentBuffer() const;
 %Docstring
-Returns the buffer to use around the visible extent for rendering symbols whose
-corresponding geometries are outside the visible extent.
+Returns the buffer in map units to use around the visible extent for rendering
+symbols whose corresponding geometries are outside the visible extent.
+
+.. seealso:: :py:func:`setExtentBuffer`
 
 .. versionadded:: 3.10
 %End
 
     void setExtentBuffer( double buffer );
 %Docstring
-Sets the buffer to use around the visible extent for rendering symbols whose
-corresponding geometries are outside the visible extent. This is useful when
-using tiles to avoid cut symbols at tile boundaries.
+Sets the buffer in map units to use around the visible extent for rendering
+symbols whose corresponding geometries are outside the visible extent. This
+is useful when using tiles to avoid cut symbols at tile boundaries.
 
 .. versionadded:: 3.10
 %End
diff --git a/src/core/qgsmapsettings.h b/src/core/qgsmapsettings.h
index e38892b51a4..cc78c1f39c8 100644
--- a/src/core/qgsmapsettings.h
+++ b/src/core/qgsmapsettings.h
@@ -103,16 +103,17 @@ class CORE_EXPORT QgsMapSettings
     void setExtent( const QgsRectangle &rect, bool magnified = true );
 
     /**
-     * Returns the buffer to use around the visible extent for rendering symbols whose
-     * corresponding geometries are outside the visible extent.
+     * Returns the buffer in map units to use around the visible extent for rendering
+     * symbols whose corresponding geometries are outside the visible extent.
+     * \see setExtentBuffer()
      * \since QGIS 3.10
      */
     double extentBuffer() const;
 
     /**
-     * Sets the buffer to use around the visible extent for rendering symbols whose
-     * corresponding geometries are outside the visible extent. This is useful when
-     * using tiles to avoid cut symbols at tile boundaries.
+     * Sets the buffer in map units to use around the visible extent for rendering
+     * symbols whose corresponding geometries are outside the visible extent. This
+     * is useful when using tiles to avoid cut symbols at tile boundaries.
      * \since QGIS 3.10
      */
     void setExtentBuffer( double buffer );