andrew/akbasic
1
0
Fork 0
Code Issues 27 Pull Requests Actions Packages Projects Releases Wiki Activity

RND is missing, and every program has to transcribe an LCG #16

New Issue
Open
opened 2026-08-02 19:04:22 -04:00 by tachikoma · 0 comments
tachikoma commented 2026-08-02 19:04:22 -04:00
Collaborator
Copy Link

Source: TODO.md §4 (at 9151438)

Chapter 17 teaches the LCG workaround and the demo's RANDOM label carries it: nine tokens, two
convention globals (RMAX# in, RND# out), and a seed the caller must remember to take from
TI#.

That is the right teaching example and the wrong thing to make every program transcribe.

Closing it is the standard function shape -- dispatch-table row, exec handler, tests, a Chapter 12
row -- and Chapter 17's section becomes a history lesson instead of a requirement.

ASC is in the same boat with a worse workaround (INSTR into a 41-character alphabet
string). INT and SQR are not, because integer assignment and ^ 0.5 already are those
functions.

Files: src/verbs.c, src/runtime_functions.c, docs/12-function-reference.md

Filed by Tachikoma (Claude Code, Opus 5, 1M context)

**Source:** TODO.md §4 (at 9151438) Chapter 17 teaches the LCG workaround and the demo's `RANDOM` label carries it: **nine tokens, two convention globals (`RMAX#` in, `RND#` out), and a seed the caller must remember to take from `TI#`.** That is the right *teaching* example and **the wrong thing to make every program transcribe.** Closing it is the standard function shape -- dispatch-table row, exec handler, tests, a Chapter 12 row -- and Chapter 17's section becomes a history lesson instead of a requirement. **`ASC` is in the same boat with a worse workaround** (`INSTR` into a 41-character alphabet string). `INT` and `SQR` are **not**, because integer assignment and `^ 0.5` already are those functions. **Files:** `src/verbs.c`, `src/runtime_functions.c`, `docs/12-function-reference.md` --- Filed by Tachikoma (Claude Code, Opus 5, 1M context)
tachikoma added this to the 0.2.0 milestone 2026-08-02 19:04:22 -04:00
tachikoma added the api-gapblast-radius:highstatus::grooming labels 2026-08-02 19:04:22 -04:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
abi-break
Cannot land without a soname bump
 api-gap
A caller cannot express something
 blast-radius:high
Ordering: highest blast radius
 blast-radius:low
Ordering: lowest blast radius
 blast-radius:medium
Ordering: middling blast radius
 defect
Wrong behaviour reachable from the public API
 design-decision
Needs a decision written down before code
 docs
Documentation, comments, AGENTS.md
 hygiene
Style, dead code, consistency
 packaging
Build, install, pkg-config, CMake config
 performance
Has a measurement behind it
 status::blocked
Waiting on something else -- a decision, a dependency, or another issue
 status::grooming
Not yet worked out: scope, approach or priority still being settled
 status::ready
Understood well enough to start: scope and approach are settled
 test-coverage
A gap in the suites, not a defect
No Label api-gap blast-radius:high status::grooming
Milestone
No items
No Milestone 0.2.0
Projects
Clear projects
No project
Assignees
Clear assignees
tachikoma andrew
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: andrew/akbasic#16
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?