doc: Fix formatting in code blocks

10 files changed, 67 insertions, 81 deletions

diff --git a/doc/classes/@GDScript.xml b/doc/classes/@GDScript.xml
index 349daae6d9..2bdfc56c44 100644
--- a/doc/classes/@GDScript.xml
+++ b/doc/classes/@GDScript.xml
@@ -127,7 +127,7 @@
 			<description>
 				Returns the arc tangent of [code]y/x[/code] in radians. Use to get the angle of tangent [code]y/x[/code]. To compute the value, the method takes into account the sign of both arguments in order to determine the quadrant.
 				[codeblock]
-				a = atan(0,-1) # a is 3.141593
+				a = atan(0, -1) # a is 3.141593
 				[/codeblock]
 			</description>
 		</method>
@@ -175,7 +175,7 @@
 				# a is 'A'
 				a = char(65)
 				# a is 'a'
-				a = char(65+32)
+				a = char(65 + 32)
 				[/codeblock]
 			</description>
 		</method>
@@ -230,7 +230,7 @@
 				Returns the cosine of angle [code]s[/code] in radians.
 				[codeblock]
 				# prints 1 and -1
-				print(cos(PI*2))
+				print(cos(PI * 2))
 				print(cos(PI))
 				[/codeblock]
 			</description>
@@ -584,7 +584,7 @@
 			<description>
 				Returns the maximum of two values.
 				[codeblock]
-				max(1,2) # returns 2
+				max(1, 2) # returns 2
 				max(-3.99, -4) # returns -3.99
 				[/codeblock]
 			</description>
@@ -599,7 +599,7 @@
 			<description>
 				Returns the minimum of two values.
 				[codeblock]
-				min(1,2) # returns 1
+				min(1, 2) # returns 1
 				min(-3.99, -4) # returns -4
 				[/codeblock]
 			</description>
@@ -657,7 +657,7 @@
 			<description>
 				Returns the result of [code]x[/code] raised to the power of [code]y[/code].
 				[codeblock]
-				pow(2,5) # returns 32
+				pow(2, 5) # returns 32
 				[/codeblock]
 			</description>
 		</method>
@@ -681,8 +681,8 @@
 			<description>
 				Converts one or more arguments to strings in the best way possible and prints them to the console.
 				[codeblock]
-				a = [1,2,3]
-				print("a","b",a) # prints ab[1, 2, 3]
+				a = [1, 2, 3]
+				print("a", "b", a) # prints ab[1, 2, 3]
 				[/codeblock]
 			</description>
 		</method>
@@ -1009,7 +1009,7 @@
 			<description>
 				Returns the tangent of angle [code]s[/code] in radians.
 				[codeblock]
-				tan( deg2rad(45) ) # returns 1
+				tan(deg2rad(45)) # returns 1
 				[/codeblock]
 			</description>
 		</method>
diff --git a/doc/classes/AStar.xml b/doc/classes/AStar.xml
index 482566ee9f..e1b79a2a3e 100644
--- a/doc/classes/AStar.xml
+++ b/doc/classes/AStar.xml
@@ -47,8 +47,7 @@
 				Adds a new point at the given position with the given identifier. The algorithm prefers points with lower [code]weight_scale[/code] to form a path. The [code]id[/code] must be 0 or larger, and the [code]weight_scale[/code] must be 1 or larger.
 				[codeblock]
 				var as = AStar.new()
-
-				as.add_point(1, Vector3(1,0,0), 4) # Adds the point (1,0,0) with weight_scale=4 and id=1
+				as.add_point(1, Vector3(1, 0, 0), 4) # Adds the point (1, 0, 0) with weight_scale 4 and id 1
 				[/codeblock]
 				If there already exists a point for the given id, its position and weight scale are updated to the given values.
 			</description>
@@ -81,15 +80,12 @@
 			<argument index="2" name="bidirectional" type="bool" default="true">
 			</argument>
 			<description>
-				Creates a segment between the given points.
+				Creates a segment between the given points. If [code]bidirectional[/code] is [code]false[/code], only movement from [code]id[/code] to [code]to_id[/code] is allowed, not the reverse direction.
 				[codeblock]
 				var as = AStar.new()
-
-				as.add_point(1, Vector3(1,1,0))
-				as.add_point(2, Vector3(0,5,0))
-
-				as.connect_points(1, 2, false) # If bidirectional=false it's only possible to go from point 1 to point 2
-				                               # and not from point 2 to point 1.
+				as.add_point(1, Vector3(1, 1, 0))
+				as.add_point(2, Vector3(0, 5, 0))
+				as.connect_points(1, 2, false)
 				[/codeblock]
 			</description>
 		</method>
