فهرست منبع

Document Mono-specific classes

This fully documents all Mono-specific classes.

(cherry picked from commit 24a8d432720d57c1cd9bcb89516ea354ea4d459e)
Hugo Locurcio 5 سال پیش
والد
کامیت
88c22cb648
2فایلهای تغییر یافته به همراه18 افزوده شده و 4 حذف شده
  1. 5 0
      modules/mono/doc_classes/CSharpScript.xml
  2. 13 4
      modules/mono/doc_classes/GodotSharp.xml

+ 5 - 0
modules/mono/doc_classes/CSharpScript.xml

@@ -1,16 +1,21 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <?xml version="1.0" encoding="UTF-8" ?>
 <class name="CSharpScript" inherits="Script" category="Core" version="3.2">
 <class name="CSharpScript" inherits="Script" category="Core" version="3.2">
 	<brief_description>
 	<brief_description>
+		A script implemented in the C# programming language (Mono-enabled builds only).
 	</brief_description>
 	</brief_description>
 	<description>
 	<description>
+		This class represents a C# script. It is the C# equivalent of the [GDScript] class and is only available in Mono-enabled Godot builds.
+		See also [GodotSharp].
 	</description>
 	</description>
 	<tutorials>
 	<tutorials>
+		<link>https://docs.godotengine.org/en/latest/getting_started/scripting/c_sharp/index.html</link>
 	</tutorials>
 	</tutorials>
 	<methods>
 	<methods>
 		<method name="new" qualifiers="vararg">
 		<method name="new" qualifiers="vararg">
 			<return type="Object">
 			<return type="Object">
 			</return>
 			</return>
 			<description>
 			<description>
+				Returns a new instance of the script.
 			</description>
 			</description>
 		</method>
 		</method>
 	</methods>
 	</methods>

+ 13 - 4
modules/mono/doc_classes/GodotSharp.xml

@@ -1,8 +1,11 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <?xml version="1.0" encoding="UTF-8" ?>
 <class name="GodotSharp" inherits="Object" category="Core" version="3.2">
 <class name="GodotSharp" inherits="Object" category="Core" version="3.2">
 	<brief_description>
 	<brief_description>
+		Bridge between Godot and the Mono runtime (Mono-enabled builds only).
 	</brief_description>
 	</brief_description>
 	<description>
 	<description>
+		This class is a bridge between Godot and the Mono runtime. It exposes several low-level operations and is only available in Mono-enabled Godot builds.
+		See also [CSharpScript].
 	</description>
 	</description>
 	<tutorials>
 	<tutorials>
 	</tutorials>
 	</tutorials>
@@ -11,26 +14,30 @@
 			<return type="void">
 			<return type="void">
 			</return>
 			</return>
 			<description>
 			<description>
-				Attaches the current thread to the mono runtime.
+				Attaches the current thread to the Mono runtime.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="detach_thread">
 		<method name="detach_thread">
 			<return type="void">
 			<return type="void">
 			</return>
 			</return>
 			<description>
 			<description>
-				Detaches the current thread from the mono runtime.
+				Detaches the current thread from the Mono runtime.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="get_domain_id">
 		<method name="get_domain_id">
 			<return type="int">
 			<return type="int">
 			</return>
 			</return>
 			<description>
 			<description>
+				Returns the current MonoDomain ID.
+				[b]Note:[/b] The Mono runtime must be initialized for this method to work (use [method is_runtime_initialized] to check). If the Mono runtime isn't initialized at the time this method is called, the engine will crash.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="get_scripts_domain_id">
 		<method name="get_scripts_domain_id">
 			<return type="int">
 			<return type="int">
 			</return>
 			</return>
 			<description>
 			<description>
+				Returns the scripts MonoDomain's ID. This will be the same MonoDomain ID as [method get_domain_id], unless the scripts domain isn't loaded.
+				[b]Note:[/b] The Mono runtime must be initialized for this method to work (use [method is_runtime_initialized] to check). If the Mono runtime isn't initialized at the time this method is called, the engine will crash.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="is_domain_finalizing_for_unload">
 		<method name="is_domain_finalizing_for_unload">
@@ -39,26 +46,28 @@
 			<argument index="0" name="domain_id" type="int">
 			<argument index="0" name="domain_id" type="int">
 			</argument>
 			</argument>
 			<description>
 			<description>
-				Returns whether the domain is being finalized.
+				Returns [code]true[/code] if the domain is being finalized, [code]false[/code] otherwise.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="is_runtime_initialized">
 		<method name="is_runtime_initialized">
 			<return type="bool">
 			<return type="bool">
 			</return>
 			</return>
 			<description>
 			<description>
+				Returns [code]true[/code] if the Mono runtime is initialized, [code]false[/code] otherwise.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="is_runtime_shutting_down">
 		<method name="is_runtime_shutting_down">
 			<return type="bool">
 			<return type="bool">
 			</return>
 			</return>
 			<description>
 			<description>
+				Returns [code]true[/code] if the Mono runtime is shutting down, [code]false[/code] otherwise.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="is_scripts_domain_loaded">
 		<method name="is_scripts_domain_loaded">
 			<return type="bool">
 			<return type="bool">
 			</return>
 			</return>
 			<description>
 			<description>
-				Returns whether the scripts domain is loaded.
+				Returns [code]true[/code] if the scripts domain is loaded, [code]false[/code] otherwise.
 			</description>
 			</description>
 		</method>
 		</method>
 	</methods>
 	</methods>