gdharness 1.3.59 → 1.3.61

package/build/godot/addons/gdharness_runtime/runtime_values.gd

@@ -226,16 +226,16 @@ static func no_action(action: String) -> String:
 	)
 	if not close.is_empty():
 		return (
-			"%s; the nearest %s %s."
+			"%s. The nearest %s %s."
 			% [said, "is" if close.size() == 1 else "are", ", ".join(close)]
 		)
 	if own.is_empty():
 		return (
-			"%s; the project defines no actions of its own, and the engine's are the ui_ ones."
+			"%s. The project defines no actions of its own, and the engine's are the ui_ ones."
 			% said
 		)
 	return (
-		"%s; the project's own actions are %s, beside the engine's ui_ ones."
+		"%s. The project's own actions are %s, beside the engine's ui_ ones."
 		% [said, ", ".join(own)]
 	)
 
@@ -246,7 +246,7 @@ static func no_action(action: String) -> String:
 static func actions_of(event: InputEvent) -> Array[String]:
 	var named: Array[String] = []
 	# A motion matches every action on its axis, either way and at any distance, which would name
-	# ui_left for a stick held right; Input presses only those its direction reaches past their
+	# ui_left for a stick held right. Input presses only those its direction reaches past their
 	# deadzone.
 	var moved: bool = event is InputEventJoypadMotion
 	for action: StringName in InputMap.get_actions():
@@ -291,7 +291,7 @@ static func focus_noted(said: Dictionary, focused: String, host: Node) -> Dictio
 ##
 ## A key goes to the shortcuts last in the tree first and stops at the first button that takes it,
 ## while an InputEventShortcut reaches only the buttons holding that one Shortcut. So each Shortcut
-## is sent in that order, a frame apart, until a button is pressed; a button still decides by its
+## is sent in that order, a frame apart, until a button is pressed. A button still decides by its
 ## disabled, its visibility and its shortcut context, as it does for the key.
 static func press_shortcuts(root: Node, action: String) -> Dictionary:
 	var pressing: InputEventAction = InputEventAction.new()
@@ -404,7 +404,7 @@ static func class_at(root: Node, path: String) -> Dictionary:
 			"type": "error",
 			"message":
 			(
-				"%s did not compile, so none of its functions can be called; script_diagnostics on "
+				"%s did not compile, so none of its functions can be called. script_diagnostics on "
 				+ "it gives the error and its line."
 			) % script_path,
 		}
@@ -544,7 +544,7 @@ func parameter_class(object: Object, method: String, index: int) -> String:
 ## carries its enum or range, and empty for anything that is not a property.
 ##
 ## Asked rather than read off the value in the slot, because an object slot can be empty: a
-## property typed `Gear` holding null reads as TYPE_NIL, and anything written into it passed the
+## property typed `Part` holding null reads as TYPE_NIL, and anything written into it passed the
 ## check and was then dropped by the engine, which answered with the slot still null.
 ##
 ## The script only for a typed container, the one place the engine hands it over. A property typed

package/build/godot/addons/gdharness_runtime/runtime_waits.gd

@@ -27,7 +27,7 @@ const LOOK_SLICE_USEC: int = 2000
 ## number that steps rather than lands, as a day counter on a fast clock goes from 31 to 34 between
 ## two looks and a wait for 32 never sees it.
 const COMPARES: Array[String] = ["==", "!=", ">=", "<=", ">", "<"]
-## The most signal watches kept at once; arming one past this lets the oldest go. Property watches
+## The most signal watches kept at once. Arming one past this lets the oldest go. Property watches
 ## are counted apart, to the same number.
 const MOST_WATCHES: int = 16
 ## The most changes a property watch keeps. Past it, each new one takes the last place, so what is
@@ -683,7 +683,7 @@ static func _not_comparable(
 		node_path, property, type_string(typeof(current)), GdhShapes.kind(wanted),
 	]
 	# A value that cannot become what the property holds is said as that, which names the remedy,