@@ -129,15 +125,12 @@
 				Returns the closest position to [code]to_position[/code] that resides inside a segment between two connected points.
 				[codeblock]
 				var as = AStar.new()
-
-				as.add_point(1, Vector3(0,0,0))
-				as.add_point(2, Vector3(0,5,0))
-
+				as.add_point(1, Vector3(0, 0, 0))
+				as.add_point(2, Vector3(0, 5, 0))
 				as.connect_points(1, 2)
-
-				var res = as.get_closest_position_in_segment(Vector3(3,3,0)) # returns (0, 3, 0)
+				var res = as.get_closest_position_in_segment(Vector3(3, 3, 0)) # returns (0, 3, 0)
 				[/codeblock]
-				The result is in the segment that goes from [code]y=0[/code] to [code]y=5[/code]. It's the closest position in the segment to the given point.
+				The result is in the segment that goes from [code]y = 0[/code] to [code]y = 5[/code]. It's the closest position in the segment to the given point.
 			</description>
 		</method>
 		<method name="get_id_path">
@@ -151,11 +144,10 @@
 				Returns an array with the ids of the points that form the path found by AStar between the given points. The array is ordered from the starting point to the ending point of the path.
 				[codeblock]
 				var as = AStar.new()
-
-				as.add_point(1, Vector3(0,0,0))
-				as.add_point(2, Vector3(0,1,0), 1) # default weight is 1
-				as.add_point(3, Vector3(1,1,0))
-				as.add_point(4, Vector3(2,0,0))
+				as.add_point(1, Vector3(0, 0, 0))
+				as.add_point(2, Vector3(0, 1, 0), 1) # default weight is 1
+				as.add_point(3, Vector3(1, 1, 0))
+				as.add_point(4, Vector3(2, 0, 0))
 
 				as.connect_points(1, 2, false)
 				as.connect_points(2, 3, false)
@@ -177,11 +169,10 @@
 				Returns an array with the ids of the points that form the connect with the given point.
 				[codeblock]
 				var as = AStar.new()
-
-				as.add_point(1, Vector3(0,0,0))
-				as.add_point(2, Vector3(0,1,0))
-				as.add_point(3, Vector3(1,1,0))
-				as.add_point(4, Vector3(2,0,0))
+				as.add_point(1, Vector3(0, 0, 0))
+				as.add_point(2, Vector3(0, 1, 0))
+				as.add_point(3, Vector3(1, 1, 0))
+				as.add_point(4, Vector3(2, 0, 0))
 
 				as.connect_points(1, 2, true)
 				as.connect_points(1, 3, true)
diff --git a/doc/classes/Array.xml b/doc/classes/Array.xml
index b013b3c4ae..6bd0ef3421 100644
--- a/doc/classes/Array.xml
+++ b/doc/classes/Array.xml
@@ -196,10 +196,10 @@
 			<description>
 				Return true if the array contains given value.
 				[codeblock]
-				[ "inside", 7 ].has("inside") == true
-				[ "inside", 7 ].has("outside") == false
-				[ "inside", 7 ].has(7) == true
-				[ "inside", 7 ].has("7") == false
+				["inside", 7].has("inside") == true
+				["inside", 7].has("outside") == false
+				["inside", 7].has(7) == true
+				["inside", 7].has("7") == false
 				[/codeblock]
 			</description>
 		</method>
diff --git a/doc/classes/ArrayMesh.xml b/doc/classes/ArrayMesh.xml
index 7806cf4ce4..bcb9b4f6da 100644
--- a/doc/classes/ArrayMesh.xml
+++ b/doc/classes/ArrayMesh.xml
@@ -6,9 +6,9 @@
 		The [code]ArrayMesh[/code] is used to construct a [Mesh] by specifying the attributes as arrays. The most basic example is the creation of a single triangle
 		[codeblock]
 		var vertices = PoolVector3Array()
-		vertices.push_back(Vector3(0,1,0))
-		vertices.push_back(Vector3(1,0,0))
-		vertices.push_back(Vector3(0,0,1))
+		vertices.push_back(Vector3(0, 1, 0))
+		vertices.push_back(Vector3(1, 0, 0))
+		vertices.push_back(Vector3(0, 0, 1))
 		# Initialize the ArrayMesh.
 		var arr_mesh = ArrayMesh.new()
 		var arrays = []
