Improve wording in terminology cleanup

Replace the placeholder noun left by the previous pass with context-fit
phrasing (arrangement XML, chart, custom songs, etc.).
This commit is contained in:
Sin
2026-06-16 19:43:45 +01:00
parent 4148b0e72e
commit c1870a0597
11 changed files with 38 additions and 38 deletions
+9 -9
View File
@@ -663,7 +663,7 @@ def list_tracks(gp_path: str) -> list[dict]:
# ---------------------------------------------------------------------------
# convert_file — mirrors gp2rs.convert_file interface
# Converts GPX tracks directly to the source game XML, reusing gp2rs._build_xml
# Converts GPX tracks directly to arrangement XML, reusing gp2rs._build_xml
# ---------------------------------------------------------------------------
@@ -816,7 +816,7 @@ def _collect_tone_events(
def _inject_tones(xml_str: str, tone_events: list[tuple[float, str]]) -> str:
"""
Inject a <tones> element into a the source game arrangement XML string.
Inject a <tones> element into a chart arrangement XML string.
Parses the prettified XML returned by _build_xml, inserts the tones
block before </song>, and re-serialises. Noop if tone_events is empty.
@@ -1124,7 +1124,7 @@ def convert_file(
*,
expand_repeats: bool = True,
) -> list[str]:
"""Convert a .gpx file to the source game XML arrangement files.
"""Convert a .gpx file to arrangement XML arrangement files.
Mirrors gp2rs.convert_file so the editor plugin can call it transparently.
expand_repeats is accepted for API compatibility but repeat expansion from
@@ -1809,10 +1809,10 @@ def _is_vocal_track(track: dict) -> bool:
def _gpx_lyric_to_rs(raw: str) -> str:
"""
Convert a GPX lyric token to the source game vocal lyric format.
Convert a GPX lyric token to the vocal lyric format.
GPX encodes syllable continuation with a trailing hyphen (e.g. "in-", "t-").
the source game uses the same convention for mid-word syllables. For word-final
charts use the same convention for mid-word syllables. For word-final
syllables with no hyphen, RS requires a "+" suffix to signal "connect to
next syllable without a space" — but only when the next beat is a
continuation of the same word. We handle this at the sequence level in
@@ -1849,7 +1849,7 @@ def convert_vocal_track(
arr_name: str = 'Vocals',
) -> str:
"""
Convert a GPX vocal track to a the source game vocals arrangement XML.
Convert a GPX vocal track to a chart vocals arrangement XML.
Each beat with a lyric and a note becomes a <vocal> element:
time — seconds from song start + audio_offset
@@ -1864,7 +1864,7 @@ def convert_vocal_track(
Beats with a lyric but no pitch note are included as pitch-0 rests so the
display timeline stays intact. Beats with no lyric are skipped entirely.
The output is a minimal but valid the source game vocals XML. It does not include
The output is a minimal but valid vocals XML. It does not include
ebeats or phrases (RS parses vocal XMLs without them).
"""
string_pitches = track['string_pitches'] # high→low, standard guitar if vocal
@@ -2018,10 +2018,10 @@ def _build_vocals_xml(
vocals: list[dict],
tempo: int,
) -> str:
"""Build a the source game vocals arrangement XML string."""
"""Build a chart vocals arrangement XML string."""
from xml.dom import minidom
# the source game vocals arrangement is a flat <vocals> document — NOT a
# vocals arrangement is a flat <vocals> document — NOT a
# <song> wrapper. Every lyric consumer in the codebase keys off the root
# tag being literally "vocals" (lib/loosefolder.py, server.py highway
# loader), so a <song> root would be silently skipped and the generated