Reword code comments in plain technical language

Comments only, no code changes. Replaces vague or personified phrasing
with explicit statements of what the code does and why, uses bullet
lists for multi-case behavior, and fixes the settings path in
WindowSettings.h (~/.config/sloposk/sloposk.conf).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-03 19:58:59 +01:00
co-authored by Claude Opus 5.5
parent 5e4d4051f3
commit 23e957660f
53 changed files with 232 additions and 226 deletions
+8 -8
View File
@@ -1,8 +1,8 @@
import QtQuick
import Sloposk
// One-tap switches for the most changed key options, beside the gear.
// Icons are drawn from boxes so they don't depend on the fonts installed.
// Toggle buttons for frequently changed key options, next to the settings button.
// Icons are built from Rectangles, so they don't depend on installed fonts.
Row {
id: toggles
@@ -13,8 +13,8 @@ Row {
return layoutModel.sections.some(s => s.id === id);
}
// Shows or hides one of the template's optional sections; absent from
// layouts without it.
// Shows or hides an optional template section. Not displayed if the
// layout has no such section.
component SectionToggle: BarToggle {
required property string section
@@ -23,7 +23,7 @@ Row {
onToggled: checked => toggles.settings.setSectionVisible(section, checked)
}
// A grid of tiny keys, optionally in a keyboard outline.
// Icon: grid of small keys, optionally inside a keyboard outline.
component KeyGrid: Item {
id: keyGrid
required property color color
@@ -58,7 +58,7 @@ Row {
}
}
// A key outline with a label on it.
// Icon: key outline with a text label.
component LabelledKey: Rectangle {
property alias label: caption.text
property alias textColor: caption.color
@@ -90,7 +90,7 @@ Row {
label: qsTr("Hold Keys")
checked: toggles.settings.holdKeys
onToggled: checked => toggles.settings.holdKeys = checked
// A fingertip resting on a key, holding it down.
// Icon: finger pressing a key (hold-keys mode).
Rectangle {
anchors { horizontalCenter: parent.horizontalCenter; bottom: parent.bottom }
width: 18
@@ -119,7 +119,7 @@ Row {
id: navigation
section: "navigation"
label: qsTr("Navigation Keys")
// The inverted T of the arrow keys.
// Icon: arrow keys in an inverted T.
Repeater {
model: [[1, 0], [0, 1], [1, 1], [2, 1]]
Rectangle {