diff --git a/doc/classes/Color.xml b/doc/classes/Color.xml
index 82a10fbaa4..68f5734491 100644
--- a/doc/classes/Color.xml
+++ b/doc/classes/Color.xml
@@ -19,11 +19,6 @@
 			</argument>
 			<description>
 				Constructs a color from an HTML hexadecimal color string in ARGB or RGB format. See also [method @GDScript.ColorN].
-				The following string formats are supported:
-					[code]"#ff00ff00"[/code] - ARGB format with '#'
-					[code]"ff00ff00"[/code] - ARGB format
-					[code]"#ff00ff"[/code] - RGB format with '#'
-					[code]"ff00ff"[/code] - RGB format
 				[codeblock]
 				# Each of the following creates the same color RGBA(178, 217, 10, 255)
 				var c1 = Color("#ffb2d90a") # ARGB format with '#'
@@ -57,7 +52,7 @@
 			<description>
 				Constructs a color from an RGB profile using values between 0 and 1. Alpha will always be 1.
 				[codeblock]
-				var c = Color(0.2, 1.0, .7) # Equivalent to RGBA(51, 255, 178, 255)
+				var c = Color(0.2, 1.0, 0.7) # Equivalent to RGBA(51, 255, 178, 255)
 				[/codeblock]
 			</description>
 		</method>
@@ -75,7 +70,7 @@
 			<description>
 				Constructs a color from an RGBA profile using values between 0 and 1.
 				[codeblock]
-				var c = Color(0.2, 1.0, .7, .8) # Equivalent to RGBA(51, 255, 178, 204)
+				var c = Color(0.2, 1.0, 0.7, 0.8) # Equivalent to RGBA(51, 255, 178, 204)
 				[/codeblock]
 			</description>
 		</method>
@@ -88,8 +83,8 @@
 				Returns a new color resulting from blending this color over another. If the color is opaque, the result is also opaque. The second color may have a range of alpha values.
 				[codeblock]
 				var bg = Color(0.0, 1.0, 0.0, 0.5) # Green with alpha of 50%
-				var fg = Color(1.0, 0.0, 0.0, .5) # Red with alpha of 50%
-				var blendedColor = bg.blend(fg) # Brown with alpha of 75%
+				var fg = Color(1.0, 0.0, 0.0, 0.5) # Red with alpha of 50%
+				var blended_color = bg.blend(fg) # Brown with alpha of 75%
 				[/codeblock]
 			</description>
 		</method>
@@ -99,8 +94,8 @@
 			<description>
 				Returns the most contrasting color.
 				[codeblock]
-				var c = Color(.3, .4, .9)
-				var contrastedColor = c.contrasted() # Equivalent to RGBA(204, 229, 102, 255)
+				var c = Color(0.3, 0.4, 0.9)
+				var contrasted_color = c.contrasted() # Equivalent to RGBA(204, 229, 102, 255)
 				[/codeblock]
 			</description>
 		</method>
@@ -110,7 +105,7 @@
 			<argument index="0" name="amount" type="float">
 			</argument>
 			<description>
-				Returns a new color resulting from making this color darker by the specified percentage (0-1).
+				Returns a new color resulting from making this color darker by the specified percentage (ratio from 0 to 1).
 				[codeblock]
 				var green = Color(0.0, 1.0, 0.0)
 				var darkgreen = green.darkened(0.2) # 20% darker than regular green
@@ -140,7 +135,7 @@
 			</return>
 			<description>
 				Returns the color's grayscale representation.
-				The gray is calculated by [code](r + g + b) / 3[/code].
+				The gray value is calculated as [code](r + g + b) / 3[/code].
 				[codeblock]
 				var c = Color(0.2, 0.45, 0.82)
 				var gray = c.gray() # a value of 0.466667
@@ -153,8 +148,8 @@
 			<description>
 				Returns the inverted color [code](1 - r, 1 - g, 1 - b, 1 - a)[/code].
 				[codeblock]
-				var c = Color(.3, .4, .9)
-				var invertedColor = c.inverted() # a color of an RGBA(178, 153, 26, 255)
+				var c = Color(0.3, 0.4, 0.9)
+				var inverted_color = c.inverted() # a color of an RGBA(178, 153, 26, 255)
 				[/codeblock]
 			</description>
 		</method>
@@ -164,7 +159,7 @@
 			<argument index="0" name="amount" type="float">
 			</argument>
 			<description>