-	# before the comparison it would also fail; an object on either side is said as the comparison.
+	# before the comparison it would also fail. An object on either side is said as the comparison.
 	var objects: bool = typeof(current) == TYPE_OBJECT or typeof(wanted) == TYPE_OBJECT
 	if not objects and not GdhValues.acceptable(wanted, typeof(current)):
 		return (
@@ -777,22 +777,22 @@ static func _declared_slot(holder: Variant, named: String) -> Dictionary:
 ## A screen rather than one node, because a panel following a clock builds its labels again every
 ## time it redraws and the engine names those `@Label@1163`. A wait holding one of them is waiting
 ## on a node that was freed a frame later, and that is what it answered: the date along the top of a
-## hall could not be waited on at all. What a caller is watching for is a word arriving on a screen,
-## and the screen is the part that stays put.
+## screen could not be waited on at all. What a caller is watching for is a word arriving on a
+## screen, and the screen is the part that stays put.
 ##
 ## On the screen, which is to say shown: a control carrying the words while hidden satisfied the
-## wait at once, so a duel screen whose "Carry on" button exists hidden through the whole sweep
+## wait at once, so a match screen whose "Keep going" button exists hidden through the whole sweep
 ## answered met in two milliseconds while the sweep was still animating, and every wait on that
 ## screen fell back to counting frames. [param include_hidden] asks the other question, for a
 ## caller waiting on words a hidden node holds.
 ##
 ## Paced by what a look costs, so the watching leaves the game its speed: every frame while a look
 ## is cheap, and on a screen large enough for one to cost a real share of a frame, often enough that
-## looking takes about a tenth of the time. Every frame on a hall of 3,500 nodes held the game at a
+## looking takes about a tenth of the time. Every frame over 3,500 nodes held the game at a
 ## sixth of its frame rate, and its clock, which advances by the frame's delta, lost three quarters
 ## of its time, so a wait for a date timed out on a clock that turned a day every thirty seconds.
 ## Each look is read a slice at a time, [constant LOOK_SLICE_USEC] to a frame, so the frames it runs
-## in keep their length; the last is read whole, since the wait answers on it.
+## in keep their length. The last is read whole, since the wait answers on it.
 ##
 ## The answer says how many frames the wait spanned, how many looks it took, how long they took
 ## between them and the longest they held one frame, which is how a caller sees what it cost and
@@ -866,7 +866,7 @@ func _wait_until_said(
 		answer["unseen_note"] = (
 			(
 				"Something under %s says it, but is hidden or drawn outside the viewport or a "
-				+ "ScrollContainer, where the player cannot read it; includeHidden true counts it "
+				+ "ScrollContainer, where the player cannot read it. includeHidden true counts it "
 				+ "there too"
 			)
 			% node_path

package/build/godot/addons/gdharness_runtime/runtime_words.gd

@@ -12,7 +12,7 @@ extends RefCounted
 ## is every label, button and field the interface is built out of.
 ##
 ## Read rather than looked up in the property list, which the engine builds afresh on every call: a
-## wait asks this of every node on the screen every frame, and on a hall of 3,500 nodes the lookup
+## wait asks this of every node on the screen every frame, and over 3,500 nodes the lookup
 ## took the game it was watching from 60 frames a second to 11. A node without the property reads
 ## as null, which is not a string.
 ##
@@ -21,8 +21,8 @@ extends RefCounted
 static func said_by(node: Node) -> String:
 	var own: String = drawn_by(node)
 	# A control showing a picture rather than words is named for a player who cannot see it, and
-	# that name is the one the words a caller asks by are meant for: the rail's "Out" tab is a
-	# square with an icon on it, and a click on "Out" found only the words around it.
+	# that name is the one the words a caller asks by are meant for: a side bar's "Away" tab is a
+	# square with an icon on it, and a click on "Away" found only the words around it.
 	if own.is_empty() and node is Control and not node is Label and not draws_a_list(node):
 		var control: Control = node
 		return control.atr(control.accessibility_name).strip_edges()
@@ -137,7 +137,7 @@ static func masked(field: LineEdit) -> String:
 	return field.secret_character.repeat(field.text.length())
 
 
-## Whether [param node] draws a list of items rather than holding words in a `text`; see
+## Whether [param node] draws a list of items rather than holding words in a `text`. See
 ## [method items_of].
 static func draws_a_list(node: Node) -> bool:
 	return (
@@ -225,7 +225,7 @@ static func _text_of(node: Node) -> String:
 	if label != null:
 		return _label_says(label)
 	# A RichTextLabel's text is its markup when it reads BBCode, and nobody reads the tags: a
-	# dossier line came back as "[b][color=#4fc2d4]Mollum Telken[/color], [/b]..." and a phrase
+	# ledger line came back as `"[b][color=#3a7bd5]Osric Halcott[/color], [/b]..."` and a phrase
 	# running across a tag could not be found or waited for. The parsed text is what is drawn, and
 	# it also holds what a game added with append_text(), which the property never shows. It is
 	# parsed from the translation already.

package/build/godot/addons/gdharness_runtime/serialisation.gd

@@ -15,7 +15,7 @@ const GdhShapes = preload("value_shapes.gd")
 const NUMBERS: Array[int] = [TYPE_BOOL, TYPE_INT, TYPE_FLOAT]
 const TEXTS: Array[int] = [TYPE_STRING, TYPE_STRING_NAME, TYPE_NODE_PATH]
 # 2^53. A JSON number is a double, and every whole number below this one in size has a double of
-# its own; from here on two or more share each double, so one arriving tells nobody which was sent.
+# its own. From here on two or more share each double, so one arriving tells nobody which was sent.
 const EXACT: int = 9_007_199_254_740_992
 # The types that cross as a plain JSON list and have to be built back into themselves. A list is
 # what a caller can write by hand and what the serialiser answers with, and the parameter or
@@ -136,7 +136,7 @@ func serialize_value(value: Variant) -> Variant:
 		return value
 	var carried: Variant = call(serialiser, value)
 	# The fixed shapes carry their components as bare floats, so an infinite one in a Vector2 is
-	# tagged here, and a 32-bit one shortened; containers reach their members through this already.
+	# tagged here, and a 32-bit one shortened. Containers reach their members through this already.
 	var type: int = typeof(value)
 	return (
 		carried
@@ -345,7 +345,7 @@ static func comparable(one: Variant, other: Variant) -> bool:
 ##
 ## A list of what is accepted rather than of what is refused, which is the way round that errs
 ## safely. The engine's own conversion table is not readable from GDScript, so either list is a
-## guess at it; guessing narrow costs a caller a refusal naming both types, and guessing wide costs
+## guess at it. Guessing narrow costs a caller a refusal naming both types, and guessing wide costs
 ## them the damage above. A refusal is the cheaper mistake, and it is the one they can act on.
 static func acceptable(value: Variant, type: int) -> bool:
 	if type == TYPE_NIL:
@@ -560,7 +560,7 @@ func _serialize_rid(value: RID) -> Dictionary:
 
 # A whole number from 2^53 on as its digits, because JSON numbers are doubles on the server's side
 # and on the engine's, and from there on neighbouring whole numbers share a double. A RefCounted's
-# instance id is one, with its top bit set, and a resource uid another; read as numbers they came
+# instance id is one, with its top bit set, and a resource uid another. Read as numbers they came
 # back as a neighbouring id, which named nothing or something else.
 func _serialize_int(value: int) -> Variant:
 	if value > -EXACT and value < EXACT:

package/build/godot/addons/gdharness_tests/bench.gd

@@ -2,7 +2,7 @@ class_name GdhBench
 extends RefCounted
 ## Work played a step a frame, for the script profiler. The engine sends the profiler what each
 ## frame called and holds names for only so many functions a frame, so work played inside one frame
-## comes back with most of its functions unnamed; spread over frames, every step is named.
+## comes back with most of its functions unnamed. Spread over frames, every step is named.
 ##
 ##     func _ready() -> void:
 ##         var timed: Dictionary = await GdhBench.each_frame(get_tree(), 400, _run.advance)

package/build/godot/addons/gdharness_tests/share.gd

@@ -7,7 +7,7 @@ extends RefCounted
 ## from one run to the next) calls [method outcomes] for each arm with the number of runs and a
 ## callable playing run `i`. Run on its own, the scene plays every run here, as it always did. Under
 ## `gdharness spread`, each worker engine plays every Nth run from its own index and leaves what
-## each run answered; then one more engine runs the scene to gather, and there [method outcomes]
+## each run answered. Then one more engine runs the scene to gather, and there [method outcomes]
 ## plays nothing and answers every run's outcome, read back as the type it went in as. The bench
 ## folds them in run order either way, so a spread table is the same table to the last digit, floats
 ## included.
@@ -70,7 +70,7 @@ static func outcomes(arm: String, runs: int, play: Callable) -> Array:
 	_learn()
 	if _arms.has(arm):
 		push_error(
-			"GdhShare: the arm %s was played twice in one run; give each arm its own name" % arm
+			"GdhShare: the arm %s was played twice in one run. Give each arm its own name" % arm
 		)
 		return []
 	_arms[arm] = true
@@ -107,7 +107,7 @@ static func outcomes(arm: String, runs: int, play: Callable) -> Array:
 	return ordered
 
 
-## [param counted], each a dictionary of whole numbers, added up key by key; a key named in
+## [param counted], each a dictionary of whole numbers, added up key by key. A key named in
 ## [param largest] keeps the largest instead. Adding and taking the largest come out the same in
 ## any order, which is what lets a bench fold its runs however it likes.
 static func added(
@@ -143,7 +143,7 @@ static func added(
 
 
 ## Leaves one arm's outcomes, then the line saying so, which `gdharness spread` checks the share
-## against; the outcomes first, so a line is never there without them.
+## against. The outcomes first, so a line is never there without them.
 static func _leave(arm: String, runs: int, by_index: Dictionary[int, Variant]) -> void:
 	var left: Dictionary = { "arm": arm, "runs": runs, "outcomes": by_index }
 	if not _appended(
@@ -185,7 +185,7 @@ static func _gathered(arm: String, runs: int) -> Array:
 			(
 				(
 					"GdhShare: no worker played the arm %s, so this run went another way than "
-					+ "theirs; which arms a bench plays must depend on its command line alone"
+					+ "theirs. Which arms a bench plays must depend on its command line alone"
 				)
 				% arm
 			)
@@ -271,7 +271,7 @@ static func _learn() -> void:
 				_index = halves[0].to_int()
 				_workers = halves[1].to_int()
 			if _index < 0 or _index >= _workers:
-				push_error("GdhShare: %s names no worker; it takes <index>/<workers>" % given)
+				push_error("GdhShare: %s names no worker. It takes <index>/<workers>" % given)
 				_index = -1
 		elif given.begins_with(GATHER):
 			_gathering = given.trim_prefix(GATHER).to_int()

package/build/godot/addons/gdharness_tests/suites.gd

@@ -20,7 +20,7 @@ func _ready() -> void:
 			(
 				(
 					"gdharness suites: no runner at '%s'. This scene is played by editor_run start "
-					+ "with suites, which names the runner after %s; it does nothing played any "
+					+ "with suites, which names the runner after %s. It does nothing played any "
 					+ "other way."
 				)
 				% [path, RUNNER]

package/build/godot/operations/audio_buses.gd

@@ -59,7 +59,7 @@ func remove_audio_bus(params: Dictionary) -> Dictionary:
 		)
 
 	# A bus sending to this one would be left sending to a name nothing has, which the engine reads
-	# as Master; sent on to where this one went instead, the chain it was part of keeps its shape.
+	# as Master. Sent on to where this one went instead, the chain it was part of keeps its shape.
 	var onward: String = AudioServer.get_bus_send(index)
 	var resent: Array[String] = []
 	for i: int in range(AudioServer.bus_count):
@@ -96,7 +96,7 @@ func get_audio_buses(_params: Dictionary) -> Dictionary:
 		answer["layout_on_disk"] = false
 		answer["note"] = (
 			(
-				"Nothing is at %s, so these are the engine's default buses; the first change to a "
+				"Nothing is at %s, so these are the engine's default buses. The first change to a "
 				+ "bus writes the layout there."
 			)
 			% layout
@@ -225,7 +225,7 @@ func set_audio_bus_send(params: Dictionary) -> Dictionary:
 	if target == bus_idx:
 		return _log.failure(
 			(
-				"%s cannot send to itself; it can send to %s."
+				"%s cannot send to itself. It can send to %s."
 				% [bus_name, ", ".join(_names().slice(0, bus_idx))]
 			)
 		)
@@ -269,7 +269,7 @@ func _no_index(index: int) -> String:
 	var held: PackedStringArray = []
 	for i: int in range(AudioServer.bus_count):
 		var _added: bool = held.append("%d %s" % [i, AudioServer.get_bus_name(i)])
-	return "No bus at index %d; the buses are %s." % [index, ", ".join(held)]
+	return "No bus at index %d. The buses are %s." % [index, ", ".join(held)]
 
 
 func _bus(index: int) -> Dictionary:

package/build/godot/operations/class_cache.gd

@@ -118,10 +118,10 @@ func _entry_for(path: String, skipped: Array[Dictionary]) -> Dictionary:
 #
 # - nothing extended: RefCounted;
 # - one name, a global class or a native one: that name, unresolved;
-# - a dotted name, `Heard.Named`, an inner class of a global class: nothing, as the scan does not
+# - a dotted name, `Outer.Inner`, an inner class of a global class: nothing, as the scan does not
 #   look names up;
 # - a path: what that script's class records, after walking into the inner classes named after
-#   the path, `"res://heard.gd".Named`, so a parent with a class_name is passed over for its own
+#   the path, `"res://outer.gd".Inner`, so a parent with a class_name is passed over for its own
 #   base. A path the engine cannot open records nothing, and it opens a relative one from the
 #   project root rather than from the script's folder.
 #
@@ -157,7 +157,7 @@ func _base_of(path: String, header: Dictionary, skipped: Array[Dictionary]) -> V
 
 
 # The path and the class names an `extends` names, from the text after the keyword:
-# `"res://heard.gd".Named` is the path and ["Named"], `Heard.Named` no path and two names. The
+# `"res://outer.gd".Inner` is the path and ["Inner"], `Outer.Inner` no path and two names. The
 # reading stops at whatever follows, a colon or a comment.
 static func _extends_parts(text: String) -> Dictionary:
 	var rest: String = text.strip_edges()

package/build/godot/operations/classdb_queries.gd

@@ -366,7 +366,7 @@ func _not_found(wanted: String, declared: Dictionary, answers_own: bool = false)
 			(
 				(
 					"Class not found: %s.%s editor_classes reads the engine's ClassDB, so a "
-					+ "class_name a project script declares is not in it either; script_info "
+					+ "class_name a project script declares is not in it either. script_info "
 					+ "structure reads one."
 				)
 				% [wanted, offered]

package/build/godot/operations/declared_values.gd

@@ -288,7 +288,7 @@ static func outside(target: Object, declared: Dictionary, value: Variant, shown:
 			return ""
 		return (
 			(
-				"%s is none of the names %s lists: %s, which the inspector holds it to; the engine "
+				"%s is none of the names %s lists: %s, which the inspector holds it to. The engine "
 				+ "stores it as given."
 			)
 			% [shown, property, ", ".join(names)]
@@ -311,7 +311,7 @@ static func outside(target: Object, declared: Dictionary, value: Variant, shown:
 		if flags.is_empty() or stray == 0:
 			return ""
 		return (
-			"%d holds bits no flag of %s has (%d): its flags are %s; the engine stores it as given."
+			"%d holds bits no flag of %s has (%d): its flags are %s. The engine stores it as given."
 			% [whole, property, stray, _listed(flags)]
 		)
 	if hint != PROPERTY_HINT_RANGE:
@@ -327,7 +327,7 @@ static func outside(target: Object, declared: Dictionary, value: Variant, shown:
 		return ""
 	return (
 		(
-			"%s is outside the range %s declares, %s to %s, which the inspector holds it to; the "
+			"%s is outside the range %s declares, %s to %s, which the inspector holds it to. The "
 			+ "engine stores it as given."
 		)
 		% [shown, property, _bound(low), _bound(high)]
@@ -544,7 +544,7 @@ static func not_held(
 		return (
 			(
 				"%s.bus takes the name of one of the project's audio buses, and %s is none of "
-				+ "them, so it would play on %s; %s. project_info include audio_buses lists them, "
+				+ "them, so it would play on %s. %s. project_info include audio_buses lists them, "
 				+ "and project_settings add_audio_bus adds one. Nothing was written."
 			)
 			% [
@@ -552,21 +552,21 @@ static func not_held(
 				given[1],
 				AudioServer.get_bus_name(0),
 				(
-					"the buses are " + ", ".join(names)
+					"The buses are " + ", ".join(names)
 					if nearest.is_empty()
-					else "the nearest " + nearest
+					else "The nearest " + nearest
 				),
 			]
 		)
 	return (
-		"%s: it takes one of the names it lists, and %s is none of them; %s. Nothing was written."
+		"%s: it takes one of the names it lists, and %s is none of them. %s. Nothing was written."
 		% [
 			said,
 			given[1],
 			(
-				"it lists " + ", ".join(names)
+				"It lists " + ", ".join(names)
 				if nearest.is_empty()
-				else "the nearest it lists " + nearest
+				else "The nearest it lists " + nearest
 			),
 		]
 	)
@@ -593,7 +593,7 @@ static func held_by_children(node: Node, property: String) -> String:
 
 ## A sentence for each node path in [param given], by property, that names no node from
 ## [param node]. A path is written whatever it names, as the inspector writes one, since the node
-## may be added next; a joint whose node_a named nothing then joined nothing, and no answer said so.
+## may be added next. A joint whose node_a named nothing then joined nothing, and no answer said so.
 static func naming_nothing(node: Node, given: Dictionary) -> Dictionary:
 	var said: Dictionary = {}
 	for property: String in given:
@@ -610,7 +610,7 @@ static func naming_nothing(node: Node, given: Dictionary) -> Dictionary:
 		said[property] = (
 			(
 				"%s names no node from %s. It is written, as the editor writes one, since that "
-				+ "node may be added next; until it is, %s finds nothing."
+				+ "node may be added next. Until it is, %s finds nothing."
 			)
 			% [str(named), node.name, property]
 		)
@@ -624,7 +624,7 @@ static func no_uniform(material: ShaderMaterial, property: String) -> String:
 	var uniform: String = property.trim_prefix("shader_parameter/")
 	if material.shader == null:
 		return (
-			"The ShaderMaterial has no shader, so it has no parameter %s yet; set shader first."
+			"The ShaderMaterial has no shader, so it has no parameter %s yet. Set shader first."
 			% uniform
 		)
 	var shader: String = material.shader.resource_path
@@ -634,5 +634,5 @@ static func no_uniform(material: ShaderMaterial, property: String) -> String:
 		uniforms.append(str(entry["name"]))
 	var said: String = "%s declares no uniform %s, which %s would set" % [named, uniform, property]
 	if uniforms.is_empty():
-		return said + "; it declares no uniforms."
+		return said + ". It declares no uniforms."
 	return GdhRead.offered(said, uniform, uniforms) + "."

package/build/godot/operations/dependencies.gd

@@ -47,7 +47,7 @@ func _init(p_log: GdhLog) -> void:
 # Get dependencies for a resource with circular reference detection
 func get_dependencies(params: Dictionary) -> Dictionary:
 	var resource_path: String = str(params.get("resource_path", ""))
-	# No depth, or a depth of zero or less, means the whole chain; the walk stops at cycles.
+	# No depth, or a depth of zero or less, means the whole chain. The walk stops at cycles.
 	var depth: int = GdhRead.as_int(params.get("depth", 0))
 	var max_depth: int = depth if depth > 0 else 1000
 	var include_built_in: bool = GdhRead.as_bool(params.get("include_builtin", false))
@@ -295,7 +295,7 @@ func find_resource_usages(params: Dictionary) -> Dictionary:
 		file.close()
 		var lines: PackedStringArray = text.split("\n")
 		# A class is used by name only in a script's code. In a scene or a resource the same word is
-		# a node's name or a caption, and each was counted as a use of the class; a shader has no
+		# a node's name or a caption, and each was counted as a use of the class. A shader has no
 		# use for one at all.
 		var code: bool = file_path.get_extension() == "gd"
 		# In a shader # opens a directive, so an #include was answered as a comment, and its
@@ -421,7 +421,7 @@ func find_resource_usages(params: Dictionary) -> Dictionary:
 
 
 # The uid [param line], line [param index] of [param file_path], declares as the file's own: a
-# scene's or a resource's header, or an import sidecar's uid of the file it imports; empty for any
+# scene's or a resource's header, or an import sidecar's uid of the file it imports. Empty for any
 # other line.
 static func _own_uid(line: String, index: int, file_path: String) -> String:
 	var trimmed: String = line.strip_edges()
@@ -738,7 +738,7 @@ static func _cycle_key(cycle: Array[String]) -> String:
 	return "\n".join(PackedStringArray(cycle.slice(first) + cycle.slice(0, first)))
 
 
-## What [param path] names, each file once, as the entries the tree lists it by; read once a walk.
+## What [param path] names, each file once, as the entries the tree lists it by. Read once a walk.
 func _references(path: String, walk: GdhDependencyWalk) -> Array[Dictionary]:
 	if walk.references.has(path):
 		var known: Array[Dictionary] = walk.references[path]
@@ -937,7 +937,7 @@ func _files_by_uid() -> Dictionary:
 
 # The ext_resource paths in [param content] whose uid leads elsewhere, each with the file the uid
 # names. The engine loads an ext_resource by its uid whenever the uid is known, whatever the path
-# says, so a file moved outside the editor still loads, and the walk called it missing; every
+# says, so a file moved outside the editor still loads, and the walk called it missing. Every
 # pattern reads the old path, the bare res:// one included, so the paths are mapped before any of
 # them runs.
 func _moved_by_uid(content: String) -> Dictionary:
@@ -1009,7 +1009,7 @@ static func _shader_code(content: String) -> String:
 	return "".join(PackedStringArray(kept))
 
 
-# The path inside a preload(), load(), #include or ext_resource match; a bare res:// match is the
+# The path inside a preload(), load(), #include or ext_resource match. A bare res:// match is the
 # path. An ext_resource is read first, since its type or its path can hold the word load.
 func _referenced_path(matched: String) -> String:
 	var expression: String = ""

package/build/godot/operations/export_presets.gd

@@ -144,7 +144,7 @@ static func _runnable_name(config: ConfigFile, platform: String) -> String:
 ## Adds an export preset to export_presets.cfg, written with the keys the editor's Project > Export
 ## writes for a new one, and every option in [code]known_options[/code] (what
 ## [method export_options] answers for the platform) at its default. The editor also writes the
-## options a new preset hides until another option shows them; its exporter fills those, and any
+## options a new preset hides until another option shows them. Its exporter fills those, and any
 ## option the file leaves out, with their defaults when it loads the file.
 func add_export_preset(params: Dictionary) -> Dictionary:
 	var preset_name: String = str(params.get("preset", "")).strip_edges()
@@ -173,7 +173,7 @@ func add_export_preset(params: Dictionary) -> Dictionary:
 				(
 					(
 						"There is already an export preset named '%s', for %s, %s. "
-						+ "project_export run exports with it; give another name to add a second."
+						+ "project_export run exports with it. Give another name to add a second."
 					)
 					% [preset_name, config.get_value(held, "platform", ""), to]
 				)
@@ -217,7 +217,7 @@ func add_export_preset(params: Dictionary) -> Dictionary:
 						str_to_var(str(described.get("defaultText", "null")))
 					)
 	# A section with nothing in it is not written, and the editor's loader reports a missing options
-	# section as an error; these two are options of every platform, empty in a new preset.
+	# section as an error. These two are options of every platform, empty in a new preset.
 	for name: String in TEMPLATE_OPTIONS:
 		if not config.has_section_key(section + ".options", name):
 			config.set_value(section + ".options", name, "")
@@ -587,7 +587,7 @@ func set_export_preset(params: Dictionary) -> Dictionary:
 	var saving: Error = config.save(PRESETS_FILE)
 	if saving != OK:
 		return _log.failure("Failed to save export_presets.cfg: " + error_string(saving))
-	# Written as given, since the file can come after the preset names it; said, since an export can
+	# Written as given, since the file can come after the preset names it. Said, since an export can
 	# fail on it until it does. A secret's path is a secret too, so only its option is named.
 	if not missing.is_empty():
 		answer["missing_files"] = missing
@@ -687,7 +687,7 @@ static func _preset_named(preset_name: String) -> Variant:
 	if preset_name.is_empty():
 		return "preset is required: the name of the preset in export_presets.cfg"
 	if not FileAccess.file_exists(PRESETS_FILE):
-		return "This project has no export_presets.cfg; project_export add_preset adds a preset."
+		return "This project has no export_presets.cfg. project_export add_preset adds a preset."
 	var config: ConfigFile = ConfigFile.new()
 	var loading: Error = config.load(PRESETS_FILE)
 	if loading != OK:
@@ -733,7 +733,7 @@ static func _files_for(filter: String, given: Variant) -> Variant:
 	if not not_scenes.is_empty():
 		return (
 			(
-				"Nothing was written: export_filter scenes lists scenes, and %s %s not one; "
+				"Nothing was written: export_filter scenes lists scenes, and %s %s not one. "
 				+ "resources lists any file."
 			)
 			% [", ".join(not_scenes), "is" if not_scenes.size() == 1 else "are"]
@@ -859,7 +859,7 @@ static func _fitted(name: String, value: Variant, option: Dictionary) -> Variant
 		return {
 			"refused":
 			(
-				"%s is a %s, which this tool does not write; the editor's Export dialog does."
+				"%s is a %s, which this tool does not write. The editor's Export dialog does."
 				% [name, type_string(type)]
 			),
 		}

package/build/godot/operations/file_reads.gd

@@ -4,7 +4,7 @@ extends RefCounted
 ##
 ## A scene is read off its SceneState rather than instantiated. Instantiating outside the editor
 ## runs every script's member initialisers and _init (measured on 4.7.2, with or without -e), so a
-## read with no editor would have run the game's code on every node; the editor gets placeholders
+## read with no editor would have run the game's code on every node. The editor gets placeholders
 ## and runs none. The state holds everything the file says, and the scenes it instances theirs,
 ## without making a node. Loading the file still does what loading does in the game: static
 ## initialisers run, and a resource with a script is made with it.
@@ -53,7 +53,7 @@ static func scene_node(scene_path: String, node_path: String) -> Dictionary:
 
 
 ## The node at [param node_path] in [param scene_path] as [method scene_node] answers it, when it is
-## a [param kind]; otherwise a refusal saying what the scene has there and where its nodes of that
+## a [param kind]. Otherwise a refusal saying what the scene has there and where its nodes of that
 ## kind are, so the caller has the path to pass. The file is read once, because every load prints
 ## the engine's warnings about it again.
 static func scene_node_of_kind(scene_path: String, node_path: String, kind: String) -> Dictionary:
@@ -143,7 +143,7 @@ static func _laid(scene_path: String) -> Dictionary:
 ## file's own entries for it applied over it. Answers a refusal, or "".
 ##
 ## [param within] is the files being laid, outermost first, so a scene that instances one of them
-## is refused rather than laid forever; the engine refuses to load such a scene, so this is only
+## is refused rather than laid forever. The engine refuses to load such a scene, so this is only
 ## reached through a state built some other way. [param loaded] is the scene [param state] is read
 ## from, when the caller has it loaded already.
 static func _lay(
@@ -200,7 +200,7 @@ static func _lay(
 			if prefix == "." and loaded == null:
 				nodes[path]["inheritedFrom"] = state.get_path()
 		# The name is the state's even for an entry laid already, since an inherited scene names its
-		# root itself; a root instanced inside another scene is renamed by that scene once laid.
+		# root itself. A root instanced inside another scene is renamed by that scene once laid.
 		if not recovered:
 			nodes[path]["name"] = str(state.get_node_name(index))
 		if fresh:
@@ -229,7 +229,7 @@ static func _lay(
 			if loaded != null and not set_here.has(named):
 				set_here.append(named)
 	# Only the scene being read and the scenes it inherits share its root, the owner whose editable
-	# instances a write here sets; a file instanced below makes its own owner's editable.
+	# instances a write here sets. A file instanced below makes its own owner's editable.
 	if prefix == ".":
 		for editable: String in _editable_in(state.get_path(), loaded):
 			var at: String = _joined(prefix, editable)
@@ -558,7 +558,7 @@ static func resource(res_path: String, include_defaults: bool) -> Dictionary:
 	var serialiser: GdhSerialisation = GdhSerialisation.new()
 	var properties: Dictionary = {}
 	# A headless engine runs a script that is not a tool as the file loads, so what its _init and
-	# setters gave other properties read as values the file sets; the file's own lines say which it
+	# setters gave other properties read as values the file sets. The file's own lines say which it
 	# does. The editor runs no such script.
 	var untooled: bool = script != null and not script.is_tool() and not Engine.is_editor_hint()
 	var from_file: bool = (