asm_book/section_1
Perry Kivolowitz 52bf6eccd9 Clarify PUSH_P / PUSH_R / POP_P / POP_R naming at first encounter
Part of #33.

The v6.S listing in the hello_world chapter introduces the PUSH_P,
PUSH_R, POP_P and POP_R macros without explicitly telling the reader
what the _P and _R suffixes stand for. For a reader reading the
chapter in order, the mapping is derivable: the book established
stp = "store pair" about 260 lines earlier, and the _R suffix falls
out by parallel with str. But a reader who jumped straight to v6.S
without reading the stp explanation (as Atcold did in issue #33) has
no such anchor and is left guessing.

One sentence at the "The push and pop macros simply save typing"
paragraph closes the gap: it names the _P / _R suffixes, connects
them to the already-taught stp / str convention, and costs a skimmer
nothing. The macro names themselves are unchanged; they were already
fine for an in-order reader, and renaming would have churned every
.S file in the book.
2026-04-19 02:26:19 -05:00
..
const updated markdownlint problems plus error in while 2024-01-25 16:08:01 -06:00
fizzbuzz updated markdownlint problems plus error in while 2024-01-25 16:08:01 -06:00
for updated markdownlint problems plus error in while 2024-01-25 16:08:01 -06:00
funcs removed link for Jishnu as it turned into a gambling sitegit add . 2025-01-14 20:40:56 -06:00
hello_world Clarify PUSH_P / PUSH_R / POP_P / POP_R naming at first encounter 2026-04-19 02:26:19 -05:00
if corrected broken link for register interlude. 2025-01-14 20:51:02 -06:00
jump_tables updated PDFs 2023-01-18 08:26:45 -06:00
recursion updated markdownlint problems plus error in while 2024-01-25 16:08:01 -06:00
regs corrected a link 2024-05-03 18:53:46 -05:00
structs Document hex dump display convention in alignment chapter 2026-04-19 02:20:10 -05:00
while corrected sense of compare for error filed almost one year ago and in a different life 2025-01-14 20:56:13 -06:00
hex.md Os are not 0s. 2023-02-01 08:09:36 -06:00
hex.pdf do not write while sleeping 2023-02-01 08:06:31 -06:00
kickstart.md something changed 2024-02-17 16:17:36 -06:00
kickstart.pdf something changed 2024-02-17 16:17:36 -06:00