-				Returns a new color resulting from making this color lighter by the specified percentage (0-1).
+				Returns a new color resulting from making this color lighter by the specified percentage (ratio from 0 to 1).
 				[codeblock]
 				var green = Color(0.0, 1.0, 0.0)
 				var lightgreen = green.lightened(0.2) # 20% lighter than regular green
@@ -179,7 +174,7 @@
 			<argument index="1" name="t" type="float">
 			</argument>
 			<description>
-				Returns the linear interpolation with another color. The value t is between 0 and 1.
+				Returns the linear interpolation with another color. The interpolation factor [code]t[/code] is between 0 and 1.
 				[codeblock]
 				var c1 = Color(1.0, 0.0, 0.0)
 				var c2 = Color(0.0, 1.0, 0.0)
@@ -193,7 +188,7 @@
 			<description>
 				Returns the color's 32-bit integer in ABGR format (each byte represents a component of the ABGR profile). ABGR is the reversed version of the default format.
 				[codeblock]
-				var c = Color(1, .5, .2)
+				var c = Color(1, 0.5, 0.2)
 				print(c.to_abgr32()) # Prints 4281565439
 				[/codeblock]
 			</description>
@@ -204,7 +199,7 @@
 			<description>
 				Returns the color's 64-bit integer in ABGR format (each word represents a component of the ABGR profile). ABGR is the reversed version of the default format.
 				[codeblock]
-				var c = Color(1, .5, .2)
+				var c = Color(1, 0.5, 0.2)
 				print(c.to_abgr64()) # Prints -225178692812801
 				[/codeblock]
 			</description>
@@ -215,7 +210,7 @@
 			<description>
 				Returns the color's 32-bit integer in ARGB format (each byte represents a component of the ARGB profile). ARGB is more compatible with DirectX.
 				[codeblock]
-				var c = Color(1, .5, .2)
+				var c = Color(1, 0.5, 0.2)
 				print(c.to_argb32()) # Prints 4294934323
 				[/codeblock]
 			</description>
@@ -226,7 +221,7 @@
 			<description>
 				Returns the color's 64-bit integer in ARGB format (each word represents a component of the ARGB profile). ARGB is more compatible with DirectX.
 				[codeblock]
-				var c = Color(1, .5, .2)
+				var c = Color(1, 0.5, 0.2)
 				print(c.to_argb64()) # Prints -2147470541
 				[/codeblock]
 			</description>
@@ -240,7 +235,7 @@
 				Returns the color's HTML hexadecimal color string in ARGB format (ex: [code]ff34f822[/code]).
 				Setting [code]with_alpha[/code] to [code]false[/code] excludes alpha from the hexadecimal string.
 				[codeblock]
-				var c = Color(1, 1, 1, .5)
+				var c = Color(1, 1, 1, 0.5)
 				var s1 = c.to_html() # Results "7fffffff"
 				var s2 = c.to_html(false) # Results 'ffffff'
 				[/codeblock]
@@ -252,7 +247,7 @@
 			<description>
 				Returns the color's 32-bit integer in RGBA format (each byte represents a component of the RGBA profile). RGBA is Godot's default format.
 				[codeblock]
-				var c = Color(1, .5, .2)
+				var c = Color(1, 0.5, 0.2)
 				print(c.to_rgba32()) # Prints 4286526463
 				[/codeblock]
 			</description>
@@ -263,7 +258,7 @@
 			<description>
 				Returns the color's 64-bit integer in RGBA format (each word represents a component of the RGBA profile). RGBA is Godot's default format.
 				[codeblock]
-				var c = Color(1, .5, .2)
+				var c = Color(1, 0.5, 0.2)
 				print(c.to_rgba64()) # Prints -140736629309441
 				[/codeblock]
 			</description>
diff --git a/doc/classes/EditorImportPlugin.xml b/doc/classes/EditorImportPlugin.xml
index 24201c39b9..d1e90470e1 100644
--- a/doc/classes/EditorImportPlugin.xml
+++ b/doc/classes/EditorImportPlugin.xml
@@ -35,7 +35,7 @@
 		func get_import_options(i):
 		    return [{"name": "my_option", "default_value": false}]
 
-		func import(source_file, save_path, options, r_platform_variants, r_gen_files):
+		func import(source_file, save_path, options, platform_variants, gen_files):
 		    var file = File.new()
 		    if file.open(source_file, File.READ) != OK:
 		        return FAILED
