From 837d299cf05cc8b8ef1041dc0d3d019e79d36742 Mon Sep 17 00:00:00 2001
From: Hugo Locurcio <hugo.locurcio@hugo.pro>
Date: Mon, 14 Jul 2025 22:53:50 +0200
Subject: [PATCH] Document Translation plurals requiring the use of the gettext
 PO format

---
 doc/classes/Translation.xml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/doc/classes/Translation.xml b/doc/classes/Translation.xml
index cc63247266f..2d365b32a87 100644
--- a/doc/classes/Translation.xml
+++ b/doc/classes/Translation.xml
@@ -8,6 +8,7 @@
 	</description>
 	<tutorials>
 		<link title="Internationalizing games">$DOCS_URL/tutorials/i18n/internationalizing_games.html</link>
+		<link title="Localization using gettext">$DOCS_URL/tutorials/i18n/localization_using_gettext.html</link>
 		<link title="Locales">$DOCS_URL/tutorials/i18n/locales.html</link>
 	</tutorials>
 	<methods>
@@ -47,6 +48,7 @@
 			<description>
 				Adds a message involving plural translation if nonexistent, followed by its translation.
 				An additional context could be used to specify the translation context or differentiate polysemic words.
+				[b]Note:[/b] Plurals are only supported in [url=$DOCS_URL/tutorials/i18n/localization_using_gettext.html]gettext-based translations (PO)[/url], not CSV.
 			</description>
 		</method>
 		<method name="erase_message">
@@ -86,6 +88,7 @@
 			<description>
 				Returns a message's translation involving plurals.
 				The number [param n] is the number or quantity of the plural object. It will be used to guide the translation system to fetch the correct plural form for the selected language.
+				[b]Note:[/b] Plurals are only supported in [url=$DOCS_URL/tutorials/i18n/localization_using_gettext.html]gettext-based translations (PO)[/url], not CSV.
 			</description>
 		</method>
 		<method name="get_translated_message_list" qualifiers="const">