From 5fcdbfb2be5458d3f765b61ab32272c5f5707bd8 Mon Sep 17 00:00:00 2001
From: salamandars <msjs@fastmail.com>
Date: Thu, 23 Jun 2022 20:55:54 +1000
Subject: [PATCH] Clarify that MeshInstance surface methods only apply to
 override materials

(cherry picked from commit 22881a6923415054bbf2a3ac85c666ea87645bf5)
---
 doc/classes/MeshInstance.xml | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/doc/classes/MeshInstance.xml b/doc/classes/MeshInstance.xml
index fe2e4e87768..6cf8f6d2c89 100644
--- a/doc/classes/MeshInstance.xml
+++ b/doc/classes/MeshInstance.xml
@@ -52,13 +52,14 @@
 			<return type="Material" />
 			<argument index="0" name="surface" type="int" />
 			<description>
-				Returns the [Material] for a surface of the [Mesh] resource.
+				Returns the override [Material] for a surface of the [Mesh] resource.
+				[b]Note:[/b] This function only returns [i]override[/i] materials associated with this [MeshInstance]. Consider using [method get_active_material] or [method Mesh.surface_get_material] to get materials associated with the [Mesh] resource.
 			</description>
 		</method>
 		<method name="get_surface_material_count" qualifiers="const">
 			<return type="int" />
 			<description>
-				Returns the number of surface materials.
+				Returns the number of surface override materials.
 			</description>
 		</method>
 		<method name="set_surface_material">
@@ -66,7 +67,7 @@
 			<argument index="0" name="surface" type="int" />
 			<argument index="1" name="material" type="Material" />
 			<description>
-				Sets the [Material] for a surface of the [Mesh] resource.
+				Sets the override [Material] for the specified surface of the [Mesh] resource. This material is associated with this [MeshInstance] rather than with the [Mesh] resource.
 			</description>
 		</method>
 	</methods>