diff --git a/doc/classes/EditorScenePostImport.xml b/doc/classes/EditorScenePostImport.xml
index 0c5de68d98..e69f3b0119 100644
--- a/doc/classes/EditorScenePostImport.xml
+++ b/doc/classes/EditorScenePostImport.xml
@@ -20,7 +20,7 @@
 
 		func iterate(node):
 		    if node != null:
-		        node.name = "modified_"+node.name
+		        node.name = "modified_" + node.name
 		        for child in node.get_children():
 		            iterate(child)
 		[/codeblock]
diff --git a/doc/classes/HTTPClient.xml b/doc/classes/HTTPClient.xml
index 2f21505757..3172a5d6c0 100644
--- a/doc/classes/HTTPClient.xml
+++ b/doc/classes/HTTPClient.xml
@@ -108,14 +108,14 @@
 				Generates a GET/POST application/x-www-form-urlencoded style query string from a provided dictionary, e.g.:
 				[codeblock]
 				var fields = {"username": "user", "password": "pass"}
-				String queryString = httpClient.query_string_from_dict(fields)
-				returns:= "username=user&amp;password=pass"
+				String query_string = http_client.query_string_from_dict(fields)
+				# returns: "username=user&amp;password=pass"
 				[/codeblock]
 				Furthermore, if a key has a null value, only the key itself is added, without equal sign and value. If the value is an array, for each value in it a pair with the same key is added.
 				[codeblock]
 				var fields = {"single": 123, "not_valued": null, "multiple": [22, 33, 44]}
-				String queryString = httpClient.query_string_from_dict(fields)
-				returns:= "single=123&amp;not_valued&amp;multiple=22&amp;multiple=33&amp;multiple=44"
+				String query_string = http_client.query_string_from_dict(fields)
+				# returns: "single=123&amp;not_valued&amp;multiple=22&amp;multiple=33&amp;multiple=44"
 				[/codeblock]
 			</description>
 		</method>
@@ -143,9 +143,9 @@
 				To create a POST request with query strings to push to the server, do:
 				[codeblock]
 				var fields = {"username" : "user", "password" : "pass"}
-				var queryString = httpClient.query_string_from_dict(fields)
-				var headers = ["Content-Type: application/x-www-form-urlencoded", "Content-Length: " + str(queryString.length())]
-				var result = httpClient.request(httpClient.METHOD_POST, "index.php", headers, queryString)
+				var query_string = http_client.query_string_from_dict(fields)
+				var headers = ["Content-Type: application/x-www-form-urlencoded", "Content-Length: " + str(query_string.length())]
+				var result = http_client.request(http_client.METHOD_POST, "index.php", headers, query_string)
 				[/codeblock]
 			</description>
 		</method>
diff --git a/doc/classes/MeshDataTool.xml b/doc/classes/MeshDataTool.xml
index c90dba1561..7bd98323c7 100644
--- a/doc/classes/MeshDataTool.xml
+++ b/doc/classes/MeshDataTool.xml
@@ -11,9 +11,9 @@
 		var mdt = MeshDataTool.new()
 		mdt.create_from_surface(mesh, 0)
 		for i in range(mdt.get_vertex_count()):
-			var vertex = mdt.get_vertex(i)
-			...
-			mdt.set_vertex(i, vertex)
+		    var vertex = mdt.get_vertex(i)
+		    ...
+		    mdt.set_vertex(i, vertex)
 		mesh.surface_remove(0)
 		mdt.commit_to_surface(mesh)
 		[/codeblock]
diff --git a/doc/classes/ScriptCreateDialog.xml b/doc/classes/ScriptCreateDialog.xml
index 67ce9a8e87..ac0384e1d4 100644
--- a/doc/classes/ScriptCreateDialog.xml
+++ b/doc/classes/ScriptCreateDialog.xml
@@ -7,9 +7,9 @@
 		The ScriptCreateDialog creates script files according to a given template for a given scripting language. The standard use is to configure its fields prior to calling a [method popup]() method.
 		[codeblock]
 		func _ready():
-			dialog.config("Node", "res://new_node.gd") # for in-engine types
-			dialog.config("\"res://base_node.gd\"", "res://derived_node.gd") # for script types
-			dialog.popup_centered()
+		    dialog.config("Node", "res://new_node.gd") # for in-engine types
+		    dialog.config("\"res://base_node.gd\"", "res://derived_node.gd") # for script types
+		    dialog.popup_centered()
 		[/codeblock]
 	</description>
 	<tutorials>