From c4b5161ed16206033563e54565897423fce1c8b4 Mon Sep 17 00:00:00 2001 From: Haoyu Qiu Date: Tue, 1 Aug 2023 16:52:37 +0800 Subject: [PATCH] Fix invalid use of markdown syntax in classref Also: * changed `[b]true[/b]` to `[code]true[/code]` * use `[i]` for mathematical constant "e" * use `[b]` for button text & menu item text * improve markups about "tap1" and "tap2" in AudioEffectDelay --- doc/classes/@GlobalScope.xml | 4 ++-- doc/classes/Area3D.xml | 2 +- doc/classes/AudioEffectDelay.xml | 18 +++++++++--------- doc/classes/BackBufferCopy.xml | 2 +- doc/classes/EditorExportPlugin.xml | 2 +- doc/classes/Mesh.xml | 2 +- .../NavigationMeshSourceGeometryData3D.xml | 2 +- doc/classes/RenderSceneBuffersRD.xml | 4 ++-- modules/gdscript/doc_classes/@GDScript.xml | 2 +- 9 files changed, 19 insertions(+), 19 deletions(-) diff --git a/doc/classes/@GlobalScope.xml b/doc/classes/@GlobalScope.xml index 9d597d8e2385..3b7974f523fb 100644 --- a/doc/classes/@GlobalScope.xml +++ b/doc/classes/@GlobalScope.xml @@ -362,8 +362,8 @@ - The natural exponential function. It raises the mathematical constant [b]e[/b] to the power of [param x] and returns it. - [b]e[/b] has an approximate value of 2.71828, and can be obtained with [code]exp(1)[/code]. + The natural exponential function. It raises the mathematical constant [i]e[/i] to the power of [param x] and returns it. + [i]e[/i] has an approximate value of 2.71828, and can be obtained with [code]exp(1)[/code]. For exponents to other bases use the method [method pow]. [codeblock] var a = exp(2) # Approximately 7.39 diff --git a/doc/classes/Area3D.xml b/doc/classes/Area3D.xml index 89b3f843af3f..4f89e9b015a1 100644 --- a/doc/classes/Area3D.xml +++ b/doc/classes/Area3D.xml @@ -6,7 +6,7 @@ [Area3D] is a region of 3D space defined by one or multiple [CollisionShape3D] or [CollisionPolygon3D] child nodes. It detects when other [CollisionObject3D]s enter or exit it, and it also keeps track of which collision objects haven't exited it yet (i.e. which one are overlapping it). This node can also locally alter or override physics parameters (gravity, damping) and route audio to custom audio buses. - [b]Warning:[/b] Using a [ConcavePolygonShape3D] inside a [CollisionShape3D] child of this node (created e.g. by using the [i]Create Trimesh Collision Sibling[/i] option in the [i]Mesh[/i] menu that appears when selecting a [MeshInstance3D] node) may give unexpected results, since this collision shape is hollow. If this is not desired, it has to be split into multiple [ConvexPolygonShape3D]s or primitive shapes like [BoxShape3D], or in some cases it may be replaceable by a [CollisionPolygon3D]. + [b]Warning:[/b] Using a [ConcavePolygonShape3D] inside a [CollisionShape3D] child of this node (created e.g. by using the [b]Create Trimesh Collision Sibling[/b] option in the [b]Mesh[/b] menu that appears when selecting a [MeshInstance3D] node) may give unexpected results, since this collision shape is hollow. If this is not desired, it has to be split into multiple [ConvexPolygonShape3D]s or primitive shapes like [BoxShape3D], or in some cases it may be replaceable by a [CollisionPolygon3D]. $DOCS_URL/tutorials/physics/using_area_2d.html diff --git a/doc/classes/AudioEffectDelay.xml b/doc/classes/AudioEffectDelay.xml index fa255e320181..eae49f6a9845 100644 --- a/doc/classes/AudioEffectDelay.xml +++ b/doc/classes/AudioEffectDelay.xml @@ -21,34 +21,34 @@ Feedback delay time in milliseconds. - Sound level for [code]tap1[/code]. + Sound level for feedback. Low-pass filter for feedback, in Hz. Frequencies below this value are filtered out of the source signal. - If [code]true[/code], [code]tap1[/code] will be enabled. + If [code]true[/code], the first tap will be enabled. - [code]tap1[/code] delay time in milliseconds. + First tap delay time in milliseconds. - Sound level for [code]tap1[/code]. + Sound level for the first tap. - Pan position for [code]tap1[/code]. Value can range from -1 (fully left) to 1 (fully right). + Pan position for the first tap. Value can range from -1 (fully left) to 1 (fully right). - If [code]true[/code], [code]tap2[/code] will be enabled. + If [code]true[/code], the second tap will be enabled. - [b]Tap2[/b] delay time in milliseconds. + Second tap delay time in milliseconds. - Sound level for [code]tap2[/code]. + Sound level for the second tap. - Pan position for [code]tap2[/code]. Value can range from -1 (fully left) to 1 (fully right). + Pan position for the second tap. Value can range from -1 (fully left) to 1 (fully right). diff --git a/doc/classes/BackBufferCopy.xml b/doc/classes/BackBufferCopy.xml index a671b85c833b..e4e6f1d76dbc 100644 --- a/doc/classes/BackBufferCopy.xml +++ b/doc/classes/BackBufferCopy.xml @@ -1,7 +1,7 @@ - Copies a region of the screen (or the whole screen) to a buffer so it can be accessed in your shader scripts using the screen texture (i.e. a uniform sampler with ``hint_screen_texture``). + Copies a region of the screen (or the whole screen) to a buffer so it can be accessed in your shader scripts using the screen texture (i.e. a uniform sampler with [code]hint_screen_texture[/code]). Node for back-buffering the currently-displayed screen. The region defined in the [BackBufferCopy] node is buffered with the content of the screen it covers, or the entire screen according to the copy mode set. Use the screen texture in your shader scripts to access the buffer. diff --git a/doc/classes/EditorExportPlugin.xml b/doc/classes/EditorExportPlugin.xml index 75641a448692..5f9e1e36845e 100644 --- a/doc/classes/EditorExportPlugin.xml +++ b/doc/classes/EditorExportPlugin.xml @@ -112,7 +112,7 @@ Virtual method to be overridden by the user. This is called to retrieve the local paths of the Android libraries archive (AAR) files provided by this plugin. - [b]Note:[/b] Relative paths **must** be relative to Godot's [code]res://addons/[/code] directory. For example, an AAR file located under [code]res://addons/hello_world_plugin/HelloWorld.release.aar[/code] can be returned as an absolute path using [code]res://addons/hello_world_plugin/HelloWorld.release.aar[/code] or a relative path using [code]hello_world_plugin/HelloWorld.release.aar[/code]. + [b]Note:[/b] Relative paths [b]must[/b] be relative to Godot's [code]res://addons/[/code] directory. For example, an AAR file located under [code]res://addons/hello_world_plugin/HelloWorld.release.aar[/code] can be returned as an absolute path using [code]res://addons/hello_world_plugin/HelloWorld.release.aar[/code] or a relative path using [code]hello_world_plugin/HelloWorld.release.aar[/code]. [b]Note:[/b] Only supported on Android and requires [member EditorExportPlatformAndroid.gradle_build/use_gradle_build] to be enabled. diff --git a/doc/classes/Mesh.xml b/doc/classes/Mesh.xml index 6c4242b92d2b..6448ace9baa3 100644 --- a/doc/classes/Mesh.xml +++ b/doc/classes/Mesh.xml @@ -253,7 +253,7 @@ [PackedFloat32Array] or [PackedFloat64Array] of bone weights in the range [code]0.0[/code] to [code]1.0[/code] (inclusive). Contains either 4 or 8 numbers per vertex depending on the presence of the [constant ARRAY_FLAG_USE_8_BONE_WEIGHTS] flag. - [PackedInt32Array] of integers used as indices referencing vertices, colors, normals, tangents, and textures. All of those arrays must have the same number of elements as the vertex array. No index can be beyond the vertex array size. When this index array is present, it puts the function into "index mode," where the index selects the *i*'th vertex, normal, tangent, color, UV, etc. This means if you want to have different normals or colors along an edge, you have to duplicate the vertices. + [PackedInt32Array] of integers used as indices referencing vertices, colors, normals, tangents, and textures. All of those arrays must have the same number of elements as the vertex array. No index can be beyond the vertex array size. When this index array is present, it puts the function into "index mode," where the index selects the [i]i[/i]'th vertex, normal, tangent, color, UV, etc. This means if you want to have different normals or colors along an edge, you have to duplicate the vertices. For triangles, the index array is interpreted as triples, referring to the vertices of each triangle. For lines, the index array is in pairs indicating the start and end of each line. diff --git a/doc/classes/NavigationMeshSourceGeometryData3D.xml b/doc/classes/NavigationMeshSourceGeometryData3D.xml index bf57baeb449c..dc446dcaaab0 100644 --- a/doc/classes/NavigationMeshSourceGeometryData3D.xml +++ b/doc/classes/NavigationMeshSourceGeometryData3D.xml @@ -54,7 +54,7 @@ - Returns [b]true[/b] when parsed source geometry data exists. + Returns [code]true[/code] when parsed source geometry data exists. diff --git a/doc/classes/RenderSceneBuffersRD.xml b/doc/classes/RenderSceneBuffersRD.xml index 80a644ad2658..3af5b78fcc88 100644 --- a/doc/classes/RenderSceneBuffersRD.xml +++ b/doc/classes/RenderSceneBuffersRD.xml @@ -133,7 +133,7 @@ - Returns [b]true[/b] if TAA is enabled. + Returns [code]true[/code] if TAA is enabled. @@ -160,7 +160,7 @@ - Returns [b]true[/b] if a cached texture exists for this name. + Returns [code]true[/code] if a cached texture exists for this name. diff --git a/modules/gdscript/doc_classes/@GDScript.xml b/modules/gdscript/doc_classes/@GDScript.xml index 0c300eade48c..b53e910fc200 100644 --- a/modules/gdscript/doc_classes/@GDScript.xml +++ b/modules/gdscript/doc_classes/@GDScript.xml @@ -621,7 +621,7 @@ Mark the following method for remote procedure calls. See [url=$DOCS_URL/tutorials/networking/high_level_multiplayer.html]High-level multiplayer[/url]. If [param mode] is set as [code]"any_peer"[/code], allows any peer to call this RPC function. Otherwise, only the authority peer is allowed to call it and [param mode] should be kept as [code]"authority"[/code]. When configuring functions as RPCs with [method Node.rpc_config], each of these modes respectively corresponds to the [constant MultiplayerAPI.RPC_MODE_AUTHORITY] and [constant MultiplayerAPI.RPC_MODE_ANY_PEER] RPC modes. See [enum MultiplayerAPI.RPCMode]. If a peer that is not the authority tries to call a function that is only allowed for the authority, the function will not be executed. If the error can be detected locally (when the RPC configuration is consistent between the local and the remote peer), an error message will be displayed on the sender peer. Otherwise, the remote peer will detect the error and print an error there. - If [param sync] is set as [code]"call_remote"[/code], the function will only be executed on the remote peer, but not locally. To run this function locally too, set [param sync] to [code]"call_local"[/code]. When configuring functions as RPCs with [method Node.rpc_config], this is equivalent to setting `call_local` to `true`. + If [param sync] is set as [code]"call_remote"[/code], the function will only be executed on the remote peer, but not locally. To run this function locally too, set [param sync] to [code]"call_local"[/code]. When configuring functions as RPCs with [method Node.rpc_config], this is equivalent to setting [code]call_local[/code] to [code]true[/code]. The [param transfer_mode] accepted values are [code]"unreliable"[/code], [code]"unreliable_ordered"[/code], or [code]"reliable"[/code]. It sets the transfer mode of the underlying [MultiplayerPeer]. See [member MultiplayerPeer.transfer_mode]. The [param transfer_channel] defines the channel of the underlying [MultiplayerPeer]. See [member MultiplayerPeer.transfer_channel]. The order of [param mode], [param sync] and [param transfer_mode] does not matter, but values related to the same argument must not be used more than once. [param transfer_channel] always has to be the 4th argument (you must specify 3 preceding arguments).