gbdev / gbdev/pandocs

Instruction timings are listed in "clock cycles" — should they be named T-states?

Open
#500 2 comments 0 reactions 0 assignees View on GitHub
content enhancement
Dominant language
Markdown
Stars
783
Forks
134
Avg merge
6h 54m
Merged PRs (30d)
3

Description

The instruction table's header names the column listing the execution time for each instruction "clock cycles". This is an ambiguous term, as it could mean M or T cycles. While there is a description at the top, the term remains confusing, particularly for someone looking at the documentation quickly; it is also at odds with most community usage, where "cycles" means M-cycles.

Would it be better to label the column "T-states" explicitly instead? Another option would be to quarter the values, but I assume this wasn't done for some reason I'm unaware of.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.