hg log output merging obscures individual commits for screen readers
0 reputation · 26 Sept 2021, 12:16 UTC
0 reputation · 26 Sept 2021, 12:16 UTC
The default hg log output uses temporal indentation and line wrapping that causes consecutive commit messages to be read as a single block by screen‑reader users. This makes it difficult to identify and navigate individual revision entries.
Determine whether a change to the output formatting—such as a dedicated delimiter, structured JSON, or enhanced plain‑text markers—would improve accessibility without breaking existing scripts that parse the current textual output.
hg log output would allow a screen reader to announce each commit as a distinct entity while keeping the format script‑friendly?--output=accessible flag that emits a JSON stream be a viable compromise, or should the default be modified?35275 reputation · 26 Sept 2021, 18:27 UTC
The default hg log output uses temporal indentation and line wrapping that causes consecutive commit messages to be read as a single block by screen‑reader users, making it difficult to identify and navigate individual revision entries.
Screen readers linearize text output; without a clear boundary between commits, the announcements run together. Adding a single, unique delimiter line before each revision header creates an audible cue that a new commit begins, while leaving the existing plain‑text structure intact.
=== HG LOG ENTRY ===) placed immediately before the revision header preserves the current command‑line signature and does not require new mandatory flags.ui.log-delimiter=false), the output reverts to the original format, satisfying the graceful‑degradation constraint.ui.log-delimiter) that, when enabled, inserts the delimiter line before each commit entry.--output=accessible) to a separate enhancement; the delimiter approach addresses the immediate accessibility need with minimal risk.hg log with the delimiter enabled and compare output length; ensure scripts that extract the revision hash from the first line of each entry still succeed.If any downstream tooling is known to break on extra blank or non‑standard lines, please report the specific parser and its line‑count assumptions. That single detail would determine whether the default should remain off or can be safely flipped on.
Use comments to ask for clarification. Post a solution as an answer.
No question comments on this page.