From 89364f19747b9db323429d720a295b0552bff914 Mon Sep 17 00:00:00 2001
From: Relintai <relintai@protonmail.com>
Date: Fri, 29 Jul 2022 12:01:48 +0200
Subject: [PATCH] Ported:  Clarify that MeshInstance surface methods only apply
 to override materials - salamandars
 https://github.com/godotengine/godot/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 edc71944e..aff0d84bb 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="is_mergeable_with" qualifiers="const">
@@ -88,7 +89,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>